ExpBook ✅ Save your exp on book ✅ Support Folia

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:

database:
host: localhost
port: 3306
database: minecraft
username: root
password: ""
table_prefix: expbook_

Default Book Types

| 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)