MCPcopy Create free account
hub / github.com/EndstoneMC/endstone

github.com/EndstoneMC/endstone @v0.11.5

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.11.5 ↗ · + Follow
6,225 symbols 11,520 edges 1,334 files 879 documented · 14% updated 2d agov0.11.6 · 2026-07-10★ 66217 open issues

Browse by type

Functions 3,897 Types & classes 2,327 Endpoints 1
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Logo

Endstone

High-performance Minecraft Bedrock server software

Extensible with Python and C++ plugins

Build Minecraft PyPI - Version Python GitHub License Discord Hosted By: Cloudsmith

Why Endstone?

Bedrock's official addon and script APIs let you add content, but can hardly modify core gameplay. Custom servers like PocketMine and Nukkit offer that control, but sacrifice vanilla features. Endstone gives you both: cancellable events, packet control, and deep gameplay access with full vanilla compatibility. Think of it as Paper for Bedrock. If you've ever wished Bedrock servers had the same modding power as Java Edition, this is it.

Quick Start

Get your server running in seconds:

pip install endstone
endstone

Then create your first plugin:

from endstone.plugin import Plugin
from endstone.event import event_handler, PlayerJoinEvent


class MyPlugin(Plugin):
    api_version = "0.10"

    def on_enable(self):
        self.logger.info("MyPlugin enabled!")
        self.register_events(self)

    @event_handler
    def on_player_join(self, event: PlayerJoinEvent):
        event.player.send_message(f"Welcome, {event.player.name}!")

Get started faster with our templates: Python | C++

Features

  • Cross-platform - Runs natively on both Windows and Linux without emulation, making deployment flexible and straightforward.

  • Always up-to-date - Designed to stay compatible with the latest Minecraft Bedrock releases so you're never left behind.

  • Python & C++ plugins - Write plugins in Python for rapid development, or use C++ when you need maximum performance. The choice is yours.

  • Powerful API - A comprehensive API with 60+ events covering players, blocks, actors, and more. Includes commands, forms, scoreboards, inventories, and a full permission system.

  • Drop-in replacement - Works with your existing Bedrock worlds and configurations. Just install and run.

  • Familiar to Bukkit developers - If you've developed plugins for Java Edition servers, you'll feel right at home with Endstone's API design.

Installation

Requires Python 3.10+ on Windows 10+ or Linux (Ubuntu 22.04+, Debian 12+).

Using pip (recommended)

pip install endstone
endstone

Using Docker

docker pull endstone/endstone
docker run --rm -it -p 19132:19132/udp endstone/endstone

Building from source

git clone https://github.com/EndstoneMC/endstone.git
cd endstone
pip install .
endstone

For detailed installation guides, system requirements, and configuration options, see our documentation.

Documentation

Visit endstone.dev for comprehensive guides, API reference, and tutorials.

Contributing

We welcome contributions from the community! Whether it's bug reports, feature requests, or code contributions:

License

Endstone is licensed under the Apache-2.0 license.

Acknowledgements

Endstone is proudly sponsored by Bisect Hosting, which offers managed Minecraft server hosting.

Bisect Hosting

Package repository hosting is graciously provided by Cloudsmith, which offers free package management for open-source projects.

Hosted By: Cloudsmith

Core symbols most depended-on inside this repo

Shape

Method 3,329
Class 2,023
Function 568
Enum 304
Route 1

Languages

C++89%
Python11%
C1%

Modules by API surface

src/bedrock/forward.h283 symbols
tests/endstone_test/src/endstone_test/tests/test_command.py119 symbols
tests/endstone_test/src/endstone_test/tests/test_ban.py74 symbols
src/endstone/core/player.cpp72 symbols
src/endstone/core/devtools/imgui_impl_glfw.cpp63 symbols
include/endstone/nbt/tag.h61 symbols
src/bedrock/world/events/player_events.h56 symbols
src/endstone/core/server.cpp52 symbols
src/endstone/python/stubgen.py51 symbols
src/endstone/core/actor/actor.h48 symbols
src/bedrock/world/actor/actor.cpp47 symbols
src/bedrock/world/item/item_stack_base.cpp42 symbols

For agents

$ claude mcp add endstone \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page