Repository navigation
Progress
What works, what's being worked on and what comes next, as of 2026-11-17. The origin tags are explained on the Timeline.
For the row-by-row state of every quest, leve, battle action, dungeon, recipe, gathering point and zone, see Status (updated with the status tracker). This page keeps the big pieces.
| Piece | What it does | Origin | Where |
|---|---|---|---|
| Lobby, world, map and web services | The four services, the 1.x wire protocol, Blowfish session handshake, packet framing | Meteor, ported by Garlemald | Base |
| Lua content system | 1,142 scripts (quests, directors, shops, aetherytes, populace) on a coroutine scheduler | Meteor, ported by Garlemald | Base |
| Character creation, zone-in, chat, movement | Making a character and getting into the world | Meteor, Garlemald | Base |
| Opening stories and story quests | The three city openings; Court in the Sands, Souls Gone Wild, Legends Adrift | Meteor scripts, finished by Garlemald | Base |
| Movement speed, server list | Run and walk speeds; servers listed in configs/servers.toml
|
Garlemald | Base |
| Tutorial softlock fixes | Magic and war combat tutorials, the Rostnsthal tutorial, quest talk on menu NPCs | XIVLegacy | Garlemald #212, #215, #223, #224 |
| Real gil in NPC scripts | Chocobo rental and shops see the player's gil | XIVLegacy | Garlemald #214 |
| Open-world monsters | About 3,200 monsters across the four regions, with the standard monster init | XIVLegacy, xivl-captures | Garlemald #213, #216 |
| Streaming to 100 yalms | Far monsters are removed, so the world fills in without overflowing the client | XIVLegacy | Local commit, 2026-10-24 |
| Crafter and gatherer starter kit | Tools and outfits at first login | XIVLegacy | Local commit, 2026-10-24 |
| LAN address | Players on the server's own network reach it | XIVLegacy | Local commit, 2026-10-24 |
Settings, sessions, modules, /status
|
Hosting without editing tracked files; one record of who's online; optional modules | XIVLegacy | #1 |
| GM levels and GM tools |
!zone, !camp, !setgm, the GM tag, Mordion Gaol, !pos, items |
XIVLegacy (tool set from our FFXI server) | #2, #3, #4 |
| Linkshells | Crests, invites, members, linkshell chat | XIVLegacy | #5, #6 |
| Inventory and gear | Items survive login and zone changes; equipping from the Gear window | XIVLegacy | #7, #8 |
| Quests, usable items, spawns | With GM test tools | XIVLegacy | #9 |
| The Final Days |
!worldend, Dalamud's red sky, an optional module |
XIVLegacy | #12, #14 |
| Battle leves | Levemete offers, camp start, kill tracking, gil rewards, abandon | XIVLegacy | #16 |
| Opening relog | Relogging during an opening replays it instead of locking the tutorial | XIVLegacy | #17 (also Garlemald #217) |
| Ul'dah landing and GM warps | Land in the plaza; no floor camera; same-zone quick warp | XIVLegacy | #15, #18, #20 |
| Camp Black Brush | NPCs on the ground, and the camp's residents | XIVLegacy, Kodama | #19 |
| Other players | Seeing each other, nameplates, targeting, female flag, grand company, mounts | XIVLegacy | #21, #22 |
| Parties | Invite, accept, party list, party chat, logout handling; linkshell invite and disband fixed along the way | XIVLegacy | #23 |
| Tells and linkshell chat | Tells; linkshell messages show the shell's name; members hear about leaves, rank changes, exiles and disbands | XIVLegacy | #25, #26 |
| Player bug reports |
!bug (and the client's bug-report key) sends the place, a screenshot and logs to GitHub and Discord |
XIVLegacy | #24, #132 |
| NPCs and travel | Default talk, private areas, aethernet gates, aetheryte menus, GM !goto/!bring/!setpos for NPCs and monsters |
XIVLegacy | #28, #30, #108, #208 |
| Main story | Every playable 1.23b main story quest through Futures Perfect, with duties, escorts and the rewards their windows show | XIVLegacy | #31–#42, #100, #105, #159, #162, #181, #190, #192, #213, #233 |
| Grand Companies | Enlisting, recruit missions, the company story through To Kill a Raven, rank quests, promotions | XIVLegacy | #43–#45, #49–#93 |
| Class and guild quests | Guild welcomes and the rank 30 and 36 quests for every Disciple of War and Magic; guild quests for all ten Disciples of the Hand and Land | XIVLegacy | #94, #96–#98, #101–#103, #106, #122, #124, #125, #127, #163, #166, #183–#185, #193, #195–#197, #287–#291 |
| Job quests | Warrior, Monk, White Mage, Black Mage, Paladin, Bard, Dragoon; bosses beatable solo; switching jobs with soul crystals | XIVLegacy | #222, #224, #225, #231, #236, #238, #240, #247, #249, #250, #286 |
| Side quests | Around the three cities, levels 1–50, with rewards, givers and quest monsters; Hildibrand | XIVLegacy | #167–#169, #174–#176, #203–#207, #209, #257, #263, #265, #266 |
| Primal battles (Hard) | The Hard fights against Ifrit, Garuda and Good King Moggle Mog XII, and Nael van Darnus on the Rivenroad, as quests | XIVLegacy | #296 |
| Monster moves in the client | Every placed monster move forced on its monster and checked in the client; Thornmarch's king learns his court's moves; Garuda's Plumage calls Razor Plumes, bombs Self-destruct; boss fights reachable with !dungeon | XIVLegacy | #300, #304 |
| Dungeons filled in | Toto-Rak chamber adds, fuller packs in Dzemael, Aurum Vale and Cutter's Cry; entry guards for Aurum Vale and Cutter's Cry that check the whole party; boss chests that open; the Dzemael terminal exit; A Light in the Dark's dungeon steps. Every dungeon row on the Status page works | XIVLegacy | #301, #302, #303, #305, #307, #310 |
| Monster Mode | GMs and testers can take over a field monster with !monstermode: its body, level, HP, stats and moves on the hotbar, with a camera sized to the body (client 0.1.24+); your own character comes back on every exit; no EXP or credit while transformed. Every move used or refused as a monster is recorded, testers mark moves working or broken with !monstermode ok/bad, and the web reports page shows it all (/reports/monster-mode). Monster Points come from kills and time played as a monster and buy gear from three monster vendors: Nibbles the Qiqirn in Ul'dah, Mogsley the Moogle in Gridania and Gobbie the Goblin in Limsa (shop window with client 0.1.25+). Monster Mode is an optional server module (monstermode), off by default |
XIVLegacy | #308, #312, #313, #315, #316, launcher #28, launcher #34 |
| Leves | Regional cards, Chase, Necrologos, Survive, Grand Company and rescue leves, class tutorial leves, faction credit | XIVLegacy | #227–#229, #232, #234, #235, #237, #264, #275 |
| Dungeons | Party or solo copies with doors, sealed boss rooms and chests; Toto-Rak, Dzemael Darkhold, Aurum Vale, Cutter's Cry, Tam-Tara Deepcroft, U'Ghamaro Mines, Shposhae and the open dungeons | XIVLegacy, Caladius | #46, #47, #210–#212, #219–#221, #246, #252–#256, #258, #260, #261, #274 |
| Parties in play | Shared leves, EXP, quest kill credit and seals; rejoining after a relog | XIVLegacy | #216–#218 |
| Crafting | Synthesis with progress, durability, quality, HQ and crafter EXP; all 5,384 recipes crafted in the client | XIVLegacy | #270, #278, #282, #283 |
| Gathering | Mining, logging and fishing; used-up points hide per player | XIVLegacy | #272, #273, #284 |
| Seasonal events | Starlight Celebration, All Saints' Wake and Hatching-tide on a yearly calendar; Starlight decorations; GM switches !starlight, !moonfire, !halloween, !easter | XIVLegacy | #268, #277, #297, #298, #299 |
| MariaDB, logs and reports | The servers run on MariaDB, with activity logs and /reports
|
XIVLegacy | #131, #145 |
| Relogs and logout | Exit Game and Return to Character Screen work; relogs keep your spot, HP, MP and status effects | XIVLegacy | #110, #134, #135 |
| GM toolkit | Set class, level, job and gear live; !giveexp, !gmhelp, !finditem, !usemove
|
XIVLegacy | #161, #164, #280, #281 |
| Character window and stability | Gear stat bonuses in the character window; no login crash from bag slot 200; no warp-in crash in zones 204, 205, 238 and 264; warps to unloaded zones refused; gear only goes in its own slot, so a class change no longer leaves a white hat | XIVLegacy | #292–#295, #326 |
| Terrain heights | Monsters and NPCs stand on the ground, read from the client's own collision data | XIVLegacy | #114 |
How each formula works and where its numbers came from: Combat formulas.
| Piece | What it does | Origin | Where |
|---|---|---|---|
| Battle commands | Every class's commands resolve; trait-gated statuses, refusal texts | XIVLegacy | #95, #115 |
| Skill power | Spells and weaponskills hit and heal by potency, level and stats, fitted to retail captures | XIVLegacy, xivl-captures | #111 |
| Area, multi-hit and class fixes | Cone and box attacks hit their target, multi-hit weaponskills, usable MP for physical classes, enhancing potency from MND, archers auto-attack from range | XIVLegacy | #116, #117, #118, #123 |
| Status effects change stats | An effect's stat changes go on when it lands and come off when it ends | XIVLegacy | #112 |
| Combat hooks | Effects react to hits, crits, misses, blocks, damage taken and commands (Life Surge, Blood for Blood, Barrage…) | XIVLegacy | #119 |
| Fists and hit rate | Pugilist fists toggle; hit rate follows the level gap (2% a level, 20–95%) | XIVLegacy | #120, #121 |
| Status effects end to end | Ticks, your own Sleep/Stun/Silence/Bind stop you, speed effects, toggles, stacking rules; all 103 effects audited | XIVLegacy | #126 |
| Accuracy, evasion, potency, resistances | Blind, Hawk's Eye, Minuet, Cleric Stance, Magic Evasion Down and elemental resistances count in combat | XIVLegacy | #128 |
| Party and support effects | Cover, Collusion, Divine Veil; weaponskill and spell combos; positional bonuses | XIVLegacy | #137–#140 |
| Traits, gear and songs | Passive stat traits, trait area effects, gear accuracy, evasion and potency in combat, one song per bard, swift traits | XIVLegacy | #141–#144, #200 |
| Monster skills | 1.0 moves and family skill lists; monsters use TP moves and spells, announce them, and dungeon bosses have their own | XIVLegacy | #146–#151, #156, #158, #165 |
| Monster behavior | Weapon-class enemies, leashing and walking home, facing, duty chases, respawns without a relog | XIVLegacy | #154, #155, #157, #160, #189, #202 |
| Knockback | The 1.0 knockback moves push you along the client's terrain, with a quick slide | XIVLegacy | #152, #178, #188, launcher #23 |
| Battle balance 1–50 | Retail-fitted HP, hit scale and monster stats, checked band by band | XIVLegacy, xivl-captures | #170, #172, #177, #223, #230 |
| Effects kept across a relog | Saved with when they started; at login they resume with the time they had left, and ended ones stay gone | XIVLegacy, after LandSandBoat | #130 |
| Piece | What it does | Origin | Where |
|---|---|---|---|
| Installer | Builds 1.23b from the original disc image and patches, or downloads them; checks and repairs an install | XIVLegacy | Launcher |
| Native client |
ffxivgame.exe translated to native code on the player's machine; no Wine, no Square Enix files shipped |
XIVLegacy (recompiler from our FFXI client, with SSE added) | Launcher |
| Windows APIs | A small portable implementation of what the game calls: files, threads, fibers, input, XAudio2, sockets | XIVLegacy | Launcher |
| Direct3D 9 on Metal | Drawing and shader translation on macOS | XIVLegacy | Launcher |
| Direct3D 9 on wgpu | Drawing on Windows (Direct3D 12 or Vulkan underneath) | XIVLegacy, with wgpu-native | 0.1.6 |
| Three game-code patches | Clock pin for the lobby, two crash guards | Found by Garlemald Client | Applied when the game is made |
| Windows: 60 fps, clean audio | One sleep timer per thread | XIVLegacy | 0.1.14 |
| Mac app | Notarized, Apple Silicon | XIVLegacy | 0.1.14 |
| Gamepads | Writes the game's gamepad settings so controllers work | XIVLegacy | 0.1.16 |
| Faster login and loading | Lobby hello in under a second; select to world in 11 s | XIVLegacy | Launcher #1, 0.1.17 |
| Battle log tab | Battle messages in a tab of the main log window | XIVLegacy | Launcher #2, 0.1.18 |
| Crash logs and bug-report key | Logs kept when the game closes early; Ctrl+F12 or both sticks sends a screenshot and logs | XIVLegacy | launcher #3, launcher #5, 0.1.18 |
| Snappy menus, steady camera, smoother motion | Windows open at full speed; the mouse camera holds still; a faster engine | XIVLegacy | launcher #4, launcher #6, launcher #10, launcher #13, 0.1.20 |
| macOS 27 | The guest window moved to 1 TB | XIVLegacy | launcher #14, 0.1.21 |
| Survives script errors and long sessions | Lua errors no longer close the game; no running out of memory after many zone changes | XIVLegacy | launcher #15, launcher #17, launcher #20, 0.1.23 |
| Visible hotbar, solid chat | Action bar outside active mode, a more solid chat window, profanity filter off | XIVLegacy | launcher #16, launcher #18, launcher #19, 0.1.22 |
| Duties and knockback on screen | Timed duty countdown; knockback slides instead of fading | XIVLegacy | launcher #22, launcher #23 (merged, not released) |
| Crash fixes | Leaving a silent server; the actor-delete crash in translated code; actor and camera lookups; the zone-in sound filter assert | XIVLegacy | launcher #21, launcher #24, launcher #25, launcher #26, launcher #27 (merged, not released) |
Per-item progress (tested, untested, not working) is on Status.
| Piece | State | Where |
|---|---|---|
| Levequests | Most of the 361 leves share tested code but haven't been played one by one | Status |
| Gathering | Thanalan mining and Black Shroud logging run; the rest of the points are in progress | Status |
| Zones and dungeons | A few zones still fail to load or crash; three dungeon rows not working | Status |
| Item functions, monster abilities | Shared code works; most rows untested in the client | Status |
| Seasonal events | Starlight Celebration ready for December, then more | — |
| Relic weapons and materia | Held until researched | — |
| Needs testing | He/she in dialog text; how other players' mounts look; leave, kick, promote and disband from the party menu | #22, #23 |
| Fixes offered upstream | 13 pull requests still waiting for review | Garlemald #212–#224 |
| Phase 2: database | Foreign keys; NPC, monster, drop and notorious-monster tables | Design |
| Phase 3: world as the authority | Zone routing and cross-zone chat, tells and parties through the world server | Design |
| Phase 5: load test | 100 bots at a steady tick | Design |
| Phase 6: operations | Docker, CI, backups | Design |
| Piece | State | Where |
|---|---|---|
| Stats in combat | DEX, MND and PIE don't count yet; reading them needs the hit and resist rates retuned | Combat formulas |
| Ammo | Arrows are never used up, so Refill has nothing to do | — |
| Notorious monsters | Their moves, together with filling in the dungeons | — |
| Piece | State | Where |
|---|---|---|
| Next release | Ships launcher #21–#27: duty countdown, knockback slide, the crash fixes | Status: Client |
| Known issues | Peasants Ward draws black around its NPCs; two rare crashes seen once each | Status: Client |
| Windows | Works; macOS gets fixes and tuning first; not code-signed yet | — |
| Controllers | Controller play works; full controller-first testing is still to come | — |
| Linux | A Vulkan host through wgpu | Later |
Community: questions, testing and news on the XIVLegacy Discord.
A passion project. XIVLegacy preserves FINAL FANTASY XIV as it was in 1.0 so people can walk through it again — and seeing the original up close may help explain why Square Enix rebuilt it as A Realm Reborn. If you enjoy old Eorzea, please play the game today: FINAL FANTASY XIV has a free trial with no time limit.
Related: XIVLegacy Reference · server documentation · client documentation · XIVLegacy Launcher