placeholderapi

PlaceholderAPI support

RareSpawns has optional integration with PlaceholderAPI so you can use dynamic placeholders (from other plugins) in chat, messages, scoreboards, GUIs and other plugins that support PlaceholderAPI.

Important note

• RareSpawns does NOT provide its own placeholders at this time. It only supports parsing placeholders that come from external PlaceholderAPI expansions you install. If you need RareSpawns-specific placeholders, they are not available yet — you must rely on other plugins' expansions.

Quick overview

• If PlaceholderAPI (PAPI) is installed on the server, RareSpawns will detect it at startup and can parse external placeholders when formatting messages.
• Use placeholders in any plugin or text field that accepts PAPI tokens (chat plugins, bossbars, sign plugins, scoreboard plugins, etc.).
• Placeholders use the standard PAPI format: %namespace_identifier% (example form: %someplugin_value%).

Installation & enablement

1. Install PlaceholderAPI:
   • Put the PlaceholderAPI JAR in your server's plugins/ folder.
2. Restart the server (or reload both PlaceholderAPI and RareSpawns, in that order).
3. Confirm detection:
   • Check server console / RareSpawns startup log for a message indicating PAPI was detected.

Usage

• Insert placeholders into any supported text field using the %...% syntax.
• Example (lang.yml):
  • poweritem-no-exist: '&cSorry %player_name%, this item no longer exists.'
• Because RareSpawns does not have its own placeholders yet, ensure the placeholder you use is provided by a third-party expansion installed in PAPI.

Discovering placeholders

• To discover exact placeholder keys available on your server, use PlaceholderAPI commands:
  • List expansions and metadata:
    • /papi ecloud list
  • Test/parse a placeholder:
    • /papi parse me %some_expansion_placeholder%
  • See loaded placeholders via PAPI commands/tools.

Common scenarios

• Show data from another plugin (via its PAPI expansion) in a RareSpawns message or GUI field.
• Display player-related values (from other expansions) alongside RareSpawns text.

Troubleshooting

• Placeholders not resolving:
  • Ensure PlaceholderAPI is installed and loaded before RareSpawns (restart both).
  • Confirm the third-party expansion that provides the placeholder is installed and registered with PAPI.
  • Use /papi parse me <placeholder> to test the token directly.
• Placeholder returns the literal token:
  • The expansion may not be registered; check PAPI's list of loaded expansions and server logs.
• Placeholder works but shows unexpected value:
  • Verify the placeholder name and context (some placeholders depend on a held item, world, or nearby entity).