--- title: "How to set up LuckPerms on a Minecraft server (Paper) | StreetHosting" description: "LuckPerms tutorial for Paper: installation, groups, prefixes, weights, inheritance, essential commands, VIP store integration and staff best practices." url: "https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup" type: "page" language: "en-US" --- Minecraft · 5 min · Intermediate Published on Jun 11, 2026 · Updated on Jun 11, 2026 # How to set up LuckPerms on a Minecraft server LuckPerms is the standard permissions plugin on Paper servers. This guide covers installation, group hierarchy, tab prefixes, safe inheritance and an audit routine before you open a public whitelist. By [Equipe StreetHosting](https://streethosting.com.br/en/autores#equipe-streethosting) · StreetHosting infrastructure and support team [Minecraft plugins](https://streethosting.com.br/en/guides/topics/plugins) [Paper, Spigot and proxies](https://streethosting.com.br/en/guides/topics/server-software) [Community and game modes](https://streethosting.com.br/en/guides/topics/community) Summarize with: [](https://chat.openai.com/?q=Summarize%20the%20key%20points%20of%20this%20StreetHosting%20guide%3A%20https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup.%20Highlight%20the%20step-by-step%20instructions%2C%20the%20prerequisites%20and%20the%20most%20common%20mistakes. "ChatGPT") [](https://claude.ai/new?q=Summarize%20the%20key%20points%20of%20this%20StreetHosting%20guide%3A%20https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup.%20Highlight%20the%20step-by-step%20instructions%2C%20the%20prerequisites%20and%20the%20most%20common%20mistakes. "Claude") [](https://www.google.com/search?udm=50&aep=11&q=Summarize%20the%20key%20points%20of%20this%20StreetHosting%20guide%3A%20https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup.%20Highlight%20the%20step-by-step%20instructions%2C%20the%20prerequisites%20and%20the%20most%20common%20mistakes. "Google AI Mode") [](https://x.com/i/grok?text=Summarize%20the%20key%20points%20of%20this%20StreetHosting%20guide%3A%20https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup.%20Highlight%20the%20step-by-step%20instructions%2C%20the%20prerequisites%20and%20the%20most%20common%20mistakes. "Grok") [](https://www.perplexity.ai/search/new?q=Summarize%20the%20key%20points%20of%20this%20StreetHosting%20guide%3A%20https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup.%20Highlight%20the%20step-by-step%20instructions%2C%20the%20prerequisites%20and%20the%20most%20common%20mistakes. "Perplexity") Share: [](https://x.com/intent/tweet?text=How%20to%20set%20up%20LuckPerms%20on%20a%20Minecraft%20server%20%28Paper%29&url=https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup "Share on X") [](https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup "Share on Facebook") [](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup "Share on LinkedIn") [](https://wa.me/?text=How%20to%20set%20up%20LuckPerms%20on%20a%20Minecraft%20server%20%28Paper%29%20https%3A%2F%2Fstreethosting.com.br%2Fen%2Fguides%2Fminecraft%2Fluckperms-minecraft-setup "Share on WhatsApp") For agents: Copy as Markdown [.md](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup.md) In this guide 5 sections * [Installation and storage](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#instalacao-e-storage) * [Groups, weights and inheritance](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#grupos-pesos-e-heranca) * [Prefixes, tab and chat](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#prefixos-tab-e-chat) * [Everyday commands](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#comandos-do-dia-a-dia) * [VIP store and auditing](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#loja-vip-e-auditoria) Quick answer To **set up LuckPerms** on a Paper server: (1) install a compatible jar and pick MySQL storage in production; (2) create the groups `default`, `helper`, `mod`, `admin` with increasing weights; (3) use inheritance instead of duplicating permissions; (4) define prefixes for tab and chat; (5) audit staff parents every month. Never give a junior moderator the `luckperms.*` wildcard. ## Installation and storage[](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#instalacao-e-storage) Download the stable LuckPerms version that matches your Paper build. Drop the jar into `plugins/`, start the server and wait for the log to confirm it loaded. On the first run, LuckPerms creates its config in `plugins/LuckPerms/` and implicitly asks which backend to use through `config.yml`. 1. Stop the server before editing storage in production. 2. For testing: built-in H2 storage, no external config, and backups by copying the plugin folder. 3. For a real community: MySQL with a dedicated credential, utf8mb4 charset and a daily backup alongside the world. 4. Restart and run `/lp info` to validate the connection. If you are still getting the server up, follow the logical order in [how to create a Minecraft server](https://streethosting.com.br/en/guides/minecraft/how-to-create-a-minecraft-server). Install LuckPerms before land protection and economy plugins: they register hundreds of nodes on first boot. Host it on a plan with automatic backups, like [Minecraft Pro](https://streethosting.com.br/en/minecraft-pro): a corrupted LuckPerms database with no snapshot turns into a nightmare of random permissions for hundreds of players. ## Groups, weights and inheritance[](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#grupos-pesos-e-heranca) The mental model: groups are ranks, weight resolves prefix conflicts, and inheritance imports permissions from the bottom up. A healthy minimum structure separates player, junior staff, senior staff and the technical owner. | Group | Suggested weight | Inherits from | | ------- | ---------------- | ------------- | | default | 10 | none | | vip | 20 | default | | helper | 30 | default | | mod | 40 | helper | | admin | 50 | mod | | owner | 100 | admin | Example commands, run in the console or in game with the right permission: * `lp creategroup helper` creates an empty group. * `lp group helper setweight 30` sets visual precedence. * `lp group helper parent add default` inherits the base permissions. * `lp group mod parent add helper` avoids duplicating nodes. Avoid `lp group helper permission set * true`. A wildcard destroys isolation and is the number one reason a malicious staff member can wreck an entire economy in one afternoon. ### Tracks for progression Tracks chain groups into a ladder: a player moves from vip to vip\_plus without you manually removing the old parent. They are useful for season passes and grind systems. Document the track in the staff's internal wiki so nobody promotes the wrong rank during an event. ## Prefixes, tab and chat[](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#prefixos-tab-e-chat) Meta prefix and suffix define how names look in chat and in the tab list when integrated through PlaceholderAPI. A conceptual example: the vip group gets a meta prefix with a color and a short tag; the mod group gets a distinct prefix so players can spot staff instantly. 1. Install PlaceholderAPI if your tab or chat plugin requires dynamic placeholders. 2. Define the meta: `lp group vip meta setprefix 20 "&a[VIP] "` adjusting the prefix weight. 3. Configure the tab plugin to read `%luckperms_prefix%` or the documented equivalent. 4. Log in with a test account in each group and check color and order. The vanilla whitelist and operators coexist with LuckPerms, but they do not replace fine-grained control. Read [setting up the whitelist and ops](https://streethosting.com.br/en/guides/minecraft/minecraft-whitelist-setup) for the access layer before players join. A list of plugins that depend on permissions is in [the most used plugins](https://streethosting.com.br/en/guides/minecraft/best-minecraft-plugins). ## Everyday commands[](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#comandos-do-dia-a-dia) Staff need a short cheat sheet, not a three-hundred-page manual. The commands below cover eighty percent of the operations on an average Brazilian survival or hub server. | Situation | Example command | Note | | ----------------------- | -------------------------------------------- | ---------------------------------- | | Promote a player to mod | lp user NICK parent add mod | Use the exact nick or the UUID | | 30-day temporary VIP | lp user NICK parent addtemp vip 30d | Test the expiry with an alt | | Remove a rank | lp user NICK parent remove vip | Does not delete direct permissions | | One-off permission | lp user NICK permission set plugin.node true | Prefer a group when it repeats | | Web editor | lp editor | Generates a secure temporary link | | Export LP backup | lp export file backup.json | Store it off site every week | * `/lp user NICK info` shows parents and effective permissions. * `/lp group mod listmembers` audits active staff. * `/lp verbose user NICK` debugs a denied node in real time. Create an internal Discord channel with only the commands the owner has approved. Standardizing stops a helper from inventing a wildcard in a rush to close a ticket. ## VIP store and auditing[](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#loja-vip-e-auditoria) Healthy monetization depends on LuckPerms groups that mirror the store packages. The full guide is in [monetizing a Minecraft server](https://streethosting.com.br/en/guides/minecraft/monetize-minecraft-server). The Tebex webhook should run `lp user {uuid} parent add vip` or a temporary variant identical to the group you configured by hand. * Identical group names across LP, tab and the store. * Test a real purchase before announcing the VIP. * Monthly audit: lp listgroups and the members of admin. * Remove the parent of former staff on the day they leave. * Export the LuckPerms JSON before a season wipe. A stable server reduces corrupted-database incidents. For small projects, [Minecraft Fácil](https://streethosting.com.br/en/minecraft-facil) is enough; networks with a Velocity proxy and several backend servers may need a [Ryzen VPS](https://streethosting.com.br/en/vps/ryzen) or a [dedicated server](https://streethosting.com.br/en/dedicated). Modpacks use the [modpack line](https://streethosting.com.br/en/minecraft-modpack); for Bedrock, see [Minecraft Bedrock](https://streethosting.com.br/en/minecraft-bedrock). Connect purchase alerts to a [Discord bot](https://streethosting.com.br/en/bots) and explore StreetHosting's [Minecraft hosting](https://streethosting.com.br/en/minecraft). LuckPerms done right on day zero prevents endless tickets about protected land and kits that never arrive: clear permissions are part of the player experience. In this guide * [Installation and storage](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#instalacao-e-storage) * [Groups, weights and inheritance](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#grupos-pesos-e-heranca) * [Prefixes, tab and chat](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#prefixos-tab-e-chat) * [Everyday commands](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#comandos-do-dia-a-dia) * [VIP store and auditing](https://streethosting.com.br/en/guides/minecraft/luckperms-minecraft-setup#loja-vip-e-auditoria) ## Frequently asked questions Does LuckPerms work on Paper and Purpur? Yes. LuckPerms supports Bukkit and Paper forks, plus Fabric and Forge in specific setups. For Java servers running traditional plugins, Paper is the most common scenario and is fully compatible. H2 or MySQL for LuckPerms? H2 is enough for local testing or a disposable world. A production server with staff, a VIP store and dozens of plugins should use MySQL or MariaDB with automated backups, especially if you restart the instance often. How do I give someone a 30-day temporary VIP? Use a temporary permission or parent with LuckPerms expiry syntax, for example parent add vip for a set duration. A Tebex store usually sends the equivalent command through its webhook; test the expiry with a secondary account before you sell. The prefix does not show in the tab list: what should I check? Confirm that your tab plugin is integrated with PlaceholderAPI, the luckperms prefix placeholder, the plugin load order and whether the player has a parent with a meta prefix defined. Restart the tab plugin after changing meta and clear the client cache if needed. Next step Create a Minecraft server Simple plans for beginners, with activation within 60 seconds, Anti-DDoS and support in Portuguese. [Create a Minecraft server](https://streethosting.com.br/en/minecraft-facil) [See Minecraft Pro Managed hosting on Ryzen with modpacks, optimized Paper and technical support.](https://streethosting.com.br/en/minecraft-pro) [Modpack hosting Forge and Fabric with RAM sized for heavy packs and fast activation.](https://streethosting.com.br/en/minecraft-modpack) [Minecraft plans Compare Minecraft hosting options in Brazil.](https://streethosting.com.br/en/minecraft) [Minecraft Bedrock A stable Bedrock server in Brazil for friends, Realms alternatives and crossplay.](https://streethosting.com.br/en/minecraft-bedrock) ## Related guides [Minecraft Beginner How to create a Minecraft server from scratch (step by step) This guide lays out server creation in a logical order: picking the right resources, launching the jar, accepting the EULA, pointing a domain, setting up the world and inviting players safely. 6 min Read guide](https://streethosting.com.br/en/guides/minecraft/how-to-create-a-minecraft-server) [Minecraft Beginner How to set up a whitelist and ops on a Minecraft server The whitelist and ops are two simple layers for controlling who can join and who can administer the server. This guide shows a safe workflow for beginners. 2 min Read guide](https://streethosting.com.br/en/guides/minecraft/minecraft-whitelist-setup) [Minecraft Beginner Best Minecraft plugins for Paper servers: a practical list to start right This guide lists the plugins that show up on almost every serious Paper server: permissions, utilities, economy, world editing, auditing and placeholders. The idea is not to install everything at once, but to know what each jar does before you clutter the server. 5 min Read guide](https://streethosting.com.br/en/guides/minecraft/best-minecraft-plugins) [← Back to the Guide Center](https://streethosting.com.br/en/guides)