A simple, reliable tool to manage players (Whitelist, Ban, OP) on your Hytale server.

It remembers players by their unique ID (UUID).

How to use

All commands start with /fo.

Flags can also be provided as a trailing options block (place it last): [opts:flag1,flag2]. Example: /fo ban add Steve 7d Griefing [opts:pre,nodb]

🛡️ Whitelist

Add a player: /fo wl add <username> Example: /fo wl add Steve
Add a player for a specific time: /fo wl add <username> <time> Example: /fo wl add Steve 1d (1 day), /fo wl add Steve 1h30m (1 hour 30 mins)
Add a player who hasn't joined yet: /fo wl preadd <username> Note: This waits for them to join once to get their ID.
Remove a player: /fo wl remove <username>

☠️ Hardcore Mode

Enable/Disable Hardcore Bans: /fo sethardcore <on|off> [--playeronly|--any]
--playeronly: Only ban if killed by another player.
--any: Ban on any death (default if not specified).
List Hardcore Bans: /fo deathlist [mode] [limit]

📜 Admin Log

View Action History: /fo adminlog list [limit] See recent bans, mutes, kicks, etc.
Revert an Action: /fo adminlog revert <number> Undoes the action (e.g., unbans the player) if possible.

👢 Kick

Kick a player: /fo kick <username> [reason] Example: /fo kick Steve AFK for too long

🚫 Bans

Ban a player: /fo ban add <username> [time] [reason] Example: /fo ban add GrieferSteve 7d Griefing the spawn
Ban a player who hasn't joined yet: /fo ban preadd <username> [time] [reason]
Ban by IP address: /fo ban ipadd <ip> Example: /fo ban ipadd 192.168.1.50
Unban: /fo ban remove <username>

⚡ OP

Give OP: /fo op add <username>
Give OP for a specific time: /fo op add <username> 2h
Take OP: /fo op remove <username>

🔇 Mute

Mute a player: /fo mute add <username>
Mute a player for a specific time: /fo mute add <username> 30m
Mute with a reason: /fo mute add <username> 30m Spamming chat
Mute a player who hasn't joined yet: /fo mute preadd <username>
Unmute: /fo mute remove <username>
List muted players: /fo mute list [mode] [limit]

🎒 Inventory & Items

Clear your own inventory: /fo inv clear
Clear a player's inventory (online or offline): /fo inv clear <username|uuid>
View a player's inventory (offline view is read-only): /fo inv see <username|uuid>
Remove Specific Items: Remove broken or dev items from players or the world. /fo removeitems <broken|dev> <target> [options]
- Targets: playername, all (all players), world (all containers).
- Options: --online, --offline (for all).

📍 Teleportation

Change Position (Online or Offline): /fo changepos <target> <x> <y> <z> [world] Teleport a player to specific coordinates. Works even if they are offline (updates their login position).
Queue a teleport for a player when they next join: /fo tp <username> [time]
Queue a teleport for everyone who joins while active: /fo tpall [time]
Time limits: if you include a time (e.g., 1h), the rule expires if they haven't joined in that window.
Cancel a queued teleport: /fo tp cancel <username>
Disable tpall: /fo tpall off

🚀 Join Commands

Automate commands when players join.

Run for a specific player: /fo xp <player> <command>
Run for a permission group: /fo xg <group> <command>
Run for everyone: /fo xa <command>
Remove commands: /fo rxp, /fo rxg, /fo rxa followed by the command (or prefix).

🔁 Migrate Pending Pre-Actions

Run all pre-migrations (sequential to reduce lag): /fo migrate all [limit]
Run a specific migration: /fo migrate wl|op|ban|mute|tp [limit]

🔧 Database & Cleanup

Check player info: /fo db whois <username>
Look up a UUID: /fo db lookup <uuid>
List all known players: /fo db listuuids
List unknown entries: /fo db listunknown <whitelist|ban|op>
Clean up unknown entries: /fo db purgeunknown <whitelist|ban|op>
Purge a player data: /fo db purgeplayer <username>
Confirm cleanup prompts: /fo confirm (available for 60s after list prompts)
Verify/refetch UUID database: /fo verify [limit]

⚙️ Permissions (Advanced)

List permissions: /fo perms list --group <group> | --user <user>
List permissions by source/access: /fo perms listby <group|user|uuid|mod|command> <target> [--access] [--sources] [--limit <n>]
Grant permission nodes: /fo perms grant <permission> --group <group> Use --owner or --command to resolve from the command registry.
Clean up invalid permissions: /fo perms cleanup <target|all> --confirm
Revert last permission change: /fo perms revert

🔄 Reload & Help

Reload configuration: /fo reload config
See all commands: /help fo

Time Formats

You can use s (seconds), m (minutes), h (hours), d (days), w (weeks).

30m = 30 minutes
1h30m = 1 hour and 30 minutes
7d = 7 days

API

Other mods can access FixOperations databases via com.xytronix.fixoperations.api.FixOperationsApi (UUID log, IP bans, and permission change log).