🧩 Konfigurace

Veškerá konfigurace Voidium je v config/voidium/ (server). Většinu věcí je nejlepší upravovat při vypnutém serveru.

Některé soubory se ukládají jako JSON s komentáři (řádky začínající //). To znamená, že to nemusí být „strict JSON“ pro všechny externí nástroje — editujte to jako obyčejný text.

Rychlá navigace

📁Struktura složek

Co se vytvoří při prvním startu

🧰general.json

Hlavní přepínače modulů

🧩Konfigurace modulů

Discord/Web/Stats/…

🗄️storage/

Persistentní data + migrace

🔄Reload

Kdy restart vs reload

📁 Struktura složek

Po prvním startu dedikovaného serveru by mělo existovat:

config/voidium/
	general.json
	discord.json
	web.json
	stats.json
	ranks.json
	tickets.json
	votes.json
	playerlist.json
	entitycleaner.json
	restart.json
	announcements.json
	storage/

🧰 general.json (hlavní přepínače)

Soubor: config/voidium/general.json

Nejdůležitější klíče:

enableMod — globální zap/vyp
enableDiscord, enableWeb, enableStats, enableRanks, enableVote
enableRestarts, enableAnnouncements, enablePlayerList
enableSkinRestorer + skinCacheHours

Discord má dva přepínače: general.json → enableDiscord a zároveň discord.json → enableDiscord.

🧩 Konfigurace modulů

discord.json

Token bota, guild id, kanály, chat bridge

web.json

Port, jazyk, public hostname

stats.json

Denní reporty: kanál + čas

NuVotifier listener + odměny

playerlist.json

TAB header/footer + jména

entitycleaner.json

Cleanup plán + whitelisty

restart.json

Fixed / interval / delay restarty

announcements.json

Broadcasty + interval

🤖 discord.json

Soubor: config/voidium/discord.json

Důležité klíče:

enableDiscord
botToken, guildId
ID kanálů: chatChannelId, consoleChannelId, linkChannelId, statusChannelId
Chat bridge: enableChatBridge, formáty, translateEmojis
Webhook chat: chatWebhookUrl

botToken nikdy nesdílejte. Když unikne, okamžitě ho v Developer Portalu otočte.

🌐 web.json

Soubor: config/voidium/web.json

port (default: 8081)
language (en / cz)
publicHostname (použije se pro odkaz, který vám Voidium vypíše)

Odkaz na web panel získáte:

/voidium web

📊 stats.json

Soubor: config/voidium/stats.json

enableStats
reportChannelId
reportTime (HH:mm)
Texty reportu: title/labels/footer

🏅 ranks.json

Soubor: config/voidium/ranks.json

enableAutoRanks
checkIntervalMinutes
ranks list: PREFIX/SUFFIX definice s hours

🎫 tickets.json

Soubor: config/voidium/tickets.json

enableTickets
ticketCategoryId, supportRoleId
Transcript: enableTranscript, transcriptFormat, transcriptFilename

🗳️ votes.json

Soubor: config/voidium/votes.json

enabled, host, port
Klíče: rsaPrivateKeyPath, rsaPublicKeyPath
Odměny: commands (používá %PLAYER%)
Logging + offline queue se ukládají do storage/

📋 playerlist.json

Soubor: config/voidium/playerlist.json

enableCustomPlayerList
Header/footer řádky + placeholdery typu %online%, %max%, %tps%, %ping%
Custom jména: enableCustomNames, playerNameFormat

🧹 entitycleaner.json

Soubor: config/voidium/entitycleaner.json

enabled, cleanupIntervalSeconds, warningTimes
Co mazat: itemy, moby, XP, šípy
Ochrany + whitelisty itemů/entit

🔁 restart.json

Soubor: config/voidium/restart.json

restartType: FIXED_TIME / INTERVAL / DELAY
Fixed list: fixedRestartTimes
Interval: intervalHours
Delay: delayMinutes

📣 announcements.json

Soubor: config/voidium/announcements.json

announcements list
announcementIntervalMinutes (0 vypne automatické broadcasty)
prefix

🗄️ storage/ (persistentní data)

Složka: config/voidium/storage/

Tady jsou runtime data, např.:

links.json
pending-votes.json
votes.log, votes-history.ndjson
voidium_stats_data.json, voidium_ranks_data.json
player_progress.json
skin-cache.json
last_restart.txt

Při startu Voidium případně přesune starší soubory z config/voidium/ do storage/ automaticky.

🔄 Reload konfigurace

Pro první setup a větší změny (token bota, porty) je lepší restart.
Na rychlé úpravy můžete použít:

/voidium reload