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.

# 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