# MacTime This plugin allows tracking of the online time for players.
# Features - Only online time tracking plugin that is updated to the latest minecraft version - Almost every message is configurable via messages.yml - GUI which showcases various ontime data for players (Updates in real time at an interval which can be configured) (v1.21+) - 0% thread usage on a single instance with over 500 players while tracking more than 50 staff members (*via spark*) - MySQL support - Administrator friendly commands, permission nodes, and error messages to pinpoint issues - Discord Webhook support - All commands (besides /mactime gui) can be executed by console - Hex support for configurable messages - PlaceholderAPI Support - AFK time tracking with EssentialsX # Commands ### Admin Commands * `/mactime export [username]` * If discord webhooks are enabled, this allows you to export all ontime data for either a specific player or all players being tracked. * `/mactime gui [groupname:online:offline:other]` * 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. * 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) * 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]` * You are also able to specify viewing online players or offline players data by running `/mactime gui [online:offline]` * 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]`
(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) * `/mactime help` * Displays the help menu * `/mactime reload [config:messages]` * Reloads either the config.yml file or messages.yml file. If no choice is specified, both will be reloaded. * `/mactime reset ` * Resets ontime data for either a player or a group (if luckperms is on your server).
*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.* * `/ontime ` * View ontime data for a specific player ### Player Commands * `/ontime` * Displays ontime data based on the player's permissions. # Permissions | Permission | Description| | ------------- |:-------------:| |`mactime.*`| Grants all permissions.| |`ontime.track`| Allows the plugin to track the player's on-time.| |`mactime.admin`| Provides access to /mactime command.| |`mactime.command.*`| Provides access to all /mactime commands and their subcommands.| |`mactime.command.help`| Grants access to /mactime help.| |`mactime.command.reload`| Grants access to /mactime reload [config:messages].| |`mactime.command.export`| if discord webhooks are enabled, this allows you to export player’s ontime data to a webhook.| |`mactime.command.reset`| Grants access to /mactime reset command.| |`mactime.command.gui`| Grants access to the /mactime gui command.| |`ontime.own`| Allows use of /ontime command.| |`ontime.own.*`| Provides access to see all on-time statistics.| |`ontime.own.afk`| Provides access to see AFK time via /ontime.| |`ontime.own.daily`| Provides access to see daily time via /ontime.| |`ontime.own.weekly`| Provides access to see weekly time via /ontime.| |`ontime.own.monthly`| Provides access to see monthly time via /ontime.| |`ontime.own.yearly`| Provides access to see yearly time via /ontime.| |`ontime.own.alltime`| Provides access to see all-time via /ontime.| |`ontime.others`| Allows usage of /ontime to view other player's on-times.| |`ontime.others.*`| Provides access to see all on-time statistics for other players.| |`ontime.others.afk`| Provides access to see AFK time via /ontime for other players.| |`ontime.others.daily`| Provides access to see daily time via /ontime for other players.| |`ontime.others.weekly`| Provides access to see weekly time via /ontime for other players.| |`ontime.others.monthly`| Provides access to see monthly time via /ontime for other players.| |`ontime.others.yearly`| Provides access to see yearly time via /ontime for other players.| |`ontime.others.alltime`| Provides access to see all-time via /ontime for other players.| # Placeholders | Permission | Description| | ------------- |:-------------:| | `%mactime_current%`| Displays the current ontime of the user looking at the placeholder| | `%mactime_daily`| Displays the daily ontime of the user looking at the placeholder| | `%mactime_weekly`| Displays the weekly ontime of the user looking at the placeholder| | `%mactime_monthly`| Displays the monthly ontime of the user looking at the placeholder| | `%mactime_yearly`| Displays the yearly ontime of the user looking at the placeholder| | `%mactime_alltime`| Displays the alltime ontime of the user looking at the placeholder| | `%mactime_afktime`| Displays the afktime of the user looking at the placeholder| | `%mactime_lastonline`| This will always return `Player is currently online!`| For other players, you can add their username to the end of the placeholder.
For example, - `%mactime_daily_notch%` * This will return the daily ontime for "Notch".
*If the player specified has no data, then the placeholder will display `Player has no data.`*
For `%mactime_lastonline_notch`, this will return how long it has been since the player logged off of the server. If you would like the raw value in seconds, you can add `_raw` to the end of any time related placeholder. For example, - `%mactime_daily_raw%` - If I had 5 minutes of daily ontime, this would return `300` # Hooks This plugin hooks into 3 plugins for optional features - - - * Luckperms * Mactime hooks into luckperms to enable group sorting by weights and adding the player's prefix inside the GUI * EssentialsX * For enabling the tracking of time spent afk * PlaceholderAPI * For placeholders. # Showcase

GUI

![mactime_gui_example](https://i.ibb.co/G5N9VGT/mactime-gui-example.gif)

Ontime Command

![mactime_ontime_command_example](https://i.ibb.co/bLYrT03/mactime-ontime-command-example.png)

Discord Webhook

![discord_webhook](https://i.ibb.co/qg0D489/mactime-discord-webhook-example.png)

Placeholders

![mactime_placeholders_example](https://i.ibb.co/VjTKgfJ/mactime-placeholders-example.gif)

# Support & Contact To report bugs, suggest a feature, or anything else, contact me via discord. - Direct Contact * -> [ajmac](http://discord.com/users/643604666634076179) # bStats ![bStats](https://bstats.org/signatures/bukkit/mactime.svg)

ajmac

MacTime

vSudo

MacFlags