# 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.
**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.
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft version listed: 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
ChaosSkills is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 16 times (via Spigot). Download it and open it directly in the game.