Commands And Permissions
MythicSeasons has one admin command, /ms (also /mythicseasons), and six player commands. This page uses the default names from commands.yml.
<argument> is required, [argument] optional. A left-out [world] is the sender's world, and the console has to name one (Add a world: /ms <command> <world>).
Messages come from the language file, apart from a few fixed English texts and the list /ms biomelist writes to the console.
commands.yml
plugins/MythicSeasons/commands.yml has one entry per command. Changes need a restart.
| Option | What it does |
|---|---|
<entry>.enabled |
false removes the command and its /ms help line. |
<entry>.name |
What players type. It is turned into lowercase and a leading slash is dropped. A name with a space or a colon keeps the default, with a warning. |
<entry>.aliases |
Other names for the command. Invalid ones are skipped with a warning. |
| Entry | Default name | Aliases |
|---|---|---|
ms |
ms |
mythicseasons |
toggleseasoncolors |
toggleseasoncolors |
none |
toggletemperature |
toggletemperature |
none |
toggleseasonparticles |
toggleseasonparticles |
none |
togglefahrenheit |
togglefahrenheit |
none |
cloudquality |
cloudquality |
none |
togglecloudlayer |
togglecloudlayer |
none |
- When another plugin has the name, the command only works as
/mythicseasons:<name>, and the console names the key to change. - A missing entry or key takes the bundled value.
/seasonand/currentbiomeare gone. Use/ms getinfo.
Player commands
| Command | Permission | What it does |
|---|---|---|
/ms getinfo [world] |
mythicseasons.getinfo |
Season information, see Season information. |
/toggleseasoncolors |
mythicseasons.toggleseasons |
Turns season colours, block replacements and populators off or on for you. |
/toggleseasonparticles |
mythicseasons.toggleparticles |
Turns season particles off or on for you: player-tick-particles skills skip you and <mythicseasons.particles> reads false. |
/toggletemperature [player] |
mythicseasons.toggletemperature, with a name mythicseasons.toggletemperature.others |
Hides or shows the temperature readout for you or an online player. |
/togglefahrenheit |
mythicseasons.togglefahrenheit |
Switches your readout between Celsius and Fahrenheit, the opposite of display.convert-to-fahrenheit in temperature.yml. |
/cloudquality [quality] |
mythicseasons.cloudquality |
Sets your cloud detail to off or a preset from clouds.quality.presets (shipped low, medium, high). Players without a valid choice get clouds.quality.default (shipped high). See Quality. |
/togglecloudlayer [layer] |
mythicseasons.togglecloudlayer |
Hides or shows a group of cloud layers for you. See Player toggles. |
- Everyone has these permissions by default, except
mythicseasons.toggletemperature.others(operators). - The console can use
/ms getinfo <world>and/toggletemperature <player>. The others answerPlayers only. - Choices are saved in
data.yml(players.colorsdisabled,particlesdisabled,tempdisabled,fahrenheit-mode,cloud-qualityandcloud-layers) everyperformance.autosave-interval-minutes, at season changes and at shutdown, so a crash can lose the latest ones. /toggleseasoncolorsonly changes chunks sent afterwards (new chunks, a season or phase change, rejoining)./toggletemperature <player>needs.others, also for your own name. Off also hides the pack's warnings (hastemperaturebecomes false), but temperature keeps working.
Season information
What /ms getinfo [world] shows:
| Line | Shown when |
|---|---|
| Season | The world has a season. Otherwise, and in the Nether and the End, it prints Seasons are off in this world. |
| Date, days until the next season, time, events, days until the next event | The calendar is on and the world has a date. The days lines also need a next season in season-cycle and an upcoming event. |
| Air temperature | A player ran it without a world name, and temperature is on. |
A line left empty in the language file is not sent.
Seasons and calendar
These need mythicseasons.admin. Nether and End worlds cannot have seasons (No seasons in the Nether or the End).
| Command | What it does |
|---|---|
/ms set <season> [world] |
Sets the season by id, in any case. Without a valid id it lists the ids. With the calendar and sub-seasons on, it also moves the date to the middle of the season, even when that season is already active: next year if the date is on or past that day, year 0 in a world that had no season. |
/ms nextseason [world] |
Moves to the next season in season-cycle and the date to its start (next year if that day has passed). Prints nothing on success, and does nothing when the current season is not in season-cycle. |
/ms disable [world] |
Turns seasons off and resends chunks. The date is kept, and the daylight cycle game rule comes back on when modify-daynight-length is on. |
/ms setdate <date> [world] |
Sets the date, see Calendar. |
/ms pausetime [world] |
Pauses or resumes time, see The clock. |
/ms event list [world] |
Lists the running events and the others. |
/ms event start <event> [world] |
Starts an event and runs its start lines. It stays on until /ms event stop, the end of its schedule, /ms reload or a restart. Refused in a world without a season, in worlds-without-events, in the event's disabled-worlds and when another plugin cancels it. |
/ms event stop <event> [world] |
Stops an event and runs its stop lines. It stays off until /ms event start, its schedule starts it again, /ms reload or a restart. Refused in a world without a season. |
/ms set(when it moves the date),/ms nextseasonand/ms setdatecount as a date change, so events start and stop as on a new day. To test a dated event, move the date from outside its range into it.- With
automatic-season-cyclingon, the calendar puts the date's season back within a second, so/ms setonly sticks when it moves the date. Otherwise use/ms nextseasonor/ms setdate. Withsync-time-with-real-world: true, onlyautomatic-season-cycling: falselets a command pick the season. - In
synced-worldsthe date furthest ahead wins within a second: a date a command sets is replaced when another synced world is ahead, and copied to the others otherwise. - For a season with no usable length in
calendar.yml(no start date or no next season),/ms setkeeps the date:Date unchanged, <season> has no usable length in calendar.yml.
Temperature commands
These need mythicseasons.admin. See Temperature.
| Command | What it does |
|---|---|
/ms temperature toggle [world] |
Turns temperature on or off for a world, also in the Nether and the End. Saved in data.yml. |
/ms temperature modify <player> <change> <seconds> |
Adds a timed change of <change> whole degrees (negative cools) to an online player, on the real clock and kept over restarts and logouts. All changes together stay within temperature-modify-command.min and .max of config.yml. 0 seconds or less expires at once. |
/ms temperature modify <player> <change> FIXED(<min>,<max>) |
Silently adds <change> to the player's running total, kept between <min> and <max>. FIXED(<min>,<max>,<ticks>) takes the change back after that many ticks, never past 0. The total lives in memory only: a restart clears it, clear does not, and the config.yml limits do not apply. |
/ms temperature clear <player> |
Removes the player's timed modify changes. The FIXED total and ModifyTemp modifiers stay. |
/ms temperature info <player> |
The player's body and air temperature, the sum of their timed changes and whether temperature is on for them. |
Write FIXED in capitals, with commas and no spaces. The plain form counts seconds, the third FIXED number ticks.
/ms temperature modify Steve -5 FIXED(-20,20)
Lowers Steve's running total by 5 and keeps it between -20 and 20 until the next restart.
Atmosphere commands
These need mythicseasons.admin. Console output goes to the server log, see Debugging.
| Command | What it does |
|---|---|
/ms weather <preset> [radius] [minutes] |
Players only. Forces the simulated weather around you: clear dries the air, rain moistens it, storm also adds rising air for thunderstorms, reset ends every forced weather in your world, skills' included. Radius in blocks (default 1024), duration in real minutes (default 10). |
/ms atmosphere or /ms atmosphere info |
The simulation's settings, every enabled world with its regions, the cloud layer with its presets, and the cloud fog pack. |
/ms atmosphere toggle [world] |
Turns the simulation on or off in an overworld-type world, saved in data.yml. With the master switch in atmosphere.yml off, nothing runs until it is on and /ms reload has run. |
/ms atmosphere stats |
Players only. The weather and clouds at your position and in the levels above you. |
/ms atmosphere debug [field] |
Players only. Live boss bars and particles for temp, wind, precip and cloud, each toggled on its own. Without a field it turns everything off, or temp on when nothing was on. |
/ms atmosphere profile [world] |
The atmosphere settings and cloud layers that apply to the world, and where each comes from. |
/ms atmosphere profiles |
Lists the files in atmosphere-profiles (shipped: example and mars). |
/ms atmosphere dumpclouds |
Players only. Writes your clouds to plugins/MythicSeasons/debug/cloud-dump-<player>-<time>.txt. |
atmoworks in place ofatmosphere./ms weatherprintsNo simulated weather herewhere this server does not simulate the weather.- On the shipped settings
clearworks in about 10 seconds,rainin about half a minute (summer air may thunder), andstormthunders in about 20 seconds in spring and summer, 2 minutes in winter.
/ms weather rain 512 5
Rain within 512 blocks of you for 5 minutes.
Plugin commands
| Command | Permission | What it does |
|---|---|---|
/ms or /ms help |
none | The command list. Only the console and holders of mythicseasons.admin see the admin commands. |
/ms reload |
mythicseasons.admin |
Reloads the files, see Reloading. |
/ms debug |
mythicseasons.admin |
Toggles debug mode (off again after a restart) and reloads. While on, the console logs a stack trace whenever MythicSeasons itself loads a chunk (only if modify-blocks was on at startup). |
/ms health |
mythicseasons.admin |
Chunk rewrite times over the last 200 chunks (not active while none are rewritten) and the pending MythicSeasons scheduler tasks. |
/ms biomelist |
mythicseasons.admin |
Writes the plugin's biomes and their replacements per season (and per phase with sub-seasons on) to the console. |
An unknown subcommand prints Unknown command, see /ms help. Without mythicseasons.admin, everything except help and getinfo answers No permission.
Reloading
/ms reload reads, in this order: config.yml, seasons/, crops.yml, lang/, temperature.yml, calendar.yml, events/, the season populators and block replacements, then atmosphere.yml with its folders and the atmosphere sections of the biome files. Chunks players already have are not sent again.
- It prints
Reloadedand, every time,Biome file changes need a restart. - When a step fails it prints
Reload stopped part-way: <error>, and the steps before it stay applied. Ifconfig.ymlcannot be read, nothing is reloaded. - A YAML error in a season file,
temperature.yml,calendar.ymloratmosphere.ymlonly shows in the console, and the reload still reports success. A brokencalendar.ymlkeeps the previous calendar.
These need a restart:
| File | Not reloaded |
|---|---|
biomes/ |
Everything except the atmosphere sections: colours, replacements, freeze-in-winter, show-snow-instead-of-rain, temperature-difference. |
| season files | foliage-transitions. |
config.yml |
performance.*, biome-display-name, optimized-custom-biomes and the colour blending order of season-cycle. |
atmosphere.yml |
grid.cell-size, grid.y-min, grid.y-max, timing.step-period-ms, timing.time-acceleration, physics.solver-threads, shared-weather-group and clouds.enabled. |
calendar.yml |
time-sync-timezone set back to system. |
commands.yml, griefprevention.yml |
Everything. |
The MythicMobs pack reloads with /mm reload, see Packs. data.yml is only read at startup.
Tab completion
Suggestions only offer what the sender may use. atmo works but is never offered.
Permissions
| Permission | Default | Checked by |
|---|---|---|
mythicseasons.admin |
operators | Every /ms subcommand except help and getinfo, the admin part of /ms help and of the /ms suggestions, the /ms set hint of /ms getinfo, and the welcome that, while no world has a season, tells the first holder to join to run /ms set <season>. |
mythicseasons.getinfo |
everyone | /ms getinfo and its suggestions. |
mythicseasons.toggleseasons |
everyone | /toggleseasoncolors. |
mythicseasons.toggleparticles |
everyone | /toggleseasonparticles. |
mythicseasons.toggletemperature |
everyone | /toggletemperature for yourself. |
mythicseasons.toggletemperature.others |
operators | /toggletemperature <player>, also with your own name. |
mythicseasons.togglefahrenheit |
everyone | /togglefahrenheit. |
mythicseasons.cloudquality |
everyone | /cloudquality and its suggestions. |
mythicseasons.togglecloudlayer |
everyone | /togglecloudlayer and its suggestions. |
- There is no
mythicseasons.*node, andmythicseasons.admindoes not include the others. A group with onlymythicseasons.admincannot use/toggletemperature <player>, although it can use/ms temperatureon anyone. - The console passes every check.