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.

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.

Do not install another copy of R2API.Language.dll side by side. Duplicate language DLLs can cause duplicate hooks, wrong load order, or missing language tokens.

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.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.