[{"data":1,"prerenderedAt":32},["ShallowReactive",2],{"doc-en-install-luckperms-ranks-minecraft":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":22,"docGroup":29,"docGroupIcon":29,"link_fr":30,"bodyHtml":31},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-luckperms-ranks-minecraft","install-luckperms-ranks-minecraft","How to Install LuckPerms and Create Ranks on a Minecraft Server","Install LuckPerms on your Winheberg Paper Minecraft server from the panel Plugins tool, create ranks with prefixes, add your players and manage everything with the web editor.","jeux","minecraft-java","tabler:file-text","2026-11-01","Winheberg",121,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-luckperms-ranks-minecraft.webp",[16,17,18,19,20,21],"minecraft","luckperms","permissions","ranks","plugin","gaming panel",[17,23,24,25,26,27,28],"minecraft ranks","minecraft permissions","luckperms plugin","minecraft prefix","paper server","lp editor","","\u002Fdocs\u002Fminecraft-java\u002Finstaller-luckperms-grades-minecraft","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>On a Minecraft server, giving operator status to every moderator hands them every command in the game. \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fluckperms.net\u002F\">LuckPerms\u003C\u002Fa>\u003C\u002Fstrong> solves this by letting you create ranks (VIP, moderator, admin...) that only grant the permissions you choose. A player inherits the rights of their rank, a rank can inherit from another one, and a prefix can be shown in front of the player name.\u003C\u002Fp>\n\u003Cp>This guide explains how to install LuckPerms on your Winheberg Minecraft Java server from the panel, give yourself admin rights, create your first ranks and add players to them, either with commands or with the web editor.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>A \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fgaming\u002Fminecraft\">Winheberg Minecraft Java server\u003C\u002Fa> running Paper, Spigot or Purpur\u003C\u002Fli>\n\u003Cli>Access to the \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\u002F\">Winheberg panel\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>The exact username of each player you want to add to a rank (each one must have joined the server at least once)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>In the panel console, type commands without a leading \u003Ccode>\u002F\u003C\u002Fcode>. In game, add the \u003Ccode>\u002F\u003C\u002Fcode> (for example \u003Ccode>\u002Flp user PlayerName info\u003C\u002Fcode>).\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Install LuckPerms from the panel\u003C\u002Fh2>\n\u003Cp>Log in to the Winheberg panel, select your server and open \u003Cstrong>Plugins\u003C\u002Fstrong> in the side menu. Before searching, set \u003Cstrong>Plugin loader\u003C\u002Fstrong> to \u003Cstrong>Paper\u003C\u002Fstrong> (or to your server software), then type \u003Ccode>LuckPerms\u003C\u002Fcode> in \u003Cstrong>Search query\u003C\u002Fstrong>. Click the download icon on the right of the \u003Cstrong>LuckPerms\u003C\u002Fstrong> result.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-luckperms-ranks-minecraft-1793568024463-50112b07408b652c19f27af0.webp\" alt=\"Searching for LuckPerms in the Plugins tool of the Winheberg panel with the Paper filter\" width=\"800\" \u002F>\n\n\u003Cp>In the \u003Cstrong>Install plugin\u003C\u002Fstrong> window, check that the \u003Cstrong>Plugin version\u003C\u002Fstrong> menu shows a version ending in \u003Cstrong>(Bukkit)\u003C\u002Fstrong>, then click \u003Cstrong>Install plugin\u003C\u002Fstrong>. The \u003Ccode>LuckPerms-Bukkit\u003C\u002Fcode> file is placed in your server&#39;s \u003Ccode>plugins\u003C\u002Fcode> folder.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-luckperms-ranks-minecraft-1793568025726-fb3b8d8c8b644ab84999c5f3.webp\" alt=\"Install plugin window with the Bukkit version of LuckPerms selected\" width=\"544\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Without the \u003Cstrong>Plugin loader\u003C\u002Fstrong> filter, the panel first offers the Velocity version of LuckPerms, which is meant for proxies. It does not run on a Paper server. If the version name ends in \u003Cstrong>(Velocity)\u003C\u002Fstrong> or \u003Cstrong>(BungeeCord)\u003C\u002Fstrong>, pick the \u003Cstrong>(Bukkit)\u003C\u002Fstrong> line in the list.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Then open \u003Cstrong>Console\u003C\u002Fstrong> and click \u003Cstrong>Restart\u003C\u002Fstrong>. On startup, the console confirms it loaded with the line \u003Ccode>[LuckPerms] Successfully enabled\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>2. Give yourself admin rights\u003C\u002Fh2>\n\u003Cp>Right after installation, nobody can use LuckPerms commands except the console and operators. From the panel console, give yourself full access to the plugin, replacing \u003Ccode>YourName\u003C\u002Fcode> with your Minecraft username.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">lp user YourName permission set luckperms.* true\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>You can now use \u003Ccode>\u002Flp\u003C\u002Fcode> in game, even without being an operator.\u003C\u002Fp>\n\u003Ch2>3. Create your ranks\u003C\u002Fh2>\n\u003Cp>In this example, we create a \u003Ccode>vip\u003C\u002Fcode> rank and a \u003Ccode>moderateur\u003C\u002Fcode> rank that inherits every permission of the VIP rank. Type these commands in the console, one per line.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">lp creategroup vip\nlp creategroup moderateur\nlp group moderateur parent add vip\nlp group moderateur permission set minecraft.command.kick true\nlp group moderateur meta setprefix 20 &quot;&amp;9[Modo] &quot;\nlp group moderateur setweight 20\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Each command is confirmed by an \u003Ccode>[LP]\u003C\u002Fcode> line in the console.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-luckperms-ranks-minecraft-1793568108682-85e6423fc1c04f84486502f3.webp\" alt=\"Winheberg panel console after creating the vip and moderateur groups with LuckPerms\" width=\"752\" \u002F>\n\n\u003Cdiv class=\"md-table md-table--info md-table--striped\">\u003Cdiv class=\"md-table__caption\">What each command does\u003C\u002Fdiv>\u003Cdiv class=\"md-table__scroll\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Command\u003C\u002Fth>\n\u003Cth>Effect\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>lp creategroup &lt;rank&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Creates a new rank\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>lp group &lt;rank&gt; parent add &lt;other rank&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The rank inherits the permissions of the other rank\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>lp group &lt;rank&gt; permission set &lt;permission&gt; true\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Grants a permission to the rank (\u003Ccode>false\u003C\u002Fcode> denies it)\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>lp group &lt;rank&gt; meta setprefix &lt;priority&gt; &quot;&lt;prefix&gt;&quot;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Sets the prefix shown in front of the player name\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>lp group &lt;rank&gt; setweight &lt;weight&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Gives the rank a weight, the highest one wins in case of conflict\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Permission names are listed on each plugin&#39;s page, for example \u003Ccode>essentials.fly\u003C\u002Fcode> for EssentialsX. The \u003Ccode>*\u003C\u002Fcode> wildcard covers every permission of a plugin, such as \u003Ccode>essentials.*\u003C\u002Fcode>. Leave large gaps between weights (10, 20, 100...) so you can slot in a new rank later.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>Every player belongs to the \u003Ccode>default\u003C\u002Fcode> rank, which LuckPerms creates automatically. This rank cannot be deleted and holds the basic permissions everyone gets.\u003C\u002Fp>\n\u003Ch2>4. Add a player to a rank\u003C\u002Fh2>\n\u003Cp>The player must have joined the server at least once. Add them to the rank you want, then check the result.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">lp user PlayerName parent add moderateur\nlp user PlayerName info\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The \u003Ccode>parent add\u003C\u002Fcode> command adds the rank without removing the others. To replace all of their ranks with a single one, use \u003Ccode>lp user PlayerName parent set moderateur\u003C\u002Fcode>. To remove a rank, use \u003Ccode>lp user PlayerName parent remove moderateur\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-warning\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M10.29 3.86L1.82 18a2 2 0 0 0 1.71 3h16.94a2 2 0 0 0 1.71-3L13.71 3.86a2 2 0 0 0-3.42 0z\"\u002F>\u003Cline x1=\"12\" y1=\"9\" x2=\"12\" y2=\"13\"\u002F>\u003Cline x1=\"12\" y1=\"17\" x2=\"12.01\" y2=\"17\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The \u003Ccode>parent set\u003C\u002Fcode> command also removes the \u003Ccode>default\u003C\u002Fcode> rank. To make sure the player keeps the basic permissions, make your ranks inherit \u003Ccode>default\u003C\u002Fcode>, for example with \u003Ccode>lp group vip parent add default\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>LuckPerms does not show the prefix in chat by itself. To show it, add \u003Cstrong>Vault\u003C\u002Fstrong> and a chat formatting plugin that reads prefixes, such as \u003Cstrong>EssentialsX Chat\u003C\u002Fstrong>. See our guide \u003Cstrong>\u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fminecraft-java\u002Finstall-use-essentialsx-minecraft\">How to install and configure EssentialsX on a Minecraft server\u003C\u002Fa>\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>5. Manage ranks with the web editor\u003C\u002Fh2>\n\u003Cp>If you would rather click than type commands, LuckPerms offers an editor in your browser. Type the following command in the console.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">lp editor\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The console shows a link to \u003Ccode>luckperms.net\u002Feditor\u002F...\u003C\u002Fcode>. Open it, then select a rank under \u003Cstrong>Groups\u003C\u002Fstrong> to view and change its permissions, weight and parent ranks. The screenshots below show the editor in French, but the buttons are in the same place in English.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-luckperms-ranks-minecraft-1793568193269-6b31dc72518aaa6d06668d41.webp\" alt=\"LuckPerms web editor open on the moderateur group with its permissions\" width=\"800\" \u002F>\n\n\u003Cp>Once you are done, click \u003Cstrong>Save\u003C\u002Fstrong> in the top right corner. The editor generates an \u003Ccode>lp applyedits\u003C\u002Fcode> command followed by a code. Copy it and paste it into the panel console to apply your changes.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Finstall-luckperms-ranks-minecraft-1793568273153-ef34bc03d01f19ca9e30e603.webp\" alt=\"lp applyedits command generated by the LuckPerms web editor after saving\" width=\"546\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>When it opens, the editor may show a window suggesting an \u003Ccode>lp trusteditor\u003C\u002Fcode> command to apply changes live. This step is optional, so you can close the window and use the \u003Cstrong>Save\u003C\u002Fstrong> button instead. After an \u003Ccode>applyedits\u003C\u002Fcode>, run \u003Ccode>lp editor\u003C\u002Fcode> again to get a fresh link before you continue.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Ch3>❌ The console replies &quot;A user for ... could not be found&quot;\u003C\u002Fh3>\n\u003Cpre>\u003Ccode class=\"language-text\">[LP] A user for PlayerName could not be found.\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cul>\n\u003Cli>Check the spelling of the username (capital letters do not matter)\u003C\u002Fli>\n\u003Cli>Ask the player to join the server once, since LuckPerms only knows players who have already connected\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ A player cannot use a command despite their rank\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check they are in the rank with \u003Ccode>lp user PlayerName info\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Test the permission with \u003Ccode>lp user PlayerName permission check &lt;permission&gt;\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>To find which permission a command needs, type \u003Ccode>lp verbose on\u003C\u002Fcode>, have the player run the command, then \u003Ccode>lp verbose off\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Make sure LuckPerms is the only permissions plugin installed on the server\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The \u002Flp command only shows the plugin version\u003C\u002Fh3>\n\u003Cp>If \u003Ccode>\u002Flp\u003C\u002Fcode> only shows the plugin version, you have no LuckPerms permission. Go back to step 2 from the panel console.\u003C\u002Fp>\n\u003Ch3>❌ The prefix does not show in chat\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Install \u003Cstrong>Vault\u003C\u002Fstrong> and a compatible chat plugin, such as EssentialsX Chat\u003C\u002Fli>\n\u003Cli>Check with \u003Ccode>lp user PlayerName meta info\u003C\u002Fcode> that the player does not inherit another prefix with a higher priority (the number given in \u003Ccode>meta setprefix\u003C\u002Fcode>)\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Avoid giving operator\u003C\u002Fstrong> to your staff, use a rank with only the permissions they need instead\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Chain your ranks\u003C\u002Fstrong> with \u003Ccode>parent add\u003C\u002Fcode> (player, VIP, moderator, admin), so each rank only adds its own permissions\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Test with a non-operator account\u003C\u002Fstrong> to see exactly what a player can do\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Back up before a big change\u003C\u002Fstrong> from the \u003Cstrong>Backups\u003C\u002Fstrong> tab, LuckPerms stores its data in the \u003Ccode>plugins\u002FLuckPerms\u003C\u002Fcode> folder\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Keep a single permissions plugin\u003C\u002Fstrong>, as two plugins of this kind on the same server conflict with each other\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If your ranks do not behave as expected, our team can help. Open a ticket in the \u003Cstrong>Technical\u003C\u002Fstrong> department from your client area, fill in the \u003Cstrong>Related Product\u003C\u002Fstrong> field with the server in question, and include the commands you used along with the message shown in the console.\u003C\u002Fp>\n\u003Cp>Your Minecraft server now has clean, well-organised ranks 🎮\u003C\u002Fp>\n",1794526353456]