Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://www.youtube.com/watch?v=8AQ-NgFGwRA</youtube>
|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/745029" width="552" height="167"><a href="https://visustellamz.itch.io/party-system">Party System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wave 2}}
|link3 = {{VisuStella All Waves Collection}}

}}



{|
| [[File:PartySystemMenu1.png|400px]]
| [[File:PartySystemBattle1.png|400px]]

|-

| [[File:PartySystemScene1.png|400px]]
| [[File:PartySystemScene2.png|400px]]

|}

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |



{{Visustella MZ}}

== Introduction ==

RPG Maker MZ only gives game projects the ability to switch party members
within the main menu and nothing more. There's no inherent functionality to
lock party members, make party members required, and/or give players the
ability to switch party members mid-battle.

This plugin will add in all of those functions as well as a dedicated scene
for switching party members. Party switching will allow party members to be
removed, swapped, and sorted. Through the usage of Plugin Commands, party
members can also be locked and/or required for party presence.

Those using the VisuStella MZ Battle Core will also have access to features
in this plugin that aren't available otherwise. These features give players
the functionality to switch out the whole party lineup mid-battle and/or
individual party member switching.

Features include all (but not limited to) the following:

* Custom scene dedicated to party management.
* Change the maximum number of party members that can participate in battle.
* Plugin Commands to lock party members.
* Plugin Commands to make certain party members required.
* Added functionality with Battle Core to switch party members mid-battle.
* This comes in the form of changing either the whole party at once.
* Or switching individual members out one at a time.

== Requirements ==

This plugin is made for RPG Maker MZ. This will not work in other iterations
of RPG Maker.

{{MZ Tier 2}}

== Major Changes ==

[[File:PartySystemMenu1.png|600px]]

This plugin adds some new hard-coded features to RPG Maker MZ's functions.
The following is a list of them.

---

=== Main Menu Formation Command ===

This command is now changed to send the player to Scene_Party for the
player to have a dedicated scene for changing the party.

---

=== Battle Members Array ===

Previously, the battle members are decided by which actors are lined up
first in the party roster. This has been changed to give players the freedom
to have a party size less than the maximum. This change is made by changing
the way the battle members are determined by using a new array. However, any
and all functions utilize the $gameParty.battleMembers() function will still
behave as normal.

---

=== Formation Change OK Function ===

RPG Maker MZ did not do anything with the Game_Actor.isFormationChangeOk
function so this plugin overwrote it completely to allow for the new
lock and require features to work.

---

=== Temporary Parties ===

Temporary parties are very specific parties that will overwrite whatever the
player has set as a party. These can include current party members or even
actors that haven't joined. The temporary party cannot be changed nor can
the positions of said party members can be changed.

When a temporary party is present, menu and battle commands involving
changing party members will be disabled.

Once the temporary party is disbanded, the player's selected party will be
available once again as well as all of the functions to change party members
and their positions.

---

== Extra Features ==

There are some extra features found if other VisuStella MZ plugins are found
present in the Plugin Manager list.

---

=== [[Battle Core VisuStella MZ]] ===

[[File:PartySystemBattle1.png|600px]]

If the VisuStella MZ Battle Core plugin is present, players are able to
access party switching functionality mid-battle at will. This can be in the
form of switching out the entire active party roster at once or individually
for each actor.

Switching Entire Rosters: This can be done by going into this plugin's
Plugin Parameters => General => Party Command Window => Add Party Command.
If the Party Command Window is accessible, the player will be able to see
the option between 'Auto Battle' and 'Options'.

Individual Member Switching: This requires going to VisuMZ_1_BattleCore's
Plugin Parameters => Actor Command Window => Battle Commands => Command List
and add in the "party" option. The "party" option can also be added to the
<Battle Commands> notetag.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Battle System - OTB VisuStella MZ]] ===

With Battle System - OTB, the player cannot change entire parties at once
from the Party Command Window. The feature will be unaccessible while
Order Turn Battle is in play. However, the player can still change party
members through the Actor Command Window by having actors replace other
actors. Party changing is also available through battle events, Common
Events, and script calls.

---

=== [[Battle System - STB VisuStella MZ]] ===

With Battle System - STB, the player cannot change entire parties at once
from the Party Command Window. The feature will be unaccessible while
Standard Turn Battle is in play. However, the player can still change party
members through the Actor Command Window by having actors replace other
actors. Party changing is also available through battle events, Common
Events, and script calls.

---

{{Plugin Commands MZ}}

{{VisuMZ Party System Plugin Commands}}

== Plugin Parameters ==

=== General Settings ===

[[File:PartySystemParams1.png]]

These Plugin Parameters control the overall behaviors pertaining to the
Party System added with this plugin. These behaviors range from the maximum
number of members that can participate in battle to the availability of the
party switching mechanics.

---

[[File:PartySystemMenu1.png|600px]]

[[File:PartySystemMenu2.png|600px]]

General

Max Battle Members:
- Maximum number of battle members.

---

[[File:PartySystemScene1.png|600px]]

Party Scene

Add Remove Command:
- Add the 'Remove' command to the party scene?

Locked Member Icon:
- Icon used for a locked party member.

Required Member Icon:
- Icon used for a required party member.

Show Back Rectangles?:
- Show back rectangles of darker colors to display information better?

Back Rectangle Color:
- Use #rrggbb for custom colors or regular numbers for text colors
from the Window Skin.

---

[[File:PartySystemBattle2.png]]

Party Command Window
- These require VisuMZ_1_BattleCore!

Add Party Command:
- Add the 'Party' command to the Party Command Window?

Command Cooldown:
- Cooldown (in turns) for this command to be available again.

---

[[File:PartySystemBattle1.png|600px]]

Actor Command Window
- These require VisuMZ_1_BattleCore!

Add Switch Command:
- Add the 'Switch' command to the Actor Command Window?

Command Cooldown:
- Cooldown (in turns) for this command to be available again.

