# PerWorldPunish<\/p>\n
**PerWorldPunish** is a lightweight per-world punishment plugin designed for PaperMC 1.21+ servers. It provides server admins with the fundamental ability to ban players only in specified worlds without the unnecessary clutter or overhead of larger plugins.<\/p>\n
—<\/p>\n
## Key Features & Why You Should Download It<\/p>\n
* **Essential Per-world Punishments:** Easily ban\/kick\/tempban your players per-world! Perfect for server admins who don’t want to ban their players on whole server.
\n* **Minimal Overhead:** Built to be lightweight and efficient, ensuring minimal impact on your server’s performance. Perfect for small to medium-sized survival, semi-vanilla, or even large public servers that just need per-world punishments!
\n* **Customize Plugin Messages:** Customize all PerWorldPunish messages completely on `messages.yml`! Uses MiniMessage so you can have gradients, hex, clickable text and more!
\n* **Full MiniMessage Support:** Supports MiniMessage everywhere so you can use hex, gradients clickable texts etc.! It even works on commands like ban\/tempban\/kick reasons. No more ugly \u00a7 color codes! MiniMessage formatter: https:\/\/webui.advntr.dev\/
\n* **Intuitive Commands:** Everything the server admin needs is covered by small, easy to remember commands set **with tab complete**.
\n* **Modern Server Support:** Built specifically for the latest **PaperMC 1.21+** versions and its forks, guaranteeing up-to-date performance and stability.
\n* **Open Source:** Developed under the **GNU General Public License v3.0**, allowing for transparency and community contributions.<\/p>\n
—<\/p>\n
## Commands & Usage
\n**(<> is required, [] is optional):**
\n*NOTE: It shows command usage if you typed the command without any arguments.*
\n[reason] argument supports MiniMessage! MiniMessage Formatter: https:\/\/webui.advntr.dev\/<\/p>\n
| Command | Description | Permission | —<\/p>\n ## Default Configs “`yaml # This will show if there is no reason provided for ban\/kick\/tempban # The player will get teleported in this world after getting banned\/kicked “`yaml nopermission: “ —<\/p>\n ## Links & Additional Information<\/p>\n **Author:** WatermanMC<\/p>\n * **GitHub Repository** (Source Code & Full Documentation): https:\/\/github.com\/WatermanMC\/PerWorldPunish Allows per-world punishments such as ban, kick and tempban!<\/p>\n","protected":false},"featured_media":120651,"template":"","meta":{"_minecraft_slug":"perworldpunish","_minecraft_project_id":"fnmiqkxr","_minecraft_author":"WatermanMC8521","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":97,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"perworldpunish.zip","_minecraft_size_bytes":188460,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T19:44:54.356129Z","_minecraft_date_created":"2026-01-25T21:39:28.599378Z","_minecraft_date_modified":"2026-02-25T14:02:38.342895Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/perworldpunish","_minecraft_icon_attachment_id":120651,"_minecraft_imported_at":"2026-06-07T02:23:14+00:00","_minecraft_import_hash":"0ae033b7db6486ef3a58cca35a4427a2","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-120650","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","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
\n|:————————————————–|:————————————-|:——————————|
\n| `\/perworldpunish [info\/reload]` | PerWorldPunish admin command. | `perworldpunish.admin` |
\n| `\/worldban
\n| `\/worldtempban
\n| `\/worldkick
\n| `\/worldunban
\n| `\/worldbanlist` | Ban list of players. | `perworldpunish.worldbanlist` |<\/p>\n
\nDefault configs used on the plugin.<\/p>\nconfig.yml<\/summary>\n
\n# PerWorldPunish – Allows per-world punishments such as ban, kick and tempban!
\n# Support: https:\/\/discord.gg\/Scgqfm5EU4
\n# GitHub Source Code: https:\/\/github.com\/WatermanMC\/PerWorldPunish<\/p>\n
\n# Only supports MiniMessage!
\n# MiniMessage formatter: https:\/\/webui.advntr.dev\/
\ndefault-reason: “
\n# If not set or world is invalid, the plugin will choose your main world, where your datapacks etc. is stored
\nfallback-world: ‘world’
\n“`
\n<\/details>\nmessages.yml<\/summary>\n
\n# All messages used in plugin
\n# Only supports MiniMessage!
\n# MiniMessage formatter: https:\/\/webui.advntr.dev\/<\/p>\n
\npluginReloaded: “
\nplayerPunishImmune: “
\npluginReloadFail: “
\ninvalidPlayer: “
\ninvalidWorld: “
\ninvalidTimeFormat: “
\ntimeNotPositive: “
\nplayerNotBanned: “
\nbanListPrefix: “
\nbanListFormat: “
\nbanListFormat-tempban: “
\nnoBannedPlayers: “
\nbanSuccess: “
\ntempBanSuccess: “
\nkickSuccess: “
\nunBanSuccess: “
\nplayerBanned: “
\nplayerTempBanned: “
\nplayerKicked: “
\nplayerNotInWorld: “
\n“`
\n<\/details>\n
\n* **Documentation:** https:\/\/github.com\/WatermanMC\/PerWorldPunish\/wiki
\n* **Discord Support:** https:\/\/discord.gg\/Scgqfm5EU4<\/p>\n","protected":false},"excerpt":{"rendered":"