Activity Tracker

Description

Activity Tracker is a Minecraft plugin that tracks the activity of players. It records login sessions and play time, provides leaderboards, detailed per-player statistics, optional Discord webhook notifications for player join and quit events, and an optional REST API for exposing activity data to external applications.

Supported Minecraft Versions

This plugin is supported on the Minecraft versions listed in minecraft-versions.json: currently 1.19.4, 1.21.11, 26.2 and 26.3 (Spigot and its forks). Every stable release is booted on a real server of each of these versions before it is published, and every build checks that the plugin only uses Bukkit API that exists on all of them. Other versions from 1.19.4 onwards are expected to work but are not tested. To support another version, add it to the file: both checks pick it up.

Installation

First Time Installation

1. Download the plugin from SpigotMC or the releases page.
2. Place the JAR in the plugins folder of your Spigot server.
3. Restart your server.

REST API (Optional)

Activity Tracker includes an optional REST API for external dashboards and applications. See REST_API.md for setup and endpoint documentation.

Usage

Documentation

• User Guide – Getting started and common scenarios
• Commands Reference – Complete list of all commands
• Configuration Guide – Detailed configuration options

Wiki & Additional Resources

• Wiki Guide
• FAQ

Support

You can find the support Discord server here.

Experiencing a bug?

Please fill out a bug report here.

• Known Bugs

Contributing

• CONTRIBUTING.md
• Notes for Developers

Testing

Unit Tests

Linux:

mvn clean test

Windows:

mvn clean test

If you see BUILD SUCCESS, the tests have passed.

Development

This plugin is built with Maven and targets Java 8.

Building

1. Clone the repository: git clone https://github.com/Dans-Plugins/Activity-Tracker.git
2. Build the plugin: mvn clean package
3. The built JAR will be in the target/ directory.

Manual Testing

1. Build the plugin JAR with mvn clean package.
2. Copy the JAR from target/ into a local Spigot server's plugins folder.
3. Start or restart the server.

Authors and Acknowledgement

Developers

Name	Main Contributions
Daniel Stephenson	Creator

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

You are free to use, modify, and distribute this software, provided that:

• Source code is made available under the same license when distributed.
• Changes are documented and attributed.
• No additional restrictions are applied.

See the LICENSE file for the full text of the GPL-3.0 license.

Project Status

This project is in active development.

bStats

You can view the bStats page for this plugin here.

Usage reporting

Usage reporting is on by default: when the plugin is enabled, and each time one of its commands is used, it sends its name, its version and the command's name to the author's trace server at https://trace.danielstephenson.dev, so it is known which plugins are actually in use. Nothing about players, worlds or IP addresses is sent, and nothing typed after a command. The plugin prints one line on every startup saying whether reporting is on and, if not, why.

Each event also carries a random server ID (the server-id line in plugins/trace/config.yml) so servers can be counted rather than events. It identifies no person, account or IP address; delete the line to get a new one.

To turn it off:

• for this plugin only: usage-reporting.enabled: false in plugins/ActivityTracker/config.yml
• for every plugin on the server that reports to trace: enabled: false in plugins/trace/config.yml (created on first start; plugins never turn it back on)
• for the whole server process: the environment variable TRACE_USAGE_REPORTING=off or DO_NOT_TRACK=1

Details: https://danielstephenson.dev/usage-reporting

Changelog

See CHANGELOG.md for a release-by-release summary of changes.