Switch Out Animation?:
- Show the sprites switching out when using individual party
member switching?

TPB: Immediate Action:
- Allow actors to immediate act upon switching in for TPB battle systems?

---

=== Vocabulary Settings ===

[[File:PartySystemParams2.png]]

These Plugin Parameters control the text that you see in-game related to the
Party System plugin.

---

General

Active Party:
- Vocabulary used to represent the Active Party.

Reserve Party:
- Vocabulary used to represent the Reserve Party.

Status:
- Vocabulary used to represent the Status Window.

---

Party Scene > Windows

Empty:
- For the party and status windows when no actor is selected.

Remove:
- For the remove option.

---

Party Scene > Button Assist

Swap Positions:
- Button assist text for the page up/down commands.
- Requires VisuMZ_0_CoreEngine!

Remove:
- Button assist text for the removal command.
- Requires VisuMZ_0_CoreEngine!

Sort:
- Button assist text for the sort command.
- Requires VisuMZ_0_CoreEngine!

Swap In:
- Button assist text for swapping in actors.
- Requires VisuMZ_0_CoreEngine!

Swap Out:
- Button assist text for swapping out actors.
- Requires VisuMZ_0_CoreEngine!

---

Battle Scene

Party Command:
- Command text for entering Party Scene.
- Requires VisuMZ_1_BattleCore!

Help: Formation:
- Help text for Formation command.
- Requires VisuMZ_1_BattleCore!

Queue Message:
- Message to say the Party Scene is queued.
- Requires VisuMZ_1_BattleCore!

Switch Command:
- Command text for switching out members.
- Requires VisuMZ_1_BattleCore!

Help: Switch:
- Help text for Switch command.
- Requires VisuMZ_1_BattleCore!

---

=== Background Settings ===

[[File:PartySystemParams3.png]]

Background settings for Scene_Party.

---

Background Settings

Snapshop Opacity:
- Snapshot opacity for the scene.

Background 1:
- Filename used for the bottom background image.
- Leave empty if you don't wish to use one.

Background 2:
- Filename used for the upper background image.
- Leave empty if you don't wish to use one.

---

=== Window Settings ===

[[File:PartySystemParams4.png]]

If you don't like the locations of the windows in Scene_Party, change them
up with these Plugin Parameters, provided that you have an understanding of
JavaScript code.

---

Active Party Label

Active Party Window

Reserve Party Label

Reserve Party Window

Status Label

Status Window

Battle Switch Window

Background Type:
- Select background type for this window.

Columns:
- Available only for the Reserve Party Window.
- How many columns do you want there to be for the window?

Actor Graphic:
- Available only for Active Party Window and Reserve Party Window.
- Choose how the actor graphics appear in the specific windows.
- Face
- Map Sprite
- Sideview Battler (Requires VisuMZ_1_MainMenuCore)

Map Sprite:
Sideview Battler:

Offset X:
Offset Y:
- If showing map sprites, offset the x or y coordinates.

JS: X, Y, W, H:
- Code used to determine the dimensions for this window.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

If you are using this plugin, credit the following people in your game:

Team VisuStella

* [[Yanfly]]
* [[Arisu]]
* [[Olivia]]
* [[Irina]]

== Changelog ==

Version 1.36: April 20, 2026
* Compatibility Update!
** Added better compatibility for other plugins that add extra commands to the party command window.

Version 1.35: August 14, 2025
* Bug Fixes!
** Fixed a bug where if the battle had no battle back setting and is using a map snapshot, the snapshot would be overwritten if the player enters the party change menu from battle. This should no longer occur and the map snapshot will be preserved. Fix made by Olivia.

Version 1.34: July 17, 2025
* Compatibility Update!
** Added better compatibility with TPB when using the in-battle Party switch command from the Party Command Window. Update made by Irina.

Version 1.33: May 15, 2025
* Compatibility Update!
** Added better compatibility for $gameParty.swapOrder function to allow it to work on the map. Update made by Irina.

Version 1.32: December 19, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash upon adding new members if the VisuStella Core Engine wasn't installed. Fix made by Arisu.

Version 1.31: August 29, 2024
* Documentation Update!
** Help file updated for new features.
** New section added to "Major Changes":
*** Temporary Parties
**** Temporary parties are very specific parties that will overwrite whatever the player has set as a party. These can include current party members or even actors that haven't joined. The temporary party cannot be changed nor can the positions of said party members can be changed.
**** When a temporary party is present, menu and battle commands involving changing party members will be disabled.
**** Once the temporary party is disbanded, the player's selected party will be available once again as well as all of the functions to change party members and their positions.
* New Features!
** New Plugin Commands added by Arisu:
*** Temp: Create Temporary Party (Normal)
**** Creates a temporary party with specific actors.
*** Temp: Create Temporary Party (JS)
**** Creates a temporary party selected with JavaScript.
*** Temp: Disband Temporary Party
**** Clears temporary party.

Version 1.30: April 18, 2024
* Bug Fixes!
** Fixed a bug where party changes with FTB, ETB, and PTB did not replace the newely added party member on the turn order timeline. Fix by Olivia.

Version 1.29: March 14, 2024
* Bug Fixes!
** Fixed a bug where party changes with PTB did not register correctly. Fix made by Olivia.

Version 1.28: November 16, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.27: February 16, 2023
* Optimization Update!
** Plugin should run more optimized.
* Feature Update!
** When holding the "up" keyboard button with the reserve window active, the return to the active party window will no longer happen unless the "up" key is released and then pressed again. Update made by Olivia.

Version 1.26: January 20, 2023
* Compatibility Update!
** Added compatibility functionality for future plugins.

Version 1.25: July 28, 2022
* Bug Fixes!
** Changing party members via actor command with a less than max battle size after removing a middle member midway through battle will no longer cause weird results when switching. Fix made by Arisu.
** Party members that were switched out during battle animations with active TPB/ATB will no longer cause damage popup crashes when switched back in a follow up battle. Fix made by Arisu.

