# MacTime<\/p>\n
This plugin allows tracking of the online time for players.<\/p>\n
# Features ### Player Commands # Permissions<\/p>\n | Permission | Description| # Placeholders For other players, you can add their username to the end of the placeholder. – `%mactime_daily_notch%` If you would like the raw value in seconds, you can add `_raw` to the end of any time related placeholder. # Showcase<\/p>\n     “`yml # Storage options sql: # Database name, username and password. # options # At the end of every week you can save players ontimes to a file in leaderboard fashion # Toggle this feature on\/off # Day of the week ontime will be saved # Order of which times will sort by # MacTime Admin Command Configurations<\/p>\n # Reset # Removes data entirely versus restarting the count after reset # Sets who is able to use \/mactime reset * (resets everyone’s ontime) # AFK Checker luckperms: # GUI # Duration in seconds to update the gui # Discord Webhooks join: leave: afkstart: afkend: print: saving: other: # Removes a player’s ontime data if they are no longer have the `ontime.track` permission # Your timezone # Date of when ontime first started recording # Config version (don’t touch or u get malaria) “`yml # %player_name% = Player’s Username # %player_name% = Player’s Username # # # Sorted player ontimes (GUI Without luckperms sorting) # Individual Group Ontimes (\/mactime gui [groupname]) # Sorted Ontimes # {0} = Date (ex. 1\/20, 3\/10) # AFK notifications logged to console # webhook: # Support & Contact # bStats You can only manage time if you track it right.
\n– Only online time tracking plugin that is updated to the latest minecraft version
\n– Almost every message is configurable via messages.yml
\n– GUI which showcases various ontime data for players (Updates in real time at an interval which can be configured) (v1.21+)
\n– 0% thread usage on a single instance with over 500 players while tracking more than 50 staff members (*via spark*)
\n– MySQL support
\n– Folia Support
\n– Administrator friendly commands, permission nodes, and error messages to pinpoint issues
\n– Discord Webhook support
\n– All commands (besides \/mactime gui) can be executed by console
\n– Hex support for configurable messages
\n– PlaceholderAPI Support
\n– AFK time tracking (with EssentialsX)
\n# Commands
\n### Admin Commands
\n* `\/mactime export
\n * If discord webhooks are enabled, this allows you to export all ontime data for either a specific player
\n or all players being tracked.
\n* `\/mactime gui [groupname:online:offline:other]`
\n * Opens a GUI with all players showcasing their ontime data. If you have luckperms on your server, you can sort players in the gui by group weights.
\n * You are also able to set the real time update interval for the GUI (If you would not like this, set `gui.updateinterval` to `0` in config.yml)
\n * If you would like to view players’ ontimes that are in a specific group, you can specify any included groups under `gui.whitelisted-groups` and run `\/mactime gui [groupname]`
\n * You are also able to specify viewing online players or offline players data by running `\/mactime gui [online:offline]`
\n * If a player was previously in a group specified under `gui.whitelisted-groups` but now isn’t, you can view their data by running `\/mactime gui [other]`
\n (If you would like their data wiped on their next join if they no longer have the `mactime.track` permission node, you can enable `other.remove-if-no-perm` in config.yml)
\n* `\/mactime help`
\n * Displays the help menu
\n* `\/mactime reload [config:messages]`
\n * Reloads either the config.yml file or messages.yml file. If no choice is specified, both will be reloaded.
\n* `\/mactime reset
\n * Resets ontime data for either a player or a group (if luckperms is on your server).
\n *If you would like the user data to be permanently removed from your server after running this command, you can set `reset.delete-data-on-reset` to `true` in the config.yml.*
\n* `\/ontime
\n * View ontime data for a specific player<\/p>\n
\n* `\/ontime`
\n * Displays ontime data based on the player’s permissions.<\/p>\n
\n| ————- |:————-:|
\n|`mactime.*`| Grants all permissions.|
\n|`ontime.track`| Allows the plugin to track the player’s on-time.|
\n|`mactime.admin`| Provides access to \/mactime command.|
\n|`mactime.command.*`| Provides access to all \/mactime commands and their subcommands.|
\n|`mactime.command.help`| Grants access to \/mactime help.|
\n|`mactime.command.reload`| Grants access to \/mactime reload [config:messages].|
\n|`mactime.command.export`| if discord webhooks are enabled, this allows you to export player\u2019s ontime data to a webhook.|
\n|`mactime.command.reset`| Grants access to \/mactime reset command.|
\n|`mactime.command.gui`| Grants access to the \/mactime gui command.|
\n|`ontime.own`| Allows use of \/ontime command.|
\n|`ontime.own.*`| Provides access to see all on-time statistics.|
\n|`ontime.own.afk`| Provides access to see AFK time via \/ontime.|
\n|`ontime.own.daily`| Provides access to see daily time via \/ontime.|
\n|`ontime.own.weekly`| Provides access to see weekly time via \/ontime.|
\n|`ontime.own.monthly`| Provides access to see monthly time via \/ontime.|
\n|`ontime.own.yearly`| Provides access to see yearly time via \/ontime.|
\n|`ontime.own.alltime`| Provides access to see all-time via \/ontime.|
\n|`ontime.others`| Allows usage of \/ontime
\n|`ontime.others.*`| Provides access to see all on-time statistics for other players.|
\n|`ontime.others.afk`| Provides access to see AFK time via \/ontime for other players.|
\n|`ontime.others.daily`| Provides access to see daily time via \/ontime for other players.|
\n|`ontime.others.weekly`| Provides access to see weekly time via \/ontime for other players.|
\n|`ontime.others.monthly`| Provides access to see monthly time via \/ontime for other players.|
\n|`ontime.others.yearly`| Provides access to see yearly time via \/ontime for other players.|
\n|`ontime.others.alltime`| Provides access to see all-time via \/ontime for other players.|<\/p>\n
\n| Permission | Description|
\n| ————- |:————-:|
\n| `%mactime_current%`| Displays the current ontime of the user looking at the placeholder|
\n| `%mactime_daily%`| Displays the daily ontime of the user looking at the placeholder|
\n| `%mactime_weekly%`| Displays the weekly ontime of the user looking at the placeholder|
\n| `%mactime_monthly%`| Displays the monthly ontime of the user looking at the placeholder|
\n| `%mactime_yearly%`| Displays the yearly ontime of the user looking at the placeholder|
\n| `%mactime_alltime%`| Displays the alltime ontime of the user looking at the placeholder|
\n| `%mactime_afktime%`| Displays the afktime of the user looking at the placeholder|
\n| `%mactime_lastonline%`| This will always return `Player is currently online!`|<\/p>\n
\nFor example,<\/p>\n
\n * This will return the daily ontime for “Notch”.
\n *If the player specified has no data, then the placeholder will display `Player has no data.`*
\nFor `%mactime_lastonline_notch%`, this will return how long it has been since the player logged off of the server.<\/p>\n
\nFor example,
\n– `%mactime_daily_raw%`
\n – If I had 5 minutes of daily ontime, this would return `300`
\n# Hooks
\nThis plugin hooks into 3 plugins for optional features
\n– – –
\n* Luckperms
\n * Mactime hooks into luckperms to enable group sorting by weights and adding the player’s prefix inside the GUI
\n* EssentialsX
\n * For enabling the tracking of time spent afk
\n* PlaceholderAPI
\n * For placeholders.<\/p>\nGUI<\/summary>\n
\n<\/details>\nOntime Command<\/summary>\n
\n<\/details>\nDiscord Webhook<\/summary>\n
\n<\/details>\nPlaceholders<\/summary>\n
\n<\/details>\nDefault config.yml<\/summary>\n
\n# MacTime, by AjMaacc<\/p>\n
\n# Data is stored in plugins\/MacTime\/playerdata\/mactime.db
\n# Default storage type is SQLite<\/p>\n
\n # To use MySQL, set below to true
\n # Default: false
\n enabled: false
\n # Your database’s server address
\n address: ‘127.0.0.1:3306’<\/p>\n
\n database: “”
\n username: “”
\n password: “”<\/p>\n
\n usessl: false<\/p>\n
\nontime-saving:<\/p>\n
\n # Default: true
\n enabled: true<\/p>\n
\n # Options: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
\n # Default: Monday
\n dayofweek: ‘Monday’<\/p>\n
\n # Options: Alphabetical, Ascending, Descending, Group.
\n # Group will sort by Luckperms group, requires Luckperms to be installed!
\n # Default: Descending
\n order: “Descending”<\/p>\n
\n# Options for the \/mactime reset command
\nreset:
\n # Delay before any un-confirmed \/mactime reset queries are cancelled in seconds
\n # Default: 10
\n delay: 10<\/p>\n
\n # Default: false
\n delete-data-on-reset: false<\/p>\n
\n # Options: “None”, “Console”, “Player”, “All”
\n # Default: None
\n wildcard-reset: ‘None’<\/p>\n
\n# The AFK Status of a player is determined by MacTime hooking into Essentials.
\n# You will need to have essentials on your server for this to work.
\nafk-checker:
\n # Enable AFK time tracking
\n # Default: false
\n enabled: false<\/p>\n
\n # Luckperm groups to be included for sorting by groups
\n # You must have Luckperms installed for this to be relevant
\n # Default:
\n # – owner
\n # – manager
\n # – admin
\n # – jradmin
\n # – dev
\n # – srmod
\n # – mod
\n # – jrmod
\n # – helper
\n whitelisted-groups:
\n – owner
\n – manager
\n – admin
\n – jradmin
\n – dev
\n – srmod
\n – mod
\n – jrmod
\n – helper<\/p>\n
\n# Options for the \/mactime gui command
\ngui:
\n # Sorts \/mactime gui by Luckperm groups specified under “luckpermgroups”
\n # You need to have Luckperms on your server for this to work!
\n # Default: false
\n sort-by-luckperm-group: false<\/p>\n
\n # Set this to 0 to disable this feature
\n # Default: 10
\n update-interval: 10<\/p>\n
\nwebhook:
\n # Enable this feature
\n # Default: false
\n enabled: false
\n # Webhook url
\n url: ”
\n # Username for the webhook. If this is not set (or empty), this will default to “MacTime”
\n username: ”<\/p>\n
\n # Enables player join webhooks to be sent
\n # Default: true
\n enabled: true
\n # If you want this specific embed to be sent to a separate webhook,
\n # add the secondary webhook’s url here
\n # If left empty, this defaults to use the main webhook url defined under “webhook.url”
\n url: ”
\n # If you would like the webhook’s username to differ from the original username (webhook.username)
\n # Leaving this blank defaults to webhook.username
\n username: ”<\/p>\n
\n # Enables player leave webhooks to be sent
\n # Default: true
\n enabled: true
\n url: ”
\n username: ”<\/p>\n
\n # Enables webhooks to be sent for when a player goes afk
\n # Default: true
\n enabled: true
\n url: ”
\n username: ”<\/p>\n
\n # Enables webhooks to be sent when a player returns from being afk
\n # Default: true
\n enabled: true
\n url: ”
\n username: ”<\/p>\n
\n # Enables the “\/mactime export” command and allows playerdata to be sent by the webhook
\n # Default: true
\n enabled: true
\n url: ”
\n username: ”<\/p>\n
\n # Enables weekly data saved during the ontime-saving section to be sent by the webhook
\n # Default: true
\n enabled: true
\n url: ”
\n username: ”<\/p>\n
\n # Enables the beautiful MacTime signature in console on startup
\n # If you don’t want this, set below to false
\n # Default: true
\n signature: true<\/p>\n
\n # This deletes their data on the player’s next join
\n # Default: false
\n remove-if-no-perm: false<\/p>\n
\n # Use https:\/\/pastebin.com\/mfdYhnu7 to find the format for your timezone
\n timezone: “America\/New_York”<\/p>\n
\n# This resets when you do \/mactime reset *
\n# Don’t touch pls
\nstart: ”<\/p>\n
\nversion: ‘1.0.4’
\n“`
\n<\/details>\nDefault messages.yml<\/summary>\n
\nversion: ‘1.0.3’
\nprefix: ‘&e\u2600 &e&lMacTime &8&l\u00bb ‘
\nonline: ‘&a\u25cf’
\noffline: ‘&c\u25cf’
\nafk: ‘&8[&7&lAFK&8]’
\nno-permission: ‘&cNo Permission’<\/p>\n
\ncommand:
\n ontime:
\n player:
\n # Header for \/ontime
\n self-header: ‘&7&m &r &a%player_name%”s Ontime &7&m &r’
\n # Header for \/ontime
\n other-header: ‘&a%player_name%”s Ontime’
\n no-ontime-data: ‘&c %player_name% &chas no ontime data!’
\n divider: ‘&7&l&m ‘
\n console:
\n invalid: ‘This Command cannot be executed by console.’
\n player-does-not-have-data: ‘This player does not have any ontime data!’
\n reload:
\n messages: ‘&7Successfully Reloaded Module: &fMessages&7.’
\n config: ‘&7Successfully Reloaded Module: &fConfiguration&7.’
\n all: ‘&7Successfully Reloaded Modules: &fConfigurations &7and &fMessages&7.’<\/p>\n
\n # {0} = Luckperm group prefix
\n # {1} = Total players
\n reset:
\n expired:
\n player: ‘&cOntime removal request for %player_name% has expired!’
\n group: ‘&cOntime removal request for {0} group has expired!’
\n wild: ‘&cOntime removal request for all users have expired!’
\n confirm:
\n player: ‘&7Are you sure you want to reset &f%player_name%”s &7ontime stats? &7[Click to Confirm]’
\n group: ‘&7Are you sure you want to reset ontimes for players in the &f{0}&7 group? &7[Click to Confirm]’
\n wild: ‘&cAre you sure you want to reset all ontime statistics? &7[Click to Confirm]’
\n success:
\n player: ‘&7Reset ontime for &f%player_name%&7!’
\n group: ‘&7Reset ontime for &f{1} &7players in &f{0}&7 group!’
\n wild: ‘&7Reset ontime statistics for &f{1} &7players!’
\n invalid:
\n player: ‘&cYou have entered an invalid username!’
\n group: ‘&cYou have entered an invalid group name!’
\n wild: ‘&cThis action is currently disabled!’
\n player-does-not-have-data: ‘ &c%player_name% has no ontime data!’
\n # %command% – Reset command ex. “\/mactime reset player Notch”
\n hover-msg: ‘&a&lCLICK ME&r’<\/p>\n
\n# Ontime Command (\/ontime)
\n#
\nontime:
\n player:
\n current-ontime: ‘&fCurrent Ontime &8\u27a1 &e%mactime_current%’
\n daily-ontime: ‘&fDaily Ontime &8\u27a1 &e%mactime_daily%’
\n weekly-ontime: ‘&fWeekly Ontime &8\u27a1 &e%mactime_weekly%’
\n monthly-ontime: ‘&fMonthly Ontime &8\u27a1 &e%mactime_monthly%’
\n yearly-ontime: ‘&fYearly Ontime &8\u27a1 &e%mactime_yearly%’
\n alltime-ontime: ‘&fAll-Time Ontime &8\u27a1 &e%mactime_alltime%’
\n afk-time: ‘&fTotal AFK Time &8\u27a1 &e%mactime_afktime%’
\n last-online: ‘&fLast Online &8\u27a1 &e%mactime_lastonline%’
\n console:
\n current-ontime: ‘* Current Ontime \u27a1 %mactime_current%’
\n daily-ontime: ‘* Daily Ontime \u27a1 %mactime_daily%’
\n weekly-ontime: ‘* Weekly Ontime \u27a1 %mactime_weekly%’
\n monthly-ontime: ‘* Monthly Ontime \u27a1 %mactime_monthly%’
\n yearly-ontime: ‘* Yearly Ontime \u27a1 %mactime_yearly%’
\n alltime-ontime: ‘* All-Time Ontime \u27a1 %mactime_alltime%’
\n afk-time: ‘* AFK Time \u27a1 %mactime_afktime%’
\n last-online: ‘* Last Online \u27a1 %mactime_lastonline%’<\/p>\n
\n# GUI message configuration (\/mactime gui)
\n#
\ngui:
\n # Player Ontimes
\n # {0} = Total Players
\n po:
\n title: ‘Staff On-Times ({0})’
\n online: ‘&a&lONLINE’
\n offline: ‘&c&lOFFLINE’
\n current-ontime: ‘&e| &fCurrent Ontime &8\u27a1 &e%mactime_current%’
\n daily-ontime: ‘&e| &fDaily Ontime &8\u27a1 &e%mactime_daily%’
\n weekly-ontime: ‘&e| &fWeekly Ontime &8\u27a1 &e%mactime_weekly%’
\n monthly-ontime: ‘&e| &fMonthly Ontime &8\u27a1 &e%mactime_monthly%’
\n yearly-ontime: ‘&e| &fYearly Ontime &8\u27a1 &e%mactime_yearly%’
\n alltime-ontime: ‘&e| &fAll-Time Ontime &8\u27a1 &e%mactime_alltime%’
\n afk-time: ‘&e| &fTotal AFK Time &8\u27a1 &e%mactime_afktime%’
\n last-online: ‘&e| &fLast Online &8\u27a1 &e%mactime_lastonline% &fAgo’<\/p>\n
\n # {0} = Total Players
\n spo:
\n title: ‘Staff On-Times ({0})’<\/p>\n
\n # {0} = Luckperms group prefix
\n # {1} = Total Players
\n igo:
\n titles:
\n main: ‘{0}&8On-Times ({1})’
\n other: ‘Other Members On-Times ({1})’
\n error:
\n invalid-group: ‘&cInvalid Group’
\n group-does-not-exist: ‘&cGroup does not exist in luckperms!’
\n # Individual Player Ontime Data Menu
\n # This is the menu that is shown when you click a player head inside \/mactime gui
\n io:
\n title: ‘Data for %player_name%’<\/p>\n
\n # {0} = Luckperms Group Prefix
\n # {1} = Total Players
\n so:
\n title: ‘{0} &8Player On-Times ({1})’<\/p>\n
\n # {1} = Time
\n history-item:
\n title: ‘Past 7 days of ontime’
\n entry: ‘&3{0} &8\u27a1 &3{1}’
\n empty: ‘&cPlayer has not logged on in the past 7 days!’<\/p>\n
\n# {0} = Total time AFK (formatted as hh:mm:ss)
\nAFK-Detection:
\n afk: ‘is now afk’
\n not-afk: ‘is no longer afk’
\n afk-time: ‘was afk for {0}’<\/p>\n
\n# Webhook Embeds
\n#<\/p>\n
\n join:
\n title: $username has joined
\n color: 0x00ff00
\n # Available Placeholders
\n # $time – Timestamp when the player joined the server
\n content:
\n – “\u2022 Time Joined: `$time`”
\n leave:
\n title: $username has left
\n color: 0xff0000
\n # Available Placeholders
\n # $time_joined – Timestamp when the player joined the server
\n # $time_left – Timestamp when the player left the server
\n # $time_online – Total time the player was on the server for
\n content:
\n – “\u2022 Time Joined: `$time_joined`”
\n – “\u2022 Time Left: `$time_left`”
\n – “\u2022 Total time online: `$time_online`”
\n afk-start:
\n title: $username is now afk
\n color: 0xff9a00
\n # Available Placeholders
\n # $time – Timestamp when the player became afk
\n # $afk_time – Total time the player has been afk on the server
\n content:
\n – “\u2022 Afk Starting at: `$time`”
\n – “\u2022 Total AFK Time: `$afk_time`”
\n afk-end:
\n # Available placeholder ($username)
\n title: $username is no longer afk
\n color: 0xff9a00
\n # Available Placeholders
\n # $time – Timestamp when the player was afk
\n # $afk_time – Time the player was afk for
\n # $total_afk_time – Total time the player has been afk
\n content:
\n – “\u2022 Afk Since: `$time`”
\n – “\u2022 Time Afk: `$afk_time`”
\n – “\u2022 Total AFK Time: `$total_afk_time`”
\n print:
\n title: Ontime Statistics for $username
\n color: 0xffffff
\n # Available Placeholders
\n # $date
\n # $uuid
\n # $daily_ontime
\n # $weekly_ontime
\n # $monthly_ontime
\n # $yearly_ontime
\n # $alltime_ontime
\n # $afk_time
\n # $last_online
\n content:
\n – “\u2022 Date: `$date`”
\n – “\u2022 UUID: `$uuid`”
\n – “\u2022 Daily Ontime: `$daily_ontime`”
\n – “\u2022 Weekly Ontime: `$weekly_ontime`”
\n – “\u2022 Monthly Ontime: `$monthly_ontime`”
\n – “\u2022 Yearly Ontime: `$yearly_ontime`”
\n – “\u2022 All time Ontime: `$alltime_ontime`”
\n – “\u2022 Afk time: `$afk_time`”
\n – “\u2022 Last Online: `$last_online`”
\n saving:
\n # Available placeholder ($range)
\n title: Weekly Ontimes for $range
\n color: 0xffffff
\n“`
\n<\/details>\n
\nTo report bugs, suggest a feature, or anything else, contact me via discord.
\n– Direct Contact
\n * -> ajmac<\/p>\n
\n<\/p>\n","protected":false},"excerpt":{"rendered":"
\nAn administrator friendly plugin to track the ontime of staff members on your server.<\/p>\n","protected":false},"featured_media":97277,"template":"","meta":{"_minecraft_slug":"mactime","_minecraft_project_id":"D6RzuXXH","_minecraft_author":"ajmac","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":1679,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mactime.zip","_minecraft_size_bytes":53163190,"_minecraft_version_count":15,"_minecraft_updated_at":"2026-05-16T06:54:16.196593Z","_minecraft_date_created":"2024-03-17T06:36:14.976230Z","_minecraft_date_modified":"2026-04-07T13:39:14.948875Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mactime","_minecraft_icon_attachment_id":97277,"_minecraft_imported_at":"2026-06-05T13:54:15+00:00","_minecraft_import_hash":"5aebaa3c03188afd43c65f308c72df4f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,867,129,92],"mod_loader":[130,131,132,133,134],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-97276","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n