Resources Tracker

# ResourcesTracker **Ever wondered who's secretly hoarding diamonds or who's been suspiciously lucky with ancient debris? ResourcesTracker is the ultimate tool for server admins who want to maintain a fair and transparent gameplay environment.** This lightweight, high-performance plugin silently logs player activity—specifically, which blocks are broken and which items are picked up. It provides you with the detailed insights you need to identify potential cheaters (like X-rayers) and keep a close eye on your server's economy and player progress. ## ✨ Core Features * **Comprehensive Logging:** Tracks every block broken and every item picked up by any player on the server. * **High-Performance Database:** Powered by **SQLite**, ResourcesTracker is designed for speed and scalability. It can handle massive amounts of data without impacting your server's performance. * **Detailed Statistics Book:** Generate an in-game book with a complete, up-to-the-second statistical report for any player. * **Powerful Search:** Instantly filter a player's statistics for specific items (e.g., "diamond," "netherite") directly from the command. * **Configurable Admin Alerts:** Receive real-time, in-game notifications when a player obtains a high-value item (fully configurable). * **Personalized Notifications:** Admins can easily enable or disable notifications for themselves at any time to avoid chat spam. * **Automatic Update Checker:** Stay informed! The plugin automatically checks for new versions on Modrinth and notifies OPs when an update is available. ## 🎮 How to Use Using ResourcesTracker is simple and intuitive. The main command is `/rstats`. ### View Player Statistics To get a full statistical report for a player, use: ``` /rstats <player_name> ``` This will generate a book and place it in your inventory. The book contains a detailed, paginated list of all the blocks the player has broken and all the items they have picked up. ### Search for Specific Items To narrow down the results to a specific item, simply add a search term: ``` /rstats <player_name> <search_term> ``` For example, to see how many diamonds a player has found, use: ``` /rstats Steve diamond ``` This will generate a book showing only statistics related to items with "diamond" in their name. The search is **case-insensitive**. ### Control Notifications Don't want to receive alerts for a while? You can toggle them for yourself without affecting other admins. ``` /rstats notifications <enable|disable> ``` ## ⚙️ Permissions * `resourcestracker.notify`: Players with this permission will receive the real-time alerts for high-value items. (Recommended for Admins/Mods only) *Note: By default, the `/rstats` command is OP-only, but this can be changed in the `config.yml`.* ## 🔧 Configuration The `config.yml` file is simple and well-documented, allowing you to customize the plugin to your needs. ```yaml # A list of materials that will trigger a notification. notify-on: - DIAMOND_ORE - ANCIENT_DEBRIS - NETHERITE_BLOCK # Whether only OPs can use the /rstats command. Only-OP: true # Whether to check for new updates on startup. check-for-updates: true ```