MacTime

<br>

<br>

<br>

<br>

```yml

MacTime, by AjMaacc

Storage options

Data is stored in plugins/MacTime/playerdata/mactime.db

Default storage type is SQLite

sql:

To use MySQL, set below to true

Default: false

enabled: false

Your database's server address

address: '127.0.0.1:3306'

Database name, username and password.

database: "" username: "" password: ""

options

usessl: false

At the end of every week you can save players ontimes to a file in leaderboard fashion

ontime-saving:

Toggle this feature on/off

Default: true

enabled: true

Day of the week ontime will be saved

Options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday

Default: Monday

dayofweek: 'Monday'

Order of which times will sort by

Options: Alphabetical, Ascending, Descending, Group.

Group will sort by Luckperms group, requires Luckperms to be installed!

Default: Descending

order: "Descending"

MacTime Admin Command Configurations

Reset

Options for the /mactime reset command

reset:

Delay before any un-confirmed /mactime reset queries are cancelled in seconds

Default: 10

delay: 10

Removes data entirely versus restarting the count after reset

Default: false

delete-data-on-reset: false

Sets who is able to use /mactime reset * (resets everyone's ontime)

Options: "None", "Console", "Player", "All"

Default: None

wildcard-reset: 'None'

AFK Checker

The AFK Status of a player is determined by MacTime hooking into Essentials.

You will need to have essentials on your server for this to work.

afk-checker:

Enable AFK time tracking

Default: false

enabled: false

luckperms:

Luckperm groups to be included for sorting by groups

You must have Luckperms installed for this to be relevant

Default:

- owner

- manager

- admin

- jradmin

- dev

- srmod

- mod

- jrmod

- helper

whitelisted-groups: - owner - manager - admin - jradmin - dev - srmod - mod - jrmod - helper

GUI

Options for the /mactime gui command

gui:

Sorts /mactime gui by Luckperm groups specified under "luckpermgroups"

You need to have Luckperms on your server for this to work!

Default: false

sort-by-luckperm-group: false

Duration in seconds to update the gui

Set this to 0 to disable this feature

Default: 10

update-interval: 10

Discord Webhooks

webhook:

Enable this feature

Default: false

enabled: false

Webhook url

url: ''

Username for the webhook. If this is not set (or empty), this will default to "MacTime"

username: ''

join:

Enables player join webhooks to be sent

Default: true

enabled: true

If you want this specific embed to be sent to a separate webhook,

add the secondary webhook's url here

If left empty, this defaults to use the main webhook url defined under "webhook.url"

url: ''

If you would like the webhook's username to differ from the original username (webhook.username)

Leaving this blank defaults to webhook.username

username: ''

leave:

Enables player leave webhooks to be sent

Default: true

enabled: true url: username:

afkstart:

Enables webhooks to be sent for when a player goes afk

Default: true

enabled: true url: username:

afkend:

Enables webhooks to be sent when a player returns from being afk

Default: true

enabled: true url: username:

print:

Enables the "/mactime export" command and allows playerdata to be sent by the webhook

Default: true

enabled: true url: username:

saving:

Enables weekly data saved during the ontime-saving section to be sent by the webhook

Default: true

enabled: true url: username:

other:

Enables the beautiful MacTime signature in console on startup

If you don't want this, set below to false

Default: true

signature: true

Removes a player's ontime data if they are no longer have the `ontime.track` permission

This deletes their data on the player's next join

Default: false

remove-if-no-perm: false

Your timezone

Use https://pastebin.com/mfdYhnu7 to find the format for your timezone

timezone: "America/New_York"

Date of when ontime first started recording

This resets when you do /mactime reset *

Don't touch pls

start: ''

Config version (don't touch or u get malaria)

version: '1.0.4' ```

