[{"data":1,"prerenderedAt":33},["ShallowReactive",2],{"doc-en-op-whitelist-minecraft-server":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":21,"docGroup":30,"docGroupIcon":30,"link_fr":31,"bodyHtml":32},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Fop-whitelist-minecraft-server","op-whitelist-minecraft-server","How to Op Yourself and Enable the Whitelist on Your Minecraft Server","Op yourself from the Winheberg panel Console, set operator levels and enable the whitelist on your Minecraft Java server, cracked mode included.","jeux","minecraft-java","tabler:file-text","2026-11-01","Winheberg",106,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Fop-whitelist-minecraft-server.webp",[16,17,18,19,20],"minecraft","op","whitelist","administration","gaming panel",[22,23,24,25,26,27,28,29],"minecraft op","minecraft whitelist","op command","op-permission-level","enforce-whitelist","ops.json","whitelist.json","minecraft java server","","\u002Fdocs\u002Fminecraft-java\u002Fop-whitelist-serveur-minecraft","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>On a Minecraft Java server, operator status (op) unlocks administration commands, such as changing game mode, kicking a player or stopping the server. The whitelist restricts access to a list of approved players, which is handy for a server among friends or a test phase before opening to the public.\u003C\u002Fp>\n\u003Cp>This guide shows you how to op yourself from the Console of the Winheberg gaming panel, set the operator level, then enable and manage the whitelist. It also covers the \u003Ccode>ops.json\u003C\u002Fcode> and \u003Ccode>whitelist.json\u003C\u002Fcode> files, as well as the special case of cracked servers.\u003C\u002Fp>\n\u003Cp>When a player who isn&#39;t on the whitelist tries to join, they get this message.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">You are not white-listed on this server!\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fgaming\u002Fminecraft\">Minecraft Java server\u003C\u002Fa> at Winheberg\u003C\u002Fli>\n\u003Cli>Access to the gaming panel at \u003Ccode>https:\u002F\u002Fpanel.winheberg.com\u002F\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>The exact username of each player involved, with the correct upper and lower case\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>The commands in this guide are the vanilla Minecraft ones. They work the same way on Spigot, Paper or Purpur, but a permissions plugin can add its own rules on top of op status.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Op yourself from the Console\u003C\u002Fh2>\n\u003Cp>Log in to the gaming panel, select your server, then open the \u003Cstrong>Console\u003C\u002Fstrong> tab. The server must be running.\u003C\u002Fp>\n\u003Cp>In the input field at the bottom of the Console, type the following command, replacing \u003Ccode>Steve\u003C\u002Fcode> with your username, then press \u003Ckbd>Enter\u003C\u002Fkbd>.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">op Steve\n\u003C\u002Fcode>\u003C\u002Fpre>\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>In the panel Console, commands are typed without the leading \u003Ccode>\u002F\u003C\u002Fcode>. In game, in the chat, the same command is written \u003Ccode>\u002Fop Steve\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>If everything went well, the Console shows the following confirmation.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">System chat: Made Steve a server operator\n\u003C\u002Fcode>\u003C\u002Fpre>\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>On a Paper server, the Console prefixes command replies with \u003Ccode>System chat:\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>The player doesn&#39;t need to be online when you run the command. Once you&#39;re op, you can use administration commands directly in game, with the \u003Ccode>\u002F\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>2. Remove op status\u003C\u002Fh2>\n\u003Cp>To remove a player&#39;s operator rights, use the \u003Ccode>deop\u003C\u002Fcode> command from the Console.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">deop Steve\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The Console confirms the removal.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-text\">System chat: Made Steve no longer a server operator\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ch2>3. Set the operator level\u003C\u002Fh2>\n\u003Cp>Each op has a permission level, from 1 to 4. The higher the level, the more sensitive the commands the player can use.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Level\u003C\u002Fth>\n\u003Cth>Name\u003C\u002Fth>\n\u003Cth>Main access\u003C\u002Fth>\n\u003Cth>Example commands\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>1\u003C\u002Ftd>\n\u003Ctd>Moderator\u003C\u002Ftd>\n\u003Ctd>Bypass spawn protection\u003C\u002Ftd>\n\u003Ctd>None in particular\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>2\u003C\u002Ftd>\n\u003Ctd>Gamemaster\u003C\u002Ftd>\n\u003Ctd>Gameplay commands and command blocks\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>gamemode\u003C\u002Fcode>, \u003Ccode>tp\u003C\u002Fcode>, \u003Ccode>give\u003C\u002Fcode>, \u003Ccode>time\u003C\u002Fcode>, \u003Ccode>weather\u003C\u002Fcode>, \u003Ccode>difficulty\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>3\u003C\u002Ftd>\n\u003Ctd>Admin\u003C\u002Ftd>\n\u003Ctd>Player management\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>kick\u003C\u002Fcode>, \u003Ccode>ban\u003C\u002Fcode>, \u003Ccode>op\u003C\u002Fcode>, \u003Ccode>deop\u003C\u002Fcode>, \u003Ccode>whitelist\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>4\u003C\u002Ftd>\n\u003Ctd>Owner\u003C\u002Ftd>\n\u003Ctd>All commands, server management\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>stop\u003C\u002Fcode>, \u003Ccode>save-all\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>The level granted by the \u003Ccode>op\u003C\u002Fcode> command is set by the \u003Ccode>op-permission-level\u003C\u002Fcode> property in the \u003Ccode>server.properties\u003C\u002Fcode> file. Its default value is \u003Ccode>4\u003C\u002Fcode>, the highest level.\u003C\u002Fp>\n\u003Cp>To change it, stop the server, open the \u003Cstrong>Files\u003C\u002Fstrong> tab, then click \u003Ccode>server.properties\u003C\u002Fcode>. Find the matching line and enter the level you want.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-properties\">op-permission-level=4\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Fop-whitelist-minecraft-server-1793566229552-636a86cf6108028d7d93b6c0.webp\" alt=\"op-permission-level=4 line highlighted in the server.properties file opened from the Files tab of the Winheberg gaming panel\" width=\"630\" \u002F>\n\n\u003Cp>Save the file with the \u003Cstrong>Save Content\u003C\u002Fstrong> button, then restart the server.\u003C\u002Fp>\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>\u003Ccode>op-permission-level\u003C\u002Fcode> only applies to players opped after the change. Existing operators keep the level stored in \u003Ccode>ops.json\u003C\u002Fcode>. To change their level, run \u003Ccode>deop\u003C\u002Fcode> then \u003Ccode>op\u003C\u002Fcode> again, or edit the file&#39;s \u003Ccode>level\u003C\u002Fcode> field as explained below.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Enable and manage the whitelist\u003C\u002Fh2>\n\u003Cp>All whitelist commands are typed in the \u003Cstrong>Console\u003C\u002Fstrong> tab, without \u003Ccode>\u002F\u003C\u002Fcode>. When used in game, they require op level 3.\u003C\u002Fp>\n\u003Cp>Start by adding the approved players, yourself in particular, then turn the whitelist on.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist add Steve\nwhitelist add Alex\nwhitelist on\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The table below sums up the available commands and the message returned by the Console, without the \u003Ccode>System chat:\u003C\u002Fcode> prefix added by Paper.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Command\u003C\u002Fth>\n\u003Cth>Effect\u003C\u002Fth>\n\u003Cth>Confirmation message\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>whitelist on\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Turns the whitelist on\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Whitelist is now turned on\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>whitelist off\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Turns the whitelist off\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Whitelist is now turned off\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>whitelist add &lt;username&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Adds a player\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Added &lt;username&gt; to the whitelist\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>whitelist remove &lt;username&gt;\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Removes a player\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Removed &lt;username&gt; from the whitelist\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>whitelist list\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Shows the approved players\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>There are X whitelisted player(s)\u003C\u002Fcode> followed by the usernames\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>whitelist reload\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Reads the \u003Ccode>whitelist.json\u003C\u002Fcode> file again\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>Reloaded the whitelist\u003C\u002Fcode>\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>Here is the result in the Console after \u003Ccode>op Steve\u003C\u002Fcode>, \u003Ccode>whitelist add Steve\u003C\u002Fcode> and \u003Ccode>whitelist list\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Fop-whitelist-minecraft-server-1793566163303-eb22776ecb3407383ec91b69.webp\" alt=\"op Steve, whitelist add Steve and whitelist list commands in the Winheberg gaming panel Console with their System chat messages\" width=\"605\" \u002F>\n\n\u003Cp>If the whitelist is already on, \u003Ccode>whitelist on\u003C\u002Fcode> changes nothing and the Console replies \u003Ccode>System chat: Whitelist is already turned on\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp>As with \u003Ccode>op\u003C\u002Fcode>, players don&#39;t need to be online to be added or removed.\u003C\u002Fp>\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>Operators can always join the server while the whitelist is on, even if they aren&#39;t listed in it.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cp>The whitelist state is stored in \u003Ccode>server.properties\u003C\u002Fcode>, on the \u003Ccode>white-list\u003C\u002Fcode> line. The \u003Ccode>whitelist on\u003C\u002Fcode> command sets this value to \u003Ccode>true\u003C\u002Fcode> for you.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-properties\">white-list=true\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-java\u002Fop-whitelist-minecraft-server-1793566229981-df0413982389c5c189fa0aa7.webp\" alt=\"white-list=true line highlighted in the server.properties file of a Minecraft 26.3 server\" width=\"630\" \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>On version 26.3, the \u003Ccode>server.properties\u003C\u002Fcode> file generated when the server is created contains \u003Ccode>white-list=true\u003C\u002Fcode> by default. A server created from scratch on this version therefore starts with the whitelist on, so add your players before inviting them. An updated server keeps the value already in its file. The changes in this version are covered in our article \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fblog\u002Fwilderness-bound-minecraft-26-3\">Minecraft Wilderness Bound (26.3), Everything the Update Changes\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>5. Kick removed players with enforce-whitelist\u003C\u002Fh2>\n\u003Cp>By default, removing a player from the whitelist doesn&#39;t kick them if they&#39;re already online. They&#39;re only blocked the next time they try to join.\u003C\u002Fp>\n\u003Cp>To kick players who aren&#39;t on the whitelist right away, stop the server, open \u003Ccode>server.properties\u003C\u002Fcode> in \u003Cstrong>Files\u003C\u002Fstrong>, and set the following line to \u003Ccode>true\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-properties\">enforce-whitelist=true\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>After a restart, when the whitelist is on and gets reloaded, for example with \u003Ccode>whitelist reload\u003C\u002Fcode>, online players who aren&#39;t on it are kicked.\u003C\u002Fp>\n\u003Ch2>6. Understand ops.json and whitelist.json\u003C\u002Fh2>\n\u003Cp>The \u003Ccode>op\u003C\u002Fcode> and \u003Ccode>whitelist\u003C\u002Fcode> commands save their data in two files at the root of the server, visible in the \u003Cstrong>Files\u003C\u002Fstrong> tab.\u003C\u002Fp>\n\u003Cp>The \u003Ccode>ops.json\u003C\u002Fcode> file holds the list of operators.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">[\n  {\n    &quot;uuid&quot;: &quot;00000000-0000-0000-0000-000000000000&quot;,\n    &quot;name&quot;: &quot;Steve&quot;,\n    &quot;level&quot;: 4,\n    &quot;bypassesPlayerLimit&quot;: false\n  }\n]\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Field\u003C\u002Fth>\n\u003Cth>Purpose\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>uuid\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The player&#39;s unique identifier\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>name\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>The player&#39;s username\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>level\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Op level, from 1 to 4\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>bypassesPlayerLimit\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>With \u003Ccode>true\u003C\u002Fcode>, the player can join even when the server is full\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>The \u003Ccode>whitelist.json\u003C\u002Fcode> file follows the same principle, with only the \u003Ccode>uuid\u003C\u002Fcode> and \u003Ccode>name\u003C\u002Fcode> fields.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-json\">[\n  {\n    &quot;uuid&quot;: &quot;00000000-0000-0000-0000-000000000000&quot;,\n    &quot;name&quot;: &quot;Alex&quot;\n  }\n]\n\u003C\u002Fcode>\u003C\u002Fpre>\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>Prefer commands over manual editing. They fetch the player&#39;s correct UUID automatically, while a typo in a JSON file can stop it from being read. If you edit \u003Ccode>whitelist.json\u003C\u002Fcode> by hand while the server is running, type \u003Ccode>whitelist reload\u003C\u002Fcode> to apply the changes. For \u003Ccode>ops.json\u003C\u002Fcode>, stop the server before editing it, then start it again.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>7. Cracked servers (online-mode=false)\u003C\u002Fh2>\n\u003Cp>Both files identify players by their UUID, not just their username. A player&#39;s UUID differs depending on the server mode. In official mode (\u003Ccode>online-mode=true\u003C\u002Fcode>), it comes from Mojang. In cracked mode (\u003Ccode>online-mode=false\u003C\u002Fcode>), it&#39;s calculated locally from the username.\u003C\u002Fp>\n\u003Cp>If you switch an existing server to cracked mode, the entries already in \u003Ccode>ops.json\u003C\u002Fcode> and \u003Ccode>whitelist.json\u003C\u002Fcode> no longer match the players. Once the server is running in cracked mode, run \u003Ccode>op\u003C\u002Fcode> and \u003Ccode>whitelist add\u003C\u002Fcode> again for each player involved, so their new UUID gets saved.\u003C\u002Fp>\n\u003Cdiv class=\"markdown-alert markdown-alert-caution\">\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=\"8\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12.01\" y2=\"16\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>In cracked mode, anyone can join with any username they like, including an operator&#39;s. The whitelist alone therefore doesn&#39;t protect your admin access. Set up local authentication as described in our guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fminecraft-java\u002Fallow-cracked-players-minecraft-server\">How to Allow Cracked Players on a Minecraft Server\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Ch3>❌ &quot;You are not white-listed on this server!&quot; when joining\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check with \u003Ccode>whitelist list\u003C\u002Fcode> that the player&#39;s username is in the list\u003C\u002Fli>\n\u003Cli>Check the exact spelling of the username, including upper case\u003C\u002Fli>\n\u003Cli>If the server switched to cracked mode after the player was added, remove and add the player again to save their new UUID\u003C\u002Fli>\n\u003Cli>If you edited \u003Ccode>whitelist.json\u003C\u002Fcode> by hand, type \u003Ccode>whitelist reload\u003C\u002Fcode> in the Console\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ &quot;That player does not exist&quot;\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>The username you entered doesn&#39;t match any Minecraft account, check its spelling\u003C\u002Fli>\n\u003Cli>In official mode, the player needs a valid Minecraft Java account to be added\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ &quot;Nothing changed. The player already is an operator&quot;\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>The player is already op, nothing else is needed\u003C\u002Fli>\n\u003Cli>To change their level, run \u003Ccode>deop\u003C\u002Fcode> then \u003Ccode>op\u003C\u002Fcode> again after changing \u003Ccode>op-permission-level\u003C\u002Fcode>, or edit the \u003Ccode>level\u003C\u002Fcode> field in \u003Ccode>ops.json\u003C\u002Fcode> with the server stopped\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ &quot;Unknown or incomplete command. See below for error&quot;\u003C\u002Fh3>\n\u003Cp>This message is followed by the command you typed, with a \u003Ccode>&lt;--[HERE]\u003C\u002Fcode> marker where the server stops understanding it.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Check the spelling of the command and its arguments, a single typo is enough to trigger this message\u003C\u002Fli>\n\u003Cli>In the Console, type the command without the leading \u003Ccode>\u002F\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>In game, if you&#39;re op, your level may be too low for this command, see the level table above and the \u003Ccode>level\u003C\u002Fcode> field of the \u003Ccode>ops.json\u003C\u002Fcode> file\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ A player removed from the whitelist stays connected\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>This is the default behavior while \u003Ccode>enforce-whitelist\u003C\u002Fcode> is set to \u003Ccode>false\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Set \u003Ccode>enforce-whitelist=true\u003C\u002Fcode> in \u003Ccode>server.properties\u003C\u002Fcode>, restart, then type \u003Ccode>whitelist reload\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>You can also kick them directly with \u003Ccode>kick &lt;username&gt;\u003C\u002Fcode> from the Console\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Add yourself to the whitelist or op yourself before typing \u003Ccode>whitelist on\u003C\u002Fcode>, so you don&#39;t lock yourself out\u003C\u002Fli>\n\u003Cli>Keep level 4 for people you trust, level 2 is often enough for an event host or a builder\u003C\u002Fli>\n\u003Cli>Remove op status from players who no longer need it with \u003Ccode>deop\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Run \u003Ccode>whitelist list\u003C\u002Fcode> regularly to check who still has access to the server\u003C\u002Fli>\n\u003Cli>On a cracked server, don&#39;t rely on the whitelist alone and set up local authentication\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If a command doesn&#39;t behave as expected or a player stays blocked despite the whitelist, our team is here. 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 command you used along with the message shown in the Console.\u003C\u002Fp>\n\u003Cp>Your Minecraft server is now under your control and reserved for the players you chose 🎮\u003C\u002Fp>\n",1794526353563]