Back
Game Servers

Set up a whitelist

Restrict your Victus Minecraft server to approved players — enable the whitelist from the console and add players by name.

minecraftwhitelistallowlistprivatesecurityplayers

A whitelist (allowlist) locks your server so only players you approve can join. It is the simplest way to keep a private or friends-only server safe from random joins and griefers. You control it with console commands or by editing server.properties.

Enable and manage from the console

  1. 1Open the Console tab (server must be running).
  2. 2Turn it on: type whitelist on.
  3. 3Add a player: whitelist add <username>.
  4. 4Remove a player: whitelist remove <username>.
  5. 5List approved players: whitelist list. Apply changes with whitelist reload.
text
whitelist on
whitelist add Notch
whitelist add Steve
whitelist list

Or set it in server.properties

  1. 1Open the Files tab and edit server.properties.
  2. 2Set white-list=true (and optionally enforce-whitelist=true to kick non-listed players already online).
  3. 3Save and Restart.

Names vs. UUIDs

On online-mode servers the whitelist stores each player by their Mojang UUID, so a friend who changes their username stays whitelisted. Add players while the server is running so it can look up their account correctly.

Whitelist is not a ban list

The whitelist controls who may join; it does not remove ops or ban rule-breakers. Use ban <player> for bans and manage admins separately — see "Make yourself op/admin".

Related in Game Servers

Create your first Minecraft serverOrder a Minecraft server on Victus, choose your software (egg) and version, then start it in the panel and connect your client.Server will not start / "unexpected error"A checklist for when a Victus server refuses to start or the panel shows an unexpected error — read the console, check the EULA, ports, memory and the JAR.You must accept the EULAMinecraft refuses to run until you accept Mojang's EULA. Set eula=true in eula.txt via the Files tab, then restart."Port is already allocated" fixFix "Failed to bind" / "port is already allocated" on a Victus Minecraft server — align server.properties with your panel allocation and clear stale processes.Out of memory / server keeps crashingDiagnose OutOfMemoryError and repeated crashes on a Victus Minecraft server — right-size RAM, cut memory-hungry settings, and find the plugin/mod at fault.Low TPS and lag (how to fix)Fix lag and low TPS on a Victus Minecraft server — measure TPS, tune view/simulation distance, control entities, and switch to Paper/Purpur.Install pluginsAdd Bukkit/Spigot/Paper plugins to a Victus server — upload the .jar to the plugins folder via the Files tab or SFTP and restart.Install mods (Forge/Fabric)Run Forge or Fabric mods on a Victus server — put mods in the mods folder, match the loader/version, and install the same mods on your client.Change the Minecraft versionChange the Minecraft version of a Victus server from the Startup tab, back up first, and update your plugins/mods to match.Switch software/JAR (Paper/Purpur/Spigot/Vanilla)Change your Victus server between Paper, Purpur, Spigot, Vanilla, Fabric, Forge or Velocity — via the Startup variables or an egg change, backing up first.Upload files via SFTPConnect to your Victus server with an SFTP client to upload worlds, plugins and modpacks fast — using the host, port and username from the panel.Change the MOTD and server iconCustomise your Victus server listing — edit the MOTD in server.properties (with colour codes) and add a 64x64 server-icon.png.Make yourself op/adminGrant yourself full admin rights on a Victus Minecraft server with the op command from the console — plus notes on Vanilla op levels and plugin permissions.Schedule automatic restartsUse the Schedules tab on Victus to automatically restart your Minecraft server on a cron schedule, keeping TPS healthy and memory clean.Create and restore backupsProtect your world on Victus — create manual or scheduled backups from the Backups tab and restore them when something breaks.Add sub-users (co-owners)Share panel access to your Victus server without giving away your login — add subusers on the Users tab and grant only the permissions they need.Reset the worldGenerate a fresh world on a Victus Minecraft server — back up, delete or rename the world folders, optionally set a new seed, and restart.Using the consoleUse the Victus panel Console tab to read logs, run Minecraft commands, and control power (start/stop/restart/kill) on your server.