JoinRestrictor

Minecraft 版本： 1.17 1.17.1 1.18 1.18.1 1.18.2 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper spigot

标签： game-mechanics management utility

🌐 JoinRestrictor

Restrict who can join your Minecraft server by requiring a specific permission.
Great for permission‑whitelisting, staff-only test servers, or overflow/full‑server routing with permission‑based exceptions.

Features

• 🔒 Permission‑gated joins — only players with the configured permission may join.
• 🧰 Fully configurable kick message, permission node, and logging.
• 🔁 Hot reload via /joinrestrictor reload.

• 🧪 Lightweight & zero‑DB — no stored data, only event handling.

  Requirements

• Paper (1.17+)
• Java 16+

• LuckPerms (or any permissions plugin)

  Installation

1. Place the plugin jar in the plugins folder.
2. Start the server to generate the config.
3. Edit plugins/JoinRestrictor/config.yml if desired.

4. Grant the join permission to allowed players/groups.

   Configuration (config.yml)

   kick-message: "&cYou do not have permission to join this server."
   log-denied-joins: true
   required-permission: "essentials.joinfullserver"

   ---

   Notes

• Color codes supported (&c, &l, etc)

• Change required-permission to whatever node matches your permission structure

  Commands

  Command	Description	Permission
  /joinrestrictor reload	Reload the plugin config	joinrestrictor.reload

Permissions

Examples

Allow only staff:
Set required-permission: "server.staff" and grant that to your staff group.

VIP testing server:
Set required-permission: "server.vip" and grant to VIP donors.

Maintenance Mode:
Set permission to something only admins have during maintenance.

Troubleshooting

• If all players are kicked → Ensure the required join permission is granted.
• If color codes show as &c → Use & formatting, it is supported.
• If reload doesn't work → Ensure you have joinrestrictor.reload permission.

🧑‍💻 Author

• Zenologia
• GitHub Repository
• License