Version 1.24: March 24, 2022
* Compatibility Update!
** Compatibility update with Skills & States Core Passive Conditions involving the party leader. Update made by Arisu.

Version 1.23: January 13, 2022
* Optimization Update!
** Plugin should run more optimized.

Version 1.22: July 16, 2021
* Feature Update!
** Added a fail safe that prevents on-battle start events from triggering when adding party members outside of battle under evented circumstances that function as a bridge between event and battle. Fix by Irina.

Version 1.21: July 9, 2021
* Bug Fixes!
** When using TPB-based battle systems, adding actors to the main party would not enable them to move. This should be fixed. Fix made by Irina.

Version 1.20: July 2, 2021
* Optimization Update!
** Plugin should run more optimized.

Version 1.19: June 18, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.18: April 16, 2021
* Documentation Update!
** Fixed typo. Fix made by Arisu.

Version 1.17: March 26, 2021
* Documentation Update!
** Added "VisuStella MZ Compatibility" section for detailed compatibility explanations with the VisuMZ_2_BattleSystemOTB plugin.

Version 1.16: March 19, 2021
* Compatibility Update
** Added compatibility functionality for future plugins.

Version 1.15: March 5, 2021
* Documentation Update!
** Help file updated for new features.
* New Features
** New Plugin Parameter added by Irina:
*** Plugin Parameters > Gneral > Battle Scene > Battle Party Icon
**** For some reason, we never had a setting that lets you change the party icon. Well, now there is!

Version 1.14: February 5, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu!
*** Party: Move Party Index to Reserve
**** Moves an actor in a specific party index to reserve. Map only. Must be 1 actor left. You may use code.
*** Party: Move Random Reserve to Active
**** Moves a random actor from the reserve party to active. Map only. Must be enough space in active party.

Version 1.13: January 29, 2021
* Documentation Update!
** Help file updated for new features.
* New Features!
** New Plugin Commands added by Arisu!
*** Party: Move Actor(s) to Active
**** Map only. Moves an actor to the active party if there is room.
*** Party: Move Actor(s) to Reserve
**** Map only. Moves an actor to the reserve party.

Version 1.12: January 15, 2021
* Bug Fixes!
** For battle testing, if the number of battle test members exceeds the maximum battle member slots, trim them until they match. Fix by Olivia.

Version 1.11: January 1, 2021
* Compatibility Update
** Plugins should be more compatible with one another.

Version 1.10: December 25, 2020
* Compatibility Update
** Plugins should be more compatible with one another.

Version 1.09: December 18, 2020
* Bug Fixes!
** Removing party members in the active party by event command will now be properly removed from the party. Fix made by Yanfly.

Version 1.08: December 4, 2020
* Bug Fixes!
** With TPB battle systems, after switching out party members, the battle system will no longer carry over any previous active battle members in the command window. Fix made by Yanfly.
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.07: November 22, 2020
* Bug Fixes!
** With Active TPB, switching out a party member mid-action is no longer possible to prevent bugs. Intead, there party switching action will be queued and take effect after the action has been completed. Fix made by Yanfly.
* Compatibility Update!
** Game_Party.swapOrder function now works with this plugin. However, keep in mind that due to how this party system plugin allows you have empty slots in the active battle party, this function will fill in the empty slots upon usage. Update made by Yanfly.

Version 1.06: November 1, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.05: October 25, 2020
* Bug Fixes!
** Plugin Command "Party: Change Max Battle Members" now works again. Fix made by Arisu.

Version 1.04: October 18, 2020
* Compatibility Update!
** Plugins should be more compatible with one another.

Version 1.03: October 11, 2020
* Bug Fixes!
** Adding party members during battle through the party window command will no longer cause crashes after they input an action. Fix made by Yanfly.

Version 1.02: October 4, 2020
* Bug Fixes!
** Adding party members during test play should now work again. Fix made by Irina.
** Changing party members mid-battle through the actor command should now refresh the party followers afterwards. Fix made by Yanfly.
* New Features!
** New Plugin Parameter added by Arisu!
*** General > Party Command Window > TPB: Immediate Action
**** Allow actors to immediate act upon switching in for TPB battle systems?

Version 1.01: September 27, 2020
* Bug Fixes!
** When switching actors with states, buffs, and/or debuffs already applied, the state icons found in the status window will now switch over properly, too. Fix made by Arisu.

Version 1.00: September 7, 2020
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wave 2]]

== Help File ==

|}



[[Category: RPG Maker MZ Battle Plugins]]




[[Category: RPG Maker MZ Gameplay Plugins]]




[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]
[[Category: RPG Maker MZ Menu Plugins]]

[[Category: RPG Maker MZ Quality of Life Plugins]]

Date and Time System VisuStella MZ

2026-04-19T11:40:41Z

Irina: /* Changelog */

{{MzPlugin
|preview = <youtube>https://youtu.be/qOF1qCMqqyU</youtube>

|link1 = <html><iframe frameborder="0" src="https://itch.io/embed/2501190" width="552" height="167"><a href="https://visustellamz.itch.io/date-time-system">Date & Time System plugin for RPG Maker MZ by VisuStellaMZ</a></iframe></html>
|link2 = {{VisuStella Wanderlust Vol 2}}

}}



[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_HUD.png]]

