Skip to content

Common Issues & FAQ

Common Issues

  • Placeholders show literally (e.g., %netherperms_prefix%)
  • The expansion isn’t installed. Run /papi providers to find the identifier, then /papi download <id>.

  • Confirm with /papi list after installing.

  • Placeholders work only after /papi reload

  • The plugin auto-reinstalls installed expansions 1 tick after startup. Ensure you installed with /papi download <id> at least once. If a provider registers very late, increase the delay (ask plugin dev to make it configurable).

  • Player placeholders are empty

  • You parsed without a player context. Pass a Player to PlaceholderAPI::parse() or PlaceholderAPI::get() when required.

  • Which plugin handles this placeholder?

  • Use /papi info <identifier[:param]> [player]. It shows value, the expansion name, and metadata.

  • Performance concerns (scoreboards, frequent updates)

  • Cache your rendered texts where possible.

  • Many expansions expose a short update interval to cache values briefly. Avoid parsing every tick if not needed.

  • Conflicts or collisions

  • Well-designed expansions declare a prefix via getIdentifierPrefix() to avoid collisions. Prefer using fully namespaced identifiers (e.g., myplugin_points).

FAQ

  • Do I need Providers?

  • Built-in placeholders are always available. Third-party placeholders require a Provider and must be installed with /papi download <id>.

  • Can I pass parameters to placeholders?

  • Yes. Use identifier:param, e.g., %server_time:<Y-m-d H:i>%. Underscore style like %server_time_<format>% is also supported.

  • Do installed expansions persist after restart?

  • Yes. The plugin remembers your installed identifiers and reinstalls them automatically on startup.

  • How do I see a list of available third-party identifiers?

  • /papi providers.

  • How do I enable a third-party placeholder?

  • /papi download <identifier> (one-time). After that, it is available immediately and on future restarts.

  • How do I get help?

  • Check /papi info, the logs, and this wiki. If an issue persists, open an issue with details: server version, plugin list, steps to reproduce, and relevant logs.