# PlayerTracer

Logo

Learn what are your players up to > [!WARNING] > This plugin is still **in development**, so it's **not** recommended to use in production servers > unless you know what are you doing. This means that **anything can change any time without > warning**, which can lead to **data loss**, configuration overwriting, etc. Whatever happens during > this phase, is **your responsibility**. # Info This plugin logs player actions to let server admins view past actions. It also lets plugin developers registers their own logs, which can lead to a more detailed list of actions a player is doing, and has done. > [!CAUTION] > You need Java 17+ to use this plugin. If you are using a lower version consider upgrading > [!CAUTION] > This plugin is **not** compatible with CraftBukkit, Bukkit or Spigot servers. Please use Paper or its forks > [!CAUTION] > This plugin has active support for Minecraft 1.17+. So, if you are using a lower version, you will not receive **any** support # Features (not all are implemented yet, check below for the TODO list) - Store logs in a database (MySQL/MariaDB, SQLite, H2) - Search logs by player name, action and date - View logs in chat - View logs in a nice GUI - (Not implemented yet) Receive logs in real time through chat - (Not implemented yet) API to let plugin developers register their own logs - (Not implemented yet) Purge system (manually and automatically) # "Why should I use this plugin?" This plugin is useful for server administrators / moderators who want to keep track of anything that a player does. For example, if a player is being reported for being toxic in chat, you can retrieve their chat logs in order to verify that information or just to collect evidence against them. # Commands - `/playertracer` - Main command. Has the following aliases: `/pt`, `/ptracer`, `/trace`, `/tracer` - `/playertracer help` - Shows the help message - `/playertracer search ` - Retrieves logs based on the query provided. Refer to the command's tab-completion to see the available options - `/playertracer page ` - Switches between pages of the last logs retrieved with `/playertracer search` - `/playertracer actionlist` - Lists all available actions that can be logged - `/playertracer tp ` - Teleports you to the location of the log that you clicked in chat after using `/playertracer search` - `/playertracer viewmode ` - Switches between GUI and Chat view modes. Chat will be used by default - `/playertracer purge` - Not implemented yet. Will be used to purge logs from the database by time, log type or player - `/playertracer reload` - Reloads the plugin configuration and messages # Permissions - `playertracer.admin` - Grants access to all commands and features of the plugin - `playertracer.search` - Grants access to the `/playertracer search` command - `playertracer.teleport` - Grants access to the `/playertracer tp` command - There's still some permissions yet to be implemented # TODOs - [x] Store logs in a database (MySQL/MariaDB, SQLite, H2) - [x] In-Game Log viewer (GUI & Command) - [ ] Receive logs in real time through chat - [ ] API - [ ] Purge system (automatically and manually)

PlayerTracer

0.4.2-BETA

0.4.1-BETA

0.4.0-BETA

0.3.2-BETA

0.3.0-BETA

0.2.0-BETA

0.1.1-BETA