Placeholders

MythicSeasons adds 37 MythicMobs placeholders for the season, calendar, events, temperature and weather of the entity a skill line runs on, and for a player's particle and cloud layer choices. The conditions read the same values directly. For other plugins, see PlaceholderAPI, where some names and fallbacks differ.

Using the placeholders

Write them as <mythicseasons.name> in lowercase, for example <mythicseasons.month.name>. They need no setup and have no aliases.

The entity

A placeholder reads the mechanic's target or the entity the condition checks, else the entity that triggered the skill, else the caster. Season skill triggers are cast by a player, so the values describe that player. Scopes such as <target.mythicseasons.season> do not exist: make the entity the line's target instead.

Values are text

Every placeholder returns text, and a zero reads 0, 0.0 or 0.00 depending on the placeholder. Compare numbers with the MythicMobs comparevalues condition, not stringequals.

The MythicMobs default attribute has no effect. With no answer, a placeholder returns the fallback under "Nothing to report", and that is a real value: "at most 3 days until the next season" is also true where daysuntilnextseason returns its fallback 0.

Worlds that answer

The Season, Calendar and Time and Events placeholders answer only for an entity in a world with a season, never in the Nether or the End. Otherwise they return their fallback. A world gets a season with /ms set or from on-new-world-creation.default-season in config.yml.

The other placeholders answer in any world. The Temperature and Weather and Clouds ones return their fallback with no entity, or when their system has nothing for that position.

Season

The phase follows progress: START below 9 percent, EARLY below 18, MIDDLE below 84, LATE below 92, END from 92. Season files move these limits with sub-season-thresholds (see Sub-Seasons).

seasonblend rises evenly from 0.00 to 1.00 over the last transition.blend-days days of the season (default 3 in atmosphere.yml), with or without the weather simulation. A season file can set atmosphere.transition.blend-days or atmosphere.transition.blend-percent.

A land plugin region with a permanent season does not change these placeholders. Inside a season area, season, season.display and subseason report the area's season, with the phase MIDDLE.

Calendar and Time

The date placeholders return their fallback while enabled is false in calendar.yml or the world has no date yet. hours, minutes and time work without the calendar. See Calendar.

time.format fills $hours$, $minutes$ and $seconds$ with two digits. With time.12-hour-clock.enabled: true the hours run 1 to 12, and time.12-hour-clock.add-am-pm adds AM or PM. The fallback 00:00 ignores the format.

The clock reads 06:00 at world time 0 (sunrise) and 18:00 at 12000. With modify-daynight-length on in config.yml, the month's day-length-in-min and night-length-in-min stretch it in worlds with a season and a date. With sync-time-with-real-world it shows the real time in time-sync-timezone and ignores time-sync-offset.

Events

These need the calendar and list only events with display-event: true (the default). See Events.

Temperature

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.

Weather and Clouds

Most of these need the weather simulation running in the world. storm, incloud, airtemperature and windspeed take the first answer from these sources:

• Permanent weather spots, priority 1000 (see Land Claims). They answer only rain and thunder, so of these four they affect only storm.
• The weather simulation, priority 100.
• Other plugins' weather providers, priority 0 unless they set another.

With no answer, storm follows vanilla thunder and airtemperature the temperature system. Every other placeholder here returns its fallback.

humidity, windx and windz have no data above or below the simulated sky (grid.y-min and grid.y-max in atmosphere.yml). For when a column counts as a storm, see Weather.

cloudcover counts thin low mist too, so it can read high under a mostly clear sky. The CloudCover condition measures it with a radius you choose.

Inside a land plugin region with a permanent wind speed, windx and windz follow the surface wind direction and are 0 when that speed is 0. windspeed does not change.

Season particles

Check it on any line that should follow /toggleseasonparticles, as the bundled pack does.

WindGust:
  Cooldown: 1
  Skills:
  - effect:sound{s=entity.breeze.idle_air;volume=0.3;audience=self} @Self
  - effect:particles{p=gust;amount=1;audience=self} @Self ?stringEquals{val1=<mythicseasons.particles>;val2=true}

To skip a whole skill instead, list it under player-tick-particles.

Cloud layers

The name is the toggle value of the layer files, such as <mythicseasons.cloudlayer.fog> (see Player toggles). The shipped layers use cumulus, fog, cirrus and dust. Case does not matter.

Before a player chooses, a name gives true, or false when its layer files set toggle-default: hidden. A name no layer uses gives true, unless the player chose it while a layer still used it. The value is only the player's choice: /cloudquality, the world and the weather simulation do not change it.

LightMist:
  Cooldown: 2
  Skills:
  - effect:particles{p=cloud;amount=2;audience=self} @Self ?stringEquals{val1=<mythicseasons.cloudlayer.fog>;val2=false}

Runs for players who hid the fog layers with /togglecloudlayer fog.

Examples

ActionBarReadout:
  Skills:
  - actionmessage{m="<gray><mythicseasons.time> <dark_gray>-</dark_gray> <white><mythicseasons.airtemperature> C</white> <dark_gray>-</dark_gray> <white><mythicseasons.windspeed> m/s</white> <dark_gray>-</dark_gray> <white><mythicseasons.humidity> g/kg</white>"} @Self

List the skill under skill-triggers.player-tick in a season file to refresh it for every player.

WindWarning:
  Cooldown: 20
  Conditions:
  - comparevalues{value1=<mythicseasons.windspeed>;operator=GTE;value2=5} true
  Skills:
  - actionmessage{m="<yellow>Strong wind: <white><mythicseasons.windspeed></white> m/s"} @Self

comparevalues reads 5.3 as a number, and the fallback 0.0 fails the test.

WindStreaks:
  Cooldown: 1.2
  Conditions:
  - atmospherewind{min=2;max=5}
  Skills:
  - effect:particles{p=cloud;amount=4;directional=true;direction=<mythicseasons.windx>,0.03,<mythicseasons.windz>;speed=0.45;hSpread=8;ySpread=3;uel=true;audience=self} @Self

With directional=true, particle types that need data, such as DUST, are not drawn. Use cloud, smoke or gust.