Admin Commands
Operational, diagnostic, and admin-teleport commands. Most live under /obx and require op.
| Command | Aliases | Usage (arguments) | Example usage | Description | Default level | Permission node |
|---|---|---|---|---|---|---|
| Admin teleport | ||||||
/kill | Command: /crosskill, /aimkill, /targetkill | /kill [player] | /kill Notch | With no argument, toggles kill mode. Left-clicking an entity in your crosshair kills it, shows entity type, distance, death location, hover details, a click-to-teleport button, and a 10-second grave marker. With a player argument, kills that online player directly. | op | obx.kill |
/tp | Command: /teleport | /tp [target] | /tp Notch | Teleport to a player, or move one player to another. The console can move players but cannot teleport itself, and there is no console to teleport to. | op | obx.teleport.admin |
/tphere | -- | /tphere | /tphere Notch | Bring a player to your location (you can't target yourself). | op | obx.teleport.admin |
| Config & Debug | ||||||
/chatgame | Command: /chatgames, /cg | /chatgame [type] | /chatgame start quick-math | Manage OBX Chat Games. Supports quick math, scrambled words, missing letters, command rewards, one-winner protection, reloads, previews, and status checks. Players need obx.chatgames.play to answer live games. | op | obx.chatgames.admin |
/backup | Command: /backups, /bkup | /backup | /backup now necessary | Manage OBX automated/manual server snapshots, backup size profiles, frequency, retention listing, restore candidates, and confirmed restores. Startup restore can be triggered by placing restore.zip in plugins/OBX/backups/restore/. | op | obx.backup.admin |
/obx config | Command: /obsidian, /obc | /obx config | /obx config | List loaded config files and their status, with clickable « Prev / Next » pagination. | op | obx.debug.config |
/obx config validate | Command: /obsidian, /obc | /obx config validate | /obx config validate | Validate config files and report errors or deprecated keys. | op | obx.debug.config.validate |
/obx editor | Command: /obsidian, /obc | /obx editor [open] | /obx editor | Open a private OBX Web Editor browser session for the executing player. | op | obx.editor |
/obx editor history | Command: /obsidian, /obc | /obx editor history [limit] | /obx editor history 10 | Show recent and previous Web Editor sessions with player, status, URL with masked token, and accurate server-local timestamps. Limit is capped at 25. | op | obx.editor |
/obx editor sessions | Command: /obsidian, /obc | /obx editor sessions | /obx editor sessions | Show active Web Editor sessions, including player, browser-open state, created/opened/expires timestamps, and masked URL. | op | obx.editor |
/obx debug | Command: /obsidian, /obc | /obx debug | /obx debug | Show debug status and active debug flags. | op | obx.debug |
/obx debug disable | Command: /obsidian, /obc | /obx debug disable | /obx debug disable | Disable debug logging. | op | obx.debug.toggle |
/obx debug dump | Command: /obsidian, /obc | /obx debug dump | /obx debug dump | Dump internal state to a log file for troubleshooting. | op | obx.debug.dump |
/obx debug enable | Command: /obsidian, /obc | /obx debug enable | /obx debug enable | Enable debug logging temporarily. | op | obx.debug.toggle |
| Reload & Diagnostics | ||||||
/obx diagnostics | Command: /obsidian, /obc | /obx diagnostics | /obx diagnostics | Run a quick health check (platform, modules, config status, storage, overall health). | op | obx.admin.diagnostics |
/obx diagnostics full | Command: /obsidian, /obc | /obx diagnostics full | /obx diagnostics full | Health check plus extended detail: registered services, detected hooks, and recorded errors. | op | obx.admin.diagnostics.full |
/obx reload | Command: /obsidian, /obc | /obx reload | /obx reload | Reload OBX configs and reinitialize all feature modules safely. Result shows a hover with per-module load times. | op | obx.admin.reload |
/obx reload | Command: /obsidian, /obc | /obx reload | /obx reload config.yml | Reload a specific file from the plugin data folder (timed, with a hover). | op | obx.admin.reload.features |
/obx reload config | Command: /obsidian, /obc | /obx reload config | /obx reload config | Reload configuration files only. | op | obx.admin.reload.config |
/pl | Command: /plugins | /pl | /pl | List loaded plugins grouped by Bukkit/Paper/Purpur/Folia with status colors (enabled/disabled/broken). | op | obx.pl |
/preview | Command: /prev | /preview | /preview Rules: 1. No Griefing | Render a MiniMessage / hex / gradient / legacy &-code string to ANSI truecolor in the console (hex isn't expressible with § codes) — or to chat in-game. Run with no args for color/format examples. | op | obx.preview |
/tps | Command: /lag, /mspt, /performance | /tps | /tps | Show server TPS (1m/5m/15m, each with a labeled hover tooltip), MSPT, online count, and uptime. Console output renders in ANSI color. | op | obx.tps |
/health | Command: /healthcheck (also /obx health) | /health | /health | Staff-only full server health check in one clean box-style report: TPS windows, tick time vs the 50 ms budget, process/system CPU + cores, heap memory, entities & chunks across worlds, players & average/worst ping, sync queue & async workers, SQLite store state/size, disk capacity, and per-player averages (entities, ping, tick & memory share). Every row has a hover tooltip; key rows and the footer [⟳ Re-run] [TPS Detail] [Diagnostics] buttons carry click actions. Color-graded green/yellow/red. | op | obx.admin.health |
| Modules | ||||||
/obx afk | Command: /obsidian, /obc | /obx afk | /obx afk off | Toggle the entire AFK system (auto-AFK detection, the idle timeout/kick, and AFK messages) on/off at runtime. Box-style confirmation in-game + console; also settable via config.yml (afk.enabled) or the Module Toggles admin GUI. | op | obx.admin.modules.afk |
/obx deathdrop | Command: /obsidian, /obc | /obx deathdrop | /obx deathdrop on | Toggle death-item grouping: on death, all dropped items combine into one carry-all entity (a chest, or a bundle on 1.17+) with a floating ×<count> hologram; walking over it restores the items (overflow stays inside). Box-style confirmation in-game (with a [Toggle] button) + console; also settable via config.yml (modules.deathdrop) or the Module Toggles admin GUI. | op | obx.admin.modules.deathdrop |
/obx joinleave | Command: /obsidian, /obc | /obx joinleave | /obx joinleave off | Toggle the join/leave broadcast module at runtime. | op | obx.admin.modules.joinleave |
/obx joinmotd | Command: /obsidian, /obc | /obx joinmotd | /obx joinmotd on | Toggle the in-game welcome MOTD module at runtime. | op | obx.admin.modules.joinmotd |
/obx mod list | Command: /obsidian, /obc | /obx mod list | /obx mod list | List available OBX modules and show whether each one is currently enabled. This command is list-only; use /obx mod <name> toggle|on|off|status to manage a module. In-game status words are clickable toggles. | op | obx.admin.modules |
/obx mod | Command: /obsidian, /obc | /obx mod toggle|on|off|status | /obx mod randomtp toggle | Standard module command for toggling or checking systems such as announcements, chatgames, roles, randomtp, scoreboard, tablist, chat, hub, afk, deathdrop, joinleave, joinmotd, and warnings. | op | obx.admin.modules |
/role | Command: /roles, /rank, /ranks | /role | /role users moderator | Manage OBX roles, player assignments, role/player permissions, user lookups, negative permissions, wildcard permissions, prefixes, suffixes, and tracks. The Web Editor has a separate Roles & Permissions section with permission-node autosuggest gated by obx.roles.web. | op | obx.roles.admin |
/obx warn | Command: /obsidian, /obc | /obx warn | /obx warn off | Toggle the unconfigured-webhook warnings: while any Discord webhook setting (discord.moderation.*, economy.reporting.discord-webhook) still holds its shipped blank/placeholder value, OBX warns the console at startup and admins on join (above the welcome MOTD, with a hover listing the affected settings). Warnings stop automatically once real values are set. Command/GUI toggle applies instantly and persists to config.yml (warnings.webhook-unconfigured); editing the config directly needs /obx reload. Box-style confirmation with a [Toggle] button; also in the Module Toggles admin GUI. | op | obx.admin.warnings |
| Admin menu | ||||||
/obx | Command: /obsidian, /obc | /obx | /obx | Open the Admin Menu when using /obx with no args. The Server Control tile shows live player count + uptime. | op | obx.admin.menu |
| Updates & Version | ||||||
/obx updates | Command: /obsidian, /obc | /obx updates | /obx updates | Check for available updates and display a box-style summary. The server also checks automatically: once at startup (console) and every updates.check-interval-minutes (default 15) while running, announcing each new release once. | op | obx.updates.check |
/obx updates check | Command: /obsidian, /obc | /obx updates check | /obx updates check | Force an update check (placeholder). | op | obx.updates.check |
/obx updates notify | Command: /obsidian, /obc | /obx updates notify | /obx updates notify | Toggle update notifications for the executor. ON by default for obx.updates.notify holders (notified on join + once when a new release is found while the server runs); the opt-out is saved to the database and survives restarts. | op | obx.updates.notify |
/obx version | Command: /obsidian, /obc | /obx version | /obx version | Show current OBX version, release date, and build tag. | op | obx.version |