Placeholders - CodedRed-Spigot/PlayTimes GitHub Wiki

📌 PAPI Placeholders

PlayTimes automatically registers its placeholders into PAPI, so you don't need to download anything extra!

Here are the current supported PAPI placeholders:

  • %PlayTimes_playtime%: Returns a player's playtime.
  • %PlayTimes_uptime%: Returns server uptime.
  • %PlayTimes_joindate%: Returns a player's join date.
  • %PlayTimes_timesjoined%: Returns the number of times a player joined the server.
  • %PlayTimes_topname1%: Returns the name of the player with the most playtime.
  • %PlayTimes_toptime1%: Returns the #1 time (player #1's time).

You can adjust the last two placeholders to get the top 1 to 10 players. For example, for the 3rd top player, use %PlayTimes_topname3% and %PlayTimes_toptime3%.

How to Enable PlayTimes Placeholders in Other Plugins

PlayTimes does all the work for you. Just follow these steps:

  1. Make sure you have PAPI downloaded on your server.
  2. Download PlayTimes.
  3. Restart the server and check if PAPI downloaded the placeholders! Use /papi list.
  4. If you're experiencing issues, make sure you have the latest versions of PAPI and PlayTimes installed, and try restarting your server once more.

How to Use Other Plugin Placeholders in PlayTimes

If you want to use placeholders from other PAPI plugins in PlayTimes, follow these steps:

  1. Make sure you have PAPI downloaded on your server.
  2. Download the placeholders with the command /papi ecloud download (name).
  3. Reload PAPI with the command /papi reload.
  4. Set use-papi-placeholders: true in the PlayTimes config.yml.
  5. Reload PlayTimes.
  6. You can now use the placeholders in PlayTimes!

Using HolographicDisplays with PlayTimes

To use PAPI placeholders in HolographicDisplays holograms, you need to install HolographicExtension or Holographic Placeholders [HoloExtension].

🎯 Built-in Placeholders

PlayTimes also supports these built-in placeholders:

  • %player%: Get the player's name.
  • %playtime%: Get the player's playtime (rawtime minus afktime, if afk enabled).
  • %afktime%: Get the player's afktime.
  • %rawtime%: Get the player's rawtime (pure playtime without afktime removed from it).
  • %timesjoined%: Get the number of times the player joined.
  • %joindate%: Get the date when the player joined.
  • %place%: Get the place in the top leaderboard (only for /toppt).
  • %player%: Get the player name (only for /toppt).
  • %timeleft%: Get the time left in cooldown for /toppt.

Looking for Database/Multi-Server placeholders?

Check them out here: https://github.com/CodedRed-Spigot/PlayTimes/wiki/Bungee-Support#placeholders

Do you want more placeholders? Feel free to submit a request for new placeholders!