[DYNRPG] MAIN MENU GAME PLAYTIME CLOCK & BACKGROUND/FOREGROUND OPTIONS

==========================================================================
Main Menu Game Playtime Clock w/Foreground & Background Image Support v4.1
For RPG Maker 2003 with DynRPG v0.13 or higher
By PepsiOtaku
==========================================================================

I'd like to share a plug-in I just finished. This plug-in calculates & displays the time played in the main menu. It does this by identifying the amount (in seconds) the current session has been open (since either starting a new game or loading a save), and adds this amount to the total playtime, then converts the result to a clock format.

I made sure there were no memory leaks or anything, so this plugin should be stable. Let me know if you spot any serious issues!




Installation

To install the plugin, make sure that you have patched your project with cherry's DynRPG patch which
can be found here: http://cherrytree.at/dynrpg

1. Copy the "game_clock.dll"into the DynPlugins folder of your own project.

2. Edit Picture\menu-time_fg.png to match your project's system graphic. This image also doubles as a foreground image, which you can use to further decorate/modify the menu screen. The file can be changed via your DynRPG.ini file.

3. Additionally, this plugin supports adding a background image (placed behind the system window)

4. Add the following (between the asterisks) to your DynRPG.ini


5. Change the numeric values 4003, 4004 etc to the variables of your choice.

6. Pixel.png is a dummy image used for the text display.

7. TimeTextDisplay is the actual label text displayed in the menu.

8. ForegroundImage is the window image below the time display. You can use this image to alter other aspects of the main menu screen. See below. The image on the right shows the alterations I made.



9. If you would like to add a background, change the value of BackgroundImage to the file of your choice.

Note: The ForegroundImage and BackgroundImage must be no larger than 320x240

Forgot to add this to the readme, but this is an explanation of the variables:

SessionStart - Stores the cpu time the session started (in seconds)
SessionCurrent - Stores the cpu time the session is currently on (in secs)
SessionSecs - Stores the difference (in secs)
PlaytimeSecs - This is your total gameplay time on a particular save. This can only be edited to a specific value by setting the RestartTrigger.
PlaytimeHH - Hour digit (Max is 65535)
PlaytimeMM - Minute digit
PlaytimeSS - Second digit
RestartTrigger - Used to manually set the playtime to a certain time (ie. Setting it to "0" would reset the time to 0)

NEW TO VERSION 4
================
4.1 - Small bugfix with the rect calculations

Nothing visual, but the code is more efficient. onFrame callback no longer loads/unloads the foreground
image every frame.

Added rect calculations for the background image, which should be supported by future versions of DynRPG.
(thanks Cherry!) Save/load menu is unaffected by this.

Version 3
=========
Bugfixes

Version 2
=========
- Fixed BackgroundImage on Save/Load menu

- Added support for variable controlled foreground & background images. Use "ForegroundVar" and
"BackgroundVar" to set the variable ID's youw ill use to control the background images

- "ForegroundImage" and "BackgroundImage" still identify the default images. To define additional images,
make a copy of those with the number you will assign the variables to after the identifier.
Example: If ForegroundVar 4011 is set to "2", the plugin will look for "ForegroundVar2="



With this functionality, you can add multiple system sets to your game, and the plugin can still support it

Extra: Extract game_clock_testProject.rar to see a test project with it in action!
Instructions

This plugin is pretty much plug and play, so just load your game, then open the menu! Voila!