OpTools

OpTools is a utility mod for Minecraft operators. It adds administrative commands and an online detector block for redstone automation.

Capabilities

Detect online players with redstone

The Online Detector emits a configurable constant or pulsed redstone signal while its owner—or, optionally, anyone on the owner's vanilla scoreboard team—is online. Its settings can be changed by the owner, server operators, and team members when team mode is enabled.

When Jade or WTHIT is installed, the detector tooltip also displays its owner's name. Both integrations are optional; neither overlay is required to use OpTools.

Teleport online and offline players

The offline-tp command moves a single player to a destination whether that player is currently connected or not.

• Online players are teleported immediately.
• Offline players have their saved player data updated and appear at the destination the next time they join.
• Teleports can cross dimensions.
• Position, rotation, and dimension are preserved in the destination data.
• Motion is cleared, fall flying is disabled, and portal cooldown is reset so the player arrives in a stable state.
• The command reports whether the player was moved immediately or will arrive at the destination on their next login.

Commands

All commands require game-master permission level (the same level used by operator commands).

Inspect client-only mods

/optools client-mods <player>

Requests the selected online player's loaded mod list and reports mods not loaded by the server, plus any matching mod IDs with different versions. The list is client-reported and can be falsified by a modified client; it is intended for diagnostics, not enforcement.

Teleport to the command source

/optools offline-tp <player>

Teleports the player to the command source's position, dimension, yaw, and pitch. This is useful when run by an in-game operator.

Teleport to coordinates

/optools offline-tp <player> <x> <y> <z>

Teleports the player to coordinates in the command source's current dimension. The command source's yaw and pitch are used.

Minecraft coordinate syntax is supported, including relative (~) and local (^) coordinates.

Teleport to coordinates with rotation

/optools offline-tp <player> <x> <y> <z> <yaw> <pitch>

Teleports the player to coordinates in the command source's current dimension with the specified rotation.

Teleport to another online player

/optools offline-tp <player> to <destination>

Teleports the player to an online destination player's position, dimension, yaw, and pitch.

Player selection and errors

• <player> is resolved from known game profiles and must identify exactly one player.
• <destination> must be an online player.
• An offline player must already have a saved .dat file in the world's playerdata directory. OpTools reports an error if no saved data exists.
• OpTools reports an error instead of making a partial change if saved player data cannot be written.

Offline data handling

Before changing an offline player's location, OpTools upgrades the player's NBT data to the server's current data version. It writes the result to a temporary file and uses Minecraft's safe file-replacement mechanism, which retains the previous file as a _old backup.

As with any tool that modifies world data, stop the server cleanly and maintain regular world backups.

Requirements

• Minecraft 1.21.1
• NeoForge 21.1.222 or newer in the 21.1 line
• Installation on the server and all connecting clients

Installation

1. Install a compatible NeoForge server.
2. Place the OpTools JAR in the server's and each client's mods directory.
3. Start or restart the server.
4. Grant the intended administrators operator permissions.

OpTools has no configuration file and no dependencies beyond Minecraft and NeoForge. The Online Detector is also available in the Redstone Blocks creative tab and can be crafted from iron, redstone, comparators, and an observer.