WorkingMan is a plugin for servers wishing to limit the play time of players. Why would you want to do this? This plugin is designed for people who enjoy playing vanilla Rust with full PvP, but have lives outside of the game. Work, family, friends, and/or other interests take up the bulk of your day, but you still enjoy playing Rust for a few hours a day, several days a week. Unfortunately, Rust is designed in such a way that the more you play, the more of an advantage you have against other players on the server. Limiting all players to the same amount of play time per day and/or per week puts them on a more level playing field.
WorkingMan allows you to configure your server to limit the play time of players to a certain number of minutes per day, and/or per week. It defaults to 6 hours per day and no weekly limit. Players can use their play time whenever they like during the day, each day, but when they reach their daily or weekly limit, they will be kicked from the server until the next day or week time cycle begins. Warnings are displayed to a user coming close to their time limit via server messages and GUI banner displays. Once a player's play time crosses the first warning threshold (when he has 30 minutes left, by default), he will receive a warning every 5 minutes. Once he reaches the second threshold (when he has 10 minutes left, by default), he will be warned every minute. This gives the player time to find a safe spot to log off for the rest of the cycle. A player trying to log back into the server when he has no time left in the current cycle is denied and provided with a message informing him of when the next cycle begins.
WorkingMan uses your server's configured timezone for determining the daily and weekly cycle start times. Be sure your server's timezone is configured how you desire. If you update your server's timezone, you can reload the plugin to have it sync with your new timezone as well.
minutesPerDay = Number of minutes allowed per day, set to
0 to disable this limit. Default is
360 minutes, or 6 hours.
minutesPerWeek = Number of minutes allowed per week, set to
0 to disable this limit. Default is
warningThreshold1 = Once a player's timer has less than this many minutes left, warnings are sent every 5 minutes. Defaults to
warningThreshold2 = Once a player's timer has less than this minutes left, warnings are sent every minute. Defaults to
dayOfWeek = Zero-based index of the day of the week that the weekly cycle begins on. Defaults to
4, or Thursday.
timeNights = Boolean value that determines whether night time counts against a player's played time.
Players have just one command they can issue via chat:
/checktimer. This will have a message sent to them specifying how much time they have played for the current cycle(s) and how much time is left until the next cycle(s).
Admin commands are all issued via the console.
workingman.reset - Resets the admin's play time for the current cycle(s) to zero.
workingman.setdaytimer <player name or id> <minutes> - Sets the designated player's daily timer for the current day cycle to
workingman.setweektimer <player name or id> <minutes> - Sets the designated player's weekly timer for the current week cycle to
workingman.setdaylimit <minutes> - Updates the server's configured number of minutes allowed per day. Set this to 0 to disable the daily time limit.
workingman.setweeklimit <minutes> - Updates the server's configured number of minutes allowed per week. Set this to 0 to disable the weekly time limit.
workingman.setweekstartday <day> - Sets the day that the weekly cycle starts if you have a weekly time limit configured.
<day> should be a number from 0 to 6, 0 being Sunday and 6 being Saturday. This value defaults to Thursday (4), a typical wipe day for many servers.
workingman.resetdefaults - Resets the server's configuration to the default settings (6 hours per day, 30 minute and 10 minute warning thresholds).
workingman.setwarn1 <minutes> - Sets warning threshold 1 to be
<minutes> remaining. Once this threshold is reached, a player will receive a warning every 5 minutes.
workingman.setwarn2 <minutes> - Sets warning threshold 2 to be
<minutes> remaining. Once this threshold is reached, a player will receive a warning every minute.
workingman.givetimeday <player name or id> <minutes> - Subtracts
<minutes> from the designated player's daily timer.
workingman.givetimeweek <player name or id> <minutes> - Subtracts
<minutes> from the designated player's weekly timer.
workingman.settimenights <true or false> - Sets the boolean value that determines whether night time counts against a player's played time (requires Time Of Day plugin).
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE