Перейти к содержимому
Mineforgian

PerWorldPunish

Allows per-world punishments such as ban, kick and tempban!

Загрузки
141
Подписчики
2
Обновлён
25 февраля 2026 г.
Лицензия
GPL-3.0-only

Опубликован 23 января 2026 г.

Исходный код

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/
  • 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/

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
# 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
# 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

Ченджлог

1.2.3Релиз26.1, 26.1.1, 26.1.2 · 25 февраля 2026 г.
  • Code cleanup & optimization.
  • Removed getConfigManager() getter on main class. All classes now use direct configManager instead of getConfigManager().
1.2.2Релиз1.21.9, 1.21.10, 1.21.11 · 24 февраля 2026 г.

Fixed Listener-related error on startup.

1.2.1Релиз1.21.9, 1.21.10, 1.21.11 · 22 февраля 2026 г.

Fixed NullPointerException error.

1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 16 февраля 2026 г.
  • Added @NotNull and @Nullable annotations.
  • getConfig() method from ConfigManager is now used for getting config.yml keys instead of Bukkit's internal plugin.getPluginConfig().
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 14 февраля 2026 г.

Changelogs:

Added tab complete to commands.

1.0.1Релиз1.21.9, 1.21.10, 1.21.11 · 28 января 2026 г.

Added return true; to prevent the code from continuing to another statement.

Комментарии

Загружаем…