RPG Maker MZ Free Plugin : TimeSystemFull

RPG Maker MZ Plugin: TimeSystemFull - Real-Time Time System

Hello RPG Maker MZ users! Today, I'm introducing the TimeSystemFull plugin. This plugin provides a powerful time system that allows you to display and manage real-time hours, minutes, and seconds within your game. It also includes a feature to activate specific switches based on time, making it easy to implement time-based events. Below, I will explain the plugin’s features, installation process, and usage in detail!

Key Features of the Plugin

Real-Time Time Display

• Displays hours, minutes, and seconds in real-time within the game.

• Uses number images (0-9.png) and separator images (time_space.png) for a visual representation.

• The display position can be freely set using X and Y coordinates.

Time Control Features

• The time flow can be controlled using the “stop time” and “start time” commands.

• Time can be paused during certain events, and once the event ends, time will resume.

Activate Switches at Specific Times

• You can activate specific switches when the game reaches a certain time.

  • Example: When the time reaches "10:30:00", Switch 5 is turned ON.

• Multiple time conditions can be set, and dynamic settings can be made via script commands.

Flexible Settings

• Initial time (hours, minutes, seconds), update interval, and display coordinates can be configured in the plugin parameters.

• Fine control is possible through script commands.

Installation Process

Download and Add the Files

• Download the TimeSystemFull.js file from the link below.

• Place the downloaded file in the js/plugins/ directory of your project.

Activate the Plugin

• In RPG Maker MZ, open the “Plugin Manager”, add the TimeSystemFull plugin, and activate it.

Prepare the Images

• Prepare number images (0.png to 9.png) and the separator image (time_space.png) in the img/pictures/ folder.

Usage Instructions

1. Basic Settings (Plugin Parameters)

   • Second Variable ID, Minute Variable ID, Hour Variable ID: Specify the variable IDs where time will be stored. (Default: 2, 3, 4)

   • Initial Time: Set the initial time (hours, minutes, seconds) when the game starts. (Default: 0:0:0)

   • Base X Coordinate, Base Y Coordinate: Set the position of the time display. (Default: 0, 0)

   • Update Interval (ms): Set the time update interval in milliseconds. (Default: 1000ms)

2. Script Commands

   • Initialize Time System

     javascript
     PluginManager.callCommand($gameSystem, 'TimeSystemFull', 'initTimeSystem', { secondsVar: 2, minutesVar: 3, hoursVar: 4, updateInterval: 1000 }); 
     

   • Update Time Display

     javascript
     PluginManager.callCommand($gameSystem, 'TimeSystemFull', 'updateTimeDisplay', {}); 
     

   • Stop / Start Time

     javascript
     PluginManager.callCommand($gameSystem, 'TimeSystemFull', 'stopTime', {}); PluginManager.callCommand($gameSystem, 'TimeSystemFull', 'startTime', {}); 
     

   • Set Specific Time

     javascript
     PluginManager.callCommand($gameSystem, 'TimeSystemFull', 'setTargetTimes', { targetsJson: '[{"hours":10,"minutes":30,"seconds":0,"switchId":5},{"hours":15,"minutes":45,"seconds":0,"switchId":10}]' }); 
     

3. Event Setup Example

   • Set Specific Time at Game Start When the time reaches 01:00:00, Switch 1 will turn ON.

     javascript
     PluginManager.callCommand($gameSystem, 'TimeSystemFull', 'setTargetTimes', { targetsJson: '[{"hours":1,"minutes":0,"seconds":0,"switchId":1}]' }); 
     

   • Pause Time During a Specific Event

     • In the event, select Plugin Command → TimeSystemFull → Stop Time.

     • After the event ends, call Plugin Command to Start Time.

Important Notes

• If the number images and separator image are not present in the img/pictures/ folder, the time display may not work properly.

• The JSON format for the setTargetTimes command must be entered correctly. Incorrect format will result in errors.

• Switch IDs must be 1 or higher. Any switch ID of 0 or below will be ignored.

Additional Feature Updates

March 21, 2025: Time display images can now be toggled ON/OFF.

I had more than 20 additional features planned, but unfortunately, I was unable to implement them due to endless errors and setbacks. No further feature updates are planned.


https://otterscribe.itch.io/rpgmakermzplugin