Records

Records is the rankings tab in the menu. It ranks every player on the server by what they do there: the mobs they defeat, the blocks they break, the quests they finish, their skill levels, the boss fights they win and more. It replaced the old skill leaderboard in 1.7.1, and everyone who was on that leaderboard is ranked on Records from the start, even players who have not logged in since.

Opening Records

• Open the menu (/xp, /ziggui or the Objective Book) and pick the Records tab.
• Or use /mmoleaderboard (also /mmolb and /mmorankings), which opens Records straight away.
• For a boss fight's records, pick the Boss Fights tab on Records, or use /zigleaderboard encounter.

The Records tab shows whenever your server keeps stats. It also shows when the only records on your server are boss fight records, and then it opens straight to Boss Fights. Each board ranks the top players for what you picked. A player who shows a title has it beside their name here too. Records never shows who is online.

Reading a board

• Where you stand. The top of each tab shows your rank, how many players are on it and your own number in each column. If you are not on it yet, it tells you what counts there and how to get on, such as "Defeat mobs or take on a boss to get on this board."
• The top three get gold, silver and bronze trophies, and your own row is lit up.
• Columns. Hover a column's name to see what it counts, and click it to rank everyone by that column. When two players tie on it, the other columns decide, starting from the left.
• Tabs and periods. Each section's tab has a picture of its own, and the periods (All Time, This Week, This Month and the season tabs) sit under the sections as their own buttons. A long name, such as "Hallow's Eve 2026", a column's name or a caption over your own numbers, reads in full on two lines.
• A board nobody is on yet, such as a week that has just started, shows the section's picture and the same line on how to get on.

What Records ranks

The top row of tabs picks what is ranked. Each section has up to four columns, and a column nothing on your server counts never shows, so a server without a minigame mod, say, has no Rounds Won column.

A seasonal event with an Almanac page, such as Hallow's Eve from Seasons of Orbis, also gets a section of its own after these, ranking the tallies on that page.

The Skills tab