{| style="width: 800px;" cellspacing="0" cellpadding="0"
| style="width: 100%; vertical-align: top;" |

{{RequiredPluginsMZ}}
* [[Core Engine VisuStella MZ]]



{{Visustella MZ}}

== Introduction ==

[[File:VisuMZ.145.jpg|600px]]

Does your game need a time system? This plugin adds time-related mechanics
to RPG Maker MZ, allowing you to control either Game Time, governed by your
own custom rules, or Real Time, synchronized to the player's PC or device.

Features include all (but not limited to) the following:

* Pick between Game Time or Real Time. Game Time uses in-game rules while real time synchronizes the timer with the player's PC or device.
* In Game Time, create custom months, weekdays, and even change up rulings like how many hours a day there are or minutes in an hour.
* Game Time allows for Time Dilation, where you can change how fast a minute occurs or even slow it down. This can be adjusted midgame even.
* Pause and unpause Game Time as you see fit, or even use notetags to halt the passage of Game Time inside certain maps like building interiors.
* Enables usage of real time data, like dates and time. This data can be utilized in-game for variables, switches, and going as far as tinting the screen on certain maps based on the time of day.
* Variables and switches will be automatically updated and can be used to save date and time-related information.
* Recorded data found in variables and switches are highly useful for immediate event usage.
* Determine the screen tone and/or overlay used depending on what time of the day it is.
* Certain message-related text codes can be used to make quick mention of what time it is, certain aspects of a date, seasons, and more.
* Compatibility with other plugins can enable more features to be used, such as date and time-related battle encounters, season items for shops, usage of different tilesets for different dates/times, and more!
* Date/Time HUD is added for the map scene to quickly display information to the player about the date and time.
* The HUD is fully customizable and custom images/icons can be used as well as custom JavaScript code to modify how certain aspects appear in-game.
* Parts of the HUD can be disabled for those who may only want a Time system but not a Date system or vice versa.

== Requirements ==

This plugin is made for RPG Maker MZ. This will not work in other iterations
of RPG Maker.

=== Required Plugin List ===

* [[Core Engine VisuStella MZ]]

This plugin requires the above listed plugins to be installed inside your
game's Plugin Manager list in order to work. You cannot start your game with
this plugin enabled without the listed plugins.

{{MZ Tier 2}}

== Major Changes ==

This plugin adds some new hard-coded features to RPG Maker MZ's functions.
The following is a list of them.

---

=== Tint Screen / Screen Tone ===

[[File:DateTimeSystem_Preview1.gif]]

Although this plugin has screen tones for different times of the day, these
do NOT conflict with the "Tint Screen" command to adjust screen tones like
one may predict. Instead, the ones used in this plugin are a separate tint
effect and can, in fact, be stacked on top of each other.

Keep in mind that if you are using VisuMZ_2_LightingEffects, the screen
tones added by this plugin won't take effect in favor of the overlay system
to better work with the Lighting Effects system.

---

== Extra Features ==

There are some extra features found if other VisuStella MZ plugins are found
present in the Plugin Manager list.

---

=== [[Battle Core VisuStella MZ]] ===

[[File:VisuMZ.002.jpg|300px|link=Battle Core VisuStella MZ]]

If you have VisuStella MZ's Battle Core installed, you will gain access to
a few of the new comment tags available to Troops. These comment tags allow
you to setup which troops that appear based on certain Date and/or Time
conditions.

For example, if you want some enemies that only appear during the day time,
you can use the <Encounter Cycles: Dawn, Day> comment tag. If you want them
to appear at night, <Encounter Cycles: Dusk, Night> will work.

For another example, we can make some enemies that appear only during
specific seasons like <Encounter Season: Winter>. Other setups can be more
numerically involved like during specific months, hours, weekdays, etc.

Keep in mind that if you are using these conditions, all other conditions
need to be met for those Troops, such as which regions they're supposed to
appear in on the map or any other plugin related conditions like for the
VisuStella MZ Conditional Random Encounters plugin.

Battlebacks will need to do the same though the notetag for this will be
placed on the map notebox itself and for seasonal changes only.

---

=== [[Events and Movement Core VisuStella MZ]] ===

[[File:VisuMZ.005.jpg|300px|link=Events and Movement Core VisuStella MZ]]

If you have VisuStella MZ's Events & Movement Core installed, you will gain
access to allowing certain tilesets to swap to another upon loading the map.
Inside the base tileset's notebox, you can insert <Winter Swap To: 7> and it
will exchange itself to tileset 7 if the season happens to be winter.

The effect does not end there, it will perform another check, but this time,
on the new tileset the map was changed to. There, it can optionally perform
another check like <Night Swap To: 8> if desired.

Priority will be given to seasons first, then the day cycles (dawn, day,
dusk, night). This way, you can ensure that the tileset you're using matches
the conditions of the season or time of day if so desired.

If time changes into a new season or day cycle while on the map, there won't
be any changes made immediately. Instead, the player must exit and reenter
the map for the changes to be seen. This is to prevent any awkward changes
and transitions that may occur otherwise. The same applies to battlebacks.

---

=== [[Items and Equips Core VisuStella MZ]] ===

[[File:VisuMZ.006.jpg|300px|link=Items and Equips Core VisuStella MZ]]

If you have VisuStella MZ's Items & Equips Core installed, you will gain
access to new notetags that govern if some items, weapons, or armors can
appear in shops during specific times or dates. This can make way for the
idea of seasonal items and the like where certain holiday cookies are
available during the winter and cool drinks are available during summers.

Additionally, you can have price changes depending on seasons and times.
Is it almost time for the bakery to close, make the items cheaper around
then. What about the holiday season? Make them cheaper again. Make your
players feel the discount frenzy.

---

=== [[Message Core VisuStella MZ]] ===

[[File:VisuMZ.004.jpg|300px|link=Message Core VisuStella MZ]]

If you have VisuStella MZ's Message Core installed, you can access the new
text codes added through this plugin to quickly display times and dates. A
few of these text codes are also used to display seasons, weekdays, parts of
the day cycle, and more. This can be used with both Game Time and Real Time
vocabularies.

---

=== [[Skills and States Core VisuStella MZ]] ===

[[File:VisuMZ.007.jpg|300px|link=Skills and States Core VisuStella MZ]]

Installing VisuStella MZ's Skills & States Core gives you access to several
special notetags that allow you to take advantage of the Date & Time System.

Some of these notetags make it so that some skills can only be used during
specific seasons or times of the day. For example, the skill "Moon Beam" can
only be used during the Night hours. Other things like "Summer Heat" can
only be used during the Summer months.

Other notetags involve changing up how much certain skills cost for MP, HP,
TP, and more. A skill like "Icicle Rain" might cost 200% less MP during the
Summer months while "Solarbeam" might cost 50% less MP during Day hours.

Damage can also be affected by dates and times. Skills like "Vine Whip" can
deal more damage during Spring months and skills like "Nocturnal Healing"
might yield less HP recovery during non-Night hours.

State turns can also benefit from these effects. A "Sleep" state might last
a couple of more turns during the Night hours while "Burn" wouldn't last as
long during Winter months.

---

=== [[Save Core VisuStella MZ]] ===

[[File:VisuMZ.009.jpg|300px|link=Save Core VisuStella MZ]]

Those using the VisuStella MZ Save Core plugin can gain access to another
feature when used together with this plugin. If the player loads a save file
then the game will record the time difference upon loading in minutes onto a
variable. This means that you can detect how long the player has been away
from the game offline and use that as a game mechanic.

In order for this mechanic to work, the Save Core must be implemented, save
the game (with this plugin installed), and then load it. If a save was made
before this plugin is installed, loading the old save file won't give out a
time difference. This is not an error as it is moreso a condition has not
been first met.

This uses Real Time and is based off the player's PC date and time settings.
For what it's worth, it's possible for the player to "cheat" using time
travel shenanigans, but just keep in mind that if a player travels backwards
in time, the variable's value will be negative. Use that information however
you want.

---

== VisuStella MZ Compatibility ==

While this plugin is compatible with the majority of the VisuStella MZ
plugin library, it is not compatible with specific plugins or specific
features. This section will highlight the main plugins/features that will
not be compatible with this plugin or put focus on how the make certain
features compatible.

---

=== [[Lighting Effects VisuStella MZ]] ===

[[File:VisuMZ.099.jpg|300px|link=Lighting Effects VisuStella MZ]]

If you have using VisuStella MZ's Lighting Effects plugin, tints/tones will
not be used, but instead, overlay values will be. This is so that the
overlay can utilize the lighting system in play. Do not be surprised if any
changes to this plugin's tone-related Plugin Parameters do nothing as long
as Lighting Effects is enabled.

---

{{Notetags MZ}}

{{VisuMZ Date and Time System Notetags}}

{{Text Codes MZ}}

{{VisuMZ Date and Time System Text Codes}}

{{Plugin Commands MZ}}

{{VisuMZ Date and Time System Plugin Commands}}

== Script Calls ==

The following are Script Calls that can be used with this plugin. These are
made for JavaScript proficient users. We are not responsible if you use them
incorrectly or for unintended usage.

---

=== Date and Time-Related Script Calls ===

---

<pre>
TimeManager.getYear()

- Gets the current year.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
</pre>

---

<pre>
TimeManager.getMonth()

- Gets the current month.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first month starts at 1.
</pre>

---

<pre>
TimeManager.getDate()

- Gets the current date.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first date starts at 1.
</pre>

---

<pre>
TimeManager.getWeekday()

- Gets the current weekday.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first weekday starts at 1.
</pre>

---

<pre>
TimeManager.getHour()

- Gets the current hour.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- The first hour starts at 0.
</pre>

---

<pre>
TimeManager.getMinute()

TimeManager.getMinuteRaw()

- Gets the current minute.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- If you are using Game Time, you may be using the Plugin Parameter called
"Round Minutes to 10s" where it only shows the minute count for every 10
minutes. The Raw version will return the actual minute value while the
non-raw version will show the selected version if enabled.
- Returns a numeric value.
- The first minute starts at 0.
</pre>

---

<pre>
TimeManager.getSecond()

- Gets the current minute.
- Only works for Real Time.
- Game Time does not use seconds and if you use this, you will always get 0.
- Returns a numeric value.
- The first second starts at 0.
</pre>

---

<pre>
TimeManager.checkSeason()

- Checks the current season based on what month it currently is.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- 1 means Spring.
- 2 means Summer.
- 3 means Autumn.
- 4 means Winter.
</pre>

---

<pre>
TimeManager.checkWeekdayType()

- Checks the current weekday type based on what weekday it currently is.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- 1 means Weekday.
- 2 means Weekend.
</pre>

---

<pre>
TimeManager.checkDayCycle()

- Checks the current day cycle based on what hour it currently is.
- Works for both Game Time and Real Time.
- The value received will depend on which mode you're using at the moment.
- Returns a numeric value.
- 1 means Dawn.
- 2 means Day.
- 3 means Dusk.
- 4 means Night.
</pre>

---

<pre>
TimeManager.forceRefreshHUD()

- For the moment you need force the HUD to refresh.
- Does not happen if you're not on the map and/or not using the HUD.

</pre>

---

== Plugin Parameters ==

=== Default Settings ===

[[File:DateTimeSystem_Preview1.gif]]

These are the default settings for the plugin that determines time type
and time-based screen tones/overlays.

---

Default Settings

[[File:DateTimeSystem_Param1.png]]

Default Map Time Type:
- What do you want to be the default time system?
- Change per map with <Time System: x> notetag.
- None - Time doesn't pass on most maps
- Game - Time passes based on game rules
- Real - Time passes based on real life

[[File:DateTimeSystem_Param2.png]]

Default Map Time Tone:
- Do maps have time-based screen tones/tints?
- Can change with <No Time Tone> or <Time Tone> notetags.

---

=== Game Time General Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param3.png]]

