Перейти к содержимому
Mineforgian

PlaceholderAPI

A resource that allows information from your favourite plugins be shown practically anywhere!

205K загрузок239 подписчиковGPL-3.0-onlybukkitfoliapaperspigot

Обновлён 3 июля 2026 г. · опубликован 15 августа 2025 г.

https://helpch.at/discord

Header

https://raw.githubusercontent.com/PlaceholderAPI/PlaceholderAPI/refs/heads/assets/dark_mode/wiki.png https://raw.githubusercontent.com/PlaceholderAPI/PlaceholderAPI/refs/heads/assets/dark_mode/Placeholders.png https://raw.githubusercontent.com/PlaceholderAPI/PlaceholderAPI/refs/heads/assets/dark_mode/eCloud.png
Development builds: https://ci.extendedclip.com/job/PlaceholderAPI/

Introduction

PlaceholderAPI is a plugin for Spigot servers that allows server owners to display information from various plugins with a uniform format.

Support for specific plugins are provided either by the plugin itself or through expansions. The expansions may be downloaded in-game through the PAPI Expansion Cloud. There are currently over 230+ expansions that support a wide variety of plugins, such as Essentials, Factions, LuckPerms, and Vault. If you're a developer and you want to add support for PlaceholderAPI in your plugin please head to our API Usage page for more information.

PlaceholderAPI has been downloaded over 2,000,000 times and is currently used concurrently on over 50,000 servers, which makes it a must-have for a server of any type or scale.

Getting Started

Steps to install

Configuration

The config.yml contains the core plugin customization settings as well as a section specifically for expansions that wish to add configurable options too.

Any settings an expansion may allow you to change will be added to the config.yml when that specific expansion is loaded.


# PlaceholderAPI
# Version: 2.11.4
# Created by: extended_clip
# Contributors: https://github.com/PlaceholderAPI/PlaceholderAPI/graphs/contributors
# Issues: https://github.com/PlaceholderAPI/PlaceholderAPI/issues
# Expansions: https://ecloud.placeholderapi.com/expansions/all/
# Wiki: https://github.com/PlaceholderAPI/PlaceholderAPI/wiki
# Discord: https://helpch.at/discord
# No placeholders are provided with this plugin by default.
# Download placeholders: /papi ecloud
check_updates: true
cloud_enabled: true
cloud_sorting: "name"
cloud_allow_unverified_expansions: false
boolean:
  'true': 'yes'
  'false': 'no'
date_format: MM/dd/yy HH:mm:ss
debug: false

Permissions


permissions:
  placeholderapi.*:
    description: "Ability to use all PAPI commands"
    children:
      placeholderapi.admin: true
      placeholderapi.ecloud.*: true
  placeholderapi.admin:
    description: "Ability to use all PAPI commands"
    children:
      placeholderapi.help: true
      placeholderapi.info: true
      placeholderapi.list: true
      placeholderapi.parse: true
      placeholderapi.reload: true
      placeholderapi.version: true
      placeholderapi.register: true
      placeholderapi.unregister: true
      placeholderapi.updatenotify: true
  placeholderapi.ecloud.*:
    description: "Ability to use all PAPI ecloud commands"
    children:
      placeholderapi.ecloud: true
      placeholderapi.ecloud.info: true
      placeholderapi.ecloud.list: true
      placeholderapi.ecloud.clear: true
      placeholderapi.ecloud.status: true
      placeholderapi.ecloud.update: true
      placeholderapi.ecloud.refresh: true
      placeholderapi.ecloud.download: true
      placeholderapi.ecloud.placeholders: true
  placeholderapi.help:
    default: "op"
    description: "Allows you to view the list of PAPI commands"
  placeholderapi.info:
    default: "op"
    description: "Allows you to view expansion information"
  placeholderapi.list:
    default: "op"
    description: "Allows you to list active expansions"
  placeholderapi.ecloud:
    default: "op"
    description: "Allows you to access PAPI eCloud"
  placeholderapi.parse:
    default: "op"
    description: "Allows you to parse placeholders"
  placeholderapi.reload:
    default: "op"
    description: "Allows you to reload PAPI and its configuration"
  placeholderapi.version:
    default: "op"
    description: "Allows you to view the version of PAPI installed"
  placeholderapi.register:
    default: "op"
    description: "Allows you to register expansions"
  placeholderapi.unregister:
    default: "op"
    description: "Allows you to unregister expansions"
  placeholderapi.updatenotify:
    default: "op"
    description: "Notifies you when there is a PAPI update"
  placeholderapi.ecloud.info:
    default: "op"
    description: "Allows you to view cloud expansion information"
  placeholderapi.ecloud.list:
    default: "op"
    description: "Allows you to list eCloud expansions"
  placeholderapi.ecloud.clear:
    default: "op"
    description: "Allows you to clear the local eCloud expansion cache"
  placeholderapi.ecloud.status:
    default: "op"
    description: "Allows you to view the status of eCloud expansions"
  placeholderapi.ecloud.update:
    default: "op"
    description: "Allows you to update registered eCloud expansions"
  placeholderapi.ecloud.refresh:
    default: "op"
    description: "Allows you to refresh the local eCloud expansion cache"
  placeholderapi.ecloud.download:
    default: "op"
    description: "Allows you to download an expansion from the eCloud"
  placeholderapi.ecloud.placeholders:
    default: "op"
    description: "Allows you to view the placeholders of a eCloud expansion"

