## Table of Contents  

1. [Core Configuration Files](#core)  

• [Attacks] (#attacks)  

• [Bosses] (#bosses)  

• [Items & Rewards](#items)  

• [Structures & Triggers] (#structures)  

2. [Advanced Mechanics](#advanced)  

• [Particles & Visuals](#particles)  

• [Groups](#groups)  

• [Permissions](#permissions)  

3. [Examples & Tutorials](#examples)  

4. [Troubleshooting](#troubleshooting)  

## 1. Core Configuration Files <a name="core"></a>  

# 1.1 Attacks Configuration** <a name="attacks"></a>  

File: `attacks.yml`  

Defines all boss attacks.  

## Key Parameter

| Parameter | Description | Allowed Values |  

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

| `type` | Attack category | `physical`, `magical`, `summon`, `heal`, `combo`, `enclose` |  

| `probability` | Chance to trigger (0.0–1.0) | `0.2` (20%) |  

| `cooldown` | Delay between uses (seconds) | `5` |  

| `targets` | Who the attack affects | `NEAREST`, `RANDOM`, `ALL` |  

## Example 1: Physical Attack  

yaml

basic_attack:

  name: "Slash"

  type: "physical"

  damage: 25

  probability: 0.8

  cooldown: 3

  targets: "NEAREST"

## Example 2: Summon Attack 

yaml

summon_minions:

  name: "Undead Army"

  type: "summon"

  mob_type: "ZOMBIE"

  amount: 5

  spawn_message: "The ground cracks as skeletons rise!"

  cooldown: 20

## 1.2 Boss Configuration <a name="bosses"></a>  

File: `bosses.yml`  

Defines boss stats, attacks, and rewards.  

## Key Parameters

| Parameter | Description | Example |  

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

| `health` | Boss max health | `500` |  

| `attacks` | List of attack IDs | `["fire_breath", "summon_minions"]` |  

| `rewards` | Drops for top players | Linked to `itemgroups.yml` |  

## Example Boss

yaml

fire_dragon:

  boss-id: "3"

  health: 1000

  mob-type: "ENDER_DRAGON"

  attacks:

    - "fire_breath"

    - "wing_slam"

  rewards:

    top_1:

      reward:

        type: "itemgroup"

        item: "legendary_group"

## 1.3 Items & Rewards <a name="items"></a>  

Files: `items.yml`, `itemgroups.yml`  

## Custom Item Example 

yaml

item_legendary_sword:

  type: "NETHERITE_SWORD"

  name: "Dragon Slayer"

  enchants:

    DAMAGE_ALL: 7

    FIRE_ASPECT: 3

  lore:

    - "Forged in volcanic lava."

## Item Group Example 

yaml

legendary_group:

  rolls: 2

  items:

    - item: "item_legendary_sword"

      probability: 40

    - item: "item_legendary_armor"

      probability: 60

## 1.4 Structures & Triggers <a name="structures"></a>  

Files: `structures.yml`, `triggers.yml`  

## Structure Example 

yaml

lava_arena:

  schematic: "schematics/lava_arena.schem"

  spawn_conditions:

    allowed_worlds: ["nether"]

    biome: "NETHER_WASTES"

## Trigger Example  

yaml

lava_trigger:

  type: "boss_defeat"

  structure_id: "lava_arena"

  boss_defeat_settings:

    boss_name: "fire_dragon"

    spawn_radius: 15

## 2. Advanced Mechanics <a name="advanced"></a>  

## 2.1 Particles & Visuals <a name="particles"></a>  

File: `particles.yml`  

## Example Explosion Effect**yaml

fire_explosion:

  type: "LAVA"

  color:

    red: 255

    green: 100

    blue: 0

  animations:

    scale_over_lifetime:

      start_scale: 1.0

      end_scale: 5.0

## 2.2 Boss Groups <a name="groups"></a>  

File: `groups.yml`  

#### **Example Group**  

yaml

nether_bosses:

  type: "mythic"

  bosses:

    boss_1:

      name: "fire_dragon"

      active: true

### 2.3 Permissions <a name="permissions"></a>  

File: `config.yml`  

yaml

permissions:

  kinglybosses.summon:

    default: "op"

  kinglybosses.bypass:

    default: "op"

## 3. Examples & Tutorials <a name="examples"></a>  

## Example 1: Create a Custom Boss 

1. Define attacks in `attacks.yml` (e.g., `fire_breath`).  

2. Configure the boss in `bosses.yml` with health, attacks, and rewards.  

3. Link rewards to item groups in `itemgroups.yml`.  

## Example 2: Trigger a Structure After Boss Death 

1. Add a structure in `structures.yml`.  

2. Create a `boss_defeat` trigger in `triggers.yml`.  

3. Assign the trigger to a boss in `bosses.yml` under `triggers`.  

## 4. Troubleshooting <a name="troubleshooting"></a>  

| Issue | Solution |  

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

| Boss doesn’t attack | Check `attacks` list in `bosses.yml` and cooldowns. |  

| Structure not spawning | Verify schematic path and trigger coordinates. |  

| Rewards not dropping | Ensure item groups are correctly linked in `bosses.yml`. |  

Need help? Join our [Discord Support Server].