Activity Tracker

Activity Tracker 1.4.0 This release is a drop-in upgrade for a server running 1.3.0: the activity data on disk is unchanged and every existing command keeps working. Two things are new on startup that you should know about. Usage reporting is on by default — the plugin sends its name, version and the names of commands used (nothing about players or the server) to the author's trace server, and it says so in the console on every start; turn it off with usage-reporting.enabled: false in the plugin's config.yml or for every trace-reporting plugin at once in the new plugins/trace/config.yml. Optional Discord join/quit notifications, a /at average command, an admin /at list command, a /at top player count, and a matching REST endpoint round out the release. Changes Usage reporting · The plugin reports one event on startup and one per command to the author's trace server, off the main thread, never blocking a tick, and dropped silently if the server is unreachable; a bounded queue keeps an unreachable server from costing memory. (#99) · A console line on every startup states whether reporting is on, what is sent, and how to turn it off. Opt out per plugin with usage-reporting.enabled: false, server-wide with enabled: false in plugins/trace/config.yml (created on first start, never turned back on by a plugin), or process-wide with the TRACE_USAGE_REPORTING=off or DO_NOT_TRACK=1 environment variables. (#99, #101) Discord notifications · Player join and quit events can be posted to a Discord webhook. Off by default; enable with discordWebhookEnabled: true and discordWebhookUrl. Messages are templated via discordWebhookJoinMessage and discordWebhookQuitMessage ({player} is replaced with the player's name), and discordWebhookStaffOnly: true limits notifications to players holding the new at.staff permission. Sending happens asynchronously. (#77) Commands · New /at average [player] [days] shows a player's total and average hours per day over the last N days (default 7), with permission at.average (default: everyone). (#69) · New /at list shows the 10 most recent sessions across all players, with permission at.list (default: op). (#59) · /at top accepts an optional number of players to show, from 1 to 100 (default 10). (#83) · /at info now shows the player's activity ranking against all tracked players. (#76) · All command output uses a consistent boxed format with colour and progress bars; /at help and /at config list the new commands and keys. (#76) · The bare /at command now checks the at.default permission, which is declared with default true. (#96) · The /at version header no longer shows a doubled v prefix. (#98) REST API · New GET /api/average-daily-activity/{uuid}?days=N returns average and total hours for a player over the period, documented in openapi.yaml. (#69) Upgrade notes · Decide whether you want usage reporting. It is on unless you turn it off: set usage-reporting.enabled: false in plugins/ActivityTracker/config.yml, or set enabled: false in plugins/trace/config.yml to switch it off for every plugin that reports to trace. The console notice on startup confirms the current state. · plugins/trace/config.yml is created on first start if it does not exist. This is expected. · New config keys are written to config.yml on first start: usage-reporting.enabled, usage-reporting.endpoint, usage-reporting.key, discordWebhookEnabled, discordWebhookUrl, discordWebhookStaffOnly, discordWebhookJoinMessage, discordWebhookQuitMessage. Existing keys and values are preserved. · New permissions: at.default (default true) gates the bare /at command; at.average (default true); at.list (default op); at.staff (default op) marks staff for staff-only Discord notifications. If your permissions plugin denies permissions that are not explicitly granted, grant at.default and at.average to players who should keep using /at. · If you run the REST API, the new endpoint is exposed on the same port and needs no configuration. Download: https://github.com/Dans-Plugins/Activity-Tracker/releases… Full release notes: https://github.com/Dans-Plugins/Activity-Tracker/releases…