> For the complete documentation index, see [llms.txt](https://wiki.realisticseasons.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.realisticseasons.com/interactions-with-other-plugins/soft-dependencies/placeholderapi.md).

# PlaceHolderAPI

Download: [**here**](https://www.spigotmc.org/resources/placeholderapi.6245/)

PlaceholderAPI is a plugin that allows server owners to easily display information from certain plugins anywhere they want. RealisticSeasons adds so-called placeholders using PlaceHolderAPI that can be used to display season, date, time, etc anywhere you want. It can be used in scoreboards, tab, bossbars, chat messages and more. 

RealisticSeasons adds 2 types of placeholders, world-specific placeholders and player based placeholders. An example of a world specific placeholder is `%rs_season_spawn%`. This placeholder will be replaced with the season of the world named "spawn". It doesn't matter what world the player is in, it will always display the information of the world "spawn". You can replace the "spawn" part with the name of your world. Another type of placeholder is the player based placeholder, for example, `%rs_season%`. These placeholders use the world the player is currently in. It is less safe since it will not work in worlds like the nether or end. You should mostly stick to the world specific placeholders. All placeholders have a player based and world based variant, except for the temperature, which is player based only. 

### World-specific placeholders

<pre><code>%rs_season_&#x3C;world>%
%rs_next_season_&#x3C;world>%
%rs_days_until_next_season_&#x3C;world>%
%rs_day_&#x3C;world>%
%rs_weekday_&#x3C;world%>%
%rs_month_&#x3C;world>%
%rs_month_asname_&#x3C;world>%
%rs_year_&#x3C;world>%
%rs_seasonlength_&#x3C;world>%
%rs_time_&#x3C;world>%
%rs_active_events_&#x3C;world>%
<strong>%rs_next_event_&#x3C;world>%
</strong>%rs_days_until_next_event_&#x3C;world>%
</code></pre>

### Player based placeholders

```
%rs_season%
%rs_next_season%
%rs_days_until_next_season%
%rs_day%
%rs_weekday%
%rs_month%
%rs_month_asname%
%rs_year%
%rs_temperature%
%rs_temperature_int%
%rs_temperature_int_celcius%
%rs_temperature_int_fahr%
%rs_temperaturecolor%
%rs_bottle_icon%
%rs_air_temperature%
%rs_air_temperaturecolor%
%rs_seasonlength%
%rs_time%
%rs_active_events%
%rs_next_event%
%rs_days_until_next_event%
%rs_biome% (v10.7.6 and above)
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.realisticseasons.com/interactions-with-other-plugins/soft-dependencies/placeholderapi.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.