Prerequisites

Before installing Voxy, make sure you have everything on this page ready.

MongoDB

Voxy uses MongoDB as its primary database for storing all persistent data — ranks, player data, punishments, guilds, reports, and more.

Required on: Proxy and Spigot
Minimum version: MongoDB 4.4+
Both standalone and SRV (Atlas/cloud) connections are supported

If you don't have MongoDB, install it from mongodb.com or use a hosted service like MongoDB Atlas.

Redis

Voxy uses Redis for real-time cross-server communication — syncing ranks, filters, punishments, parties, and more between your proxy and backend servers.

Required on: Proxy (always), Spigot (when running behind a proxy)
Optional on: Standalone Spigot (not behind BungeeCord/Velocity) — Voxy will warn but continue
Minimum version: Redis 6+

If you don't have Redis, install it from redis.io or use a hosted service like Redis Cloud.

License Key

Voxy requires a valid license key. Without it, the plugin will refuse to start and shut down the server.

Keep your license key ready — you will paste it into settings.yml during setup.

One license key covers one network. Do not share your license key.

Java

Voxy requires your server to run on Java 21+

Some older versions (e.g. 1.8.8) may require you to set use-native-transport to false in your server.properties

Next Step

Continue to Proxy Setup to install and configure the proxy module.