Installation¶
Installing on Windows¶
Download the latest PHP binary from Bintray. Use the installer to install PocketMine-MP. The installer may have an outdated version of PocketMine-MP. You can download the latest .phar from Jenkins.
Warning
If the provided x64 binary does not work then try the x86 binary.
Installing on Linux/MacOS¶
Warning
Only works on Linux or MacOS.
Use curl or wget to install PocketMine-MP using the following command.
curl -sL https://raw.githubusercontent.com/pmmp/php-build-scripts/master/installer.sh | bash -s -
wget -q -O - https://raw.githubusercontent.com/pmmp/php-build-scripts/master/installer.sh | bash -s -
[*] Found PocketMine-MP Final_1.5dev (build 1254) using API 1.12.0
[*] This development build was released on Sat Jun 20 09:45:04 CEST 2015
[*] Installing/updating PocketMine-MP on directory ./
[1/3] Cleaning...
[2/3] Downloading PocketMine-MP Final_1.5dev-1254 phar... done!
[3/3] Obtaining PHP: detecting if build is available...
[3/3] MacOS 64-bit PHP build available, downloading PHP_5.6.10_x86-64_MacOS.tar.gz... checking... regenerating php.ini... done
[*] Everything done! Run ./start.sh to start PocketMine-MP
Error
It is recommended to run it as a normal user as it doesn’t need further permissions.
Do not run the installer as root, this is discouraged.
Installing manually¶
Did the installer fail? It is not your taste? YOLO? DIY!
Using .phar¶
- Create a new directory for PocketMine-MP.
- Download PocketMine-MP.phar from Jenkins.
- Rename the .phar to
PocketMine-MP.phar. - Place it in the PocketMine-MP directory you just created.
Using GitHub¶
$ git clone --recursive https://github.com/pmmp/pocketmine-mp.git pocketmine-mp.git
Cloning into 'pocketmine-mp.git'...
remote: Counting objects: 34068, done.
remote: Compressing objects: 100% (13/13), done.
remote: Total 34068 (delta 2), reused 0 (delta 0), pack-reused 34055
Receiving objects: 100% (34068/34068), 9.89 MiB | 1.79 MiB/s, done.
Resolving deltas: 100% (25602/25602), done.
Checking connectivity... done.
Submodule 'src/pocketmine/gui' (https://github.com/pmmp/pocketmine-mp-gui.git) registered for path 'src/pocketmine/gui'
Submodule 'src/raklib' (https://github.com/pmmp/raklib.git) registered for path 'src/raklib'
Submodule 'src/spl' (https://github.com/pmmp/pocketmine-spl.git) registered for path 'src/spl'
Submodule 'tests/TesterPlugin' (https://github.com/pmmp/testerplugin.git) registered for path 'tests/TesterPlugin'
Cloning into 'src/pocketmine/gui'...
remote: Counting objects: 26, done.
remote: Compressing objects: 100% (21/21), done.
remote: Total 26 (delta 4), reused 26 (delta 4), pack-reused 0
Unpacking objects: 100% (26/26), done.
Checking connectivity... done.
Submodule path 'src/pocketmine/gui': checked out 'b551c3d58ec2fd9fa0f3c92d36fcbaa5c70467f7'
Cloning into 'src/raklib'...
remote: Counting objects: 577, done.
remote: Total 577 (delta 0), reused 0 (delta 0), pack-reused 577
Receiving objects: 100% (577/577), 141.29 KiB | 0 bytes/s, done.
Resolving deltas: 100% (432/432), done.
Checking connectivity... done.
Submodule path 'src/raklib': checked out '660bdff07d85c0270e57da2a5ce69eff2a87649a'
Cloning into 'src/spl'...
remote: Counting objects: 65, done.
remote: Total 65 (delta 0), reused 0 (delta 0), pack-reused 65
Unpacking objects: 100% (65/65), done.
Checking connectivity... done.
Submodule path 'src/spl': checked out '178d2a38f95d552fa5d91da26edc13a86d8054c6'
Cloning into 'tests/testerplugin'...
remote: Counting objects: 8, done.
remote: Compressing objects: 100% (2/2), done.
remote: Total 8 (delta 2), reused 1 (delta 1), pack-reused 5
Unpacking objects: 100% (8/8), done.
Checking connectivity... done.
Submodule path 'tests/testerplugin': checked out '1a0dec97cc354a0b62b41c007caa6f84885b8263'
Starting for the first time¶
Now you should be able to start PocketMine-MP.
The first time it starts with a set-up wizard,
this can be disabled by running ./start.sh --no-wizard.
$ ./start.sh
[*] PocketMine-MP set-up wizard
[*] Please select a language:
English => en
Español => es
ä¸æ–‡ => zh
Pyccĸий => ru
日本語 => ja
Deutsch => de
í•œêµì–´ => ko
Nederlands => nl
Français => fr
Italiano => it
Melayu => ms
Norsk => no
Svenska => sv
Suomi => fi
Türkçe => tr
[?] Language (en):
PocketMine-MP supports a few other languages. Fill in the two letters behind the language and press enter. Is your language not in the list? Add it on Crowdin.
[*] English has been correctly selected.
Welcome to PocketMine-MP!
Before starting setting up your new server you have to accept the license.
PocketMine-MP is licensed under the LGPL License,
that you can read opening the LICENSE file on this folder.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
[?] Do you accept the License? (y/N):
Do you accept the License?
[?] Do you want to skip the set-up wizard? (y/N):
You can skip the wizard from here and start the server with the default settings or continue.
[*] You are going to set up your server now.
[*] If you don't want to change the default value, just press Enter.
[*] You can edit them later on the server.properties file.
[?] Give a name to your server (Minecraft: PE Server):
[*] Do not change the default port value if this is your first server.
[?] Server port (19132):
[*] The RAM is the maximum amount of memory PocketMine-MP will use. A value of 128-256 MB is recommended
[?] Server RAM in MB (256):
[*] Choose between Creative (1) or Survival (0)
[?] Default Game mode: (0):
[?] Max. online players (20):
[*] The spawn protection disallows placing/breaking blocks in the spawn zone except for OPs
[?] Enable spawn protection? (Y/n):
[*] An OP is the player admin of the server. OPs can run more commands than normal players
[?] OP player name (example, your game name):
[!] You will be able to add an OP user later using /op <player>
[*] The white-list only allows players in it to join.
[?] Do you want to enable the white-list? (y/N):
[!] Query is a protocol used by different tools to get information of your server and players logged in.
[!] If you disable it, you won't be able to use server lists.
[?] Do you want to disable Query? (y/N):
[*] RCON is a protocol to remote connect with the server console using a password.
[?] Do you want to enable RCON? (y/N):
[*] Getting your external IP and internal IP
[!] Your external IP is 87.212.35.149. You may have to port-forward to your internal IP 192.168.0.150
[!] Be sure to check it, if you have to forward and you skip that, no external players will be able to join. [Press Enter]
[*] You have finished the set-up wizard correctly
[*] Check the Plugin Repository to add new features, minigames, or advanced protection to your server
[*] PocketMine-MP will now start. Type /help to view the list of available commands.
[Server thread/INFO]: Loading pocketmine.yml...
[Server thread/INFO]: Loading server properties...
[Server thread/INFO]: Selected English (eng) as the base language
[Server thread/INFO]: Starting Minecraft: PE server version v0.11.0 alpha
[Server thread/NOTICE]: The memory-limit setting has been deprecated.
[Server thread/NOTICE]: There are new memory settings on pocketmine.yml to tune memory and events.
[Server thread/NOTICE]: You can also reduce the amount of threads and chunks loaded control the memory usage.
[Server thread/INFO]: Opening server on 0.0.0.0:19132
[Server thread/INFO]: This server is running PocketMine-MP version 1.5dev-1254 "活発(Kappatsu)フグ(Fugu)" (API 1.12.0)
[Server thread/INFO]: PocketMine-MP is distributed under the LGPL License
[Server thread/INFO]: Preparing level "world"
[Server thread/INFO]: Starting GS4 status listener
[Server thread/INFO]: Setting query port to 19132
[Server thread/INFO]: Query running on 0.0.0.0:19132
[Server thread/INFO]: Default game type: Survival Mode
[Server thread/INFO]: Done (19.485s)! For help, type "help" or "?"
The server should have started now and you should be able to join.