🛡️ WGLocale
WGLocale is a modern multilingual localization and help layer for WorldGuard.
It replaces common WorldGuard denial messages with clean, configurable Adventure/MiniMessage output, supports per-player languages, and modernizes the old /wg and /rg help experience — without modifying WorldGuard internals or replacing its actual commands.
🌍 Multilingual WorldGuard
WGLocale can automatically use each player's Minecraft client language, allowing different players on the same server to receive WorldGuard messages in their own language.
Built-in languages:
- 🇬🇧 English
- 🇷🇺 Russian
- 🇰🇿 Kazakh
- 🇺🇦 Ukrainian
- 🇩🇪 German
- 🇫🇷 French
- 🇪🇸 Spanish
Custom language files can also be added by server administrators.
English is always available as the final built-in fallback. If a selected language or translation key is unavailable, WGLocale safely falls back instead of breaking message output.
✨ Features
- Localized WorldGuard protection messages
- Block, entity, container, vehicle, PvP and interaction denials
- Region entry and exit messages
- Mount and dismount protection messages
- Adventure + MiniMessage formatting
- Chat or Action Bar output
- Per-player language detection
- Server-wide language mode
- Configurable fallback language
- Custom locale files
- Localized configuration comments
- Modern
/wgand/rghelp interface - Player, region, flag and administrator guides
- Permission-aware help sections
- Localized WGLocale commands and tab completion
- Preservation of custom WorldGuard deny messages
- Folia-aware runtime design
💬 Modern WorldGuard Help
WorldGuard is powerful, but its default command help can be difficult to read.
WGLocale provides a cleaner, localized interface for:
/wg
/worldguard
/wg help
/rg
/region
/rg help
The help interface is separated into useful sections such as Player, Regions, Flags, and Administration.
Sections and administrative commands are shown according to the player's permissions.
WGLocale only replaces the help presentation. Actual WorldGuard commands are still executed and permission-checked by WorldGuard itself.
Commands such as /wg reload, /rg define, /rg flag, /rg remove, and other WorldGuard functionality remain untouched.
🧭 Player Utilities
WGLocale also provides several lightweight utilities around WorldGuard.
| Command | Description |
|---|---|
/wgl help |
Open the WGLocale help menu |
/wgl language |
Show your currently resolved language |
/wgl language list |
Show available languages |
/wgl guide |
Open the WorldGuard guide |
/wgl guide player |
Commands useful to regular players |
/wgl guide regions |
Region creation and management |
/wgl guide flags |
Region flags and examples |
/wgl worldguard |
Open the modern WorldGuard help |
/wgl here |
Show the WorldGuard regions at your current location |
Aliases for the main command:
/wglocale · /wglang
English subcommand names always remain available even when another language is selected.
⚙️ Administration
| Command | Description |
|---|---|
/wgl reload |
Reload WGLocale configuration and languages |
/wgl status |
Show WGLocale, WorldGuard, language and runtime information |
/wgl language set <code> |
Change the server language |
/wgl language mode <server|player> |
Change language resolution mode |
/wgl preview <action> |
Preview a translated protection message |
🔐 Permissions
WGLocale deliberately keeps its own permission system small.
| Permission | Default | Description |
|---|---|---|
wglocale.use |
Everyone | Access player commands, language information and guides |
wglocale.admin |
OP | Access WGLocale administration commands |
WorldGuard commands continue to use WorldGuard's own permissions.
WGLocale does not grant, bypass or emulate WorldGuard administrative access.
🎨 Message Formatting
Messages use Adventure + MiniMessage, making it possible to configure modern formatting such as:
- gradients
- hover text
- clickable elements
- custom prefixes
- Action Bar output
- chat output
Server owners can change the visual style without editing the plugin source.
🔄 Language Resolution
WGLocale supports two language modes.
Player mode automatically detects the Minecraft client locale of each player.
For example, the same server can simultaneously display Russian messages to one player, Kazakh messages to another, and English messages to another.
Server mode uses one configured language for everyone.
Missing translations fall back through the configured fallback locale and finally to English.
🧩 Custom Languages
Language files are stored in:
plugins/WGLocale/languages/
Server owners can modify existing translations or add their own locale files.
When WGLocale is updated, existing customized language files are not blindly overwritten. New built-in translation keys can be supplied at runtime while preserving administrator changes.
🚀 Requirements
- Minecraft 26.2+
- Java 25+
- WorldGuard 7.0.18+
- Compatible WorldEdit
- Paper-compatible server software
Primary targets:
Leaf · Folia · Paper · Purpur
Spigot is not an officially supported target.
🧱 Safe by Design
WGLocale does not use Java Agents, ByteBuddy instrumentation or runtime bytecode modification.
WorldGuard remains responsible for region protection, command execution and permission enforcement.
WGLocale focuses on localization, presentation and usability.
📦 Source Code
WGLocale is developed publicly on GitHub.
Source code is available for review, configuration, translations and contributions under the WGLocale Software License.
👤 Author
Onelsey
No gallery available for this project.