EuphoriaParties for Endstone

This project ports the original PowerNukkitX plugin to the Endstone framework using the Python API.

Included Features

• Party creation, invites, accept/leave, kick, promote
• Party ranks (setrank), banning/unbanning, color/icon customization
• Party allies (/party ally add|remove|list)
• Party homes, /party home, and /party warp
• Public/private parties with join requests
• Party stats, daily rewards (with streak bonus), achievements, leaderboard
• Party chat via @ prefix and optional party tag in global chat
• Friendly-fire prevention between party members
• HUD toggles (/coordinates, /compass)
• Lightweight party scoreboard toggle (/party scoreboard)
• Party member list toggle (/party show)
• Admin tools: list/info/disband/teleport/reload/health
• JSON persistence with periodic autosave
• Optional MySQL persistence backend

Build

pip install -e .

To enable MySQL storage support:

pip install -e .[mysql]

Commands

• /party (or /p)
• /partyadmin (or /pa)
• /coordinates (or /coords)
• /compass

Local Tests

python -m unittest discover -s tests -v

Notes

• Config is generated at runtime at plugins/euphoria-parties/config.toml.
• Default data is saved to plugins/euphoria-parties/parties.json.
• To use MySQL, set storage.provider = "mysql" (or storage.mysql.enabled = true) and configure storage.mysql.* in config.toml.
• The MySQL backend uses mysql-connector-python (installed via the [mysql] extra).
• This build targets Endstone 0.11.x.
• Latest Endstone release checked: v0.11.0 (published February 13, 2026).
• Update checks reference the GitHub latest release page: https://github.com/EuphoriaDevelopmentOrg/EuphoriaParties-Endstone/releases/latest
• Update checks run on startup; disable with updates.enabled = false in config.toml.