Skip to content

Spanish (es_mx) Localization: Complete Guidebook Overhaul and UI Consistency#5600

Open
GravisLudio wants to merge 10 commits intoSlimeKnights:1.20.1from
GravisLudio:1.20.1
Open

Spanish (es_mx) Localization: Complete Guidebook Overhaul and UI Consistency#5600
GravisLudio wants to merge 10 commits intoSlimeKnights:1.20.1from
GravisLudio:1.20.1

Conversation

@GravisLudio
Copy link

Summary
This PR provides a comprehensive Spanish (es_mx) translation for Tinkers' Construct. The main focus was a complete rewrite and formatting of all guidebooks, ensuring that all technical information is accurate and fits perfectly within the in-game UI margins.

Key Changes
Guidebooks: All 6 books (Materials and You, Punches and Patches, Mighty Smelting, Tensors and Toasts, Fantastic Foundry, and Encyclopedia) have been fully translated.

Localized Covers: Each book now features a localized cover image. To ensure compatibility, I created a /cover directory within each book's es_mx folder and updated appearance.json to point specifically to these paths. This prevents any interference with the default English covers.

UI Consistency: Updated the main es_mx.json file to match the terminology used in the books, ensuring a cohesive experience between the items and the manuals.

Formatting: Every page has been meticulously tested and adjusted to eliminate text overflow and "ghost spaces" between paragraphs.

Technical Details
Cover Paths: book/<book_name>/es_mx/cover/<cover_image_name>

Mod Version: Tested and verified for Minecraft 1.20.1.

Isolation: No changes were made to files outside the es_mx directories, ensuring 100% safety for other localizations.

GravisLudio and others added 10 commits January 22, 2026 10:01
I have updated the es_mx.json file to ensure full consistency with the newly translated guidebooks. Some item names and modifier descriptions were adjusted so that the terms used in the UI match exactly with the instructions and lore found in the books. This provides a much more cohesive experience for Spanish-speaking players.
Localization: Full guidebook update and custom covers for es_mx

Book Updates: All guidebooks have been fully translated and formatted for the es_mx locale.

Custom Assets: Created a new /cover directory within each book's es_mx folder to host localized cover images.

Pathing & Appearance: Modified the appearance.json for each book to point to the new localized path: book/bookname/es_mx/cover/booknamecover.

Isolation: This change ensures that localized covers are only loaded for Spanish players, leaving other languages (like English) completely unaffected.

Testing: Fully tested in-game to ensure images load correctly and text fits within the margins.
Encyclopedia (Part 1) - Core structure and Upgrades
feat(lang): Encyclopedia localization - es_mx (Part 1)

This is the first commit for the Encyclopedia guidebook localization. Due to the large number of files, this commit includes the core configuration and the complete upgrades section:

Core: Updated appearance.json (with localized cover path), index.json, and the main language file for the book.

Upgrades: Full translation of the /upgrades folder, including all individual modifier and ability files.

Formatting: All text has been adjusted to fit correctly within the book margins.
1. Materials and You (Materiales y Tú)
feat(lang): translate Materials and You guidebook (es_mx)

Fully translated all pages and adjusted text formatting for es_mx. Localized cover added to es_mx/cover/materials_and_you_cover. Updated appearance.json paths to ensure the localized cover is only displayed for the Spanish locale. Fully tested in-game.

2. Punches and Patches (Castas y Personalización)
feat(lang): translate Punches and Patches guidebook (es_mx)

Complete Spanish translation of the modifiers book. Added localized cover in es_mx/cover/punches_and_patches_cover. Modified appearance.json to point to the new localized path, isolating the change to the es_mx language folder.

3. Mighty Smelting (Fundición Poderosa)
feat(lang): translate Mighty Smelting guidebook (es_mx)

Translated all smelting and alloy mechanics into Spanish. The localized cover is now located at es_mx/cover/mighty_smelting_cover. Updated book appearance settings to use the localized cover specifically for the es_mx locale without affecting other languages.

4. Tensors and Toasts (Tensores y Brindis - Arcos)
feat(lang): translate Tensors and Toasts guidebook (es_mx)

Full localization for the ranged weaponry book. Includes localized cover image within es_mx/cover/tensors_and_toasts_cover. Adjusted appearance.json paths to link correctly to the localized asset while maintaining global language compatibility.

5. Fantastic Foundry (Fundición Fantástica)
feat(lang): translate Fantastic Foundry guidebook (es_mx)

Complete es_mx translation for high-tier metallurgy. Localized cover added to the es_mx/cover/ directory. Pathing in appearance.json updated to target the new localized cover file specifically for Spanish players. Tested for formatting and image loading.

6. Encyclopedia (Enciclopedia)
feat(lang): translate Encyclopedia guidebook (es_mx)

Full Spanish localization of the Encyclopedia. Localized cover image implemented at es_mx/cover/encyclopedia_cover. Updated appearance.json to ensure the localized cover path is unique to the es_mx folder, preventing any override of default language covers.
Se agrego el material redstone
@KnightMiner KnightMiner added 1.20 Issue affects 1.20 Translation Pull request or issues related to improving translations or the English text in game labels Jan 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

1.20 Issue affects 1.20 Translation Pull request or issues related to improving translations or the English text in game

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants