# ChaosSkills



**A Universal Skills Plugin for Every Minecraft Server**

*Developed by ChaosBay Studios | Development Team*



---



## Installation



1. Place the JAR file into your server’s `plugins/` folder

2. Start the server — configuration files will be generated automatically

3. Edit the `config.yml` (enter database credentials if needed)

4. Restart the server or run `/ska reload`



---



## ️ Folder Structure (similar to AuraSkills)



```

plugins/ChaosSkills/

├── config.yml ← Main configuration

├── chaosskills.db ← SQLite database (SQLite mode only)

└── (MySQL data is stored externally)

```



---



## ️ Building (from Source)



**Requirements:**



* Java 21+

* Gradle (or use the Gradle Wrapper)



```bash

# Clone or extract the project

cd ChaosSkills



# Build using Gradle Wrapper

./gradlew build



# or directly

gradle shadowJar

```



The compiled JAR will be located at:



```

build/libs/ChaosSkills-1.0.0.jar

```



---



## ️ Database Setup (MySQL)



```sql

CREATE DATABASE chaosbay_skills CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

CREATE USER 'chaosbay'@'localhost' IDENTIFIED BY 'your_password';

GRANT ALL PRIVILEGES ON chaosbay_skills.* TO 'chaosbay'@'localhost';

FLUSH PRIVILEGES;

```



Then configure in `config.yml`:



```yaml

database:

type: MYSQL

host: localhost

port: 3306

database: chaosbay_skills

username: chaosbay

password: your_password

```



---



## Commands



| Command | Description | Permission |

| ---------------------------------------- | ---------------------------- | ----------------- |

| `/skills` | Opens your skills menu | chaosskills.use |

| `/skills <player>` | View another player's skills | chaosskills.admin |

| `/top` | Global leaderboard | chaosskills.top |

| `/top <skill>` | Skill-specific leaderboard | chaosskills.top |

| `/ska reload` | Reload the plugin | chaosskills.admin |

| `/ska reset <player>` | Reset player skills | chaosskills.admin |

| `/ska setlevel <player> <skill> <level>` | Set a skill level | chaosskills.admin |

| `/ska setxp <player> <skill> <xp>` | Set XP value | chaosskills.admin |

| `/ska addxp <player> <skill> <xp>` | Add XP to a player | chaosskills.admin |

| `/ska info <player>` | Show skill information | chaosskills.admin |



---



## Skills



| Skill | XP Sources | Bonuses |

| -------------- | ------------------------------- | -------------------------- |

| ⚔ Combat | Mob kills, player kills, bosses | Increased damage & defense |

| ⛏ Mining | Stone, ores, ancient debris | Luck mining & extra drops |

| Woodcutting | Breaking logs | Faster breaking speed |

| Farming | Harvesting crops | Double harvest chance |

| Fishing | Fish, treasure, junk | Improved fishing luck |

| ✨ Enchanting | Enchanting & anvils | Enchantment bonuses |

| Cooking | Smelting & food cooking | Faster smelting |

| ⚗ Alchemy | Brewing potions | Extended potion duration |



---



## ⚙️ Compatibility



* **Minecraft:** 1.21.x (Paper / Spigot)

* **Java:** 21+

* **Database:** MySQL 8+ or SQLite (fallback)



---



## About ChaosSkills



ChaosSkills is designed for **everyone** — from small survival servers to large community networks.

The plugin provides long-term player progression, engaging gameplay mechanics, and a fully customizable skills system suitable for any server style.



---



## Development Credits



**Developed by:**

**ChaosBay Studios | Development Team**



---



## License



Created and maintained by **ChaosBay Studios**.

Redistribution or resale without permission is not allowed.