Here are the general settings regarding Game Time.

---

Starting Data:

Start Year:
- What is the number of the starting year?

Start Month:
- What is the number of the starting month?

Start Date:
- What is the number of the starting date?

Start Weekday:
- What is the number of the starting weekday?

Start Hour:
- What is the number of the starting hour?

Start Minute:
- What is the number of the starting minute?

---

Game Time Mechanics:

MS Per Game Minute:
- How many milliseconds will count as a game minute?
- 1000 milliseconds = 1 real life second.

Minutes in an Hour:
- How many minutes are there in an hour?
- This is for Game Time only.

Round Minutes to 10s:
- Rounds the displayed minutes to 10's so they only visually update every
10 Game Time minutes.

Hours in a Day:
- How many hours are there in a day? This is for Game Time only.

JS: Check Leap Year:
- Code used to determine how a year is considered a leap year.

---

Pause Conditions:

If Event Running:
- Pauses Game Time update if an event is running?
- Doesn't apply to Parallels. Applies to Autorun.

If Forced Player Move:
- Pauses Game Time update if player movement is forced?
- Doesn't apply to Parallels. Applies to Autorun.

If Gather Followers:
- Pauses Game Time update if followers are gathering?
- Doesn't apply to Parallels. Applies to Autorun.

If Vehicle Entry/Exit:
- Pauses Game Time update if followers are gathering?
- Doesn't apply to Parallels. Applies to Autorun.

