Plugins
PlaceholderAPIv0.2.0
Pythonby EndstoneMCLets server owners show information from other plugins through one placeholder format.
pip install endstone-papi- Stars
- 10
PLUGINSPLACEHOLDERAPI
v0.2.0Latest
Added
- Added support for Python 3.15.
Changed
- Dropped Python 3.10 support; Python 3.11 is now the minimum.
Fixed
- Linux wheels now target Endstone's
manylinux_2_31baseline and reject packaging when generated binaries require a newer baseline. /papiparse commands now register reliably while preserving both supported parse forms and multi-word text.- Python plugins can reliably load the active
PlaceholderAPIservice through Endstone's service manager. - Fixed Linux wheel loading with Endstone's bundled C++ runtime.
- PAPI now declares support for Endstone
>=0.11.8,<0.12(API 0.11). - Linux source builds support Clang 18 or newer; official wheels are built with Clang 20.
Changed
- Placeholder routing now uses a colon namespace boundary: ordinary placeholders are
{identifier:params}and relational placeholders are{rel:identifier:params}. Only the routing colon(s) are interpreted by PAPI; provider params preserve underscores, dots, later colons, case, spaces, and empty values exactly as written. relis reserved for relational dispatch and cannot be registered as an ordinary expansion identifier. Legacy underscore- and dot-separated outer syntax is not accepted.
Added
- Native C++20 PlaceholderAPI framework with a bracket parser, owner-aware expansion lifecycle, and shared service.
- A common
PlaceholderExpansioncontract for C++ and Python providers. {identifier:params}ordinary placeholder syntax with first-colon splitting and exact parameter preservation.{rel:identifier:params}relational placeholder dispatch with explicit provider opt-in.- Python expansions can be registered, retained, and invoked through the same native service as C++ expansions.
/papi parse,/papi list, and/papi infocommands with permission checks and input validation.ExpansionRegisteredEventandExpansionUnregisteredEventfor expansion lifecycle changes.- Repeated expansion errors are rate-limited to prevent log spam.
- Strict ASCII identifier grammar
[A-Za-z0-9][A-Za-z0-9-]*. - Windows and Linux wheels for CPython 3.10–3.14.
Removed
- BREAKING: Python plugins must load
PlaceholderAPIfrom Endstone's service manager; direct construction and subclassing are no longer supported. - BREAKING: Removed the 0.0.1 Python-only registry, parser, and built-in placeholders.
- BREAKING: Removed the
{identifier|params}pipe syntax. - BREAKING: Removed the
plugin:identifierduplicate-namespace fallback. - BREAKING: Removed 0.0.1 compatibility adapters:
PlaceholderAPI::Processor,registerPlaceholder,getPlaceholderPattern, Pythonregister_placeholder, andplaceholder_pattern.
Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.
© 2023–2026 EndstoneMC
Not an official Minecraft product. Not approved by or associated with Mojang or Microsoft.