🧰 Installation

✅ Requirements

Server

• A NeoForge dedicated server
• Java 21+ (recommended)
• A standard server folder with a mods/ directory

Client (optional)

• NeoForge client matching your game version
• Java 21+

🖥️ Server installation

1) Download

• Download the latest release jar from:
  • https://github.com/venom74cz/voidium/releases

2) Put it into mods/

Place the jar directly into your server’s mods/ directory.

# Linux/macOS
cd /path/to/your/server
mkdir -p mods
cp voidium-*.jar mods/

3) Start the server once

On the first boot, Voidium creates its config directory and default config files.

Expected folder after first start:

config/voidium/

💻 Client installation (optional)

If you want the client UI features (modern chat, emoji rendering, chat history), install the same jar on the client too:

1. Install NeoForge for your client profile
2. Put voidium-*.jar into:
   • Linux: ~/.minecraft/mods/
   • Windows: %APPDATA%\.minecraft\mods\
3. Start the game with NeoForge

⚙️ First run: what gets generated

After the first server start, Voidium creates:

• config/voidium/general.json (master switches for modules like Discord/Web/Stats/etc.)
• Module configs (examples): discord.json, web.json, stats.json, ranks.json, …
• config/voidium/storage/ for persistent data (links, vote queues, cached skins, history files)

Voidium also auto-migrates older storage files (if present) into config/voidium/storage/ on startup.

🔁 Updating

Recommended safe update process:

1. Stop the server
2. Backup config/voidium/
3. Replace the old jar in mods/ with the new one
4. Start the server

Your configuration and persistent data stay in config/voidium/. If an internal storage layout changes, Voidium migrates files automatically into config/voidium/storage/.

🧯 Troubleshooting

Voidium doesn’t load

• Verify you’re using NeoForge (not Forge/Fabric)
• Verify Java 21+: run java -version
• Ensure the jar is directly inside mods/ (not in a subfolder)

Config folder not created

• Make sure you started a dedicated server
• Check server logs for VOIDIUM - INTELLIGENT SERVER CONTROL is loading...

Next steps

• Quick Start
• Configuration
• Discord Setup