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, full recipe lists and troubleshooting — read this before you zone in.

2023-11-27 Challenger Continent Mod · User Guide Installation, load order, and common crash troubleshooting. Read this before you play. 2023-11-23 Challenger Continent Mod — Complete Recipe List Every custom recipe in Challenger Continent — now an online codex with item icons and probability labels.

◆ ◆ ◆

Ⅱ

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-09 Challenger Continent MOD Changelog Complete version change history of the Challenger Continent mod pack. 2026-07-24 Mikuro Launcher Changelog Version change history of the Mikuro Launcher (including MIKURO Game Enhancement). 2026-07-17 Upcoming On the way: the Qinglian Lingshi system, WASD movement, the MIKURO Afdian server, and a fix for the mercenary shield breaking.

◆ ◆ ◆

Ⅲ

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-24 TL2 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.) 2026-06-20 TL2 EditorGuts RE — MOD Packing & Reading Internals Reversing .MOD packing & reading internals from EditorGuts.dll exports. (Superseded 2026-07-25 by 'TL2 .MOD Packing, Fully Analyzed' — several conclusions here have since been overturned; see the notice at the top.) 2023-11-28 Torchlight 2 MOD Development Test Log Hands-on test records and pitfall notes from the MOD development process. 2023-08-30 TL2 MPP Research Why cleaning up .MPP files breaks dungeon walkability — repro steps and findings. (2026-07-25: the black-box model below is correct; the mechanism behind it is now reversed — see the notice at the top.)

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.9 windows 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 Enhancement runtime-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.”

■ Released github.com/heiybb/TL2-Mikuro

Challenger Continent · Equipment Gallery

Rare · Online Equipment Gallery · Data Browser

7000+ items and socketables from 9 component mods, each tagged with its source
Innate effects / fixed affixes / set bonuses, rendered from the in-game text
Socketables (gems / skulls / embers) list effects per target: weapon / armor / trinket
Online 3D model preview, filter by rarity / type / source mod

“Every legendary, laid out under the lamp.”

■ Live web · opens right in the browser

Vanilla + Challenger Continent · Monster Bestiary

Rare · Online Monster Bestiary · Data Browser

800+ vanilla and 2300+ Challenger Continent entries, color-coded by rank: boss / champion / regular / pet & summon
HP / damage / armor / elemental armor shown with true engine semantics: level-curve multipliers (×1.0 = baseline)
Both vanilla and Challenger level curves built in — drag the level slider to compute real HP / damage / XP per difficulty
Monster skill lists (incl. AI triggers), innate traits and boss control-resist affixes, rendered from in-game text
Online 3D model preview, filter by source / rank / family; same-name random variants auto-collapsed

“Every pair of eyes that lights up in the dark, kept on record.”

■ Live web · opens right in the browser

Challenger Continent · Transmutation Recipe Codex

Rare · Online Recipe Codex · Data Browser

455 recipes extracted straight from the mod DAT files, with item icons and rarity colors
Random results expanded via the engine's weighted roll algorithm: 137 random recipes with per-item probabilities
Gamble recipes that can yield nothing (e.g. legendary → shards) show the empty-handed chance
Hidden recipes and ?-result recipes are all included and labeled
Filter by group / source component; search by recipe, ingredient or result name

“Luck goes into the crucible; probability goes into the ledger.”

■ Live web · runs in your browser (UI in Chinese)

.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.”

■ Live web · chrome / edge / firefox