A Minecraft plugin that allows players to store and withdraw experience points using special books.
Features
-
Multiple Book Types - Common, Advanced, and Shared experience books with different capacities
-
Player Binding - Books can be bound to specific players to prevent theft
-
Database Storage - MySQL database integration with anti-cheat verification
- ⚡
Folia Compatible - Full support for Folia's regionized threading system
-
Custom Models - Support for custom model data for resource packs
-
Customizable Messages - All messages can be configured in `messages.yml`
Requirements
- Minecraft: 1.20.1+
- Server: Folia / Paper / Spigot / Bukkit
- Java: 17+
- Database: MySQL 5.7+ or MariaDB 10.2+
Installation
1. Download `ExpBookPlugin-1.0.0.jar`
2. Place the jar file in your server's `plugins` folder
3. Start the server to generate configuration files
4. Edit `plugins/ExpBookPlugin/config.yml` to configure database connection
5. Run `/expbook reload` to apply changes
Configuration
Edit `config.yml` to set up your database connection:
| Book Type | Capacity | Material | Bound | Permission |
| Common Book | 1000 XP | Paper | Yes | `expbook.common` |
| Advanced Book | 5000 XP | Book | Yes | `expbook.advanced` |
| Shared Book | 2000 XP | Enchanted Book | No | `expbook.shared` |
Commands
| Command | Description | Permission |
| `/expbook give <player> <type>` | Give an experience book to a player | `expbook.give` |
| `/expbook list` | List all available book types | `expbook.admin` |
| `/expbook reload` | Reload plugin configuration | `expbook.reload` |
Permissions
| Permission | Description | Default |
|------------|-------------|---------|
| `expbook.admin` | Access to all admin commands | OP |
| `expbook.give` | Give experience books to players | OP |
| `expbook.reload` | Reload plugin configuration | OP |
| `expbook.common` | Use common experience books | Everyone |
| `expbook.advanced` | Use advanced experience books | Everyone |
| `expbook.shared` | Use shared experience books | Everyone |
Usage
**For Players:**
- **Store XP**: Hold the book and `Shift + Right Click`
- **Withdraw XP**: Hold the book and `Right Click`
- **Withdraw Half**: Hold the book and `Shift + Right Click` (when withdrawing)