Real-Timer v1.0

::----- README.txt -----::
Real-Timer v1.0
by Mea (timer sprites and testing), Amaikokonut (core caos and number-sprites), and PuppyPi (tedious cacluation caos)

May be found at Naturing :: Nurturing (https://naturingnurturing.blogspot.com) and/or Naturing :: Nurturing :: Static (https://naturingnurturing.songua.com) and/or a friendly community archive near you! It's also possible this got finished in time for CCSF '23, in which case, happy CCSF!

If you rehost this file, please keep all provided all files including this readme intact. Thank you!

If you have any comments, questions, bug reports, or just want to chat, email *****@songua.com

:: About ::

This connectable gadget will allow you to schedule a signal of 255 to send in real-world time, regardless of if your game is running in fast ticks or slowly due to lag. Due to the often inconsistent frame rate in this game, expect for the display to occasionally appear to lag or skip seconds as it syncs with real-time-- especially if your game is running slow. This gadget is immune to physics and creature interactions.

:: Usage ::

This is... sort of a complicated gadget, but I'll do my best to explain everything in detail.

Clicking the top left button will toggle between two options: Countdown Timer and Alarm Clock. You may use one of these modes at a time:

In Countdown Timer mode, clicking the letters in the bottom right corner will toggle between 'HM' (Hours:Minutes) mode and 'MS' (Minutes:Seconds) mode. Clicking the numbers themselves will allow you to set the amount of time you wish for the timer to tick down. Clicking the top-right button will start the timer. The button will blink to let you know that the timer is running. When the countdown reaches 0, the agent will send out the signal and reset back to the last amount of time you set it to. The agent will then remain in an 'off' state until you click the top-right button to start it again, or until it receives a positive input signal.

When you switch to alarm clock mode, you will at first be in 'set' mode. Clicking the letters in the bottom right corner will toggle between AM and PM. Clicking the numbers will allow you to set the time you wish the alarm to go off. Clicking the top-right button will make the alarm clock 'active.' When the alarm clock is active, it will switch to displaying real-world time, much like a typical alarm clock. When it reaches the time that the alarm was set to, it will send out a signal to whatever it is connected to. Unlike the Countdown mode, Alarm mode is continuous, meaning you do not need to reset it. If you set it to 7pm, it will send the signal out every day at 7pm. Clicking the top right button will put it back into 'set' mode, allowing you to set the alarm to a different time.

The bottom left button on this gadget allows you to turn 'Closed-Game Detection' on or off. It is off by default. When it is off, the countdown timer will only count down while the game is running, or the alarm on the Clock will only activate while the game is running. If it is set to on, the agent detects when the game is reopened after a close, and it will account for the time that passed while the game was closed. This means if you set the countdown timer for 60 minutes, close the game for 10 minutes, and reopen it, the timer will have 50 minutes remaining. If enough time has passed for the timer to countdown to 0, it will activate and send out the signal as soon as the game is opened. Similarly, in Alarm Clock mode, if you set the Alarm Clock for 7pm, close the game, and open it at 8pm, the alarm will activate immediately since 7pm passed while the game was closed. (This will, however, only happen once, so if you close the game for 30 days it will not activate 30 times when you next re-open the game.

The bottom left button on this gadget will change the gadget's outer shell to a random color. May as well make it look pretty, right?

Signals sent to this gadget can imitate clicking the top-right start/stop button:
If this gadget receives a signal > 0, it will START the timer/alarm clock IF it is currently stopped/in set mode. Otherwise the signal will be ignored.
If this gadget receives a signal of 0, it will STOP the timer/alarm clock IF it is currently running.
If this gadget receives a signal of < 0, it toggle the timer/alarm clock's start/stop status regardless of the state it is currently in.

(I hope this makes sense!)

:: Changelog ::

11-30-2023: RUSHING THIS INTO SOME SORT OF COMPLETION FOR CCSF AAAsdaasfdnsaf