Chronus - Chronus.js

Plugin desc : In-game time introduction plugin

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com/

Desc page : https://triacontane.blogspot.com/

Download Page : https://raw.githubusercontent.com/munokura/triacontane-MV-plugins/refs/heads/main/Chronus.js

File name : Chronus.js

Help of plugin :

@url https://triacontane.blogspot.com/
@plugindesc In-game time introduction plugin
@author Triacontane
@license MIT License

@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help，
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/triacontane-MV-plugins ).
Original plugin by Triacontane.
Please check the latest official version at:
https://triacontane.blogspot.com
-----

This plugin lets you express the concepts of time and weather in-game.
Time passes during autoplay， map navigation， and combat， and weather and
color tones change over time.
These times can be adjusted， and time will stop during events.

It also has a function to reflect real-world time in-game.
Enabling this setting will link real-world time with in-game time.

It also records the date and day of the week， and you can freely set the
number and names of days.
The current date is displayed in the upper left corner of the screen
according to the format.

The following date formats are available:
YYYY: Year MON: Month Name MM: Month DD: Day HH24: Hour (24 hours) HH: Hour
(12 hours)
AM: Morning or Afternoon MI: Minute DY: Day of the Week TZ: Time Zone Name
DDALL: Total Number of Days

You can also display an analog clock by providing a standard image.
The display position and whether each image is displayed can be adjusted.

The image standards are as follows:
-Dial:A square image of any size.
-Long Hand:An image of the hand the same size as the dial， pointing up (0).
-Hour Hand:An image of the hand the same size as the dial， pointing up (0).

I requested a clock image that conforms to the Tsukumate standard.
If you wish to use it， please read the terms of use separately at the
following URL before use.
http://tm.yumineko.com/viewtopic.php?f=47&t=555&p=1615#p1615

Plugin Command Details
Execute from the "Plugin Command" event command.
The specified value can contain the control character ￥V[n].
(Arguments must be separated by a space.)

C_ADD_TIME [minutes]: The specified number of minutes will elapse.
C_ADD_DAY [days]: The specified number of days will elapse.
C_SET_TIME [hour] [minute]: Changes to the specified time.
C_SET_DAY [year] [month] [day]: Changes to the specified date.
C_STOP: Stops time from progressing.
C_START: Starts time from progressing.
C_SHOW: Shows the calendar.
C_HIDE: Hides the calendar.
C_DISABLE_TINT: Prevents color changes based on the time of day.
C_ENABLE_TINT: Allows color changes based on the time of day.
C_DISABLE_WEATHER: Prevents weather from changing over time.
C_ENABLE_WEATHER: Allows weather to change over time.
C_SET_SNOW_LAND: Enables snow to fall in bad weather.
C_RESET_SNOW_LAND: Enables rain or storms to fall in bad weather.
C_SET_SPEED [minutes]
: Sets the rate at which time passes per second in real time.
C_SHOW_CLOCK: Displays the analog clock.
C_HIDE_CLOCK: Hides the analog clock.
C_SET_TIME_REAL: Changes the time acquisition method to real time.
C_SET_TIME_VIRTUAL: Changes the time acquisition method to in-game time.
C_SET_RAINY_PERCENT [probability]
: Sets the probability of precipitation (0-100).
C_INIT_TOTAL_TIME
: Initializes the cumulative time and cumulative number of days.

-Analog Clock Image Change Command
You can change the analog clock image filename (img/pictures).
However， the image will only actually change after moving maps.
C_SET_CLOCK_BASE [filename]: Changes the filename of the clock face image.
C_SET_HOUR_HAND [filename]: Changes the filename of the hour hand image.
C_SET_MINUTE_HAND [filename]
: Changes the file name of the minute hand image.

- Timer Operation Commands
This command turns on a switch or self-switch after a specified number of
minutes have elapsed since the command was executed.

Can also be used in conjunction with the real-time linkage function.
For switches， specify the ID， and for self-switches， specify the type
 (A， B， C， D).

C_SET_SWITCH_TIMER [minutes] [switch ID] [loop]
Example (Turn on switch [10] every 30 minutes in-game time).
C_SET_SWITCH_TIMER 30 10 ON

C_SET_SELF_SWITCH_TIMER [minutes] [self-switch type] [loop]
Example (Turn on self-switch [B](※) after 3 hours in-game time).
C_SET_SELF_SWITCH_TIMER 180 B OFF
*The target event is the event that executed the plugin command.

