MIKURO · TORCHLIGHT II DEVWORKS

Emberworks

余烬工坊 Remaster · Mods · Tools

Tear down an old lantern, light a new furnace. This is where the Torchlight II reverse-engineering and remaster journal lives, alongside changelogs for the Challenger Continent mod pack and a full armory of homegrown tools — from packers to launchers.

◆ ◆ ◆

Ⅰ

Field Manual 指南

Install notes, combat math and troubleshooting — read this before you zone in.

2023-11-27Challenger Continent Mod · User Guide Installation, load order, and common crash troubleshooting. Read this before you play.

◆ ◆ ◆

Ⅱ

Changelog 更新日志

Release notes for Challenger Continent and the Mikuro Launcher, entries colored by item rarity — scan what dropped in this patch at a glance.

2026-08-09Challenger Continent MOD Changelog Complete version change history of the Challenger Continent mod pack.2026-07-24Mikuro Launcher Changelog Version change history of the Mikuro Launcher (including MIKURO Game Enhancement).

◆ ◆ ◆

Ⅲ

Dev Journal 开发日志

Reverse engineering, faithful reconstruction, pitfalls and backfills — speculation is never written up as conclusion.

Latest

2026-07-25 · Mikuro

What's Actually Inside a .MOD: Torchlight II's Packing Format, Fully Explained

Everything that happens between a mod folder and a .MOD the game will actually load: how the container is assembled, what each of the five binary formats is, which single hash the game really validates, and how the pathing grid gets baked. Including the real mechanism behind those baffling failures — ticked in the launcher but does nothing / the portrait turned into some other image / players can't move after entering the dungeon.

2026-07-24TL2 Tag System RE: A Zero-Validation Engine, and a Property-Key Audit The engine matches tags by rghash with zero runtime validation; any tag works. Plus the truth about GUTS's spammy no-match warning, and a property-key audit of two real mod packs. (2026-07-25: section 9 added: names live in two namespaces, and the "zero hardcoded tags" search was blind.)2023-08-05Torchlight 2 IMBA MOD Modification Notes Technical notes on IMBA MOD modifications and a record of data-side changes.

All entries

◆ ◆ ◆

Ⅳ

The Armory 工具库

Homegrown third-party tools, each displayed as a piece of equipment — the affixes are its abilities, the rarity its maturity.

Mikuro Launcher

Legendary · Game Enhancement · Mod Launcher

MIKURO X layer: loot filter / save-crash fix / WASD movement: one switch, all on
Breaks the official 10-mod cap: stack as many as you like (in-memory, exe untouched)
Dual DXVK builds auto-selected by GPU driver: Direct3D 9 rendered through Vulkan
Save tools: respec skills & stats, unbind mods precisely, double-click to select a save's mod set
One click to join the MIKURO Afdian multiplayer servers (Guangzhou / Australia)
Environment self-check on every launch: OS / first run / mod folder / VC++ runtime

“The cap only ever existed in one line of the old launcher.”

■ Released · v1.1.9windows 10 / 11 · bundled with the mod pack

MIKURO Runtime MOD

Legendary · Runtime content MOD · Azure Lotus gem system

Azure Lotus gems: three-tier cooldown line (Gathered Spirit / Condensed Essence / Great Void) + four dual-effect (stat + cap) cap-break stones + Bloodthirst
Socket tooltip rows 5 → 10 (engine has no 5-socket cap; items with ≤5 sockets unaffected)
Beast Taunt: collar + command tome, pet pulls 10m aggro for 4 seconds
In-game item text is deliberately short; this page is the authoritative reference

“Farm the jade, forge the spirit.”

■ Always on with Game Enhancementruntime-mounted · single-player / host

Torchlight II Mod Pack/Unpack Tool

Legendary · Mod Pack / Unpack CLI

3-second init — no more waiting 20 seconds for the editor
Packs / unpacks by calling EditorGuts.dll exports directly
Fits a keep-your-workspace-clean development flow

“Pack without waking the editor ever again.”

■ Releasedgithub.com/heiybb/TL2-Mikuro

.MOD UN/PACKER · Web Edition

Magic · In-Browser Mod UN/PACKER · WebAssembly

The same Rust code as the desktop tl2-mikuro-mod-packer, compiled to wasm; DAT / LAYOUT compilation and .MOD packing are byte-identical
Fully client-side: pick a folder → pack → download; nothing uploaded, nothing installed, works offline once loaded
Ships the full Runic base data (UNITS templates + level collision geometry): BASEFILE inheritance and MPP walk-grids bake right in the browser
Uses wasm threads under cross-origin isolation; large mods pack in ~1/4 – 1/6 of the single-thread time
Unpacks too: a .MOD back into an editable source folder, with BINDAT / BINLAYOUT decompiled to text; Chrome / Edge write the folder directly, others get a ZIP
Key-name recovery: a 465k-entry tiered reverse table plus the file's own context. Recovered names print green, still-unknown ones red; across 20 third-party mods UNK_ fell from 972 to 871 with zero regressions
For speed, or for multi-hundred-MB compilations, reach for the native Rust build tl2-mikuro-mod-packer-rs: real multi-core parallelism, no browser memory ceiling

“The same furnace, seen through a new window.”

■ Liveweb · chrome / edge / firefox

◆ ◆ ◆

Ⅴ

The Drawing Board 创意公示

Unfinished ideas, laid out on the table — some will catch fire, some are only sparks. Every entry carries a status; this is disclosure, not a promise.

Status scale —— ■ Spark = a fresh idea · ■ Hatching = research & prototyping · ■ Forging = under construction · ■ Shipped = done and delivered · ■ Shelved = cooling off

2026-08-01Hatching Azure Lotus Taoist · Rites of the Three Pure Ones A second-class concept for the Azure Lotus lineage — cycle the Five Elements to build Qi, unleash it at Five Breaths Converged, and let runtime miracles handle charm, death-cheating and soul-harvesting. Full 36-skill draft inside.2026-07-14Hatching Adding WASD Movement to the Vanilla Game Teaching an old click-to-move engine to listen to the keyboard; the two key engine anchors are verified by reverse engineering, the approach is settled, and it's waiting to be written into Mikuro Runtime.2026-07-14Forging Azure Lotus · Haste Spirit Stone A skill-cooldown spirit-stone system rooted in Azure Lotus Chalcedony and evolved through three forgings — complete design draft; numbers and rules open for debate, critique welcome.2026-07-14Hatching Moonlight Blade Progression Systems: A Research Report Taking apart Moonlight Blade's entire progression stack (Longzhu, Tianxinzhu, Langwen, Bianshi, Jingmai) to scout the road for the remaster's equipment and progression systems.