PermsCraft

PermsCraft is a modern, high-performance permissions plugin for Minecraft servers, built for admins who need more than basic group management — contextual permissions, temporary ranks, multi-server sync, and a full REST API for external tools.

Unlike plugins that bolt these features on as an afterthought, PermsCraft was designed around them from the start, while keeping the day-to-day commands simple enough that you don't need a wiki open just to create a group.

📦 Installation Guide

Drop the PermsCraft jar into your plugins folder and restart your server. On first boot, run /pc setup from console to bootstrap your first admin. PermsCraft works out of the box with the built-in storage, but supports MySQL, SQLite, and Redis network sync if you're running a proxy network — configure this in config.yml before your first restart if you plan to use it.

Not sure if it installed correctly? Run /pc info in-game or console — it'll print your active storage backend, loaded contexts, and plugin version.

Migrating from another plugin? Use /pc migrate <plugin> to import your existing groups, users, and permissions automatically.

✅ Compatibility

PermsCraft supports Paper, Spigot, Purpur, and Folia on Minecraft 1.21.x. Softdepends on Vault and PlaceholderAPI are optional — the plugin runs fine without them, but enabling them unlocks economy-based contexts and placeholders respectively.

🧩 Features

• Tracks — Create rank progression tracks, promote and demote players through them with a single command
• Groups — Create, edit, and delete groups with permissions, prefix, suffix, weight, and inheritance
• Contextual Permissions — Scope permissions to world, gamemode, time of day, playtime, or economy balance
• Grant Permission GUI — Grant or revoke permissions to any player, group, or track directly from an in-game menu
• REST API — Generate scoped API keys for external tools and integrations
• Recent Log — View recent permission changes, color-coded by action type
• Backup & Restore — Export and import all data as YAML at any time
• Users — Edit player permissions and groups, set personal prefix/suffix, promote or demote on tracks

🔧 Configuration

Most servers won't need to touch config.yml beyond picking a storage backend. Context calculators (world, gamemode, time of day, playtime, economy) can be toggled individually if you only want a subset active.

🐛 How to Report Issues

Please use the issue tracker linked at the top of the page to report bugs. Include your server version, other installed plugins, and relevant console errors or logs — this makes it much faster to track down what's going on.

Note: PermsCraft is actively developed. Some REST API endpoints are still in beta — check the wiki for current stability status before relying on them in production.