Chronus - Chronus.js

Plugin desc : In-game time introduction plugin

License : MIT License

Author : Triacontane

Website : https://triacontane.blogspot.com

Desc page : https://github.com/triacontane/RPGMakerMV/tree/mz_master/Chronus.js

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

File name : Chronus.js

Help of plugin :

@target MZ
@url https://github.com/triacontane/RPGMakerMV/tree/mz_master/Chronus.js
@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-MZ-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 this， please read the terms of use separately at the
following URL before use.
http://tm.lucky-duet.com/viewtopic.php?f=47&t=555&p=1615#p1615

・Timer Operation Commands
These plugin commands turn on switches and self-switches after a specified
number of minutes have elapsed since the command was executed.
They can also be used in conjunction with the real-time linkage function.
For switches， specify an ID， and for self-switches， specify a type (A， B， C，
D).

Memo Field Details
By entering the following in the memo field of a title set or map，
we can automatically disable weather and color changes temporarily.
This can be used to temporarily disable weather and color changes on indoor
maps， event scenes， etc. The map’s memo field takes priority.

<C_Tint:OFF> # Temporarily disables tint changes.
<C_Tint:OFF> # Same as above
<C_Weather:OFF> # Temporarily disables weather.
<C_Weather:OFF> # Same as above
<C_Snow:ON> # Sets the weather to snow.
<C_Snow:ON> # Same as above

You can set whether time passes while an event is running for each event.
This setting overrides the parameter settings.
Enter the following in the event memo field.
<C_Time Passage:ON> # Time passes while the event is running. (ON/OFF)
<C_NoStop:ON> # Same as above

Advanced Settings
You can change the following by referencing the ”User-Modifiable Area” in the
source code:
Time period information (e.g.， morning hours， etc.)
Hue by time period (adjustments are applied in bad weather)

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

This plugin requires the base plugin ”PluginCommonBase.js.”
”PluginCommonBase.js” is located in the following folder under the RPG Maker
MZ installation folder:

dlc/BasicResources/plugins/official