If there's a possibility that the timer may be canceled or paused midway，
execute a command specifying the [timer name].

C_SET_SWITCH_NAMED_TIMER [Timer Name] [Minute] [Switch ID] [Loop]
Example (Turn on switch [10] every 30 minutes in-game time).
C_SET_SWITCH_NAMED_TIMER timer 30 10 ON

C_SET_SELF_SWITCH_NAMED_TIMER [Timer Name] [Minute] [Self-Switch Type] [Loop]
Example (Turn on self-switch [B](*) after 3 hours in-game time).
C_SET_SELF_SWITCH_NAMED_TIMER timer 180 B OFF
*The target event is the event that executed the plugin command.

The commands for canceling， stopping， and restarting are as follows:
C_CLEAR_TIMER timer # Cancels timer name "timer".
C_STOP_TIMER timer # Pauses timer name "timer".
C_START_TIMER timer # Resumes timer name "timer".

This is an alarm function that allows you to operate the switch by
specifying a time instead of a time.
[Year， Month， Hour， Minute] should be specified in "YYYYMMDDHHMM" format.
To cancel， use the timer command.
C_SET_SWITCH_ALARM [Year， Month， Hour， Minute] [Switch ID] [Interval]
C_SET_SELF_SWITCH_ALARM [Year， Month， Hour， Minute] [Self-Switch Type]
[Interval]
C_SET_SWITCH_NAMED_ALARM [Alarm Name] [Year， Month， Hour， Minute] [Switch ID]
[Interval]
C_SET_SELF_SWITCH_NAMED_ALARM [Alarm Name] [Year， Month， Hour， Minute] [Self-Switch Type] [Interval]

Example (Turn on Self-Switch [B] after 15:00 on October 22， 2019 in-game
time.)
C_SET_SELF_SWITCH_ALARM 201910221500 B

If you specify an interval， the switch will turn on again after the
specified period has elapsed after it has turned on. The unit is minutes，
but you can use formulas.

Example (Turn on Self-Switch [B] after 15:00 on October 22， 2019 in-game
time. Turn on Self-Switch [B] again each day thereafter.)
C_SET_SELF_SWITCH_ALARM 201910221500 B 24*60

Memo Details
Enter the following in the title set or map Note field to automatically
disable weather and color changes.

This can be used to temporarily disable weather changes on indoor maps or
event scenes.

The map Note field takes priority.

<C_Tint:OFF> # Temporarily disables color changes.
<C_Weather:OFF> # Temporarily disables weather.
<C_Snow:ON> # Sets the weather to snow.

You can set whether time passes during an event for each event.
This setting overrides the parameter settings.
Enter the following in the event's Note field.
<C_NoStop:ON> # Time passes while the event is running. (ON/OFF)

Advanced Settings
Referring to the "User-Modifiable Area" in the source code， you can change
the following:
Time zone information (e.g.， morning hours)
Color tone for each time zone
 (adjustments will be applied for bad weather)

Script
Sets the natural time addition interval to the number of frames specified
by frame.
$gameSystem.chronus().setAutoAddInterval(frame);

Terms of Use:
You may modify and redistribute this plugin without permission from the
author， and there are no restrictions on its use (commercial， 18+， etc.).
This plugin is now yours.

@param 月ごとの日数配列
@text Array of days per month
@desc An array of the number of days in each month. Please specify them separated by commas. You can specify any number.
@default 31，28，31，30，31，30，31，31，30，31，30，31

@param 月名配列
@text Month name array
@desc An array of month names. Please specify them separated by commas. You can specify any number.
@default Jan.，Feb.，Mar.，Apr.，May.，Jun.，Jul.，Aug.，Sep.，Oct.，Nov.，Dec.

@param 曜日配列
@text Day of the week array
@desc An array of weekday names. Separate them with commas. You can specify any number.
@default Sun.，Mon.，Tue.，Wed.，Thu.，Fri.，Sat.

@param 自然時間加算
@text Natural time addition
@desc The number of minutes of game time added per second (the interval specified by the Natural Time Addition Interval). This is disabled during event processing.
@type number
@default 5

@param 自然時間加算間隔
@text Natural Time Addition Interval
@desc The interval (number of frames) at which the game time is naturally added up. 1F = 1/60 seconds
@type number
@default 60