```yml version: '1.0.3' prefix: '&e☀ &e&lMacTime &8&l» ' online: '&a●' offline: '&c●' afk: '&8[&7&lAFK&8]' no-permission: '&cNo Permission'

%player_name% = Player's Username

command: ontime: player:

Header for /ontime

self-header: '&7&m &r &a%player_name%''s Ontime &7&m &r'

Header for /ontime <username>

other-header: '&a%player_name%''s Ontime' no-ontime-data: '&c %player_name% &chas no ontime data!' divider: '&7&l&m ' console: invalid: 'This Command cannot be executed by console.' player-does-not-have-data: 'This player does not have any ontime data!' reload: messages: '&7Successfully Reloaded Module: &fMessages&7.' config: '&7Successfully Reloaded Module: &fConfiguration&7.' all: '&7Successfully Reloaded Modules: &fConfigurations &7and &fMessages&7.'

%player_name% = Player's Username

{0} = Luckperm group prefix

{1} = Total players

reset: expired: player: '&cOntime removal request for %player_name% has expired!' group: '&cOntime removal request for {0} group has expired!' wild: '&cOntime removal request for all users have expired!' confirm: player: '&7Are you sure you want to reset &f%player_name%''s &7ontime stats? &7[Click to Confirm]' group: '&7Are you sure you want to reset ontimes for players in the &f{0}&7 group? &7[Click to Confirm]' wild: '&cAre you sure you want to reset all ontime statistics? &7[Click to Confirm]' success: player: '&7Reset ontime for &f%player_name%&7!' group: '&7Reset ontime for &f{1} &7players in &f{0}&7 group!' wild: '&7Reset ontime statistics for &f{1} &7players!' invalid: player: '&cYou have entered an invalid username!' group: '&cYou have entered an invalid group name!' wild: '&cThis action is currently disabled!' player-does-not-have-data: ' &c%player_name% has no ontime data!'

%command% - Reset command ex. "/mactime reset player Notch"

hover-msg: '&a&lCLICK ME&r'

#

Ontime Command (/ontime)

# ontime: player: current-ontime: '&fCurrent Ontime &8➡ &e%mactime_current%' daily-ontime: '&fDaily Ontime &8➡ &e%mactime_daily%' weekly-ontime: '&fWeekly Ontime &8➡ &e%mactime_weekly%' monthly-ontime: '&fMonthly Ontime &8➡ &e%mactime_monthly%' yearly-ontime: '&fYearly Ontime &8➡ &e%mactime_yearly%' alltime-ontime: '&fAll-Time Ontime &8➡ &e%mactime_alltime%' afk-time: '&fTotal AFK Time &8➡ &e%mactime_afktime%' last-online: '&fLast Online &8➡ &e%mactime_lastonline%' console: current-ontime: '* Current Ontime ➡ %mactime_current%' daily-ontime: '* Daily Ontime ➡ %mactime_daily%' weekly-ontime: '* Weekly Ontime ➡ %mactime_weekly%' monthly-ontime: '* Monthly Ontime ➡ %mactime_monthly%' yearly-ontime: '* Yearly Ontime ➡ %mactime_yearly%' alltime-ontime: '* All-Time Ontime ➡ %mactime_alltime%' afk-time: '* AFK Time ➡ %mactime_afktime%' last-online: '* Last Online ➡ %mactime_lastonline%'

#

GUI message configuration (/mactime gui)

# gui:

Player Ontimes

{0} = Total Players

po: title: 'Staff On-Times ({0})' online: '&a&lONLINE' offline: '&c&lOFFLINE' current-ontime: '&e| &fCurrent Ontime &8➡ &e%mactime_current%' daily-ontime: '&e| &fDaily Ontime &8➡ &e%mactime_daily%' weekly-ontime: '&e| &fWeekly Ontime &8➡ &e%mactime_weekly%' monthly-ontime: '&e| &fMonthly Ontime &8➡ &e%mactime_monthly%' yearly-ontime: '&e| &fYearly Ontime &8➡ &e%mactime_yearly%' alltime-ontime: '&e| &fAll-Time Ontime &8➡ &e%mactime_alltime%' afk-time: '&e| &fTotal AFK Time &8➡ &e%mactime_afktime%' last-online: '&e| &fLast Online &8➡ &e%mactime_lastonline% &fAgo'

Sorted player ontimes (GUI Without luckperms sorting)

{0} = Total Players

spo: title: 'Staff On-Times ({0})'

Individual Group Ontimes (/mactime gui [groupname])

{0} = Luckperms group prefix

{1} = Total Players

igo: titles: main: '{0}&8On-Times ({1})' other: 'Other Members On-Times ({1})' error: invalid-group: '&cInvalid Group' group-does-not-exist: '&cGroup does not exist in luckperms!'

Individual Player Ontime Data Menu

This is the menu that is shown when you click a player head inside /mactime gui

io: title: 'Data for %player_name%'

Sorted Ontimes

{0} = Luckperms Group Prefix

{1} = Total Players

so: title: '{0} &8Player On-Times ({1})'

{0} = Date (ex. 1/20, 3/10)

{1} = Time

history-item: title: 'Past 7 days of ontime' entry: '&3{0} &8➡ &3{1}' empty: '&cPlayer has not logged on in the past 7 days!'

AFK notifications logged to console

{0} = Total time AFK (formatted as hh:mm:ss)

AFK-Detection: afk: 'is now afk' not-afk: 'is no longer afk' afk-time: 'was afk for {0}'

#

Webhook Embeds

#

webhook: join: title: $username has joined color: 0x00ff00

Available Placeholders

$time - Timestamp when the player joined the server

content: - "• Time Joined: `$time`" leave: title: $username has left color: 0xff0000

Available Placeholders

$time_joined - Timestamp when the player joined the server

$time_left - Timestamp when the player left the server

$time_online - Total time the player was on the server for

content: - "• Time Joined: `$time_joined`" - "• Time Left: `$time_left`" - "• Total time online: `$time_online`" afk-start: title: $username is now afk color: 0xff9a00

Available Placeholders

$time - Timestamp when the player became afk

$afk_time - Total time the player has been afk on the server

content: - "• Afk Starting at: `$time`" - "• Total AFK Time: `$afk_time`" afk-end:

Available placeholder ($username)

title: $username is no longer afk color: 0xff9a00

Available Placeholders

$time - Timestamp when the player was afk

$afk_time - Time the player was afk for

$total_afk_time - Total time the player has been afk

content: - "• Afk Since: `$time`" - "• Time Afk: `$afk_time`" - "• Total AFK Time: `$total_afk_time`" print: title: Ontime Statistics for $username color: 0xffffff

Available Placeholders

$date

$uuid

$daily_ontime

$weekly_ontime

$monthly_ontime

$yearly_ontime

$alltime_ontime

$afk_time

$last_online

content: - "• Date: `$date`" - "• UUID: `$uuid`" - "• Daily Ontime: `$daily_ontime`" - "• Weekly Ontime: `$weekly_ontime`" - "• Monthly Ontime: `$monthly_ontime`" - "• Yearly Ontime: `$yearly_ontime`" - "• All time Ontime: `$alltime_ontime`" - "• Afk time: `$afk_time`" - "• Last Online: `$last_online`" saving:

Available placeholder ($range)

title: Weekly Ontimes for $range color: 0xffffff ```