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