---

Month Structure:

List of Months:
- Here, adjust the in-game months for Game Time.
- Months will occur in the order they're in.

Name:
- What is the name of the month?

Abbreviation:
- What is the abbreviation of this month?

Total Days:
- How many days are there in this month?

Leap Month?:
- Is this month a leap month?
- It'll get an extra day each leap year.

Season:
- What season is this month a part of?
- Spring
- Summer
- Autumn
- Winter

---

Weekday Structure:

List of Weekdays:
- Here, adjust the in-game weekdays for Game Time.
- Weekdays will occur in the order they're in.

Name:
- What is the name of this weekday?

Abbreviation:
- What is the abbreviation of this weekday?

Weekday Type:
- Is this day part of the weekdays or weekend?
- Weekday
- Weekend

---

Day Structure:

Dawn Hours:
- What hours are considered "Dawn" hours?
- This is for Game Time only.

Day Hours:
- What hours are considered "Day" hours?
- This is for Game Time only.

Dusk Hours:
- What hours are considered "Dusk" hours?
- This is for Game Time only.

Night Hours:
- What hours are considered "Night" hours?
- This is for Game Time only.

---

=== Game Time Tone Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param4.png]]

These settings determine the screen tones used for Game Time and will occur
the order the hours appear.

---

Tone Settings

Tone:
- What tone/tint is used for various Game Time hours?
- Format: [Red, Green, Blue, Gray]. Starts at 0:00.

---

=== Game Time Overlay Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param5.png]]

These settings determine the screen tones used for Game Time and will occur
the order the hours appear.

Requires VisuMZ_2_LightingEffects!

---

Overlay Settings

Overlay:
- What overlay is used for this hour? Starts at 0:00.
- Format: #rrggbb.
- Requires VisuMZ_2_LightingEffects!

---

=== Game Time Variables & Switches ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param6.png]]

Adjust the variables and switches that record data here. These will be
automatically updated upon time changes.

Changing these variables' values does not mean the Game Time will be
changed in-game. These variables are just for automatically reading what
the Game Time is. If you wish to change the Game Time, you will need to use
the Plugin Commands "Change Date To" and "Change Time To" instead.

---

Calendar:

Year Variable:
- Select a variable to record the year.
- Leave at 0 to not use.

Month Variable:
- Select a variable to record the month.
- Leave at 0 to not use.

Date Variable:
- Select a variable to record the date.
- Leave at 0 to not use.

Full Date Variable:
- Select a variable to record the full date.
- Leave at 0 to not use.
- Result is year + month (2 digits) + date (2 digits)
- For example, Year 2, Month 4, Date 12 will yield 20412

---

Weekday:

Weekday Variable:
- Select a variable to record the weekday.
- Leave at 0 to not use.

---

Time:

Hour Variable:
- Select a variable to record the hour.
- Leave at 0 to not use.

Minute Variable:
- Select a variable to record the minute.
- Leave at 0 to not use.

Second Variable:
- Select a variable to record the second.
- Leave at 0 to not use.
- Not available for Game Time.

Full Time Variable:
- Select a variable to record the full time.
- Leave at 0 to not use.
- Result is hour + minutes (2 digits) + seconds (2 digits)
- For example, Hour 16, Minute 8, Seconds 0 will yield 160800

---

Seasons:

Spring Switch:
- Turns on when season is a "Spring" month.
- Leave at 0 to not use.

Summer Switch:
- Turns on when season is a "Summer" month.
- Leave at 0 to not use.

Autumn Switch:
- Turns on when season is a "Autumn" month.
- Leave at 0 to not use.

Winter Switch:
- Turns on when season is a "Winter" month.
- Leave at 0 to not use.

---

Days:

Weekday Switch:
- Turns on when day is "Weekday". Leave at 0 to not use.

Weekend Switch:
- Turns on when day is "Weekend". Leave at 0 to not use.

---

Hours:

Dawn Switch:
- Turns on when time is "Dawn" hours. Leave at 0 to not use.

Day Switch:
- Turns on when time is "Day" hours. Leave at 0 to not use.

Dusk Switch:
- Turns on when time is "Dusk" hours. Leave at 0 to not use.

Night Switch:
- Turns on when time is "Night" hours. Leave at 0 to not use.

---

=== Game Time Vocabulary Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param7.png]]

Here are the vocabulary-related terms involving Game Time.

---

Seasons:

Spring:
- How "Spring" is displayed.

Summer:
- How "Summer" is displayed.

Autumn:
- How "Autumn" is displayed.

Winter:
- How "Winter" is displayed.

---

Weekday Type:

Weekday:
- How "Weekday" is displayed.

Weekend:
- how "Weekend" is displayed.

---

Time-Related:

Meridiem:

Ante Meridiem:
- How "Ante Meridiem" is displayed.

