Player Utils

Minecraft 版本： 1.21.1

平台： neoforge

标签： game-mechanics management utility

Player Utils

A powerful administrative mod for NeoForge 1.21.1 that adds four essential commands for gameplay control.

✨ Features

• /choke – Force players to suffocate unless specific inventory conditions are met.
  Oxygen depletes rapidly and causes damage when empty. Conditions are optional.
• /health – Lock a player's health to a fixed value (1–100) until conditions are met.
  Supports optional inventory conditions.
• /pvp – Disable a player's ability to attack other players.
  Simple on/off toggle.
• /autosp – Automatically sets your spawnpoint to your death location when you die.
  Click the respawn button to respawn exactly where you died.

All states are persisted in each player's NBT data, surviving server restarts and relogs.

📖 Command Reference

/choke

/health

/pvp

/autosp

🧩 SlotList Format (for /choke and /health)

The slotList is an optional JSON array that defines conditions on specific inventory slots.
Each entry is an object with the slot name as key and an object of item IDs and required counts.

Slot names:

• hotbar.0 to hotbar.8 –hotbar
• inventory.9 to inventory.35 –inventory
• armor.head, armor.chest, armor.legs, armor.feet –armor
• offhand –offhand

Item format: "namespace:item" (e.g., "minecraft:diamond").
Count is optional; if omitted, any amount is accepted. Multiple items in one slot act as OR (any of them works).

Example:

[
  {"hotbar.8": {"minecraft:bedrock": 1}},
  {"armor.head": {"create:diving_helmet": 1, "create:netherite_diving_helmet": 1}},
  {"inventory.32": {"minecraft:netherite_block": 32}}
]

This requires:

• Slot 8 (last hotbar slot) has at least 1 bedrock.
• Helmet slot has either a diving helmet or a netherite diving helmet.
• Inventory slot 32 has exactly 32 netherite blocks.

🔒 Permissions

All commands require OP level 2 (default for most server admins).
In singleplayer, enable cheats or use /op in a server environment.

📝 License

This mod is distributed under All Rights Reserved unless otherwise stated in the source code.
You may use it on your server, but redistribution or modification requires explicit permission from the author.

🙏 Acknowledgements

• NeoForge for the modding framework.
• All contributors and testers.

📞 Contact

Author: DogOfFurina
Issues & suggestions: GitHub Issues