Terms of Use:
You may modify and redistribute this plugin without permission from the
author， and there are no restrictions on its use (commercial， R18+， 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 Array of month names
@desc An array of month names. Separate them with commas. You can specify any number.
@default Jan.，Feb.，Mar.，Apr.，May.，Jun.，Jul.，Aug.，Sep.，Oct.，Nov.，Dec.

@param 曜日配列
@text Array of days of the week
@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 Location travel time addition
@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 Game variable for year
@desc The ”year” value will be automatically set to the game variable with the specified number.
@type variable
@default 0

@param 月のゲーム変数
@text Game variable for month
@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 for 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 Game variable for day ID
@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 Game variable for day of week ID
@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 Game variable for hour
@desc The ”hour” value will be automatically set to the game variable with the specified number.
@type variable
@default 0

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

@param 累計時間のゲーム変数
@text Game variable for cumulative time
@desc The ”Cumulative Time” (in minutes) value 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 Game variable for time zone ID
@desc The ”Time Zone” ID will be automatically set to the game variable with the specified number.
@type variable
@default 0

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

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

@param フォーマット時間の計算式
@text Format time 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 YYYY年 MM月 DD日 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 AMHH時 MI分

@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 width
@desc The width of the calendar. If not specified， it will be adjusted automatically.
@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 Hide calendar frame
@desc Hides the calendar pane.
@type boolean
@default false

@param カレンダーの非表示
@text Hide 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 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 短針画像ファイル
@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
@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 elapsed during event
@desc Time will continue to pass even during events. (ON/OFF)
@type boolean
@default false

@param 天候補正無効
@text Weather correction disabled
@desc Disables weather color correction.
@type boolean
@default false

@command ADD_TIME
@text Time addition
@desc The specified number of minutes will elapse.
@arg time
@text time
@desc This is the time to add. If you want to use the control character ￥v[n]， please enter it from the text tab. The same applies to other items.
@type number
@default 0

@command SET_TIME
@text Time Settings
@desc Change to the specified time.
@arg hour
@text time
@desc Time to set it up.
@type number
@default 0
@min 0
@max 23
@arg minute
@text minutes
@desc The minute to set.
@type number
@default 0
@min 0
@max 59

@command ADD_DAY
@text Date addition
@desc The specified number of days will pass.
@arg day
@text Number of days
@desc It’s time to add up.
@type number
@default 0

@command SET_DAY
@text Date setting
@desc Change to the specified date.
@arg year
@text year
@desc The year to set.
@type number
@default 1
@arg month
@text month
@desc The month to set.
@type number
@default 1
@arg day
@text day
@desc The date to be set.
@type number
@default 1

@command STOP
@text Time Stop
@desc Stop the progression of time.

@command START
@text Time Start
@desc Time begins to progress.

@command SHOW
@text Calendar View
@desc Display the calendar.

@command HIDE
@text Hide calendar
@desc Hide the calendar.

@command DISABLE_TINT
@text No color changes allowed
@desc Changing the color tone depending on the time of day is prohibited.

@command ENABLE_TINT
@text Color change allowed
@desc Allows changing the color tone depending on the time of day.

@command DISABLE_WEATHER
@text No weather changes allowed
@desc Prevents weather from changing over time.

@command ENABLE_WEATHER
@text Weather Change Permit
@desc Allows weather to change over time.

@command SET_SNOW_LAND
@text Snowfall area setting
@desc Snow will fall during bad weather.

@command RESET_SNOW_LAND
@text Snowfall area lifted
@desc Rain or storms will occur during bad weather.

@command RESET_SNOW_LAND
@text Snowfall area lifted
@desc Rain or storms will occur during bad weather.

@command SET_SPEED
@text speed setting
@desc Sets the rate at which time passes per second of real time.
@arg speed
@text speed
@desc The rate at which time passes.
@type number
@default 1

@command SET_AUTO_ADD_INTERVAL
@text Natural time addition interval setting
@desc Change the natural time addition interval.
@arg interval
@text Interval Frames
@desc The number of frames between natural time additions.
@type number
@default 60

@command SHOW_CLOCK
@text Analog clock display
@desc Displays an analog clock.

@command HIDE_CLOCK
@text Hide analog clock
@desc Hide the analog clock.

@command SET_TIME_REAL
@text Real-time display
@desc Change the time acquisition method to real time.

@command SET_TIME_VIRTUAL
@text Virtual Time Display
@desc Changes the time acquisition method to in-game time.

@command SET_RAINY_PERCENT
@text Precipitation probability setting
@desc Set the probability of precipitation (0-100).
@arg percent
@text probability
@desc The probability of precipitation.
@type number
@default 0
@max 100

@command INIT_TOTAL_TIME
@text Initialize cumulative time
@desc Initialize the cumulative time and cumulative number of days.

@command SET_CLOCK_IMAGE
@text Change clock image file
@desc Change the analog clock file. The image will actually change after you move the map.
@arg baseFileName
@text Dial image file name
@desc The file name of the watch face image. Select from the picture. If not specified， it will not be changed.
@type file
@dir img/pictures
@arg hourFileName
@text File name of the hour hand image
@desc The file name of the hour hand image. Select from the picture. If not specified， it will not be changed.
@type file
@dir img/pictures
@arg minuteFileName
@text File name of the minute hand image
@desc The file name of the minute hand image. Select from the picture. If not specified， it will not be changed.
@type file
@dir img/pictures

@command SET_SWITCH_TIMER
@text Switch Timer Settings
@desc You can turn the switch on after a specified time has elapsed.
@arg name
@text Timer Name
@desc The timer identifier. This is required when canceling the timer， so please set it if you want to cancel it.
@arg timeout
@text time
@desc The number of minutes until the timeout expires.
@type number
@default 1
@min 1
@arg switchId
@text Switch Number
@desc The switch number to turn ON.
@type switch
@default 1
@arg loop
@text Loop presence/absence
@desc Whether the timer should loop.
@type boolean
@default false

@command SET_SELF_SWITCH_TIMER
@text Self-switch timer settings
@desc You can turn the switch on after a specified time has elapsed.
@arg name
@text Timer Name
@desc The timer identifier. This is required when canceling the timer， so please set it if you want to cancel it.
@arg timeout
@text time
@desc The number of minutes until the timeout expires.
@type number
@default 1
@min 1
@arg selfSwitchId
@text Self-Switch Number
@desc The self-switch number to turn ON.
@type select
@default A
@option A
@option B
@option C
@option D
@arg loop
@text Loop presence
@desc Whether the timer should loop.
@type boolean
@default false

@command SET_SWITCH_ALARM
@text Switch Alarm Settings
@desc You can turn the switch on at a specified time.
@arg name
@text Alarm Name
@desc The alarm identifier. This is required when canceling the alarm， so please set it if you want to cancel it.
@arg year
@text Alarm Year
@desc The year the alarm will turn on. If you specify 0， it will be the current year.
@type number
@default 0
@arg month
@text Alarm Month
@desc The month the alarm will be turned on. If you specify 0， it will be the current month.
@type number
@default 0
@arg day
@text Alarm date
@desc The date the alarm will turn on. If you specify 0， it will be the current day.
@type number
@default 0
@arg hour
@text Alarm time
@desc It’s time for the alarm to turn on.
@type number
@default 0
@max 23
@arg minute
@text Alarm minutes
@desc The minute the alarm turns on.
@type number
@default 0
@max 59
@arg switchId
@text Switch Number
@desc The switch number to turn ON.
@type switch
@default 1
@arg interval
@text Interval
@desc Once the alarm is enabled， it will be enabled again after the specified time has elapsed.
@type number
@default 0

@command SET_SELF_SWITCH_ALARM
@text Self-switch alarm settings
@desc You can turn on the self-switch at a specified time.
@arg name
@text Alarm Name
@desc The alarm identifier. This is required when canceling the alarm， so please set it if you want to cancel it.
@arg year
@text Alarm Year
@desc The year the alarm will turn on. If you specify 0， it will be the current year.
@type number
@default 0
@arg month
@text Alarm Month
@desc The month the alarm will be turned on. If you specify 0， it will be the current month.
@type number
@default 0
@arg day
@text Alarm date
@desc The date the alarm will turn on. If you specify 0， it will be the current day.
@type number
@default 0
@arg hour
@text Alarm time
@desc It’s time for the alarm to turn on.
@type number
@default 0
@max 23
@arg minute
@text Alarm minutes
@desc The minute the alarm turns on.
@type number
@default 0
@max 59
@arg selfSwitchId
@text Self-Switch Number
@desc The self-switch number to turn ON.
@type select
@default A
@option A
@option B
@option C
@option D
@arg interval
@text Interval
@desc Once the alarm is enabled， it will be enabled again after the specified time has elapsed.
@type number
@default 0

@command CLEAR_TIMER
@text Cancel timer/alarm
@desc Cancels the timer and alarm. Once a timer is canceled， it cannot be restarted.
@arg name
@text Timer Name
@desc The timer identifier.

@command STOP_TIMER
@text Stop timer/alarm
@desc Stops the timer and alarm. While stopped， the switch will not turn on even if the conditions are met.
@arg name
@text Timer Name
@desc The timer identifier.

@command START_TIMER
@text Timer/alarm restart
@desc Resume timers and alarms.
@arg name
@text Timer Name
@desc The timer identifier.

@command SET_TIME_INFO_NAME
@text Current time information setting
@desc Sets the current time related information to the specified variable.
@arg variableId
@text Variable Number
@desc The variable number for which time information is set.
@type variable
@default 1
@arg method
@text Information Type
@desc The type of information to set.
@type select
@default getMonthName
@option Month name
@value getMonthName
@option Day of the week name
@value getWeekName
@option Time Zone Name
@value getTimeZoneName

munokura

Welcome to PGMZ! 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.