Post Meridiem:
- How "Post Meridiem" is displayed.

---

Day Cycle:

Dawn:
- How "Dawn" is displayed.

Day:
- How "Day" is displayed.

Dusk:
- How "Dusk" is displayed.

Night:
- How "Night" is displayed.

---

=== Real Time General Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param8.png]]

Here are the general settings regarding Real Time.

---

Seasonal Months:

Spring Months:
- Which Real Time months are Spring months for this game?

Summer Months:
- Which Real Time months are Summer months for this game?

Autumn Months:
- Which Real Time months are Autumn months for this game?

Winter Months:
- Which Real Time months are Winter months for this game?

---

Week Structure:

Weekdays:
- Which Real Time weekdays are considered "Weekdays"?

Weekends:
- Which Real Time weekdays are considered "Weekends"?

---

Day Structure:

Dawn Hours:
- What hours are considered "Dawn" hours?
- Use military time.

Day Hours:
- What hours are considered "Day" hours?
- Use military time.

Dusk Hours:
- What hours are considered "Dusk" hours?
- Use military time.

Night Hours:
- What hours are considered "Night" hours?
- Use military time.

---

VisuMZ_1_SaveCore:

Difference Variable:
- Select a variable that records the time difference from the last save
game and the current load game in minutes.

---

=== Real Time Tones & Overlay Settings ===

[[File:DateTimeSystem_Preview1.gif]]

[[File:DateTimeSystem_Param9.png]]

Adjust the tones and overlay settings to change what color the screen will
appear based on the time of day.

---

Screen Tones/Tints

00:00 / 12 AM to 23:00 / 11 PM:
- What tone/tint is used for this hour?
- Format: [Red, Green, Blue, Gray]

---

Screen Overlay

00:00 / 12 AM to 23:00 / 11 PM:
- What overlay is used for this hour?
- Format: #rrggbb.
- Requires VisuMZ_2_LightingEffects!

---

=== Real Time Variables & Switches ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param10.png]]

Adjust the variables and switches that record data here. These will be
automatically updated upon time changes.

Changing these variables' values does not mean the Real Time will be
changed in-game. These variables are just for automatically reading what
the Real Time is. Real Time value cannot be changed by the plugin.

---

Calendar:

Year Variable:
- Select a variable to record the year.
- Leave at 0 to not use.

Month Variable:
- Select a variable to record the month.
- Leave at 0 to not use.

Date Variable:
- Select a variable to record the date.
- Leave at 0 to not use.

Full Date Variable:
- Select a variable to record the full date.
- Leave at 0 to not use.
- Result is year + month (2 digits) + date (2 digits)
- For example, Year 2, Month 4, Date 12 will yield 20412

---

Weekday:

Weekday Variable:
- Select a variable to record the weekday.
- Leave at 0 to not use.

---

Time:

Hour Variable:
- Select a variable to record the hour.
- Leave at 0 to not use.

Minute Variable:
- Select a variable to record the minute.
- Leave at 0 to not use.

Second Variable:
- Select a variable to record the second.
- Leave at 0 to not use.
- Not available for Game Time.

Full Time Variable:
- Select a variable to record the full time.
- Leave at 0 to not use.
- Result is hour + minutes (2 digits) + seconds (2 digits)
- For example, Hour 16, Minute 8, Seconds 0 will yield 160800

---

Seasons:

Spring Switch:
- Turns on when season is a "Spring" month.
- Leave at 0 to not use.

Summer Switch:
- Turns on when season is a "Summer" month.
- Leave at 0 to not use.

Autumn Switch:
- Turns on when season is a "Autumn" month.
- Leave at 0 to not use.

Winter Switch:
- Turns on when season is a "Winter" month.
- Leave at 0 to not use.

---

Days:

Weekday Switch:
- Turns on when day is "Weekday". Leave at 0 to not use.

Weekend Switch:
- Turns on when day is "Weekend". Leave at 0 to not use.

---

Hours:

Dawn Switch:
- Turns on when time is "Dawn" hours. Leave at 0 to not use.

Day Switch:
- Turns on when time is "Day" hours. Leave at 0 to not use.

Dusk Switch:
- Turns on when time is "Dusk" hours. Leave at 0 to not use.

Night Switch:
- Turns on when time is "Night" hours. Leave at 0 to not use.

---

=== Real Time Vocabulary Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param11.png]]

Here are the vocabulary-related terms involving Real Time.

---

Month Names:

Full Names:

Month 1 to 12:
- Name of this month.

Abbreviations:

Month 1 to 12:
- Abbreviation of this month.

---

Seasons:

Spring:
Summer:
Autumn:
Winter:
- How this season is displayed.

---

Weekday Names:

Full Names:

Weekday 1 to Weekday 7:
- Name of this weekday.

Abbreviation:

Weekday 1 to Weekday 7:
- Abbreviation of this weekday.

Weekday Type:

Weekday:
Weekend:
- How "Weekday/end" is displayed.

---

Time-Related:

Meridiem:

Ante Meridiem:
Post Meridiem:
- How "Ante/Post Meridiem" is displayed.

Day Cycle:

Dawn:
Day:
Dusk:
Night:
- How "Dawn", "Day", "Dusk", "Night" is displayed.

---

=== Date/Time HUD Sprites ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param12.png]]

These settings let you adjust the HUD sprites displayed for this plugin.

---

General:

Enabled?:
- Enables usage of the Date/Time HUD.

Show by Default:
- Sets up default visibility of the Date/Time HUD.
- Individual maps can be adjusted by notetags.

Opacity Speed:
- How fast does fade in/out work?
- Lower is slower. Higher is faster.

---

Position:

Position X:
- How much to position the HUD's X by.
- Negative: left. Positive: right.

Position Y:
- How much to position the HUD's Y by.
- Negative: up. Positive: down.

---

Season Sprite:

Enabled?:
- Enables usage of this sprite.

