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