[{"data":1,"prerenderedAt":31},["ShallowReactive",2],{"doc-en-change-default-world-pocketmine":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":16,"docGroupIcon":28,"link_fr":29,"bodyHtml":30},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fchange-default-world-pocketmine","change-default-world-pocketmine","How to Change the Default World on PocketMine-MP","Learn how to easily change the default world (level-name) on your PocketMine-MP server using the server.properties file on the Winheberg gaming panel.","jeux","minecraft-bedrock","tabler:file-text","2026-07-24","Winheberg",54,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fchange-default-world-pocketmine.webp",[16,17,18,19,20],"pocketmine","minecraft","configuration","world","gaming-panel",[22,23,24,25,26,27],"change default world pocketmine","level-name pocketmine-mp","minecraft bedrock server","winheberg gaming panel","change map pocketmine","multiworld configuration","tabler:brand-minecraft","\u002Fdocs\u002Fminecraft-bedrock\u002Fchanger-monde-par-defaut-pocketmine","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>By default, during its initial startup, a PocketMine-MP server automatically generates a standard world named \u003Ccode>world\u003C\u002Fcode>. If you wish to import a custom adventure map, a mini-games arena, or simply switch from one environment to another, you must modify the server's root configuration.\u003C\u002Fp>\n\u003Cp>This change is performed via a specific directive within the main configuration file, allowing the core engine to target the correct storage directory.\u003C\u002Fp>\n\u003Ch2>Accessing Server Files\u003C\u002Fh2>\n\u003Cp>All folder and text file manipulations take place directly from your hosting management interface.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Log in to the \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\u002F\">panel.winheberg.com\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>Select your PocketMine-MP server instance.\u003C\u002Fli>\n\u003Cli>In the left sidebar menu, click on the \u003Cstrong>\u003Ccode>File manager\u003C\u002Fcode>\u003C\u002Fstrong> tab.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fchange-default-world-pocketmine-1781090311125-631cdb906aaaecd7005c6eb7.webp\" alt=\"Accessing the File Manager tab on the Winheberg gaming panel\" width=\"800\" \u002F>\n\n\u003Ch2>Changing the Default World: Step-by-Step Guide\u003C\u002Fh2>\n\u003Cp>To ensure the server correctly loads your new map during the process initialization, carefully follow these steps.\u003C\u002Fp>\n\u003Ch3>1. Identify the Exact Map Name\u003C\u002Fh3>\n\u003Cp>Before modifying the configuration, navigate to the folder named \u003Cstrong>\u003Ccode>\u002Fworlds\u003C\u002Fcode>\u003C\u002Fstrong> via your file manager. Note down the exact name of the directory containing your target world.\u003C\u002Fp>\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>The PocketMine-MP file system is strictly case-sensitive. If your folder is named \u003Ccode>Adventure_Map\u003C\u002Fcode>, typing \u003Ccode>adventure_map\u003C\u002Fcode> will cause an indexing error or trigger the automatic generation of a new blank map.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fchange-default-world-pocketmine-1781090438213-538b60b1a5e6d293f27f9068.webp\" alt=\"Folder containing the map\" width=\"800\" \u002F>\n\n\u003Ch3>2. Open the server.properties File\u003C\u002Fh3>\n\u003Cp>Return to the root of your server (\u003Ccode>\u002F\u003C\u002Fcode>) and locate the primary configuration document:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-properties\">server.properties\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Click on it to open it within the text editor integrated into the Winheberg panel.\u003C\u002Fp>\n\u003Ch3>3. Modify the level-name Directive\u003C\u002Fh3>\n\u003Cp>Scroll through the file until you locate the line containing the \u003Ccode>level-name\u003C\u002Fcode> key. By default, it is generally found around line 18 and looks like this:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ini\">level-name=world\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Replace the default value with the exact name of your previously identified world folder:\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-ini\">level-name=Adventure_Map\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fchange-default-world-pocketmine-1781090558489-4687f57756356962d4555f0e.webp\" alt=\"Modifying the level-name line inside the server.properties file\" width=\"800\" \u002F>\n\n\u003Ch3>4. Save and Restart\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>At the top or bottom right of the web editor, click the \u003Cstrong>\u003Ccode>Save Content\u003C\u002Fcode>\u003C\u002Fstrong> button (or use the standard shortcut \u003Ckbd>Ctrl\u003C\u002Fkbd> + \u003Ckbd>S\u003C\u002Fkbd>).\u003C\u002Fli>\n\u003Cli>Next, head over to the \u003Cstrong>\u003Ccode>Console\u003C\u002Fcode>\u003C\u002Fstrong> tab in the sidebar menu.\u003C\u002Fli>\n\u003Cli>Click the \u003Cstrong>\u003Ccode>Restart\u003C\u002Fcode>\u003C\u002Fstrong> button to permanently apply the changes.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>World Management Variables Summary Table\u003C\u002Fh2>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth align=\"left\">Parameter\u003C\u002Fth>\n\u003Cth align=\"left\">Source File\u003C\u002Fth>\n\u003Cth align=\"left\">Description\u003C\u002Fth>\n\u003Cth align=\"left\">Application Role\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd align=\"left\">\u003Cstrong>\u003Ccode>level-name\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd align=\"left\">\u003Ccode>server.properties\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd align=\"left\">Defines the subfolder of the \u003Ccode>\u002Fworlds\u003C\u002Fcode> directory loaded at startup.\u003C\u002Ftd>\n\u003Ctd align=\"left\">Default spawn point for newly connecting users.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd align=\"left\">\u003Cstrong>\u003Ccode>level-type\u003C\u002Fcode>\u003C\u002Fstrong>\u003C\u002Ftd>\n\u003Ctd align=\"left\">\u003Ccode>server.properties\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd align=\"left\">Algorithmic generation type of the world (DEFAULT, FLAT).\u003C\u002Ftd>\n\u003Ctd align=\"left\">Active only if the folder defined in \u003Ccode>level-name\u003C\u002Fcode> does not exist yet.\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ The Server Generates a New Empty Map or Reverts to the Old World\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Root Directory Error\u003C\u002Fstrong>: Ensure your custom map folder is located inside the \u003Ccode>\u002Fworlds\u003C\u002Fcode> directory and not at the root of your FTP server.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Case Sensitivity Mismatch\u003C\u002Fstrong>: The PocketMine-MP engine will fail to recognize the folder if spelling is imperfect. Double-check uppercase, lowercase, and symbols between the folder name and the \u003Ccode>level-name\u003C\u002Fcode> variable.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Missing Map Chunks or Crash Upon Server Startup\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Active Process During Transfer\u003C\u002Fstrong>: Uploading or renaming files while the instance is online causes synchronous writing conflicts that will corrupt the world. Fully turn off the server before altering configuration directives.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Administrative Best Practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Standardized Nomenclature\u003C\u002Fstrong>: Although PocketMine-MP tolerates spaces, opt for a space-free nomenclature using underscores or hyphens (e.g., \u003Ccode>Adventure_Map\u003C\u002Fcode> instead of \u003Ccode>Adventure Map\u003C\u002Fcode>) to avoid conflicts with future add-ons and plugins.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>System Restore Points\u003C\u002Fstrong>: Systematically generate a manual backup via the panel's \u003Cstrong>Backups\u003C\u002Fstrong> tab before modifying environment variables to secure your existing world data.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Level Type Verification\u003C\u002Fstrong>: If generating a flat world using the \u003Ccode>level-type=FLAT\u003C\u002Fcode> key, make sure to delete any existing folder with that name so the engine can properly apply the new generation algorithm.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need Help?\u003C\u002Fh2>\n\u003Cp>Managing and indexing your virtual worlds requires structural discipline to preserve the data integrity of your players.\u003C\u002Fp>\n\u003Cp>If your modifications are not being registered or if you encounter import issues, our teams remain at your disposal. You can submit a support ticket to our \u003Cstrong>Technical\u003C\u002Fstrong> department from your client area at \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">billing.winheberg.com\u003C\u002Fa> by attaching your PocketMine-MP subscription for personalized expert assistance.\u003C\u002Fp>\n\u003Cp>Happy administration and have a great game on your Winheberg infrastructure! 🎮\u003C\u002Fp>\n",1788993141309]