AdminPunish
\nA lightweight, self-contained punishment system for Paper 1.21.1 servers.
\nNo dependencies. No database setup. Drop the jar in, restart, and your staff team has a full punishment toolkit available immediately.<\/p>\n
Overview
\nAdminPunish is an OP-only punishment plugin that covers every common moderation action through a single unified command interface. All data is stored locally in JSON files, persists across restarts, and is indexed by UUID so player records survive name changes. The plugin was written as a direct Java port of a battle-tested Skript script, preserving every behaviour precisely while gaining the performance and reliability of compiled code.<\/p>\n
Features
\nPermanent Ban
\nIssues an indefinite ban. The banned player is immediately kicked with a formatted disconnect screen showing the reason, issuing staff member, and an appeal prompt. The ban is enforced on every subsequent login attempt until lifted with \/unban.
\nTemporary Ban
\nIssues a time-limited ban using a compact duration format: 30s, 15m, 12h, 7d, 2w. The player is kicked on issuance and blocked on login with a screen showing the time remaining. When the ban expires it is lifted automatically the next time the player attempts to connect, requiring no manual intervention.
\nKick
\nDisconnects an online player with a formatted reason screen. The action is broadcast to all online players.
\nNumbered Warnings
\nIssues a warning that is numbered sequentially per player and stored permanently. The warned player receives a visible chat notification, then is kicked three seconds later with a warning screen showing the warning number, reason, and issuing staff. Warnings can be reviewed in full with \/warnings and erased with \/clearwarnings.
\nJail
\nFreezes a player at their current position without requiring any jail location to be configured in advance. Jailed players are switched to Adventure mode, receive a persistent action bar message every second, and are fully restricted:<\/p>\n
Block-level movement is prevented while head rotation is still allowed
\nAll teleportation is blocked, including ender pearls, chorus fruit, \/tp, and stasis chamber pulls
\nEnder pearl throws are cancelled at the source
\nBlock breaking and placing is prevented
\nAll inventory interaction is prevented
\nItem dropping and picking up is prevented
\nCombat is blocked in both directions \u2014 jailed players cannot be hit and cannot hit others
\nCommand usage is blocked for non-OP jailed players<\/p>\n
If a jailed player disconnects, a 30-minute temporary ban is automatically issued and broadcast to the server. On their next login the ban is checked: if it has expired, the jail is also cleared and they join freely; if it has not expired, they are blocked at the login screen with the remaining time. When a staff member issues \/unjail, the player is restored to Survival mode and receives a release notification.<\/p>\n
Commands Permissions Data Storage bans.json \u2014 active and expired ban records keyed by UUID Records are written to disk immediately on every change. No scheduler or batch-write delay is involved.<\/p>\n Compatibility<\/p>\n Server software: Paper 1.21.1 (API version 1.21) Installation<\/p>\n Download AdminPunish-2.4.0.jar No configuration is required. The plugin is operational immediately after the first restart.<\/p>\n","protected":false},"excerpt":{"rendered":" AdminPunish plugin that lets ops use \/punish commands (ban, tempban, kick, and jail)<\/p>\n","protected":false},"featured_media":129364,"template":"","meta":{"_minecraft_slug":"rays-admin-utils","_minecraft_project_id":"v6eDKsnd","_minecraft_author":"vrkrayy","_minecraft_license":"MIT","_minecraft_downloads":23,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"rays-admin-utils.zip","_minecraft_size_bytes":293194,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:22:30.377823Z","_minecraft_date_created":"2026-03-11T23:00:29.651443Z","_minecraft_date_modified":"2026-03-06T19:31:11.977628Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/rays-admin-utils","_minecraft_icon_attachment_id":129364,"_minecraft_imported_at":"2026-06-07T14:51:57+00:00","_minecraft_import_hash":"af850547bde22ff2b57249feed70278e","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-129363","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nCommandDescription\/punish
\nAll commands support tab-completion for online player names. \/unban and \/unjail additionally suggest names from the stored UUID cache, allowing offline players to be targeted by name.
\nDuration format for \/punish tempban: append a unit character to a positive integer. Supported units are s (seconds), m (minutes), h (hours), d (days), and w (weeks). Examples: 30m, 12h, 7d, 2w.<\/p>\n
\nAll commands require the adminpunish.use permission, which defaults to OP. No configuration file is needed; permissions work out of the box on any standard Paper server.<\/p>\n
\nAll records are stored as human-readable JSON files inside the plugin’s data folder:<\/p>\n
\nwarnings.json \u2014 warning history lists keyed by UUID
\njail.json \u2014 active jail records keyed by UUID
\nplayers.json \u2014 UUID-to-name and name-to-UUID cache populated on every join<\/p>\n
\nJava version: Java 21
\nDependencies: None \u2014 Gson is shaded into the jar
\nSoft dependencies: None<\/p>\n
\nPlace it in your server’s plugins\/ folder
\nRestart the server<\/p>\n