NID's Toolbox Light - Timed Messages

Contains Server Timed messages module for NidToolbox Light server tool-set. Time-based messages can be set to trigger at certain hour, or every X minutes.

1573-nidtoolbox-design01-nid-64-png

Timed Messages

for NidToolbox Light

requries nid-core module available here

1586-default-violet-2-png

Create timed messages that trigger either at a specific hour or every X minutes

NidToolbox's Discord Channel -> here

Timed Messages module allows:

  • Easy creation, sending and display of messages that are based on specific timer.
  • Module can store multiple messages, which can all have their own timers.
  • Two types of timed messages available: Timer Messages - triggering every X minutes and Scheduled Messages - triggering at specific hour.
  • Messages accept all the formatting options and colors.
  • Messages can be displayed in game chat as well as in a PopUp window.
  • Configuration easily viewable in an "at-glance" window.

(click to enlarge)


Requirements:

As any module of NidToolbox set, it requires nid-core version 1.0.3+ module, available in the main forum thread: here

How to install:

  1. Unpack .zip archive
  2. Copy nid-timedmessages.dll to Mods\NidToolbox\Modules

Settings files:

Config files are located at:

  1. Configs\Mods\NidToolbox\TimedMessages.json - contains module settings.

Configuration:

Module operates on 24 hour clock. 5 pm is 17:00, 5 am is 5:00 :)

Timed Messages are created and configured via usage of in game commands.

After creation basic message, it is possible to edit it's full text in a configuration file, allowing for easier adding of formatting tags.

Module contains example messages that are created and activated at the plugin first load. These can be viewed for some example usage.

There are currently two timed messages types:

  • Timer Message - this message will trigger every X minutes, for example "Stay hydrated reminder" that will trigger every 30 minutes in game.
  • Scheduled Message - this message will trigger at a specific hour, for example "Restart Announcement 30 min to reboot" will trigger at 5:30 every day.

Adding new message is as simple as issuing /timer-add or /sched-add and specifying the details. For more information, check the available commands.

MANUAL CONFIG EDITS: When editing config file by hand, be careful when changing the hour and minutes attribute of the scheduled messages. Avoid leading zeros ,as the automatic config loader does not like these.

Your file will be checked when reloaded in game.

Common commands:

/timer-reload

Reloads settings of the module. Useful if you have edited the config file manually. Will check if the file is correct, before loading it into the server.

Timer Messages commands:

/help Timer

Displays information about all commands related to Timer Messages.

/timer-Enable

Enables or disables timer messages.

/timer-Enable bool trueFalse


    /timer-enable true/false
                      

/timer-ShowMsg

Displays message configuration in a separate window.

/timer-ShowMsg string title


    /timer-ShowMsg messageTitle
                      

/timer-list

Lists all timer messages.

/timer-List


    /timer-list
                      

/timer-Add

Adds new timer message. Timer must be given in minutes

/timer-Add string title, string msgText, float timer, bool showAsPopUp


    /timer-add My New Timer Message, <color=yellow>Some nice text</color>, 20, false
                      

/timer-Del

Deletes timer Message.

/timer-Del string title


    /timer-Del messageTitle
                      

/timer-Minutes

Changes the default timer of the message. This will change the default timer for the message, it will take effect once the current timer has elapsed.

/timer-Minutes string title, float minutes


    /timer-Minutes messageTitle, 20
                      

/timer-Running

Changes the running timer of the timer message. This will alter the timer that message is currently under. Has no effect on the default timer.

/timer-Running string title, float minutes


    /timer-Running messageTitle, 20
                      

/timer-PopUp

Changes the show as PopUp window attribute of the message.

/timer-PopUp string title, bool true/False


    /timer-PopUp messageTitle, false
                      

/timer-Rename

Changes the title of the message.

/timer-Rename string title, string newTitle


    /timer-Rename oldTitle, newTitle
                      

/timer-Text

Changes the text of the message.

/timer-Text string title, string newText


    /timer-text title, newText
                      

/timer-Active

Activates or Deactivates the chosen timer message. Allows to disable the specific message, without disabling the whole module.

/timer-Active string title, bool true/False


    /timer-Active messageTitle, true
                      

Scheduled Messages commands:

/help Sched

Displays information about all commands related to Scheduled Messages.

/sched-Enable

Enables or disables scheduled messages.

/sched-Enable bool trueFalse


    /sched-enable true/false
                    

/sched-ShowMsg

Displays message configuration in a separate window.

/sched-ShowMsg string title


    /sched-ShowMsg messageTitle
                    

/sched-list

Lists all scheduled messages.

/sched-List


    /sched-list
                    

/sched-Add

Adds new scheduled message.

/sched-Add string title, string msgText, int hour, int minutes, bool showAsPopUp

For example: Message that is supposed to be shown at 14:02:


    /sched-add My New Scheduled Message, <color=yellow>Some nice text</color>, 14, 02, false
                    

/sched-Del

Deletes scheduled Message.

/sched-Del string title


    /sched-Del messageTitle
                    

/sched-Time

Changes the time at which scheduled message will trigger.

/sched-Time string title, int hour, int minutes


    /sched-Time messageTitle, 14, 02
                    

/sched-PopUp

Changes the show as PopUp window attribute of the message.

/sched-PopUp string title, bool true/False


    /sched-PopUp messageTitle, false
                    

/sched-Rename

Changes the title of the message.

/sched-Rename string title, string newTitle


    /sched-Rename oldTitle, newTitle
                    

/sched-Text

Changes the text of the message.

/sched-Text string title, string newText


    /sched-Rename title, newText
                    

/sched-Active

Activates or Deactivates the chosen timer message. Allows to disable the specific message, without disabling the whole module.

/sched-Active string title, bool true/False


    /sched-Active messageTitle, true
                

Current Version: 1.0.0

Supported Eco Version: 9.2.x

Download Docs

Changelog

How To Install


Would you consider supporting NID as he brings you more content and continuesly updates his modkit?

Support NID


Need more help? Join NID's

Elixr Mods DiscordDiscord!