This guide covers how to kick and ban players from your Hytale server, and how to remove bans when needed. All commands can be run from the in-game chat (if you have admin rights) or directly in the server console.
Kicking a Player
Kicking removes a player from the server immediately but does not prevent them from rejoining.
/kick <playername>Replace <playername> with the player's username. You can optionally add a reason:
/kick <playername> <reason>Banning a Player
Banning prevents a player from rejoining the server permanently until the ban is removed.
/ban <playername>You can also ban by UUID (useful if a player has changed their username):
/ban <uuid>To include a reason:
/ban <playername> <reason>Unbanning a Player
To lift a ban and allow a player to rejoin:
/unban <playername>Or by UUID:
/unban <uuid>Viewing the Ban List
To see all currently banned players:
/banlistManaging Bans via File
Bans are stored in bans.json in your server directory. You can edit this file directly if you need to make bulk changes or manage bans while the server is offline.
Important: Always stop your server before editing bans.json by hand. Changes made while the server is running can be overwritten when the server shuts down.
Frequently Asked Questions
Do bans survive a server restart?
Yes. Bans are saved to bans.json and persist across restarts.
Can I ban a player who isn't currently online?
Yes, as long as you know their username or UUID.
A player keeps rejoining under a different name — what do I do?
Ban them by UUID rather than username. A UUID is permanently tied to the player's Hytale account and cannot be changed. You can find a player's UUID in your server logs after they connect.
