Battle

This guide explains how to create a Battle NPC, how its interaction system works, how to define its Pokémon party, and how behaviours control battles and rewards.

All examples shown here are real and fully functional.

---

📁 Required Folder Structure

config/
└── CobbleBetterNPC/
    ├── NPC/
    │   └── battles/
    │       └── battle_001.json
    └── Dialogues/
        └── battles/
            └── battle_001.json

📌 These folders can be generated automatically with: /cbn create example battle

📌 Apply changes with: /cbn reload

---

🧍 Battle NPC File

config/
└── CobbleBetterNPC/
    └── NPC/
        └── battles/
            └── battle_001.json
 

This file defines the NPC as an entity:

• What type of NPC it is

• How many Pokémon it uses

• Which Pokémon it has

• What happens on win or loss

• Which dialogue opens on interaction

---

📄 Full File

{
  "id": "cobblebetternpc:battles/battle_003",
  "type": "battle",
  "names": [
    "Battle"
  ],
  "resourceIdentifier": "cobblemon:standard",
  "presets": [
    ""
  ],
  "skill": 0.01,
  "autoHealParty": true,
  "isMovable": false,
  "minPokemon": 3,
  "maxPokemon": 3,
  "interaction": [
    {
      "name": "dialogue one",
      "with": "1",
      "permission": "",
      "dialogue": "cobblebetternpc:battles/battle_003"
    }
  ],
  "party": [
    "venusaur uncatchable=true level=5 hp_iv=10 attack_iv=10 defence_iv=10 special_attack_iv=10 special_defence_iv=10 speed_iv=10",
    "venusaur uncatchable=true level=5 hp_iv=10 attack_iv=10 defence_iv=10 special_attack_iv=10 special_defence_iv=10 speed_iv=10",
    "venusaur uncatchable=true level=5 hp_iv=10 attack_iv=10 defence_iv=10 special_attack_iv=10 special_defence_iv=10 speed_iv=10"
  ],
  "behaviours": [
    {
      "type": "cobblemon:apply_behaviours",
      "behaviours": [
        "cobblemon:battler",
        "cobblemon:battle_scripts",
        "cobblemon:looks_at_players",
        "cobblemon:core"
      ]
    },
    {
      "type": "cobblebetternpc:battle_rewards",
      "winRewards": [
        "[message] &aYou won the battle!",
        "[title] &6VICTORY! | &eYou defeated the opponent",
        "[sound] minecraft:entity.player.levelup",
        "[command] give %player% minecraft:diamond 1",
        "[chance]50 [command] give %player% cobblemon:poke_ball 15",
        "[chance]25 [command] give %player% cobblemon:master_ball 1",
        "[random]{[command] give %player% minecraft:gold_ingot 1|[command] give %player% minecraft:iron_ingot 1|[command] give %player% minecraft:redstone 1}"
      ],
      "loseRewards": [
        "[message] &cYou lost the battle",
        "[title] &4DEFEAT | &7Better luck next time",
        "[sound] minecraft:entity.villager.no",
        "[delay]40 [command] give %player% minecraft:coal 2",
        "[chance]30 [command] give %player% minecraft:iron_ingot 5",
        "[random]{[message] &7Keep training!|[message] &7You will win next time|[message] &7Don't give up}"
      ]
    },
    {
      "type": "cobblebetternpc:skin_texture",
      "skin_name": "leaders/misty"
    }
  ]
}

---

🧠 Field-by-Field Explanation

🔹 NPC Identity

Field	Description
id	Unique NPC identifier
type	battle indicates this NPC can start battles
names	NPC display name
resourceIdentifier	Base model used
presets	Optional presets (can be empty)

---

🎯 Battle Difficulty & Behavior

Field	Description
skill	NPC AI intelligence (0.0 – 1.0)
autoHealParty	Automatically heals party after each battle
isMovable	Prevents the NPC from walking

---

🧬 Pokémon Party Rules

Field	Description
minPokemon	Minimum Pokémon used
maxPokemon	Maximum Pokémon used

📌 If both values are equal, the NPC will always use that exact number.

---

🐉 Pokémon Party

The party list defines the NPC’s Pokémon team, using Cobblemon syntax.

Example:

"spiritomb level=100 pokeball=master_ball held_item=cobblemon:sitrus_berry 
ability=pressure nature=jolly moves=darkpulse,shadowball,willowisp,suckerpunch 
hp_iv=31 attack_iv=31 defence_iv=31 special_attack_iv=31 special_defence_iv=31 
speed_iv=31 hp_ev=252 special_attack_ev=252 speed_ev=6"

---

🔁 Interaction (Dialogue Trigger)

"interaction": [
  {
    "name": "battle dialogue",
    "with": "1",
    "permission": "",
    "dialogue": "cobblebetternpc:battles/battle_001"
  }
]

Field	Purpose
with	Priority (lower = first)
permission	Required permission (empty = everyone)
dialogue	Dialogue that opens

📌 Battles never start automatically — they always start from dialogue.

---

🧠 Used Behaviours

Behaviour	Purpose
battler	Enables battling
battle_commands	Executes commands on win/loss
looks_at_players	NPC looks at players
core	Base logic (required)

---

⚙️ Battle Command Variables

Variable	Usage
winrewards	Command executed on win
loserewards	Command executed on loss

📌 Use @s to target the battling player.

---

💬 Battle NPC Dialogue

📄 config/CobbleBetterNPC/Dialogues/battles/battle_001.json

This file controls:

• NPC speech

• Player options

• Battle start logic

---

📄 Full File

{
  "name": "&#B8C4CCBattle",
  "gibber": {
    "npc": {
      "step": 3,
      "interval": 0.02,
      "allowSkip": true
    },
    "player": {
      "step": 3,
      "interval": 0.02
    }
  },
  "dialogue": [
    "[page1] npc: &#A08C7DHey! <player> Do you want a battle?",
    "player -> &#E6C88CLet's start the battle: npc-battle",
    "player -> &#8C4B50No, I don't feel ready: npc-declined",
    "quitter: &#D2C6B8See you on the next adventure!"
  ],
  "actions": {
    "npc-declined": [
      "q.dialogue.close()"
    ],
    "close": [
      "q.dialogue.close()"
    ],
    "npc-battle": [
      "q.dialogue.close()",
      "v.battle = q.npc.start_battle(q.player)"
    ]
  }
}

---

⚔️ How Does the Battle Start?

1. Player interacts with NPC

2. Dialogue opens

3. Player selects “Let’s start the battle”

4. The action runs:

        "v.battle = q.npc.start_battle(q.player)"
         "v.battle = q.npc.start_battle(q.player, 'single')"
         "v.battle = q.npc.start_battle(q.player, 'double')"
         "v.battle = q.npc.start_battle(q.player, 'triple')"

5. Pokémon battle begins

6. When finished:

   • winrewards or loserewards is executed

---