# PerWorldPunish **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. --- ## Key Features & Why You Should Download It * **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. * **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! * **Customize Plugin Messages:** Customize all PerWorldPunish messages completely on `messages.yml`! Uses MiniMessage so you can have gradients, hex, clickable text and more! * **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 § color codes! MiniMessage formatter: [https://webui.advntr.dev/](https://webui.advntr.dev/) * **Intuitive Commands:** Everything the server admin needs is covered by small, easy to remember commands set **with tab complete**. * **Modern Server Support:** Built specifically for the latest **PaperMC 1.21+** versions and its forks, guaranteeing up-to-date performance and stability. * **Open Source:** Developed under the **GNU General Public License v3.0**, allowing for transparency and community contributions. --- ## Commands & Usage **(<> is required, [] is optional):**
*NOTE: It shows command usage if you typed the command without any arguments.*
[reason] argument supports MiniMessage! MiniMessage Formatter: [https://webui.advntr.dev/](https://webui.advntr.dev/) | Command | Description | Permission | |:--------------------------------------------------|:-------------------------------------|:------------------------------| | `/perworldpunish [info/reload]` | PerWorldPunish admin command. | `perworldpunish.admin` | | `/worldban [reason]` | Ban a player in a world. | `perworldpunish.worldban` | | `/worldtempban [reason]` | Temporarily ban a player in a world. | `perworldpunish.worldtempban` | | `/worldkick [reason]` | Kick a player in a world. | `perworldpunish.worldkick` | | `/worldunban ` | Unban a player in a world. | `perworldpunish.worldunban` | | `/worldbanlist` | Ban list of players. | `perworldpunish.worldbanlist` | --- ## Default Configs Default configs used on the plugin.

config.yml

```yaml # PerWorldPunish - Allows per-world punishments such as ban, kick and tempban! # Support: https://discord.gg/Scgqfm5EU4 # GitHub Source Code: https://github.com/WatermanMC/PerWorldPunish # This will show if there is no reason provided for ban/kick/tempban # Only supports MiniMessage! # MiniMessage formatter: https://webui.advntr.dev/ default-reason: "No reason provided." # The player will get teleported in this world after getting banned/kicked # If not set or world is invalid, the plugin will choose your main world, where your datapacks etc. is stored fallback-world: 'world' ```

messages.yml

```yaml # All messages used in plugin # Only supports MiniMessage! # MiniMessage formatter: https://webui.advntr.dev/ nopermission: "You don't have permission to do that!" pluginReloaded: "Plugin reloaded!" playerPunishImmune: "You can't punish {player}" pluginReloadFail: "Plugin reload failed. Check console for errors." invalidPlayer: "Player not found." invalidWorld: "World not found." invalidTimeFormat: "Invalid time format." timeNotPositive: "Time must be positive." playerNotBanned: "That player is not banned in {world}." banListPrefix: "Banned players:" banListFormat: "{player} is banned on {world}" banListFormat-tempban: "{player} is banned on {world} for {time} minutes" noBannedPlayers: "There's no banned players." banSuccess: "Successfully banned {player} on {world}. Reason : {reason}" tempBanSuccess: "Successfully banned {player} on {world} for {time} minutes. Reason : {reason}" kickSuccess: "Successfully kicked {player} from {world}. Reason : {reason}" unBanSuccess: "Successfully unbanned {player} from {world}" playerBanned: "You are banned on {world}! Reason: {reason}" playerTempBanned: "You are temporarily banned on {world} for {time} minutes! Reason: {reason}" playerKicked: "You got kicked from {world}. Reason: {reason}" playerNotInWorld: "That player is not in {world}." ```

--- ## Links & Additional Information **Author:** WatermanMC * **GitHub Repository** (Source Code & Full Documentation): [https://github.com/WatermanMC/PerWorldPunish](https://github.com/WatermanMC/PerWorldPunish) * **Documentation:** [https://github.com/WatermanMC/PerWorldPunish/wiki](https://github.com/WatermanMC/PerWorldPunish/wiki) * **Discord Support:** [https://discord.gg/Scgqfm5EU4](https://discord.gg/Scgqfm5EU4)

Published on	January 28, 2026
Downloads	3

PerWorldPunish

Release 1.0.1

WatermanMC released PerWorldPunish version 1.0.1 on January 28, 2026

Information

Platforms

Release
1.0.1