Achievements

The Achievement plugin tracks what players do (kills, levels, resets, upgrades, chaos mixes, events, quests, play time and more) and turns it into a card grid of achievements. Every achievement has one or more tiers; reaching a tier's target completes it, and the player clicks Claim on the card to receive that tier's rewards and achievement points.

Opening the Window#

Press U (Window Menu) and pick Achievements - it is the last entry. The entry is only listed when the server shipped an achievement catalog, so an unlicensed server never shows it. There is no dedicated letter hotkey (every letter is already taken). When a tier completes, a toast appears under the top bar and a gold chat line is printed.

File Location#

Data/Plugins/Achievements/
  Settings.xml                                  optional global settings
  01 - Combat.xml                               one file per category
  02 - Progression.xml
  ...
  _TEMPLATE - Achievement Format Reference.xml  reference, never loaded

Dependencies#

How Files Are Loaded#

• Every *.xml in the folder is loaded in alphabetical order. Settings.xml and files starting with _ are skipped.
• One file = one <Category>; its <Achievement> children belong to it.
• Category Id must be 1 to 16 and unique. Achievement Id must be 0 to 249 and globally unique across all files.
• Progress is stored by achievement Id. Never renumber a live achievement; removing one leaves harmless orphan progress in the database.
• A bad entry (duplicate id, missing trigger, no tiers) is logged and skipped; the rest of the file still loads.
• Reload with $achreload (GM) or the plugin reload. Players already online keep the old catalog until they relog.

Category#

<Category Id="1" Name="Combat" Order="1" Icon="ach/cat_combat">
  <Achievement .../>
</Category>

Achievement#

<Achievement Id="2" Name="Dragon Slayer" Icon="ach/dragon" Text="Slay Budge Dragons in Lorencia." Enabled="1">
  <Trigger Type="KillMonster" MonsterClass="2" Map="0"/>
  <Tier Target="10"   Points="5">  <Reward Type="Zen" Amount="50000"/> </Tier>
  <Tier Target="100"  Points="10"> <Reward Type="Item" ItemType="14" ItemIndex="13" Count="1"/> </Tier>
  <Tier Target="1000" Points="15"> <Reward Type="Item" ItemType="14" ItemIndex="14" Count="2"/> </Tier>
</Achievement>

Trigger#

Exactly one <Trigger> per achievement. Every achievement owns one counter. The counter mode is fixed by the trigger type:

• Count types add 1 per matching event.
• Max types keep the highest value seen (level, reset count, item level).

Filters default to -1 = any. Generic A and B attributes override the friendly names below.

Tier#

1 to 8 tiers per achievement. Target values must strictly ascend.

Reward#

0 to 4 per tier. Same grammar as Custom Quests.

Settings.xml#

<Achievements AutosaveSec="180" RewardToInventory="0"/>

Icons#

Icons are client sprites from the atlas Data/Interface/UI/atlas/achievements.png + achievements.xml, referenced as ach/<name>. The same atlas serves both UI skins. To add icons (48x48 PNG), use Tools\AtlasPacker (see Tools): AtlasPacker.exe -unpack <client>\Data\Interface\UI\atlas\achievements.xml MyIcons, add your PNGs to MyIcons (keep default.png), then AtlasPacker.exe MyIcons achievements ach -out <client>\Data\Interface\UI\atlas. The file name is the sprite name: slayer.png becomes ach/slayer. Any Icon that is missing from the atlas falls back to ach/default; if that is missing too, the card shows an empty plate. Text and progress are unaffected.

Important Behavior#

• Tier completion is derived from the counter (Counter >= Target), not stored. Raising a Target after players progressed can un-complete a tier they have not claimed yet; lowering one completes it on their next progress tick or relog.
• Claimed tiers are stored as a bitmask and never revert.
• Progress before the DataServer answered the load request is dropped (never saved over the database). Players see this only on a slow DataServer.
• Achievement points are display-only (window header, per tier in the tooltip). They are the sum of claimed tiers' Points.
• The Bridge plugin can export the same events; achievements do not depend on it.

GM Commands#

GM authority (Authority & 32) required.

Examples#

<?xml version="1.0" encoding="UTF-8"?>
<Category Id="2" Name="Progression" Order="2">
  <Achievement Id="14" Name="Devoted" Icon="ach/playtime" Text="Spend time in the world (minutes online).">
    <Trigger Type="PlayTime"/>
    <Tier Target="60"   Points="5">  <Reward Type="Zen" Amount="100000"/> </Tier>
    <Tier Target="600"  Points="10"> <Reward Type="Item" ItemType="14" ItemIndex="13" Count="2"/> </Tier>
    <Tier Target="6000" Points="25"> <Reward Type="Currency" CurrencyType="Goblin" Amount="300"/> </Tier>
  </Achievement>
</Category>

<Achievement Id="26" Name="Soul Gambler" Icon="ach/upgrade" Text="Reach +9 using Jewels of Soul.">
  <Trigger Type="ItemUpgrade" Method="1"/>
  <Tier Target="7" Points="5">  <Reward Type="Item" ItemType="14" ItemIndex="14" Count="2"/> </Tier>
  <Tier Target="9" Points="15"> <Reward Type="Item" ItemType="12" ItemIndex="15" Count="2"/> </Tier>
</Achievement>

<Achievement Id="23" Name="Wingmaker" Icon="ach/wings" Text="Craft first-class wings.">
  <Trigger Type="ChaosMix" MixType="7" Success="1"/>
  <Tier Target="1" Points="20"> <Reward Type="Item" ItemType="14" ItemIndex="22" Count="2"/> </Tier>
</Achievement>
<Achievement Id="27" Name="Kundun's Contract" Icon="ach/quest" Text="Complete quest 15.">
  <Trigger Type="QuestComplete" QuestId="15"/>
  <Tier Target="1" Points="10"> <Reward Type="Zen" Amount="500000"/> </Tier>
</Achievement>

Common Issues#