DN-Stats

A Minecraft plugin for tracking and displaying player statistics including ores mined and mobs killed. Features an intuitive GUI interface and multi-language support.

Features

• 📊 Comprehensive Statistics Tracking

  • Track all ores mined by players
  • Track all mobs killed by players
  • View first and last interaction timestamps

• 🎨 Interactive GUI

  • Easy-to-use graphical interface
  • Separate views for ore and mob statistics
  • Detailed information for each tracked item

• 🌍 Multi-Language Support

  • English (en)
  • Vietnamese (vi)
  • Chinese (zh)
  • Japanese (ja)
  • Korean (ko)
  • Spanish (es)
  • French (fr)

• 💾 Data Storage

  • SQLite database for efficient data storage
  • Auto-save feature (configurable interval)
  • Automatic data persistence on server shutdown

• ⚡ Performance

  • Optimized SQLite integration
  • Asynchronous operations where possible
  • Minimal server impact

Requirements

• Minecraft Server: Spigot/Paper 1.21 or higher
• Java: Version 21 or higher
• Database: SQLite (included)

Installation

1. Download the latest DN-Stats-0.1.jar from the releases
2. Place the JAR file into your server's plugins folder
3. Restart your server or use /reload
4. The plugin will automatically create configuration files

Configuration

config.yml

# Default language
# Supported languages: vi (Vietnamese), en (English), zh (Chinese), ja (Japanese), ko (Korean), es (Spanish), fr (French)
default-language: en

# Auto-save interval (in seconds)
auto-save-interval: 300

Language Files

Language files are located in plugins/DN-Stats/lang/:

• messages_en.yml - English
• messages_vi.yml - Vietnamese
• messages_zh.yml - Chinese
• messages_ja.yml - Japanese
• messages_ko.yml - Korean
• messages_es.yml - Spanish
• messages_fr.yml - French

Edit these files to customize messages in your preferred language.

Usage

Commands

• /dnstats - Open the statistics GUI
• /thongke - Alias for /dnstats
• /tk - Alias for /dnstats

Permissions

• dnstats.use - Allows players to use /dnstats command (default: true)
• dnstats.admin - Administrator permission (default: op)

GUI Navigation

1. Use /dnstats to open the main menu
2. Select either Ores or Mobs to view respective statistics
3. Browse through your statistics for different items
4. Click the back button to return to the main menu

Building from Source

Prerequisites

• Maven 3.6+
• Java 21+
• Spigot/Paper API (downloaded automatically)

Build Steps

# Clone the repository
git clone <repository-url>
cd DN-Stats

# Build the plugin
mvn clean package

# The compiled JAR will be in target/DN-Stats-0.1.jar

Statistics Tracked

Ores

• Total blocks mined
• First mined timestamp
• Last mined timestamp

Mobs

• Total mobs killed
• First killed timestamp
• Last killed timestamp

Data Storage

The plugin uses SQLite to store player statistics. The database file is located at:

plugins/DN-Stats/data.db

Important: Always backup your plugins/DN-Stats/ folder before updating or modifying the plugin.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License.

Author

• devnguyen0111
• Website: https://devnguyen.xyz

Support

For issues, bug reports, or feature requests, please open an issue on the repository.

---

Note: This plugin requires Minecraft 1.21+ and Java 21+. Make sure your server meets these requirements before installation.