
PlaceholderAPI
A resource that allows information from your favourite plugins be shown practically anywhere!
PlaceholderAPI 2.12.2
release8 февраля 2026 г.Bug Fix
Fix #1167
Fixes the update checking causing an error on older versions of Minecraft due to the outdated Gson dependency.
Hytale
PlaceholderAPI is now also on Hytale! If you're running a Hytale server or are developing mods, have a look at https://placeholderapi.com/download or our wiki to get more information.
Adventure Components, Added Security, URL Changes and More!
release3 февраля 2026 г.This update introduces support for Adventure Components! It also includes several security improvements, a new eCloud URL, and other quality of life enhancements.
Components support [#1157]
PlaceholderAPI can now parse placeholders in Kyori Adventure Components.
Default implementation uses a custom built recursive replacer for components which will go through the entire component tree, including all styles (hover/click events), and even NBT/data components. If you have any issues with replacement however, you can switch to the one built into adventure via a config option use_adventure_provided_replacer.
A new class called PAPIComponents is available for use in the API. Just a warning if you try use this class on a spigot server, the plugin will error at start, this class should only be used on paper or derivatives of it.
Security updates
Expansion Jar Hash check
PlaceholderAPI now checks downloaded expansion hashes at start and reload against a list of known malicious expansions. The server will be forcibly stopped and the malicious jars logged in console.
Per-version verification
The eCloud received per-version expansion verification as part of a major overhaul, and PlaceholderAPI was updated to support this change.
From now on, expansion versions are verified individually and just like with verified expansions before, PlaceholderAPI only allows for downloading verified versions via the /papi ecloud commands.
Note for Server Hosts
We've begun migrating from api.extendedclip.com to the *.placeholderapi.com domain. You may need to update your whitelist if users encounter any related connection errors.
The new eCloud can be found at https://ecloud.placeholderapi.com
Note that starting with this version, PlaceholderAPI will begin using the new domain.
Blocked eCloud
We've noticed an increasing number of users having connection troubles to the eCloud due to censorship restrictions imposed by their firewall, server host, isp or country. We've added a more helpful error message in game and in console to help users find alternative ways to use the eCloud.
Bug Fixes / Minor Changes
- Changed updater URL to use PAPI's primary distribution platform
- Check for permissions on all tab to complete
- Show expansion version when hovering over an expansion in
/papi ecloud list
Hytale
PlaceholderAPI is now also on Hytale! If you're running a Hytale server or are developing mods, have a look at https://placeholderapi.com/download or our wiki to get more information.
Full Changelog: https://github.com/PlaceholderAPI/PlaceholderAPI/compare/2.11.7...2.12.1
2.11.7 Folia Support and Code Improvements
release3 ноября 2025 г.After a long wait and countless requests, including multiple pull requests to implement it - PlaceholderAPI is finally able to support Folia!
Additionally there has been some smaller code improvements, including updating the NMSVersion enum to include the latest 1.21.x versions.
Folia Support [#1127]
Folia support has been added, allowing PlaceholderAPI to run on Folia based servers without scheduler related issues. While we’ve tested the core functionality, we haven’t been able to verify every expansion, so some edge cases may still exist. If you encounter any bugs, please report them so we can investigate and resolve them.
NMSVersion updates
The NMSVersion enum has been updated to support the latest 1.21.x versions up to and including 1.21.10 for expansions that depend on this.
Full Changelog
Other changes
- feat: initial work on 1.21 by @darbyjack in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1067
- Added missing NotNull annotations to setBracketPlaceholders methods by @mfnalex in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1000
- Revert api links by @Funny-cube in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1098
- fix for all expansions stop loading after an exception is thrown (#1094) by @Kqliber in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1095
- Merge UniversalScheduler (Folia Support) #980 by @PiggyPiglet in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1127
New Contributors
- @mfnalex made their first contribution in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1000
- @Anon8281 made their first contribution in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/980
Full Changelog: https://github.com/PlaceholderAPI/PlaceholderAPI/compare/2.11.6...2.11.7
PlaceholderAPI 2.11.6
release15 августа 2025 г.This update brings 1.20.6 support but also some important changes to developers to keep in mind. Most notably a deprecation.
Deprecated Version class [#1035]
The Version class in PlaceholderAPI has been deprecated.
The reasons were many with the primary one being that there are various other ways to find out what server version is used to ensure your expansion is compatible with it.
While the class still works, can there be minor changes in how the version is being displayed, due to changes on how PlaceholderAPI fetches the server version. It is recommended to switch to alternative methods as soon as possible, as we won't guarantee this class to remain working for the forseeable future.
Parse Command Improvement
Fixed the parse command showing the wrong command in the "You must provide a target and message" response for the "cmdparse" type. Also added the ability to use "me" in both the first and second player for parserel.
New Wiki
In case you haven't seen it yet, the PlaceholderAPI wiki has been moved. While the old wiki at GitHub served us well was it lacking ways of customizing it. The new location allows us higher customization and organization of the wiki alongside other beneficial changes.
You can find the new Wiki at https://wiki.placeholderapi.com
Just like the old one can you contribute to it by PRing changes to the wiki branch!
What's Changed
Other changes
- Add Hangar and BuiltByBit pages to readme by @Andre601 in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1006
- Update config.yml with papi domain for wiki and ecloud by @Funny-cube in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1038
- Use the OfflinePlayer$getPlayer method instead of casting to Player class by @DevCyntrix in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1040
- Add Plugin Authors to /papi dump by @Andre601 in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1046
New Contributors
- @DevCyntrix made their first contribution in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1040
Full Changelog: https://github.com/PlaceholderAPI/PlaceholderAPI/compare/2.11.5...2.11.6