@param 場所移動時間加算
@text Travel time added
@desc The number of minutes of game time added per location move.
@type number
@default 30

@param 戦闘時間加算(固定)
@text Battle time addition (fixed)
@desc The number of minutes of game time added per battle.
@type number
@default 30

@param 戦闘時間加算(ターン)
@text Battle time addition (turns)
@desc This is the number of minutes of game time added for each turn used in a battle.
@type number
@default 5

@param 年のゲーム変数
@text Year Game Variable
@desc The "year" value will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 月のゲーム変数
@text Moon Game Variable
@desc The value of "Month" will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 日のゲーム変数
@text Game Variable of the Day
@desc The value of "day" will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 曜日IDのゲーム変数
@text Day of the week ID game variable
@desc The "day of the week" ID will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 曜日名のゲーム変数
@text Day of the week game variable
@desc The name "Day of the Week" will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 時のゲーム変数
@text Time Game Variable
@desc The "hour" value will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 分のゲーム変数
@text Minutes Game Variable
@desc The "minutes" value will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 累計時間のゲーム変数
@text Accumulated Time Game Variable
@desc The "cumulative time" (in minutes) will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 累計日数のゲーム変数
@text Game variable for cumulative number of days
@desc The value of "Cumulative number of days" will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 時間帯IDのゲーム変数
@text Time zone ID game variable
@desc The "Time Zone" ID will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 天候IDのゲーム変数
@text Weather ID game variable
@desc The "Weather" ID will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param フォーマット時間の変数
@text Format time variables
@desc The result calculated based on the "Format time calculation formula" is automatically set.
@type variable
@default 0

@param フォーマット時間の計算式
@text Formatting time calculation formula
@desc The contents of the calculation formula using the date and time format.
@default HH24 * 60 + MI

@param 日時フォーマット1
@text Date and time format 1
@desc This is the string that will be displayed on the first line of the date window on the map.
@default MM / DD / YYYY DY

@param 日時フォーマット2
@text Date and time format 2
@desc The string that will be displayed on the second line of the date window on the map.
@default HH : MI AM

@param 日時フォーマット行間
@text Date and time format line spacing
@desc This is the line spacing of the calendar display.
@type number
@default 0

@param カレンダー表示X座標
@text Calendar display X coordinate
@desc The displayed X coordinate of the calendar.
@type number
@default 0

@param カレンダー表示Y座標
@text Calendar display Y coordinate
@desc The calendar's display Y coordinate.
@type number
@default 0

@param カレンダーフォントサイズ
@text Calendar Font Size
@desc Font size of the calendar. Specify 0 to use the default.
@type number
@default 0

@param カレンダー不透明度
@text Calendar Opacity
@desc The opacity of the calendar background (0-255).
@type number
@default 192

@param カレンダー枠の非表示
@text Hiding the calendar pane
@desc Hides the calendar pane.
@type boolean
@default false

@param カレンダーの非表示
@text Hide the calendar
@desc Hides the calendar. It can be displayed using the plugin command.
@type boolean
@default false

@param カレンダー余白
@text Calendar Margins
@desc Calendar margin (8-).
@type number
@default 8

@param 文字盤画像ファイル
@text Dial image file
@desc This is the file name of the clock face image when displaying an analog clock (extension not required).
@type file
@require 1
@dir img/pictures/

@param 長針画像ファイル
@text Long hand image file
@desc This is the file name for the minute hand image when displaying an analog clock (extension not required).
@type file
@require 1
@dir img/pictures/

@param 短針画像ファイル
@text Hour hand image file
@desc This is the file name for the minute hand image when displaying an analog clock (extension not required).
@type file
@require 1
@dir img/pictures/

@param 24hourClock
@text 24-hour clock
@desc When enabled， the hour hand will rotate once every 24 hours.
@type boolean
@default false

@param 時計X座標
@text Clock X coordinate
@desc The display X coordinate of the analog clock. Specify the center coordinate of the image.
@type number
@default 84

@param 時計Y座標
@text Clock Y coordinate
@desc This is the Y coordinate of the analog clock. Specify the center coordinate of the image.
@type number
@default 156

@param イベント中時間経過
@text Time passes during the event
@desc Time will continue to pass even during events. (ON/OFF)
@type boolean
@default false

munokura

Welcome to PGMV! My goal is to make it easy for everyone to find and share great plugins for creating amazing games. As a plugin developer myself, I'm excited to grow this community with all of you.