Server Utilities

A Minecraft server-side utility mod built on NeoForge, providing convenient teleportation, account security, inventory inspection, and private message monitoring for server admins and players.

• Supported version: Minecraft 1.21.1 / NeoForge
• Mod ID: server_utilities
• Mod version: see mod_version in gradle.properties

Features

1. TPA Teleport System

Teleport requests between online players with complete safety and fairness mechanics:

• Stand-still check: You must remain stationary for a duration after accepting; moving resets the timer
• Experience cost: Cost based on distance, with an extra fee for cross-dimension teleports
• Timeout: Requests expire automatically
• Clear feedback for offline targets, self-lock, target-lock, etc.

2. Login / Register System

Password protection for your server:

• Unverified players are locked high above the spawn area, blocked from chatting and commands (except /login /register /logout), with periodic reminders
• Auto-kick on login timeout
• Data safety: full player data (inventory, ender chest, XP, health, hunger, position) is backed up / cleared / restored around login
  • Unauthenticated players have their data cleared; it is fully restored after a successful login
  • Backups are also written to disk (world/playerdata/auth_backups/) so data survives a server restart
  • Join / leave messages of unauthenticated players are suppressed to hide their online status

3. Inventory / Ender Chest Inspection (Admins)

• Requires permission level 2 (admin)
• Online players are auto-completed when typing a name; offline players can still be typed manually
• With no argument, defaults to the player in your line of sight (distance configurable)

4. Private Message Monitoring (Admins)

• Vanilla /msg, /tell, /w private messages are monitored
• Admins see them in real time in gray italics: <playerA> whispers to <playerB>: message (format configurable)
• Every private message is also written to the server log ([MSG] sender -> receiver: content)

Configuration

Config file: config/server_utilities.toml, containing these groups:

• [tpa]: tpa_enabled, lock_enabled, timeout_ms, stand-still duration, XP cost settings, etc.
• [login]: enabled, timeout_seconds, reminder interval, etc.
• [invsee]: invsee_enabled, endersee_enabled, invsee_look_range (line-of-sight distance, default 5), etc.
• [msg]: msg_monitor_enabled, msg_monitor_format (admin monitor message format)

Development

If your IDE is missing libraries, run:

./gradlew --refresh-dependencies   # Refresh the local dependency cache
./gradlew clean                    # Clean build outputs (does not affect your code)

Data generation: run the data task to generate mod data:

./gradlew runData

Mapping Names

By default, this project uses the official Mojang mappings to access Minecraft code. These names are covered by a specific license; see the mapping file itself or the reference copy for the latest license text: https://github.com/NeoForged/NeoForm/blob/main/Mojang.md

Additional Resources

• Community documentation: https://docs.neoforged.net/
• NeoForged Discord: https://discord.neoforged.net/