Player Manager

Calagopus extension: manage players of Minecraft Java and Bedrock servers (online players, whitelist, operators, bans).

Player Manager A Calagopus Panel extension for managing the players of Minecraft servers, both Java Edition (vanilla, Paper/Spigot, Fabric, Forge and other servers that keep the vanilla player files) and Bedrock Dedicated Server. Open Players in the server sidebar to see who is online, kick or ban them, and edit the whitelist, operators and bans without touching the console or the JSON files. Package name: dev.caloptreyx.playermanager · Requires panel >=1.2.3 Features • Online players: the current player list with count and slots, read from the server's own list command. Java servers also return each player's UUID. Kick, ban, op/deop and whitelist players from their row. • Whitelist / allowlist: add and remove players and turn the whitelist on or off. • Operators: Java permission levels 1 to 4 and "bypass player limit"; Bedrock operator, member and visitor levels. • Bans and IP bans (Java): ban with a reason, see who banned whom and when, pardon. • Name lookup: players the server has seen before are suggested while typing. Java UUIDs come from usercache.json, the Mojang API, or the offline-mode UUID when online-mode=false. Bedrock XUIDs come from the allowlist, the console log (Player connected) or the GeyserMC API. • Edition detection: the extension recognises Java and Bedrock servers from their files, so the same page works for both. How changes are applied | Server | State | How | |---|---|---| | Java | running | Console commands (whitelist add, op, ban, pardon, ban-ip, kick...). The server updates its own files. | | Java | offline | whitelist.json, ops.json, banned-players.json, banned-ips.json and server.properties are edited through Wings. | | Bedrock | running | allowlist.json / permissions.json are edited, then allowlist reload / permission reload is sent. Turning the allowlist on or off edits server.properties and needs a restart. | | Bedrock | offline | The files are edited. | While the server is starting or stopping, changes are refused. Operator levels and "bypass player limit" can only be chosen while a Java server is offline; the op command always uses the server's op-permission-level. Bedrock Dedicated Server has no ban list, so the ban tabs are only shown for Java servers. Refreshing the online list runs list in the console (minecraft:list uuids on Java), so it shows up in the console output. The list is not polled in the background. Permissions The extension uses the panel's own permissions; it adds none. | Action | Permission | |---|---| | Open the page, see whitelist, operators and bans | files.read-content | | See online players | control.console and control.read-console | | Change anything while a Java server is running, kick | control.console | | Change anything while the server is offline, any Bedrock change | files.create (the panel's file write permission) | | Bedrock changes while running (the reload command) | additionally control.console | Commands are logged as server:console.command and file edits as server:file.write, the same activity events the panel's console and file editor create. Installation Download devcaloptreyxplayermanager.c7s.zip from the latest release and either upload it under Admin → Extensions or put it in your heavy image's build/extensions/ directory and run docker compose restart web. Extensions need the :heavy panel image or a development environment. The extension has no database tables. To build the zip from a checkout, run python3 scripts/package.py (writes dist/). API All routes live under /api/client/servers/{server}/player-manager: | Route | Purpose | |---|---| | GET / | Edition, state, properties, whitelist, operators, bans, known players | | GET /online | Online players (runs list) | | POST, DELETE /whitelist | Add or remove a whitelist entry | | PUT /whitelist/enabled | Turn the whitelist on or off | | POST, DELETE /operators | Add or remove an operator | | POST, DELETE /bans | Ban or pardon a player (Java) | | POST, DELETE /ip-bans | Ban or pardon an IP address (Java) | | POST /kick | Kick an online player | Development The crate lives at the repository root, the frontend in frontend/. Every push runs the shared extension check (.github/workflows/check.yml): typecheck, Biome, frontend build, the node tests in tests/ and cargo test against the newest panel release. License MIT