GearScore System

GearScore System for rAthena delivers an equipment scoring and ranking feature:

• Deterministic formula (documented in db/gearscore.yml):

  • Weapons = ATK + MATK + Weapon-Level score

  • Armor = (DEF × 2) + Weight

  • Grade bonus (D→A)

  • Refine tables (per armor & weapon level)

  • Tier bonuses for headgears, accessories, cards, and orbs.

• Config-first: All scores and tier scales are editable via YAML.

• Item “Tiers” field: Adds Tiers parsing to item_db_equip.yml / item_db_etc.yml (pre-RE & RE).
  By default, equipment are tiers 1. It can be applied only on headgear, accessories, cards and orbs enchant.
  You’ll need to set it yourself if you want to set higher tiers on some items.

• Live ladder & buffs: A timer refreshes the Top-10 every 30s; the server grants statuses with icons and buffs. Buffs can be changed in db/import/status.yml

  • Top 1 → +15 ATK/MATK/DEF

  • Top 2–5 → +10 ATK/MATK/DEF

  • Top 6–10 → +5 ATK/MATK/DEF

• Persistence: Scores are saved in SQL per character (with timestamp) and recalculated on login and save.

What’s inside

• db/gearscore.yml (all scoring tables & documentation)

• Status effects & icons (Gearscore_Top1, Top2to5, Top6to10)

Technical highlights

• Ladder refresh interval: #define GEARSCORE_UPDATE_INTERVAL (30000) (30s)

• New constants: MAX_HEADGEAR_TIER=4, MAX_ACCESSORY_TIER=2, MAX_CARD_TIER=5, MAX_ORB_ENCHANT_TIER=3

Usage

• Players: @gearscore to print the breakdown and total.

• Scripts: .@gs = get_gearscore(<char_id or rid>);

• Players in Top-10 automatically receive the visual status and corresponding buff.