Introduction
What Altay is, what it is not, and where to start.
Altay is Minecraft: Bedrock Edition server software written in PHP. It is a fork of PocketMine-MP: the same object oriented API, the same plugin ecosystem, maintained by a separate team.
The server is distributed as a single Altay.phar that you run with a PHP binary. There is no
compile step, no build pipeline and no container requirement. Edit a plugin, restart, done.
Install it now
curl -sL https://getaltay.org/download | bash -s -The installer fetches the release, matches it to the right PHP build for your platform and leaves
you with a start.sh. Everything it does by hand is written out in
Installation.
Windows without bash
The installer needs a bash shell. On plain Windows, download the phar and the PHP build by hand: it is two files in one directory.
What you get
A real plugin API
Events, handlers and managers rather than patches to the server. Twelve years of upstream plugins already target it.
Many worlds, one process
Lobby, arena and survival on the same node, loaded and unloaded while the server runs.
Fast version tracking
New Bedrock releases are usually supported within days of the client update.
Source you can follow
From the packet decoder down to the PHP extensions, every layer is a repository you can read.
What this is not
Altay is not vanilla Bedrock Dedicated Server and does not aim to be identical to it. Some vanilla features are missing or behave differently, and add-ons written for the official server do not apply.
Add-ons
Behaviour packs do not drive server side logic here. Custom content needs a plugin for the behaviour and a resource pack for the visuals. See Resource packs.
Altay is also not affiliated with, approved by or associated with Mojang.
Where to go next
Getting started
Install the server, run it for the first time, get players connected.
Running a server
Configuration, worlds, permissions, resource packs and what to do when it gets slow.
Plugins
Installing them, writing them, and the parts of the API that catch people out.
Development
Building from source and contributing back.
Troubleshooting
Crashes, bug reports and the questions asked every week.
API reference
Upstream Doxygen output, regenerated weekly. Applies directly to Altay.