Installing/updating manually
Warning
Installing manually is complicated. Don’t attempt it unless you have no other option.
Windows
Make a folder for your server. If you’re updating an existing server, delete
PocketMine-MP.phar
, any file calledstart
, and thebin
folder from the folder.Download the custom PHP binary for Windows here. Make sure you get the right version for your chosen version of PocketMine-MP (see below).
Right-click -> click Extract All, pick your server folder and click Extract. Now you should have a folder called
bin
.In the
bin
folder, double-click the folevc_redist.x64.exe
, accept the terms and conditions, and install. This will install Microsoft Visual C++ Redistributable, which is needed by the PHP binary.Download your chosen version of
PocketMine-MP.phar
andstart.cmd
from here and save them in your server folder.
Now you should be able to double-click start.cmd
to start the server.
Linux/MacOS
The following steps require you to use the Terminal.
cd
to wherever you want to put the server (e.g.cd /home/dylan
).Make a folder for your server using
mkdir
(e.g.mkdir pocketmine
). If you’re updating an existing server,cd
directly to your server’s folder instead.Run
rm -rf ./bin ./PocketMine-MP.phar ./start.sh
. This deletes any outdated server files (don’t worry, your data won’t be harmed).Find the download link for the right PHP version for your OS. You can see a list of available ones here.
Run
curl -L <link to your chosen PHP binary> | tar -xz
. Now you should have a folder calledbin
. Make sure you get the right version for your chosen version of PocketMine-MP (see below).Find the download link for your chosen version of
PocketMine-MP.phar
andstart.sh
here.Run
curl -LO <link to PocketMine-MP.phar>
.Run
curl -LO <link to start.sh>
.Run
chmod +x ./start.sh
.`
Now you should be able to run the server by running ./start.sh
.
Warning
Make sure you know which binary to use for your chosen version of PocketMine-MP. Different versions need different binaries. You can get some information about this from the update.pmmp.io API.
Binaries have a suffix that tells you which PocketMine-MP version they are for. PM4
is for 4.x, and PM5
is for 5.x.
There are also different downloads different operating systems, different CPU architectures and different versions of PHP itself.
If you use the wrong binary, the server might not work.