Quests Lang Splitter: Split FTB Quests Lang Files for Git

Quests Lang Splitter: cleaner FTB Quests lang files for packs and servers

If you maintain a Minecraft modpack with FTB Quests, you already know how fast quest text can sprawl across a single locale file. One giant en_us.snbt (or other locale) is hard to review in Git, painful for translators, and easy to break with a bad merge. Quests Lang Splitter is a small utility mod that reshapes how those lang files live on disk so your blocks of quest copy behave more like real source code.

What this mod changes under the hood

Instead of one monolithic lang file per language, the mod can split strings into a folder layout grouped by category. For quests, tasks, and quest links, entries are organized by chapter, which mirrors how players experience your pack in biomes, progression gates, and reward pacing.

• Chapter-specific snippets live under a chapters folder, one file per chapter.
• Chapter titles, chapter group names, the quest book title, and reward table names each get their own focused file.
• The original top-level locale file still exists as the merged result: it updates from the split pieces when quests load or reload.

That workflow is a big win for version control: diffs become readable, conflicts shrink, and you can assign whole chapter files to different contributors without stepping on each other’s mechanics text.

Commands you will actually use

The mod ships a few slash commands aimed at pack authors and localization teams. Think of them as crafting recipes for your quest strings: you run the right command, and the filesystem rearranges itself into the shape you want.

• split — /langsplitter split <replace_unmerged> [<locale>]. Splits lang files by category and chapter. If you omit the locale, every available language is processed. The replace_unmerged boolean matters: keep it false unless you intentionally want to overwrite split files that were not merged back yet.
• fill_missing_translation — /langsplitter fill_missing_translation <replace_unmerged> <locale>. Fills missing entries using en_us as a base, then runs the split. Check your debug log for a clear list of what was added.
• purge_merged — /langsplitter purge_merged. After a load or reload, split files merge into the original locale file and the on-disk splits are renamed to .snbt_merged. This command tidies those renamed files if you do not want them cluttering the folder.

Pack makers who juggle dozens of mods often appreciate tooling that stays out of the way until you need it. If you are assembling a custom profile, you can grab community mods from your usual sources and keep the workflow lightweight; some players also like having a launcher that treats mod discovery as part of the daily routine, and this mod can be easily installed via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, which pairs nicely with iterative quest rewrites between updates.

Folder layout at a glance

After splitting, a typical English tree looks like nested SNBT under lang/en_us/: a chapters directory with per-chapter files containing quest, task, and quest link ids, plus sibling files for chapter names, chapter group names, the quest book filename, and reward table names. The root en_us.snbt remains the canonical merged output when the game reads everything back in.

Git, translators, and maintainers

For repositories, add ignores so generated noise does not drown real contributions. Ignore the original lang SNBT files under config/ftbquests/quests/lang/*.snbt, recovery backups under config/ftbquests/quests/lang/recovery/*.snbt, and merged remnants with config/ftbquests/quests/lang/**/*.snbt_merged. That keeps pulls focused on the split structure you actually want to review.

Translators can start from fill_missing_translation to materialize complete files, translate what is needed, then run /ftbquests reload to merge. After reload, files become .snbt_merged; for more edits, either split again or edit the merged file, rename it back to .snbt, reload to merge fresh changes, and when everything is ready, split once more before opening a pull request. Run purge_merged if stray merged copies linger, though a solid .gitignore usually handles it.

Maintainers should adopt the ignore rules, generate the starting split with the split command, commit the folder layout, then remove the old per-locale monoliths from version control because those originals are regenerated at runtime from the split sources. From that point on, accept contributions only through the split file tree so updates stay predictable across Minecraft versions.

Recovery backups when strings collide

When merges replace an existing translation — for example, you retranslate a subtitle — the mod can stash the previous value under config/ftbquests/quests/lang/recovery. Expect timestamped files such as en_us_1755120819.snbt containing paths, ids, and new versus old text. That safety net is quieter than losing strings silently during a server reload.

Installation and licensing

Grab the build from CurseForge and drop it into the mods folder of your pack or server instance alongside FTB Quests. The project uses the MIT License, so downstream pack authors can reason about reuse without friction.

Conclusion

Quests Lang Splitter does not add new biomes or flashy blocks; it hardens the authoring pipeline around one of the most text-heavy parts of modern modded Minecraft. By splitting lang data into chapter-scoped SNBT, adding practical commands, and guarding merges with recovery files, it turns sprawling quest books into something you can ship, translate, and update with the same discipline you apply to code. For any team serious about quest-driven progression across updates and multiplayer servers, that is the kind of invisible mechanic that saves weeks of merge pain.

--- **Update Aug 27, 2026:** Added 2 files for version 1.21.1 (NeoForge).