AdminTools

AdminTools — VanishSpec, Tracker & IJail

Short description: A lightweight, audit-friendly admin toolkit for Paper 1.21.x servers. Combines a stealth observer (VanishSpec), full player activity tracker (TrackerBox) and a persistent invisible jail (Invisible Jail), plus essential admin utilities (invsee, endersee, heal, feed). Designed for moderation, incident investigation and safe staff tools with built-in logging and anti-abuse practices.

Key selling points (one-liners)

Quietly observe players without showing in the world — vs (VanishSpec).

Full, human + machine-friendly tracking logs for players (/track) — join/quit, teleports, damage, kills, drops/pickups, inventories, block interactions, commands and periodic snapshots.

Persistent, configurable jail point (/ijail set) and per-player jail durations + list view.

Simple admin utilities: view inventories/ender chest, heal and feed players.

Append-only logs stored under plugins/AdminTools/ for auditing and evidence.

What it does — full feature list

VanishSpec (/vs)

/vs toggle — toggle staff vanish (hide from other players).

/vs watch <player> — teleport to a target and enable vanish to silently observe.

Admins are invisible and (configurable) non-interactive while vanished; all vanish toggles are logged.

Freeze (/fz)

/fz <player> - freezes the player completely, preventing them from moving, breaking/placing blocks, picking up/throwing objects, etc.

Tracker (/track)

track start <player> — begin full tracking of the named player. Creates folder plugins/AdminTools/tracker/<PlayerName>/.

track stop <player> — stop tracking.

Logged events (each recorded as NDJSON + pretty human log):

Login / Logout

Teleports (including inter-world transfers)

Block Break / Block Place (with coordinates)

Interact (right/left clicks, clicked block type)

Pickups & Drops (item type + counts)

Commands issued by player

Inventory opens (with container title)

Damage dealt / damage taken (who/what, amount)

Player deaths (message + killer)

Entity kills by player (entity type, drops count)

Periodic snapshots every configurable minutes: timestamp, world, coordinates, health, gamemode (useful for tracing location over time)

_Storage format:_

events.log — NDJSON (one JSON object per event) — machine-parsable.

events_pretty.log — compact human-readable lines — quick inspection.

Configurable sampling and retention in config.yml to avoid IO blowups.

Invisible Jail (/ijail)

/ijail set — set the global jail location to the admin’s current position (persisted to disk). Requires admintools.ijail.set.

/ijail jail <player> <minutes> [reason] — jail a player for N minutes and record the reason. Teleports player to the saved jail location (or fallback limbo).

/ijail release <player> — release a jailed player.

/ijail list — list all jailed players with: player name, reason, remaining time.

All jailing/unjailing events are logged (append-only) for audit.

Admin utilities

/invsee <player> — open target’s inventory (read/write).

/endersee <player> — open target’s ender chest.

/heal <player|self> [amount] — heal to amount or full.

/feed <player|self> [amount] — set hunger level (0–20).

Command reference

All commands require the permission listed or OP by default.

/admintools help — show full English help and examples

/vs toggle — toggle VanishSpec (permission: admintools.vsspec.use)

/vs watch <player> — vanish + teleport to player

/fz <player> - freezes the player completely

/track start <player> — start tracking player (admintools.track.use)

/track stop <player> — stop tracking player (admintools.track.use)

/ijail set — set jail teleport point (admintools.ijail.set)

/ijail jail <player> <minutes> [reason] — jail a player (admintools.ijail.use)

/ijail release <player> — release a jailed player (admintools.ijail.use)

/ijail list — list jailed players and remaining time

/invsee <player> — open player inventory (admintools.invsee)

/endersee <player> — open player ender chest (admintools.endersee)

/heal <player|self> [amount] — heal (admintools.heal)

/feed <player|self> [amount] — set food level (admintools.feed)