Update Endstone

Pre-update backups

Before updating, stop the server and make a quick backup of your world.

Warning

If you use C++ plugins, some releases may require rebuilding against the new Endstone API. Python plugins are generally unaffected. Check the Release Notes for any breaking changes.

Update

If you installed with uv + pip

Activate your virtual environment


.\.venv\Scripts\activate

Upgrade Endstone


uv pip install -U endstone

Verify the version


uv run endstone --version
# Extra: show installed package details
uv pip show endstone

Start the server again


uv run endstone

If something goes wrong, you can roll back to a previous version:


uv pip install endstone==<previous_version>

If you’re using Docker

For Docker users, follow the platform-specific update steps (pull the new image tag and recreate the container) on the Run with Docker page.

Post-update checks

Confirm plugins loaded without errors.
Join from a client and verify basic gameplay.
Scan the logs for warnings or deprecations, and review the Release Notes for any follow-up actions.