JoinRestrictor

🌐 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

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