P.E.L.E - Plugin for Enhanced Language Extension

P.E.L.E expands Risk of Rain 2 language support beyond the game's built-in language list. It adds native support for Ukrainian, Esperanto, and Latin while remaining compatible with mods that already depend on R2API.Language.

It was created because custom community languages need more than translated text files: they need menu entries, font support, reliable token loading, and a way to keep many mod translations working as one coherent language pack.

What P.E.L.E Adds

• Native custom language support for Ukrainian (uk), Esperanto (eo), and Latin (la).
• P.E.L.E JSON translation packs for the base game and supported mods.
• Priority loading for P.E.L.E translations when another pack has the same token.
• Main-menu and pause-menu language selection.
• Keyboard, mouse, and controller hints in the language menu.
• F5 hot reload for P.E.L.E JSON files and normal .language files.
• Built-in Ukrainian/Cyrillic font support.
• Startup checks for missing folders, missing font data, and duplicate language DLLs.

Optional KingModUtilities integration

P.E.L.E includes a separate PELE.KingDBZFix.dll compatibility plugin for the Goku, Vegeta and Trunks translation packs. It localizes their KingModUtilities transformation menus and tutorials, including Kaioken and Light Charge, in the 15 supported languages. The plugin activates when KingModUtilities is installed; the P.E.L.E language system works without these characters or the utility.

The character translation packs require P.E.L.E 1.0.3. Install P.E.L.E first, then the relevant character mod and its translation pack. P.E.L.E itself does not install the character mods or KingModUtilities; the original character mods provide their own dependencies. Text and compatibility may vary with mod updates.

Translation status

The included translations are a work in progress. Coverage and linguistic review vary between languages, game content, and mods; untranslated strings may fall back to the original text. This release does not include DLC4 translations.

Screenshots

Main menu language selector:

Pause-menu language dialog:

Character select in Esperanto:

Character select in Ukrainian:

Why These Languages?

Ukrainian is the main practical target because it needs clean custom-language registration and Cyrillic font support. Esperanto and Latin are the first experimental custom languages shipped with P.E.L.E, useful for testing the loader, menus, and mod translation support outside the official language list.

This package includes every P.E.L.E translation file currently shipped in the repository, even for mods you do not have installed. Risk of Rain 2 only uses a token when matching game or mod content asks for it.

Important

P.E.L.E replaces the R2API.Language.dll provided by RiskofThunder-R2API_Language. It keeps the same BepInEx plugin GUID so mods that depend on R2API.Language continue to work normally.

Some mods also install the upstream RiskofThunder-R2API_Language as a dependency. BepInEx selects the higher-version P.E.L.E fork with the same plugin GUID; keep both packages managed by the mod manager. Do not manually add extra copies of the fork. Compatibility with all mods and future versions is not guaranteed.

Dependencies

Thunderstore installs these automatically:

bbepis-BepInExPack-5.4.2121
RiskofThunder-HookGenPatcher-1.2.9
RiskofThunder-R2API_Core-5.3.0

RiskofThunder-R2API_Language is not listed as a dependency because P.E.L.E provides the replacement R2API.Language.dll itself.

Translation Priority

When P.E.L.E provides a token, it wins over other language packs. If P.E.L.E does not provide that token, the normal game/mod language fallback is used.

Included Three-Language Mod Support

The mods below have P.E.L.E translation packs for all three custom languages in this release: Ukrainian, Esperanto, and Latin.

"Complete P.E.L.E support" here means this package includes matching P.E.L.E JSON files for uk, eo, and la for that mod. It does not mean the original mod author officially ships those languages.

This list was checked against the P.E.L.E language files in this GitHub repository, not against the mods currently installed in a local r2modman profile.

All mods listed below include P.E.L.E JSON support for:

Ukrainian (uk) | Esperanto (eo) | Latin (la)

More Jaosnake Translations

P.E.L.E is designed to work alongside my existing Risk of Rain 2 translation packs. Those packs remain fully supported and are still recommended for the other languages they already cover.

Jaosnake packages on Thunderstore

Documentation

More technical details are available here:

• Installation and compatibility
• Manual installation
• Configuration
• Translation file layout
• Technical hook notes
• Manual test checklist

Questions and Support

For questions, suggestions, bug reports, or translation feedback, please open an issue on GitHub:

Jaosnake/ror2-multi-language-pack

Support

Changelog

1.0.4 - Documentation update

• Add Goku, Vegeta and Trunks to the list of included three-language mod support.
• Link directly to the three character translation packs in the KingModUtilities integration section.

1.0.3 - Loader and optional mod integration

• Repair the separate KingModUtilities integration, including translated tutorials, colored highlights and transformation menu labels.

• Recognize P.E.L.E language files and the Cyrillic font in mod-manager installations as well as the direct folder layout.

• Resolve Ukrainian UA and uk language codes as aliases while preserving exact-code priority.

• Include an optional KingModUtilities integration for Goku, Vegeta, and Trunks, plus associated three-language files.

• Update included translation files and document current coverage limitations.

1.0.2 - README cleanup

• TOO MUCH STUFF IN README LOL GO TO WIKI.

1.0.1 - Package metadata update

• Updates the Thunderstore package description to clearly mention native Ukrainian, Esperanto, and Latin support.
• Keeps the internal BepInEx plugin version at 2.0.0 so P.E.L.E continues replacing RiskofThunder-R2API_Language safely.

1.0.0 - P.E.L.E initial release

• Ships as a replacement for RiskofThunder-R2API_Language's R2API.Language.dll, not as a second side-by-side plugin.
• Uses internal BepInEx plugin version 2.0.0 so the fork wins over upstream R2API.Language 1.1.0 during manual side-by-side r2modman tests.
• Adds P.E.L.E JSON language loading from BepInEx/plugins/PELE/Language/<lang>/*.json.
• Gives P.E.L.E translations priority over normal mod/game language fallbacks when a token exists in P.E.L.E.
• Adds custom language support for Latin (la), Esperanto (eo), and Ukrainian (uk).
• Adds native Cyrillic font support for Ukrainian without requiring AnotherOneCyrillicFont.
• Adds a pause-menu Language button with controller/keyboard hints.
• Adds F5 hot reload for .language and P.E.L.E JSON files.
• Adds startup sanity checks for P.E.L.E folders, icons, language manifests, font bundle, and duplicate DLLs.
• Keeps the F6 debug window available behind EnableDebugMenu=false by default for release builds.
• Keeps verbose hook/layout logs behind EnableVerboseLogging=false by default.