Ultimate Moderation

Server moderation in game: admins and moderators, kick and ban with reasons, whitelist, required mods, blocked commands, all devcommands and a free camera for admins.

⌨️ PRESS F3 IN THE GAME TO OPEN THE SETTINGS PANEL ⌨️

Every feature of this mod is turned on and tuned in the in-game panel.
Can't use F3? Open the console with F5 and type ultimateqol_config.

⌨️ How to use

1. Install and start the game.
2. Press F3 to open the settings panel.
3. Find the Moderation options in the sidebar (or type in the search box at the top) and turn on what you want.

Everything is off by default, so the game stays vanilla until you turn something on.

🔑 To change settings you need admin access with devcommands: be listed in the server's adminlist.txt (on a dedicated server) or be the host of the world. Changes are synchronized to all players in real time.

Features

Server management (admins and moderators)

The MANAGEMENT section is the first of the panel (the other options are under GENERAL) (off by default where it changes rules). Every action is checked by the server.

• Roles: the admin master is the first ID of adminlist.txt (or the host of the world) and can do everything. Other admins manage everything except admins and can never kick or ban the master. Moderators (moderator.txt, added and removed by any admin) only open the Players page and only kick normal players; they cannot change settings. The panel header shows your role.
• Players: kick and permanent ban with a required reason; ban offline players by ID; the last 20 players who left (to ban someone who already disconnected); the ban list with unban. The player sees who and why in the main menu.
• Moderation log: moderation_log.txt next to adminlist.txt – dd/MM/yyyy HH:mm | KICK/BAN | by | target | reason (also whitelist, admin and moderator changes). The latest entries are shown on the page.
• Whitelist (permittedlist.txt): add an ID with an optional nickname (permittedlist_names.txt), add everybody online (nickname = in-game name), remove, and clear (master only). A warning and a confirmation appear when the list is empty; the admin who turns it on is always added too, so nobody locks themselves out.
• Staff: admins (the master adds/removes them when Master manages admins is on) and moderators.
• Mods: Require the same mods (exact versions; the server reads its mods at every start), Optional and Admin only per mod, Block unknown patchers (BepInEx/patchers) and Kick players without Ultimate QOL (about 30 s after joining; admins are never kicked). A player who differs is disconnected and sees in the main menu what is missing, different, extra, admin only and patchers not allowed, with a Copy button formatted for Discord / WhatsApp.

Blocked commands

• Blocked commands – a list of console commands that players cannot use even without devcommands (the admin types a name, clicks Add, and removes entries with the x button). The list starts with printseeds (shows the world seed) and lodbias. Admins and the host are never blocked; blocked commands also disappear from the help and auto-complete. The block runs in each player's game, so players need the mod. An empty list blocks nothing. You can also add yesiuseddevcommandsbutiwantmyachievementsanyway to stop players from using that command.

Console: all devcommands for admins

Panel page Admin camera and console (config section 132 - Console; the same page holds the admin free camera).

Option (config key)	Default	Range	What it does
All devcommands for admins (AllDevCommandsForAdmins)	off	on / off	Administrators on the server admin list (adminlist.txt) can use every devcommands command on this server, after typing devcommands, like in a local game.

• Only administrators on the admin list are affected (the host of a local game also counts as admin). Nobody else gets anything, and the blocked command list (see Console commands) still applies.
• It lifts the game's client-side checks (cheats allowed, admin only, server only) for those admins once devcommands has been typed.
• Known limit: a command whose work is done by the server in the world is run by the admin's own game, so it may change only what that game controls. Local-game behaviour cannot be fully reproduced by a client on a dedicated server. Test the commands you need on your server.
• Cheated items and achievements keep following the existing rules of the game and of the Achievements options.

Admin free camera

Option Free camera for admins (off by default) and its key (default F10, changeable in the panel). Made for recording fights: a free flying camera that moves like walking: the mouse looks around with your normal sensitivity, W/S fly where you look (look up and press W to go up), A/D move sideways, jump/crouch go straight up and down, Shift is 3× faster, with a smooth start and stop; the character follows invisibly behind the camera so the area stays loaded, and other players do not see its body, name, health bar or map marker. Meanwhile the admin takes no damage, does not get hungry, monsters ignore him and every HUD disappears (the mod's clock and day counter too). The key again puts the character back exactly where it was; Esc, the game menu and opening the settings panel do the same. Only admins can use it.

---

⚠️ Experimental

This mod is still experimental and may contain bugs. Back up your world and your character, and turn features on a few at a time.

💬 Bugs and suggestions

Join the Discord: discord.gg/aMkN89Cuas

_{Powered by Ultimate QOL, installed automatically as a dependency. The F3 panel also shows its other options, all off by default.}