AE2 Translations

AE2 Translations

A community resource pack that overrides the in-game translations of
Applied Energistics 2
for Minecraft 1.21.1.

Installation

1. Download the .zip from Files (do not unzip it).
2. Drop it into your .minecraft/resourcepacks/ folder.
3. In-game: Options → Resource Packs → enable it.
4. Set your in-game language (Options → Language) to the one you want to use.

It’s client-side: every player installs it on their own.

What’s included

• Interface translations — item, block, tooltip, and GUI text, under
  assets/ae2/lang/.
• The in-game guide — the AE2 Guide (powered by GuideMe), under
  assets/ae2/ae2guide/.

Both are per-language and fall back to English for anything not yet translated,
so partial translations are perfectly fine.

Contributing: interface text

The language files live in assets/ae2/lang/<locale>.json (e.g. de_de.json,
fr_fr.json, pt_br.json).

1. Fork the GitHub repo and edit or add your locale’s file.
2. assets/ae2/lang/en_us.json is the source of truth for keys and order.
3. Preserve the %s, %d, %1$d, %% placeholders exactly — you may only
   reorder them to match your language’s grammar.
4. Run the ordering script (see below) so your file matches the layout of the
   others.
5. Open a Pull Request.

Contributing: the in-game guide

The AE2 Guide is written in Markdown and lives at assets/ae2/ae2guide/. In the
mod’s own source it sits in a top-level guidebook/ folder, but in the built jar
(and here) it is mounted at assets/ae2/ae2guide/.

Where translated pages go

Each language goes in a _<locale> subfolder that mirrors the English page
tree:

assets/ae2/ae2guide/getting-started.md              <- English (base)
assets/ae2/ae2guide/ae2-mechanics/channels.md
assets/ae2/ae2guide/_es_es/getting-started.md       <- Spanish (Spain)
assets/ae2/ae2guide/_es_es/ae2-mechanics/channels.md
assets/ae2/ae2guide/_de_de/getting-started.md       <- German
...

GuideMe picks the folder matching the player’s language and falls back to the
English page when a translated one is missing, so you can translate pages
gradually.

What to translate inside a page

Guide pages are Markdown with YAML frontmatter and special components. Translate
only the human-readable text:

• Do translate: body prose, the frontmatter title, and the visible text
  of links [visible text](path.md).
• Do NOT touch: component tags (<ItemLink>, <GameScene>,
  <ImportStructure>, etc.) and their attributes (id=, src=, coordinates,
  colors), file paths and anchors inside links, and the frontmatter parent and
  icon values.

Do NOT copy the shared assets

Do not copy the assets/ subfolder (the .snbt scene structures and .png
images) into your _<locale> folder. Those files have no text, are shared by all
languages, and are resolved from the base guide. Only the .md files are
translated.

Licensing

This project is released under CC0 1.0 (public domain), matching how AE2
itself licenses its text and translations. The imported base translations come
from AE2’s community contributors and are likewise CC0.

Do not add copyrighted assets (e.g., AE2’s own textures, models, or logo — those
are CC BY-NC-SA); anything you contribute should be your own work or CC0.