1 Release 23 Tags

RSS Feed

• 2.12.3 7d21d2f1d7

  Compare

  2.12.3 | Bug fixes and 26.2 support Stable

  upstream-bot released this 2026-11-04 15:37:32 -05:00 | 2 commits to master since this release

  This is a smaller update providing some bugfixes and improvements.

  Please note that while PAPI works on 26.2, this version is considered experimental on Paper. If you're running a Paper server it's recommended not to update until the version is stable.

  Notable changes

  Fixed Version parsing [#1227]

  Paper changed how their version is structured, which in turn broke the existing version parsing of PlaceholderAPI that is used for things such as the VersionSpecific interface.

  As a reminder we recommend not to rely on, nor use these interfaces, as they can break further in the future.

  Make setPlaceholders consistent with setRelationalPlaceholders [#1178]

  Normal and relational placeholders had an inconsistent behaviour where the former would work with just the identifier, while the later did not.
  This was now changed to make normal placeholders be more in line with relational ones by requiring an underscore after the identifier to be considered valid.

  Support deserializing strings into components [#1188]

  Note

  This only applies to the Paper version of PAPI supporting Components!

  Previously, parsing methods for components always return a TextComponent with the parsed String. This was limiting on how much could be done with the actual text.
  A new setPlaceholders method with an optional Function<String, ComponentLike> argument has been added. This method allows you to define a function to convert the parsed String into a ComponentLike, which can be useful for situations like parsing MiniMessage tags returned by the placeholder, which would've otherwise been ignored.

  Full Changelog

  Other changes

  • Update Common Issues page link in issue-template by @Andre601 in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1089
  • Make setPlaceholders behavior consistent with setRelationalPlaceholders by @BlitzOffline in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1178
  • Refactor CharsReplacer & PlaceholderAPI for better performance and reduced memory allocation by @ichoco-milk in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1163
  • PAPIComponents Deserializer Support by @BitByLogics in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1188
  • Feat/new chars replacer by @PiggyPiglet in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1205
  • fix(parsing): adjust parsing to support paper dev builds better by @darbyjack in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1227
  • fix(logging): improve local expansion failure diagnostics by @darbyjack in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1235

  New Contributors

  • @ichoco-milk made their first contribution in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1163
  • @BitByLogics made their first contribution in https://github.com/PlaceholderAPI/PlaceholderAPI/pull/1188

  Full Changelog: https://github.com/PlaceholderAPI/PlaceholderAPI/compare/2.12.2...1.12.3

  ---

  Mirrored from the original GitHub release: https://github.com/PlaceholderAPI/PlaceholderAPI/releases/tag/2.12.3

  Downloads

  • PlaceholderAPI-2.12.3.jar
    1.1 MiB

    2026-11-04 15:37:33 -05:00
  • Source Code (ZIP)
  • Source Code (TAR.GZ)