Opacity:
- What is the default opacity for this sprite?
- Use a value between 0 and 255.

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

Scale:

Scale X:
- What is the scale used for this sprite icon's X?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Scale Y:
- What is the scale used for this sprite icon's Y?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Icons:

Spring Icon:
Summer Icon:
Autumn Icon:
Winter Icon:
- What icon is used for this months?
- Ignore if there is an image equivalent.

Images:

Spring Image:
Summer Image:
Autumn Image:
Winter Image:
- What image is used for spring months?
- Ignores any icon equivalents.

---

DayCycle Sprite:

Enabled?:
- Enables usage of this sprite.

Opacity:
- What is the default opacity for this sprite?
- Use a value between 0 and 255.

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

Scale:

Scale X:
- What is the scale used for this sprite icon's X?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Scale Y:
- What is the scale used for this sprite icon's Y?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Icons:

Dawn Icon:
Day Icon:
Dusk Icon:
Night Icon:
- What icon is used for these day cycle hours?
- Ignore if there is an image equivalent.

Images:

Dawn Image:
Day Image:
Dusk Image:
Night Image:
- What image is used for these day cycle hours?
- Ignores any icon equivalents.

---

Weekday Type Sprite:

Enabled?:
- Enables usage of this sprite.

Opacity:
- What is the default opacity for this sprite?
- Use a value between 0 and 255.

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

Scale:

Scale X:
- What is the scale used for this sprite icon's X?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Scale Y:
- What is the scale used for this sprite icon's Y?
- 0.0 - 0%; 0.5 - 50%; 1.0 - 100%; 1.5 - 150%; 2.0 - 200%

Icons:

Weekday Icon:
Weekend Icon:
- What icon is used for weekdays?
- Ignore if there is an image equivalent.

Images:

Weekday Image:
Weekend Image:
- What image is used for weekdays?
- Ignores any icon equivalents.

---

Year Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Year Format:
- How is the year written when it's less than 4 digits?
- %1 - Current Year

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Month Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Date Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Weekday Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

Time Sprite:

Enabled?:
- Enables usage of this sprite.

Angle:
- What is the angle used for this sprite?
- Value is written in degrees.

Size:

Width:
- What is the width of this sprite in pixels?

Height:
- What is the height of this sprite in pixels?

Anchor:

Anchor X:
- Anchor X value for this sprite.
- 0.0 - left; 0.5 - center; 1.0 - right

Anchor Y:
- Anchor Y value for this sprite.
- 0.0 - top; 0.5 - middle; 1.0 - bottom

Offset:

Offset X:
- How much to offset this sprite's X by.
- Negative: left. Positive: right.

Offset Y:
- How much to offset this sprite's Y by.
- Negative: up. Positive: down.

JS: Draw Text:
- Code used to draw the text for this sprite.

---

=== Date/Time HUD Options Settings ===

[[File:DateTimeSystem_HUD.png]]

[[File:DateTimeSystem_Param13.png]]

Options settings for the Date & Time System.

---

Options:

Add Option?:
- Add the 'Date Time HUD' option to the Options menu?

Adjust Window Height:
- Automatically adjust the options window height?

Option Name:
- Command name of the option.

---

{{VisuStella MZ Terms of Use}}

== Credits ==

If you are using this plugin, credit the following people in your game:

Team VisuStella
* [[Irina]]
* [[Arisu]]
* [[Olivia]]
* [[Yanfly]]

== Changelog ==

Version 1.07: April 20, 2026
* Bug Fixes!
** Loading a previous save would yield any potential time changes from any action committed afterwards that weren't saved. This should be fixed now. Fix made by Arisu.

Version 1.06: September 18, 2025
* Bug Fixes!
** Fixed a bug where manual game time updates made by Plugin Commands would not allow variables to update if Game Time was paused. Fix made by Arisu.

Version 1.05: August 14, 2025
* Documentation Update!
** Added warning to these Plugin Commands:
*** Game Time: Record to Variable(s)
*** Real Time: Record to Variable(s)
**** Does NOT overwrite automatic variables used in Plugin Parameters.
** Added segment to Plugin Parameters: Game Time Variables & Switches
*** Changing these variables' values does not mean the Game Time will be changed in-game. These variables are just for automatically reading what the Game Time is. If you wish to change the Game Time, you will need to use the Plugin Commands "Change Date To" and "Change Time To" instead.
** Added segment to Plugin Parameters: Real Time Variables & Switches
*** Changing these variables' values does not mean the Real Time will be changed in-game. These variables are just for automatically reading what the Real Time is. Real Time value cannot be changed by the plugin.

Version 1.04: November 14, 2024
* Bug Fixes!
** Fixed a bug where turns were added to each state without using any of the notetag effects. Fix made by Olivia.

Version 1.03: May 16, 2024
* Bug Fixes!
** Fixed a bug where the Winter switch would turn on during summer. Fix made by Irina.

Version 1.02: April 18, 2024
* Bug Fixes!
** Fixed a bug where "Show by Default" plugin parameter did not register. Fix made by Olivia.
* Feature Update!
** Default option state for the Date & Time HUD will be true for those not using the Options Core. Update by Olivia.

Version 1.01: February 15, 2024
* Bug Fixes!
** Fixed a bug that would cause a crash when using Real Time and skip title. Fix made by Irina.
** Fixed a bug where seasonal tilesets could cause a crash. Fix by Irina.

Version 1.00 Official Release Date: February 19, 2024
* Finished Plugin!

== See Also ==

* [[Inspiration Behind Wanderlust Volume 2]]

== End of Helpfile ==

|}








[[Category: RPG Maker MZ Gameplay Plugins]]



[[Category: RPG Maker MZ Eventing Plugins]]
[[Category: RPG Maker MZ Utility Plugins]]
[[Category: RPG Maker MZ Mechanical Plugins]]
[[Category: RPG Maker MZ Visual Plugins]]