Skills ranks your total level (every skill's level added up), your total XP, the abilities you have cast and the work cycles you have run at work stations. Your level and XP update as you earn XP, and right away when you level up. Its tab is pictured by the crystal from the All tab in the menu's Skills section.

As on the old skill leaderboard, you can also rank by category or by one skill. Under the Skills tab, pick Gathering, Combat, Production or Misc to rank everyone by their levels in those skills, or pick a single skill, such as Mining, from the list beside them. A tie goes to whoever has more XP. These rankings count over all time, so the period row hides while one is picked, and you only see the skills you can earn XP in.

All Time, This Week, This Month

Under the sections, a row of buttons picks the period:

• All Time ranks everything a player has ever done.
• This Week starts empty every Monday at midnight (UTC unless your server changes it).
• This Month starts empty on the first of every month.

Season tabs

While a seasonal event is on, it gets a period tab of its own, named with its year, such as "Hallow's Eve 2026". It counts only what you do while the event runs, and it stays after the event ends, so you can still see who came out on top. Records keeps each event's two most recent tabs.

Renown

Renown ranks how many of the game's own objectives you have completed and your standing with each reputation on the server (the ones Seasons of Orbis adds, for example), one column for each, up to three. Your standing there is what you have earned. Renown counts over all time only, so its week, month and season tabs stay empty. Your own numbers update when you open Records; everyone else's stand as of their last login or the last time they opened it.

Boss Fights

Every boss fight on record has a tab of its own under Boss Fights, and one tab for each party size or difficulty when the fight keeps those apart. Each one ranks:

• Wins: how many times you helped win the fight.
• Best Time: your fastest win.
• Best Share: your best share of a win, out of 100, where the player who did the most in that win reads 100.
• Damage: the damage you dealt the boss across your wins.

The periods work the same as everywhere else on Records: All Time, This Week, This Month and each seasonal event's tab. /zigleaderboard encounter opens the first fight on record, and --encounter=<id> picks one by its encounter id.

The game's own bosses in the goblin Deepworks keep records here under the game's names: the Feastmaster, and the Gobliterator (Gobliterator MkIIII). A Gobliterator fight with Hard Mode switched on at the button in its arena keeps a tab of its own, Gobliterator MkIIII Final. The fights play exactly as the game made them.

The boss records a server kept before 1.7.1 carry over once, the first time it starts on this version, and the fights you win from then on add to them. The old records screen's total points and damage taken are no longer kept. A boss from the base game that shows no boss bar, such as the Voidtaken Grizzly, counts toward Combat's Bosses Defeated when you land the killing blow, but has no tab under Boss Fights (see Bosses without a boss bar).

For Server Owners

Records runs on the shared library, Ziggfreed's CommonLib. It counts on its own, with nothing to set up, and MMO Skill Tree adds the Skills tab. Everything players had counted carries over by itself: each player's Statistics numbers move across the first time they log in, and MMO Skill Tree reads the old leaderboard's mods/mmoskilltree/leaderboard-cache.json once, on the first start, so the old board's players rank from the start. That file is left where it is and never read again. Players are kept by their account, not their name, so a renamed player keeps their place.

Settings in stats.json

Records' settings live in mods/ziggfreedcommon/stats.json. Every entry is optional:

{
  "$Enabled": true,
  "Weekly":  { "StartsOn": "Sunday", "Zone": "America/New_York" },
  "Monthly": { "Zone": "America/New_York" },
  "Season":  { "Event": "Hallows_Eve" },
  "Launch":  { "Kind": "Range", "NameKey": "myserver.stats.period.launch",
               "From": "2026-10-12T00:00", "To": "2026-10-19T00:00" }
}

• $Enabled: false turns stats off. Records stops counting and ranking and its tab goes away, and what players already have is kept for when you turn it back on. The Almanac's own tallies still count.
• Weekly: StartsOn is the day a week starts (Monday unless you change it) and Zone the time zone the week turns over in (UTC unless you change it).
• Monthly: Zone is the time zone a month turns over in (UTC unless you change it).
• Season: Event limits the season tabs to one event, by its id. Left out, every seasonal event gets its tab.
• A date range of your own: any other name with "Kind": "Range" adds a period tab that counts from From to To and can still be read after it ends, for a launch week or a server event. NameKey names the tab from your own lang file, and a Zone of its own sets its clock (UTC unless set).

Weeks and months each keep their two most recent tabs (Keep). The rankings themselves are kept in mods/ziggfreedcommon/stats-board.json, which the server writes for itself: back it up with the world, and do not edit it.

Looking up and using stats

• /zigstats show --player=<name> lists every stat an online player holds, by the key a condition would name. It is an admin command: nobody holds it until you grant it.
• A quest, a conversation or a shop offer can ask how many of something a player has done with the ziggfreedcommon:counter factor and a stat key as its Param: Mob_Kills for every kill, or Mob_Kills/Trork_Warrior for one kind of mob. See Factor spellings.
• /zigleaderboard clock 7d moves the records clock ahead in memory so you can see a week or a month turn over, and /zigleaderboard clock 0 puts it back. While it is moved, stats count toward All Time only.

Stats and sections from a content pack

A stat is a file under Server/ZiggfreedCommon/Stats/, a section under Server/ZiggfreedCommon/StatSections/ (a NameKey, an Order and up to four Stats, each a stat id or Stat/Thing for one line of it) and a period under Server/ZiggfreedCommon/StatPeriods/. A pack adds its own the same way the library and MMO Skill Tree ship theirs, and a file with the same name as a shipped one replaces it.

A section can also name two optional leaves. Icon is the item whose picture its tab shows, and the picture over the board while nobody is on it; left out, the tab shows the library's own picture. HintKey is the full key of one line from your lang file saying what counts on the tab and how to get on it, shown to a player who has no place there yet and under a board nobody is on; left out, the tab says that anything in its columns counts.

// Server/ZiggfreedCommon/StatSections/Combat.json, as the library ships it
{
  "NameKey": "ziggfreedcommon.statboard.section.combat",
  "Order": 10,
  "Icon": "Weapon_Sword_Iron",
  "HintKey": "ziggfreedcommon.statboard.section.combat.hint",
  "Stats": ["Mob_Kills", "Deaths", "Encounters_Defeated", "Encounter_Attempts"]
}