[{"data":1,"prerenderedAt":40},["ShallowReactive",2],{"doc-en-update-your-pocketmine-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":25,"docGroup":36,"docGroupIcon":37,"link_fr":38,"bodyHtml":39},"\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fupdate-your-pocketmine-server","update-your-pocketmine-server","How to Update Your PocketMine Server","Learn how to update your WinHeberg PocketMine server via the Versions tab in the panel. Version selection, one-click installation, and Minecraft Bedrock version error troubleshooting.","jeux","minecraft-bedrock","tabler:file-text","2026-07-24","Winheberg",29,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fupdate-your-pocketmine-server.webp",[16,17,18,19,20,21,22,23,24],"PocketMine","Minecraft Bedrock","Update","Version","Panel","MCPE","Installation","Tutorial","Gaming",[26,27,28,29,30,31,32,33,34,35],"update PocketMine","PocketMine update","PocketMine version","PocketMine panel","Minecraft Bedrock PocketMine","PocketMine host","WinHeberg PocketMine server","PocketMine version error","official PocketMine binary","install PocketMine","pocketmine","tabler:brand-minecraft","\u002Fdocs\u002Fminecraft-bedrock\u002Fmettre-a-jour-son-serveur-pocketmine","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>You manage a \u003Cstrong>PocketMine server\u003C\u002Fstrong> at WinHeberg and want to \u003Cstrong>upgrade it to a more recent version\u003C\u002Fstrong>? Whether it&#39;s to benefit from the latest bug fixes, to follow a Minecraft Bedrock update, to test a new feature, or because \u003Cstrong>your players see a compatibility error message\u003C\u002Fstrong> since Microsoft updated Minecraft Bedrock, the update is done in one click from your gaming panel.\u003C\u002Fp>\n\u003Cp>This guide walks you through how to change the version of your PocketMine server, and what to do in case of incompatibility with a recent Minecraft Bedrock update from Microsoft.\u003C\u002Fp>\n\u003Ch2>How to know if your server needs an update?\u003C\u002Fh2>\n\u003Cp>PocketMine is friendly with you. As soon as a new version is available, the server displays a \u003Cstrong>warning message\u003C\u002Fstrong> in the console at startup. If you see this kind of log appearing, it&#39;s time to take action.\u003C\u002Fp>\n\u003Cpre>\u003Ccode>[20:39:55.558] [Server thread\u002FWARNING]: [Update Checker] Your version of PocketMine-MP is out of date. Version 5.43.1 was released on Sat May 9 05:41:51 2026\n[20:39:55.558] [Server thread\u002FWARNING]: [Update Checker] Details: https:\u002F\u002Fgithub.com\u002Fpmmp\u002FPocketMine-MP\u002Freleases\u002Ftag\u002F5.43.1\n[20:39:55.558] [Server thread\u002FWARNING]: [Update Checker] Download: https:\u002F\u002Fgithub.com\u002Fpmmp\u002FPocketMine-MP\u002Freleases\u002Fdownload\u002F5.43.1\u002FPocketMine-MP.phar\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>The message directly tells you the \u003Cstrong>new version number\u003C\u002Fstrong> available (here \u003Ccode>5.43.1\u003C\u002Fcode>), the \u003Cstrong>release date\u003C\u002Fstrong>, and a link to the \u003Cstrong>release notes\u003C\u002Fstrong> on GitHub. As long as you don&#39;t update, this warning will appear at every server startup.\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>Regularly check your server console. If you see this \u003Cstrong>Update Checker\u003C\u002Fstrong> warning, take a few minutes to follow the procedure below. It will save you from running on an outdated version potentially containing bugs that have since been fixed.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Why update your PocketMine server?\u003C\u002Fh2>\n\u003Cp>PocketMine evolves \u003Cstrong>regularly\u003C\u002Fstrong> to follow Minecraft Bedrock updates and fix bugs reported by the community. Updating your server allows you to.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Benefit from the latest fixes\u003C\u002Fstrong> for bugs and security\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Stay compatible with new Minecraft Bedrock clients\u003C\u002Fstrong> (which auto-update on mobile\u002Fconsole)\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Take advantage of new features\u003C\u002Fstrong> and performance optimizations\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Avoid version errors\u003C\u002Fstrong> shown to players trying to connect\u003C\u002Fli>\n\u003C\u002Ful>\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>When \u003Cstrong>Microsoft releases a new version of Minecraft Bedrock\u003C\u002Fstrong>, PocketMine isn&#39;t always compatible right away. \u003Cstrong>The PocketMine developers\u003C\u002Fstrong> first have to adapt the code to the new protocol version, which can take \u003Cstrong>a few days to a few weeks\u003C\u002Fstrong>. During this period, your players with an up-to-date client won&#39;t be able to connect to your server until you update PocketMine.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cp>Before getting started, make sure you have the following.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>An active \u003Cstrong>PocketMine server\u003C\u002Fstrong> on your WinHeberg gaming panel\u003C\u002Fli>\n\u003Cli>A \u003Cstrong>recent backup\u003C\u002Fstrong> of your server (recommended in case of post-update issues)\u003C\u002Fli>\n\u003Cli>A few minutes ahead of you, ideally during off-peak hours so you don&#39;t disturb your players\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>A major update can \u003Cstrong>break some plugins\u003C\u002Fstrong> that haven&#39;t been updated by their authors. Before switching to a major version (for example from 5.42 to 5.43), check the compatibility of your essential plugins.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>1. Stop your server\u003C\u002Fh2>\n\u003Cp>Before changing the version, your server must be \u003Cstrong>completely stopped\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Log in to your \u003Cstrong>WinHeberg gaming panel\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Select your \u003Cstrong>PocketMine server\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>On the main page, click \u003Cstrong>Stop\u003C\u002Fstrong> if the server is running\u003C\u002Fli>\n\u003Cli>Wait for the status to switch to \u003Cstrong>Offline\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Fol>\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>Don&#39;t try to change the version while the server is running, you could corrupt files or world data.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Access the Versions tab\u003C\u002Fh2>\n\u003Cp>WinHeberg provides a \u003Cstrong>dedicated tab\u003C\u002Fstrong> to manage the version of your PocketMine server.\u003C\u002Fp>\n\u003Col>\n\u003Cli>In the left side menu of your server, click \u003Cstrong>Update version PMMP\u003C\u002Fstrong> (Configuration section)\u003C\u002Fli>\n\u003Cli>You&#39;ll arrive on a page listing \u003Cstrong>all the official PocketMine versions available\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fupdate-your-pocketmine-server-1784365885302-ce2a0d175c115cd2e83a3b81.webp\" alt=\"WinHeberg panel side menu with the Versions button highlighted in the Configuration section\" width=\"200\" \u002F>\n\n\n\u003Ch2>3. Choose and install the desired version\u003C\u002Fh2>\n\u003Cp>The \u003Cstrong>Versions\u003C\u002Fstrong> tab displays the list of all official PocketMine versions, from the most recent to the oldest.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fminecraft-bedrock\u002Fupdate-your-pocketmine-server-1784366058573-97f2e98656a5a079d166cde4.webp\" alt=\"List of PocketMine versions available in the WinHeberg panel with Install button to the right of each version\" width=\"800\" \u002F>\n\n\u003Cp>You&#39;ll see for example the following versions (the list is automatically updated by WinHeberg).\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>PocketMine 5.44.3\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PocketMine 5.44.2\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PocketMine 5.44.1\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PocketMine 5.43.2\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PocketMine 5.43.1\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PocketMine 5.43.0\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PocketMine 5.42.1\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>PocketMine 5.42.0\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>And all earlier versions\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>To install a version.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Locate the version you want (usually \u003Cstrong>the most recent\u003C\u002Fstrong> at the top of the list)\u003C\u002Fli>\n\u003Cli>Click the \u003Cstrong>Install\u003C\u002Fstrong> button to the right of the chosen version\u003C\u002Fli>\n\u003Cli>Wait a few seconds while the binary is downloaded and installed\u003C\u002Fli>\n\u003C\u002Fol>\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>If you&#39;re hesitating about which version to choose, take \u003Cstrong>the most recent available\u003C\u002Fstrong>, it&#39;s almost always the right choice. An older version is only relevant if you specifically know that one of your plugins doesn&#39;t work with recent versions.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Restart your server\u003C\u002Fh2>\n\u003Cp>Once the new version is installed, you can restart your server.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Go back to the main page of your server\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Start\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>Watch the \u003Cstrong>console\u003C\u002Fstrong> to verify that startup runs without errors\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>You should see in the logs a message confirming the new version of PocketMine at startup, for example \u003Ccode>This server is running PocketMine-MP version 5.43.1\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2>Why does WinHeberg only offer official versions?\u003C\u002Fh2>\n\u003Cp>You may have heard of \u003Cstrong>community PocketMine binaries\u003C\u002Fstrong> or \u003Cstrong>unofficial forks\u003C\u002Fstrong> that sometimes provide versions adapted to new Bedrock releases faster than the official version. At WinHeberg, \u003Cstrong>we only offer official binaries\u003C\u002Fstrong> published by the PocketMine development team, and for a simple reason, \u003Cstrong>the security of your servers and your players\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch3>The risks of unofficial binaries\u003C\u002Fh3>\n\u003Cp>Unofficial PocketMine binaries can contain.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Hidden \u003Cstrong>malicious code\u003C\u002Fstrong> (backdoors, player data theft, etc.)\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Unaudited modifications\u003C\u002Fstrong> that introduce vulnerabilities\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Hidden features\u003C\u002Fstrong> that can compromise your server integrity\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cp>Since PocketMine is an open-source project, anyone can download the source code, modify it, and redistribute a compiled binary. Without code auditing, \u003Cstrong>it&#39;s impossible to guarantee\u003C\u002Fstrong> that a community binary doesn&#39;t contain an unpleasant surprise.\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>We know this choice can be frustrating during a Bedrock update awaited by your players. However, \u003Cstrong>security comes before speed\u003C\u002Fstrong>, and a compromised server does far more harm to your community than a few days of delay waiting for the official version.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Cp>Here are the most common errors during a PocketMine update.\u003C\u002Fp>\n\u003Ch3>❌ Minecraft Bedrock version error (clients can no longer connect)\u003C\u002Fh3>\n\u003Cp>If your players see a message like \u003Cstrong>&quot;Outdated server&quot;\u003C\u002Fstrong> or \u003Cstrong>&quot;Outdated client&quot;\u003C\u002Fstrong> when connecting.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>This is due to a \u003Cstrong>protocol incompatibility\u003C\u002Fstrong> between PocketMine and the Minecraft Bedrock client\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Outdated client\u003C\u002Fstrong> means your players are on an older version than the one expected by the server, they need to \u003Cstrong>update their game\u003C\u002Fstrong>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Outdated server\u003C\u002Fstrong> means the opposite, your PocketMine server is too old compared to the client, you need to \u003Cstrong>switch to a more recent version\u003C\u002Fstrong> in the Versions tab\u003C\u002Fli>\n\u003Cli>If the official PocketMine version isn&#39;t yet available for the latest Bedrock version, you&#39;ll have to \u003Cstrong>wait a few days\u003C\u002Fstrong> for the PocketMine developers to publish an update\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ A plugin no longer loads after the update\u003C\u002Fh3>\n\u003Cp>If one of your plugins refuses to launch in the console.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Check on the \u003Cstrong>Poggit\u003C\u002Fstrong> page (the official PocketMine plugin repository) if a \u003Cstrong>compatible version\u003C\u002Fstrong> with your new PocketMine version is available\u003C\u002Fli>\n\u003Cli>If the plugin hasn&#39;t been updated by its author, you can either \u003Cstrong>wait for an update\u003C\u002Fstrong>, or \u003Cstrong>revert to an earlier compatible\u003C\u002Fstrong> PocketMine version\u003C\u002Fli>\n\u003Cli>Some critical plugins may justify \u003Cstrong>staying on an older stable version\u003C\u002Fstrong> while waiting for all your plugins to be updated\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ The server no longer starts after the update\u003C\u002Fh3>\n\u003Cp>If the console shows errors at launch after the version change.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>Check the \u003Cstrong>full logs\u003C\u002Fstrong> to identify the exact error\u003C\u002Fli>\n\u003Cli>A \u003Cstrong>major incompatibility\u003C\u002Fstrong> between your \u003Ccode>pocketmine.yml\u003C\u002Fcode> or your \u003Ccode>server.properties\u003C\u002Fcode> and the new version may block startup, compare with the example files of the new version\u003C\u002Fli>\n\u003Cli>As a last resort, \u003Cstrong>go back to the previous version\u003C\u002Fstrong> from the Versions tab and contact our support team\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ My worlds or player data have disappeared\u003C\u002Fh3>\n\u003Cp>No panic, your worlds are \u003Cstrong>not deleted\u003C\u002Fstrong> during a version change.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>The version change only affects \u003Cstrong>the PocketMine binary\u003C\u002Fstrong>, not your data (worlds, plugins, configurations)\u003C\u002Fli>\n\u003Cli>Check via SFTP or the file manager that your \u003Ccode>worlds\u002F\u003C\u002Fcode> and \u003Ccode>plugin_data\u002F\u003C\u002Fcode> folders are still present\u003C\u002Fli>\n\u003Cli>If something really has disappeared, restore the backup you made before the update\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cp>A few recommendations to manage your PocketMine updates safely.\u003C\u002Fp>\n\u003Cul>\n\u003Cli>\u003Cstrong>Back up your server\u003C\u002Fstrong> before each update, especially when switching to a major version\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Test first on a test server\u003C\u002Fstrong> if you have many critical plugins, rather than updating your production server directly\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Follow PocketMine news\u003C\u002Fstrong> on their official GitHub and Discord to anticipate important updates\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Notify your players in advance\u003C\u002Fstrong> of a version change, especially if a few minutes of downtime is expected\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Document which version you use\u003C\u002Fstrong> so you can easily roll back if needed\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Don&#39;t force an immediate update\u003C\u002Fstrong> after a Bedrock release, wait a few days for the official PocketMine version to stabilize\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If you can&#39;t update your server, if an essential plugin no longer works after the update, or if you encounter a console error, feel free to contact our support team and include the server startup logs.\u003C\u002Fp>\n\u003Cp>Your PocketMine server is now up to date, ready to welcome your players on the latest version 🎮.\u003C\u002Fp>\n",1788993142285]