mirror of
https://github.com/pmmp/PocketMine-MP.git
synced 2025-05-19 12:15:32 +00:00
49a8eff11e
submodules are useful (e.g. devtools, build/php) but they are not required to build a server phar.
40 lines
1.8 KiB
Markdown
40 lines
1.8 KiB
Markdown
# Building
|
|
## Pre-requisites
|
|
- A bash shell (git bash is sufficient for Windows)
|
|
- [`git`](https://git-scm.com) available in your shell
|
|
- PHP 8.0 or newer available in your shell
|
|
- [`composer`](https://getcomposer.org) available in your shell
|
|
|
|
## Custom PHP binaries
|
|
Because PocketMine-MP requires several non-standard PHP extensions and configuration, PMMP provides scripts to build custom binaries for running PocketMine-MP, as well as prebuilt binaries.
|
|
|
|
- [Prebuilt binaries](https://jenkins.pmmp.io/job/PHP-8.0-Aggregate)
|
|
- [Compile scripts](https://github.com/pmmp/php-build-scripts) are provided as a submodule in the path `build/php`
|
|
|
|
If you use a custom binary, you'll need to replace `composer` usages in this guide with `path/to/your/php path/to/your/composer.phar`.
|
|
|
|
## Setting up environment
|
|
1. `git clone https://github.com/pmmp/PocketMine-MP.git`
|
|
2. `composer install`
|
|
|
|
## Checking out a different branch to build
|
|
1. `git checkout <branch to checkout>`
|
|
2. Re-run `composer install` to synchronize dependencies.
|
|
|
|
## Optimizing for release builds
|
|
1. Add the flags `--no-dev --classmap-authoritative` to your `composer install` command. This will reduce build size and improve autoloading speed.
|
|
|
|
## Building `PocketMine-MP.phar`
|
|
Run `composer make-server` using your preferred PHP binary. It'll drop a `PocketMine-MP.phar` into the current working directory.
|
|
|
|
You can also use the `--out` option to change the output filename.
|
|
|
|
There is a bug in PHP that might cause an error which looks like this:
|
|
```
|
|
Fatal error: Uncaught BadMethodCallException: unable to create temporary file in PocketMine-MP/build/server-phar.php:119
|
|
```
|
|
You can work around it by setting `ulimit -n` to some bigger number, e.g. `8192`, or by updating your PHP version to at least 8.0.3.
|
|
|
|
## Running PocketMine-MP from source code
|
|
Run `src/PocketMine.php` using your preferred PHP binary.
|