ModsFinder

LocalizedBook

by marlester-dev

LocalizedBook lets modpack developers and content creators translate the hardcoded landing text, subtitle and name values in Patchouli books.

FabricForgeClient-side onlyMIT LicenseOpen source1.20.1

What it does

Patchouli books store a book's name, landing text and subtitle as fixed strings in book.json, and LocalizedBook replaces those strings through a configuration file. Each book is set up with its mod ID and book ID, followed by a custom name, landing text or subtitle, and any field left at its default keeps the original text. The settings live in the mainconfig.toml file under the config folder for localizedbook, and they are written in TOML format.

Changes take effect in the game after Minecraft is restarted, so a translator can edit the file, relaunch and check the result. The Botania Lexicon is a worked example: an entry for botania:lexicon can set its own guide name, welcome text and subtitle, with the untouched fields reverting to the stock Botania wording. The mod is client-side only, so it is installed in the mods folder of a single-player or multiplayer client and does not need to run on the server.

The mod requires Patchouli, which must be installed next to it on either Fabric or Forge, along with Fabric API on Fabric builds. Files are published for Fabric and Forge, both for 1.20.1, and the latest files date from 2024-10-25. The source code is public under the MIT License, so the mod is open source.

Key features

  1. Localized book names

    The name shown for a Patchouli book can be replaced with a translated string set per book ID.

  2. Localized landing text

    The landing text on a book's first page can be changed without editing the book's own files.

  3. Localized subtitles

    The subtitle line of a book can be replaced with a custom value.

  4. TOML configuration

    Entries are written in a TOML file in the config folder, and fields left at their defaults keep the original wording.

Compatibility

Latest build for each game version and loader.

1.20.11.0.01.0.0
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

PatchouliAccessible, Data-Driven, Dependency-Free Documentation for Minecraft Modders and Pack Makers
Required

Use cases

Multilingual modpacks

Pack makers who ship Patchouli books can supply translated names and text for each language without modifying the books themselves.

Customizing existing guides

A pack can rename or reword a book such as the Botania Lexicon while leaving other entries untouched.

Who it’s for: The mod suits modpack developers and content creators who want Patchouli books to read in other languages, and players who run such a pack on their own client.

Questions

Does LocalizedBook need Patchouli?

Yes. Patchouli is a required dependency and must be installed alongside LocalizedBook on Fabric or Forge.

Is LocalizedBook needed on a server?

No. Players add it to their own game, and a server needs no copy.

Do changes apply without restarting the game?

No. After the book entries in mainconfig.toml are changed, Minecraft must be restarted before the new text appears.

More from marlester-dev

All projects

What the author says

The LocalizedBook mod enhances your Minecraft experience by allowing the localization of hardcoded values such as 'name', 'landing_text', and 'subtitle' in Patchouli's book.json. This functionality is essential for modpack developers and content creators who wish to offer multilingual support for patchouli books from…
marlester-dev, on the Modrinth page

Official listing

Owner
marlester-dev
Published
2024-10-25
Updated on Modrinth
2024-10-25
Facts verified
2026-10-15