Commands

Parse Commands

/papi bcparse <player|--null|me> <string>

/papi cmdparse <player|me> <string>

/papi parse <player|--null|me> <string>

/papi parserel <player> <player> <string>

eCloud Commands

/papi ecloud status

/papi ecloud clear

/papi ecloud download <expansion> [version]

/papi ecloud update <expansion/all>

/papi ecloud info <expansion> [version]

/papi ecloud list <all|<author>|installed> [page]

/papi ecloud placeholders <expansion>

/papi ecloud refresh

Expansion Commands

/papi info <expansion>

/papi list

/papi register <jar file>

/papi unregister <jar file>

Utility Commands

/papi dump

/papi reload

/papi version

Some Useful Links

Plugins using PAPI - API Usage - Placeholder List - Wiki

If you enjoy this completely free and powerful resource, please be kind enough to leave a like and review!

This plugin utilizes bStats to collect anonymous statistics https://bstats.org/signatures/bukkit/PlaceholderAPI.svg https://bstats.org/plugin/bukkit/PlaceholderAPI

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
2.12.3Релиз26.1, 26.1.1, 26.1.2, 26.2bukkit, folia, paper, spigot3 июля 2026 г..jar (1.1 МБ)
2.12.2Релиз1.21.11, 26.1, 26.1.1, 26.1.2bukkit, folia, paper, spigot8 февраля 2026 г..jar (1.1 МБ)
2.12.1Релиз1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, spigot3 февраля 2026 г..jar (1.1 МБ)
2.11.7Релиз1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, folia, paper, spigot3 ноября 2025 г..jar (931 КБ)
2.11.6Релиз1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, paper, spigot15 августа 2025 г..jar (911 КБ)

Ченджлог

2.12.3Релиз26.1.1, 26.1.2, 26.2 · 3 июля 2026 г.

This is a smaller update providing some bugfixes and improvements.

Notable changes

Fixed Version parsing [#1227]

Paper changed how their version is structured in their latest 26.2 experimental builds, 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

New Contributors

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

2.12.2Релиз26.1, 26.1.1, 26.1.2 · 8 февраля 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.

2.12.1Релиз1.21.9, 1.21.10, 1.21.11 · 3 февраля 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Релиз1.21.9, 1.21.10, 1.21.11 · 3 ноября 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

New Contributors

Full Changelog: https://github.com/PlaceholderAPI/PlaceholderAPI/compare/2.11.6...2.11.7

2.11.6Релиз1.21.6, 1.21.7, 1.21.8 · 15 августа 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

New Contributors

Full Changelog: https://github.com/PlaceholderAPI/PlaceholderAPI/compare/2.11.5...2.11.6

Полная история изменений — на Modrinth.

Комментарии

Загружаем…