Placeholder A P I

MythicSeasons registers its own PlaceholderAPI expansion when PlaceholderAPI is installed, for scoreboards, tab lists and other plugins. Nothing extra needs downloading.

• The identifier is ms: every placeholder starts with %ms_. Write names in lowercase, exactly as listed.
• A placeholder answers for its player and that player's world, unless a table says otherwise.

In MythicMobs skills, use the MythicMobs placeholders instead. Names and fallbacks differ, see Differences from the MythicMobs placeholders.

When a placeholder can't resolve

• An unknown name returns nothing. The Celsius identifier is spelled celcius: temperature_int_celcius.
• Without a player, as in event files, everything except the world form returns nothing.
• For an offline player, everything except the world form returns Player is offline!, unknown names included.
• The world form returns nothing for a world that never had a season.

Where MythicSeasons resolves them itself

The commands.start and commands.stop lines of event files resolve PlaceholderAPI placeholders without a player, so only the world form works there, such as %ms_season_survival%. The %season%, %world%, %day%, %month%, %month_asname%, %year% and %weekday% tokens in those lines are MythicSeasons' own (see Event Options).

World identifiers

These answer for the player's world, or for a named world with the world form.

%ms_day%, %ms_month%, %ms_month_asname%, %ms_year% and %ms_weekday% return their fallback while enabled is false in calendar.yml or the world has no date. The values in the table follow the MythicMobs placeholders of the same meaning.

World form

Add an underscore and the exact, case-sensitive world name (underscores allowed) to any identifier in the table above: %ms_<identifier>_<world>%, such as %ms_season_survival% or %ms_time_resource_world%. The world must have had a season at some point. Other identifiers have no world form: %ms_temperature_survival% returns nothing.

Inside a season area, the player form of %ms_season%, %ms_season_id%, %ms_season_display% and %ms_sub_season% reports the area's season, with the phase MIDDLE.

Season and time

These identifiers answer only for a player.

%ms_progress% and %ms_season_blend% do not check that the world has a season.

Temperature

All temperature values are whole numbers. A player is hydrated for hydration-seconds (default 300) after drinking any potion item, water bottles included, see Temperature Options.

The body temperature updates every temperature-update-interval ticks (default 40, in temperature.yml), only in worlds with temperature on, and stops changing in Creative and Spectator mode, so test as a Survival player. A player who switched temperature off with /toggletemperature still has a value. See Where temperature applies.

Celsius and Fahrenheit

With display.convert-to-fahrenheit: true in temperature.yml, a player sees Fahrenheit unless they have used /togglefahrenheit. With false, only after using it. This sets the number and unit of %ms_temperature%, %ms_body_temperature%, %ms_temperature_int%, %ms_body_temperature_int% and %ms_air_temperature%.

The conversion is (celsius * 9) / 5 + 32 in whole numbers, so 20 becomes 68 and -3 becomes 27. The unit text follows with no space: display.temperature.celcius (default °C) or display.temperature.fahrenheit (default °F) of temperature.yml.

Body temperature while burning

While a player is on fire, the body temperature identifiers add 100 degrees before converting the unit. Burning from heat (marked with SetRSBurn at 50 degrees and above) does not count.

Temperature colours

%ms_temperaturecolor% and %ms_air_temperaturecolor% were removed. Use %mythic_var_mstempcolor%, the colour tag the bundled readout keeps in the MythicMobs variable mstempcolor. It shows [Undefined] until the readout has run once for the player.

%mythic_var_mstempcolor%, %ms_season_display%, %ms_next_season_display%, %ms_active_events% and %ms_next_event% can contain MiniMessage tags, which a plugin that only reads & codes shows as plain text.

Weather and clouds

These answer only for a player and give the same value as the MythicMobs placeholder in the second column, see Weather and Clouds. While enabled is false in atmosphere.yml, every identifier below except %ms_wind_speed%, %ms_storm% and %ms_in_cloud% returns its fallback.

Decimals always use a dot.

Biome

Season particles

Cloud layers

<name> is the toggle value of the layer files (see Player toggles). The shipped layers use cumulus, fog, cirrus and dust. It may contain underscores, and case does not matter. A world name after it counts as part of the name: there is no world form.

Before a player chooses, a name gives true, or false when its layer files set toggle-default: hidden. The rest works as for <mythicseasons.cloudlayer.name>.

Differences from the MythicMobs placeholders

"a against b" means a in MythicMobs and b in PlaceholderAPI.

These identifiers have no MythicMobs counterpart: %ms_seasonlength%, %ms_biome%, %ms_bottle_icon%, %ms_temperature_int%, %ms_body_temperature_int%, %ms_temperature_int_fahr% and the world form.

Examples

Season: %ms_season_display%
Date: %ms_weekday%, %ms_month_asname% %ms_day%
Time: %ms_time%
Temperature: %mythic_var_mstempcolor%%ms_temperature%
Wind: %ms_wind_speed% m/s

%mythic_var_mstempcolor% colours the temperature while the bundled readout runs for the player.

commands:
  start:
    - "/say The harvest festival begins. The next season starts in %ms_days_until_next_season_survival% days."

Event files have no player, so this uses the world form for a world named survival.

  - actionmessage{m="<caster.var.mstempcolor><caster.var.mstempwarn><caster.var.mstemplead>[ <mythicseasons.bodytemperature> ] %ms_season_display%<caster.var.mstempicon>"} @Self ?!burning

The first actionmessage line of MS_TemperatureReadout in skills/TemperatureReadout.yml, with the season added. Change the other three the same way, then run /mm reload.