Player Utils

Overview

Player Utils is a specialized utility mod designed for Minecraft 1.21.1 using the NeoForge loader. It provides server administrators with a suite of four administrative commands to control player mechanics, including health, combat, and respawn locations. All command states are persisted within each player's NBT data, ensuring that effects remain active through server restarts and player relogs.

Administrative Commands

/choke

The /choke command forces a target player to undergo suffocation damage. This effect can be made conditional by providing a slotList via a JSON array. If the player does not possess the required items in the specified inventory slots (such as the hotbar, armor, or offhand), they will suffer rapid damage from oxygen depletion. Honestly, if no slot list is provided, the effect is unconditional.

/health

Administrators can use the /health command to lock a player's health to a specific fixed value ranging from 1 to 100. Similar to the choke command, this can be applied conditionally using a JSON array to check for specific items in player inventory slots. Once the command is stopped, the player's maximum health is restored to the default value of 20.

/pvp

The /pvp command allows for the toggling of a player's ability to engage in combat. When the command is started for a specific target, that player is unable to damage other players. Using the stop subcommand re-enables their ability to participate in PvP.

/autosp

The /autosp command automates spawnpoint management. When enabled, the mod automatically sets a player's spawnpoint to their current death location at the moment they die. This allows the player to respawn exactly where they fell when they click the respawn button.

Technical Requirements

To function correctly, this mod requires NeoForge 21.1.235 or later and Java 21 or 17. This mod is required on both the client and the server side. All commands require OP level 2 permissions to execute. In singleplayer environments, cheats must be enabled to access these administrative tools.

Slot Configuration

When using the conditional features for /choke or /health, administrators can define requirements for the following slots:

• Hotbar: hotbar.0 through hotbar.8
• Inventory: inventory.9 through inventory.35
• Armor: armor.head, armor.chest, armor.legs, and armor.feet
• Offhand: offhand

Requirements are defined using a JSON format specifying the item ID and an optional count.