[{"data":1,"prerenderedAt":29},["ShallowReactive",2],{"doc-en-enable-pocketmine-whitelist":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":20,"docGroup":16,"docGroupIcon":26,"link_fr":27,"bodyHtml":28},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fenable-pocketmine-whitelist","enable-pocketmine-whitelist","How to enable whitelist on a PocketMine-MP server","Learn how to enable and manage the whitelist on your PocketMine-MP server directly from the console to allow only authorized players.","jeux","minecraft-bedrock","tabler:file-text","2026-07-24","Winheberg",49,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fenable-pocketmine-whitelist.webp",[16,9,17,18,19],"pocketmine","whitelist","console","gaming-server",[21,22,23,24,25],"pocketmine whitelist","enable pocketmine whitelist","minecraft bedrock whitelist","whitelist commands pocketmine","add player whitelist","tabler:brand-minecraft","\u002Fdocs\u002Fminecraft-bedrock\u002Factiver-whitelist-pocketminemp","\u003Ch2>Contexte\u003C\u002Fh2>\n\u003Cp>The whitelist feature allows you to strictly restrict access to your PocketMine-MP server to explicitly authorized players only. Once this security measure is enabled, any player not appearing in this registry will be denied connection by the system, even if they possess the exact IP address and port of your infrastructure.\u003C\u002Fp>\n\u003Cp>On your PocketMine-MP server hosted at Winheberg, implementing this restriction is particularly relevant in several scenarios.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Making your gaming space completely private for invitation-only accessibility\u003C\u002Fli>\n\u003Cli>Restricting access to a circle of friends to prevent intrusions from unknown users\u003C\u002Fli>\n\u003Cli>Safeguarding the environment during critical construction phases, maintenance, or testing of your extensions\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Prérequis\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active PocketMine-MP game server on our platform\u003C\u002Fli>\n\u003Cli>Functional access to your administration interface with the server started (Online status) in order to execute console queries\u003C\u002Fli>\n\u003Cli>The exact Minecraft Bedrock usernames of the players you wish to add to the registry\u003C\u002Fli>\n\u003C\u002Ful>\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>If you enable the whitelist without previously registering your own game identifier, the system will reject your own connection. Take care to add yourself to the list before locking global access.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Log in to the management panel\u003C\u002Fh2>\n\u003Cp>Go to our administration interface accessible via \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\u002F\">panel.winheberg.com\u003C\u002Fa> and select your PocketMine-MP instance from your active services.\u003C\u002Fp>\n\u003Ch2>2. Open the administration console\u003C\u002Fh2>\n\u003Cp>In the navigation menu located on the left of your screen, click on the \u003Cstrong>Console\u003C\u002Fstrong> option and ensure your instance is running correctly in the background before sending any commands.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fenable-pocketmine-whitelist-1780988878764-56d99878bafb9716d7666510.webp\" alt=\"Administration console interface for PocketMine-MP server on the Winheberg panel\" width=\"800\" \u002F>\n\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>All whitelist management instructions are executed in real time directly through this console entry field.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>3. Enable or disable the whitelist\u003C\u002Fh2>\n\u003Cp>To toggle your server into restricted access mode, send the following instruction.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist on\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>If you wish to lift the filtering and reopen access to the instance for the general public, use the reverse directive.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist off\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>Within the Winheberg management console, instructions must be entered without inserting the \u003Ccode>\u002F\u003C\u002Fcode> character at the beginning of the line. Enter exclusively \u003Ccode>whitelist on\u003C\u002Fcode> and not \u003Ccode>\u002Fwhitelist on\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Add a user to the whitelist\u003C\u002Fh2>\n\u003Cp>To grant permanent access authorization to a player, specify their exact username following the assignment command.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist add PlayerUsername\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>For example, to validate access for the user Steve, transmit the following command.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist add Steve\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Upon instruction validation, the player is authorized to authenticate, even when the global restriction is active.\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>The specified identifier must match the user's Minecraft Bedrock username to the character, paying scrupulous attention to case sensitivity (uppercase and lowercase).\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>5. Revoke a player's access\u003C\u002Fh2>\n\u003Cp>To remove a user from your access registry, apply the removal instruction combined with the targeted profile name.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist remove PlayerUsername\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>To illustrate this action with the user Steve, the instruction will be as follows.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist remove Steve\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>If global filtering is active, the revoked user will be immediately disconnected and will no longer be able to establish a connection with the server.\u003C\u002Fp>\n\u003Ch2>6. View the authorized users registry\u003C\u002Fh2>\n\u003Cp>To check the complete list of currently approved accounts on your game instance, execute the general query command.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">whitelist list\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>This command allows you to quickly audit the access granted on your infrastructure.\u003C\u002Fp>\n\u003Ch2>En cas de problème\u003C\u002Fh2>\n\u003Cp>Several verification mechanisms allow for resolving common access anomalies.\u003C\u002Fp>\n\u003Ch3>❌ Connection rejected for a registered player\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check the case sensitivity of the configured username by meticulously comparing it with the user's real Bedrock identifier.\u003C\u002Fli>\n\u003Cli>Use the \u003Ccode>whitelist list\u003C\u002Fcode> directive to validate the correct presence of the account in the server registry.\u003C\u002Fli>\n\u003Cli>Invite the player to completely restart their Minecraft application to refresh their client authentication token.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Lack of filtering despite configuration\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check the console confirmation return following the submission of the \u003Ccode>whitelist on\u003C\u002Fcode> command. The console must explicitly validate the rule state change.\u003C\u002Fli>\n\u003Cli>Ensure your server is not currently restarting, which could cancel the writing of temporary changes if they are not saved.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Accidental lockout of your own administrator access\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>If another member of your team has administrative privileges, invite them to execute the \u003Ccode>whitelist add YourUsername\u003C\u002Fcode> instruction from their interface.\u003C\u002Fli>\n\u003Cli>In the absence of a connected third party, temporarily disable the module via the \u003Ccode>whitelist off\u003C\u002Fcode> instruction in the console, apply your profile registration, then reactivate the security lock.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Bonnes pratiques\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>Systematically register your administration and moderation profiles before enabling global filtering.\u003C\u002Fli>\n\u003Cli>Invite your users to send you an exact text copy of their Bedrock profile to eliminate the risks of manual entry errors.\u003C\u002Fli>\n\u003Cli>Perform periodic audits of your access via the \u003Ccode>whitelist list\u003C\u002Fcode> command to clean up the registry of inactive profiles.\u003C\u002Fli>\n\u003Cli>Prefer a global disabling (\u003Ccode>whitelist off\u003C\u002Fcode>) rather than a complete deletion of your data if you wish to temporarily open your instance access for a public event.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Besoin d'aide ?\u003C\u002Fh2>\n\u003Cp>If the whitelist system exhibits abnormal behavior or if validated profiles face persistent lockouts, our technical teams remain at your entire disposal. You can initiate a support request with our Technical department by going to \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">billing.winheberg.com\u003C\u002Fa> and taking care to link your PocketMine-MP instance in the concerned product selection field.\u003C\u002Fp>\n\u003Cp>A rigorously managed whitelist ensures the serenity and perfect security of your gaming community 🔒\u003C\u002Fp>\n",1788993141743]