🧩 Configuration

All Voidium configuration lives in config/voidium/ (server side). Most settings are safe to edit while the server is stopped.

Some config files are written as JSON with comments (lines starting with //). That means they are not strict JSON for every external tool — edit them as plain text.

📁 Folder structure

After the first dedicated server start, you should have:

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 (master switches)

File: config/voidium/general.json

Key toggles:

enableMod — global on/off
enableDiscord, enableWeb, enableStats, enableRanks, enableVote
enableRestarts, enableAnnouncements, enablePlayerList
enableSkinRestorer + skinCacheHours

Discord has two toggles: general.json → enableDiscord AND discord.json → enableDiscord.

🧩 Module configs

discord.json

Bot token, guild id, channels, chat bridge

web.json

Port, language, public hostname

stats.json

Daily report channel + time

ranks.json

Playtime-based ranks

tickets.json

Discord tickets + transcript

votes.json

NuVotifier listener + rewards

playerlist.json

TAB header/footer + names

entitycleaner.json

Cleanup schedule + whitelists

restart.json

Fixed / interval / delay restarts

announcements.json

Broadcast messages + interval

🤖 discord.json

File: config/voidium/discord.json

Important keys:

enableDiscord
botToken, guildId
Channel IDs: chatChannelId, consoleChannelId, linkChannelId, statusChannelId
Chat bridge: enableChatBridge, formats, translateEmojis
Webhook chat: chatWebhookUrl

Keep botToken secret. If it leaks, rotate it in Discord Developer Portal.

🌐 web.json

File: config/voidium/web.json

port (default: 8081)
language (en / cz)
publicHostname (used for the link shown to you)

To get your access link:

/voidium web

📊 stats.json

File: config/voidium/stats.json

enableStats
reportChannelId
reportTime (HH:mm)
Custom report strings: title/labels/footer

🏅 ranks.json

File: config/voidium/ranks.json

enableAutoRanks
checkIntervalMinutes
ranks list: PREFIX/SUFFIX definitions with hours

🎫 tickets.json

File: config/voidium/tickets.json

enableTickets
ticketCategoryId, supportRoleId
Transcript: enableTranscript, transcriptFormat, transcriptFilename

🗳️ votes.json

File: config/voidium/votes.json

enabled, host, port
Keys: rsaPrivateKeyPath, rsaPublicKeyPath
Rewards: commands list (uses %PLAYER%)
Logging + offline queue are stored in storage/

📋 playerlist.json

File: config/voidium/playerlist.json

enableCustomPlayerList
Header/footer lines + placeholders like %online%, %max%, %tps%, %ping%
Custom names: enableCustomNames, playerNameFormat

🧹 entitycleaner.json

File: config/voidium/entitycleaner.json

enabled, cleanupIntervalSeconds, warningTimes
Removal toggles: dropped items, mobs, XP, arrows
Protection toggles + item/entity whitelists

🔁 restart.json

File: config/voidium/restart.json

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

📣 announcements.json

File: config/voidium/announcements.json

announcements list
announcementIntervalMinutes (0 disables auto announcements)
prefix

🗄️ storage/ (persistent data)

Folder: config/voidium/storage/

This folder stores persistent runtime data, for example:

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

On startup, Voidium migrates older files from config/voidium/ into storage/ automatically (if needed).

🔄 Reloading config

Prefer restart for first-time setup and bigger changes (Discord bot token, ports).
For quick tweaks you can use:

/voidium reload