FixOperations

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).