Voidium Docs

🌍 Lokalizace

Voidium podporuje anglické a české locale presety. Každá uživatelská zpráva se dá upravit v příslušném config souboru a jedním kliknutím lze přepnout všechny zprávy najednou.

Locale presety mění hodnoty konfiguračních polí (zprávy, popisky, prefixy). Neovlivňují kód modu ani příkazy — příkazy jsou vždy v angličtině.

Rychlá navigace

⚙️Jak to funguje
Locale presety, zprávy per-modul
🔄Aplikování locale
Web panel, příkazy, config
📝Placeholdery
Dynamické hodnoty ve zprávách
✏️Vlastní zprávy
Přepis jednotlivých zpráv

⚙️ Jak to funguje

Voidium nepoužívá separátní jazykový soubor. Místo toho je každá zpráva konfiguračním polem v příslušném config souboru (např. discord.json, restart.json, tickets.json).

Třída LocalePresets poskytuje kompletní sady přeložených hodnot pro každý modul:

Modul Config soubor Přeložená pole
General general.json modPrefix
Discord discord.json 20+ polí: kick zprávy, link zprávy, odpovědi bota, stavové zprávy
Announcements announcements.json prefix, announcements[]
Ranks ranks.json promotionMessage
Votes vote.json announcementMessage
Tickets tickets.json 11 polí: ticket created/welcome/close zprávy, MC zprávy
Restart restart.json warningMessage, restartingNowMessage, kickMessage
Entity Cleaner entitycleaner.json warningMessage, cleanupMessage
Stats stats.json reportTitle, reportPeakLabel, reportAverageLabel, reportFooter
Player List playerlist.json headerLine1–3, footerLine1–3

Podporované locales

Kód Jazyk
en Angličtina (výchozí)
cz Čeština

🔄 Aplikování locale

Přes Web Panel (doporučeno)

  1. Otevřete Config Studio ve web panelu
  2. Použijte dropdown Locale Preset (nebo zavolejte /api/config/locale)
  3. Vyberte en nebo cz
  4. Všechny zprávy všech modulů budou aktualizovány a uloženy okamžitě

Přes příkaz ve hře

/voidium locale <en|cz>

Tento příkaz zavolá applyLocale() na každou config třídu, přepíše všechna pole se zprávami a uloží každý config soubor.

Ručně

Upravte jednotlivé config soubory v config/voidium/ a změňte konkrétní pole se zprávami. Máte tak plnou kontrolu — můžete míchat jazyky nebo psát úplně vlastní zprávy.

Důležité: Aplikování locale presetu přepíše jakékoli vlastní úpravy zpráv. Pokud jste zprávy přizpůsobili, zálohujte je před aplikací presetu.

📝 Placeholdery

Zprávy podporují dynamické placeholdery pomocí syntaxe %název%. Každé pole zprávy má svou sadu dostupných placeholderů:

Běžné placeholdery

Placeholder Dostupný v Hodnota
%player% Discord, Ranks, Votes Jméno Minecraft hráče
%user% Discord chat bridge Uživatelské jméno na Discordu
%message% Chat bridge Text chatové zprávy
%code% Discord whitelist 6místný kód pro propojení
%max% Discord linking Max účtů na Discord uživatele
%online% Téma kanálu Počet online hráčů
%uptime% Téma kanálu Uptime serveru
%days%, %hours%, %minutes% Formát uptime Složky uptime
%rank% Ranks Název ranku
%time% Restart varování Čas do restartu
%count% Entity Cleaner Počet odstraněných entit
%voter% Votes Jméno hráče který hlasoval

Placeholdery se nahrazují za běhu pomocí String.replace(). Pokud placeholder není nahrazen, zobrazí se tak jak je — to pomáhá odhalit překlepy.

✏️ Vlastní zprávy

Jakoukoliv zprávu můžete upravit přímou editací config pole:

Příklad: Vlastní restart varování

V restart.json:

{
  "warningMessage": "&c&l⚠ RESTART SERVERU za %time%! Uložte si stavby!",
  "restartingNowMessage": "&4Server se restartuje NYNÍ!",
  "kickMessage": "Server se restartuje. Připojte se prosím za chvilku."
}

Příklad: Vlastní Discord úspěšné propojení

V discord.json:

{
  "linkSuccessMessage": "✅ Úspěšně propojeno s **%player%**! Vítej na palubě."
}

Barevné kódy

Všechny herní zprávy podporují & barevné kódy:

Kód Výsledek Kód Výsledek
&0–&9 Barvy (černá–modrá) &l Tučné
&a–&f Barvy (zelená–bílá) &o Kurzíva
    &n Podtržení
    &r Reset

Jazyk Web Panelu

Jazyk UI web panelu se ovládá samostatně přes web.json:

{
  "language": "cz"
}

Nastavte na "cz" pro české popisky v Config Studiu a dashboardu.

Související stránky