PerWorldPunish
Allows per-world punishments such as ban, kick and tempban!
97
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
PerWorldPunish
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
* GNU General Public License v3.0 Easily ban/kick/tempban your players per-world! Perfect for server admins who don't want to ban their players on whole server. * GNU General Public License v3.0 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! * GNU General Public License v3.0 Customize all PerWorldPunish messages completely on `messages.yml`! Uses MiniMessage so you can have gradients, hex, clickable text and more! * GNU General Public License v3.0 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: GNU General Public License v3.0 * GNU General Public License v3.0 Everything the server admin needs is covered by small, easy to remember commands set GNU General Public License v3.0. * GNU General Public License v3.0 Built specifically for the latest GNU General Public License v3.0 versions and its forks, guaranteeing up-to-date performance and stability. * GNU General Public License v3.0 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: (<> is required, [] is optional):
| Command | Description | Permission | |:--------------------------------------------------|:-------------------------------------|:------------------------------| | `/perworldpunish [info/reload]` | PerWorldPunish admin command. | `perworldpunish.admin` | | `/worldban <player> [reason]` | Ban a player in a world. | `perworldpunish.worldban` | | `/worldtempban <player> <timeInMinutes> [reason]` | Temporarily ban a player in a world. | `perworldpunish.worldtempban` | | `/worldkick <player> [reason]` | Kick a player in a world. | `perworldpunish.worldkick` | | `/worldunban <player>` | 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: "<red>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: "<red>You don't have permission to do that!" pluginReloaded: "<green>Plugin reloaded!" playerPunishImmune: "<red>You can't punish <reset>{player}" pluginReloadFail: "<red>Plugin reload failed. Check console for errors." invalidPlayer: "<red>Player not found." invalidWorld: "<red>World not found." invalidTimeFormat: "<red>Invalid time format." timeNotPositive: "<red>Time must be positive." playerNotBanned: "<red>That player is not banned in <gray>{world}<red>." banListPrefix: "<gray>Banned players:" banListFormat: "<reset>{player} <gray>is banned on <yellow>{world}" banListFormat-tempban: "<reset>{player} <gray>is banned on <yellow>{world} <gray>for <gray>{time} <gray>minutes" noBannedPlayers: "<gray>There's no banned players." banSuccess: "<green>Successfully banned <reset>{player} <green>on <yellow>{world}<gray>. Reason <reset>: {reason}" tempBanSuccess: "<green>Successfully banned <reset>{player} <green>on <yellow>{world} <green>for <yellow>{time} <green>minutes<gray>. Reason <reset>: {reason}" kickSuccess: "<green>Successfully kicked <reset>{player} <green>from <yellow>{world}<gray>. Reason <reset>: {reason}" unBanSuccess: "<green>Successfully unbanned <reset>{player} <green>from <yellow>{world}" playerBanned: "<red>You are banned on <yellow>{world}<red>! <gray>Reason: <reset>{reason}" playerTempBanned: "<red>You are temporarily banned on <yellow>{world}<red> for <yellow>{time} <red>minutes! <gray>Reason: <reset>{reason}" playerKicked: "<gray>You got kicked from <yellow>{world}<gray>. Reason: <reset>{reason}" playerNotInWorld: "<gray>That player is not in <yellow>{world}<gray>." ```
---
Links & Additional Information
Author: WatermanMC
* Discord Support: (Source Code & Full Documentation): Discord Support: * Discord Support: %%MD1%% * Discord Support: %%MD2%%
