# TItems — Lootbags, Masques, Hache Évolutive & Boss Eggs

#  

## Sacs de Butin / Lootbags

**FR** — Les lootbags (behavior `lootbag`) s'ouvrent en **clic droit**. Ils accordent une récompense aléatoire parmi celles configurées, selon un système de chances en pourcentage.  
**EN** — Lootbags (`lootbag` behavior) open on **right-click**. They grant a random reward from those configured, based on a percentage chance system.

<table id="bkmrk-cl%C3%A9-items.yml-nom-af"><thead><tr><th>Clé `items.yml`</th><th>Nom affiché</th><th>Tier</th><th>Son / Sound</th><th>Effet particule</th></tr></thead><tbody><tr><td>`lootbag_common`</td><td>Common LootBag</td><td>`common`</td><td>`LEVEL_UP`</td><td>`HAPPY_VILLAGER`</td></tr><tr><td>`lootbag_rare`</td><td>Rare LootBag</td><td>`rare`</td><td>`LEVEL_UP`</td><td>`WITCH_MAGIC`</td></tr><tr><td>`lootbag_epic`</td><td>Epic LootBag</td><td>`epic`</td><td>`LEVEL_UP`</td><td>`PORTAL`</td></tr><tr><td>`lootbag_legendary`</td><td>Legendary LootBag</td><td>`legendary`</td><td>`ENDERDRAGON_GROWL`</td><td>`FLAME`</td></tr></tbody></table>

### Récompenses par tier / Rewards by tier

**Common**

<table id="bkmrk-r%C3%A9compense-chance-di"><thead><tr><th>Récompense</th><th>Chance</th></tr></thead><tbody><tr><td>Diamond ×1</td><td>30%</td></tr><tr><td>Iron Ingot ×5</td><td>50%</td></tr><tr><td>$500</td><td>20%</td></tr></tbody></table>

**Rare**

<table id="bkmrk-r%C3%A9compense-chance-di-1"><thead><tr><th>Récompense</th><th>Chance</th></tr></thead><tbody><tr><td>Diamond ×5</td><td>40%</td></tr><tr><td>Emerald ×10</td><td>35%</td></tr><tr><td>$2 500</td><td>25%</td></tr></tbody></table>

**Epic**

<table id="bkmrk-r%C3%A9compense-chance-di-2"><thead><tr><th>Récompense</th><th>Chance</th></tr></thead><tbody><tr><td>Diamond Block ×3</td><td>35%</td></tr><tr><td>Emerald Block ×5</td><td>30%</td></tr><tr><td>$10 000</td><td>25%</td></tr><tr><td>Legendary Sword</td><td>10%</td></tr></tbody></table>

**Legendary**

<table id="bkmrk-r%C3%A9compense-chance-di-3"><thead><tr><th>Récompense</th><th>Chance</th></tr></thead><tbody><tr><td>Diamond Block ×10</td><td>30%</td></tr><tr><td>$50 000</td><td>35%</td></tr><tr><td>$100 000</td><td>20%</td></tr><tr><td>Legendary Helmet</td><td>15%</td></tr></tbody></table>

> ℹ️ Les récompenses peuvent être des **items Minecraft** (`item` + `amount`) ou des **commandes** (`command: "eco give %player% X"`). Les chances doivent **totaliser 100%** par lootbag.

---

## Masques / Masks

**FR** — Les masques (behavior `mask`) sont des items de type `SKULL_ITEM` portés dans le **slot casque**. Ils accordent des multiplicateurs d'argent et d'XP Jobs.  
**EN** — Masks (`mask` behavior) are `SKULL_ITEM` items worn in the **helmet slot**. They grant money and Jobs XP multipliers.

<table id="bkmrk-cl%C3%A9-items.yml-nom-af-1"><thead><tr><th>Clé `items.yml`</th><th>Nom affiché</th><th>Rareté</th><th>Multiplicateur Argent</th><th>Multiplicateur Jobs XP</th></tr></thead><tbody><tr><td>`money_mask`</td><td>Money Mask</td><td>RARE</td><td>x1.5 (+50%)</td><td>x1.0</td></tr><tr><td>`jobs_mask`</td><td>Jobs Mask</td><td>RARE</td><td>x1.0</td><td>x1.5 (+50%)</td></tr><tr><td>`ultimate_mask`</td><td>Ultimate Mask</td><td>EPIC</td><td>x2.0 (+100%)</td><td>x2.0 (+100%)</td></tr></tbody></table>

> ⚠️ Le multiplicateur Jobs XP nécessite le plugin **Jobs**. Sans Jobs, seul le multiplicateur argent fonctionne.  
> The Jobs XP multiplier requires the **Jobs** plugin. Without it, only the money multiplier works.

---

## Hache de Ferme Évolutive / Upgradable Farm Axe

**FR** — Système à **4 niveaux** (behavior `upgradable_farm_axe`). Chaque niveau se débloque en minant/récoltant suffisamment de blocs. Déblocage des fonctionnalités progressif.  
**EN** — **4-level** system (`upgradable_farm_axe` behavior). Each level unlocks by mining/harvesting enough blocks. Features unlock progressively.

<table id="bkmrk-niveau-cl%C3%A9-items.yml"><thead><tr><th>Niveau</th><th>Clé `items.yml`</th><th>Tree Feller</th><th>Auto-Replant Cacao</th><th>Multiplicateur</th><th>Auto-Sell</th><th>Max taille arbre</th></tr></thead><tbody><tr><td>Lvl 1</td><td>`upgradable_farm_axe_1`</td><td>✘</td><td>✘</td><td>x1</td><td>✘</td><td>100 blocs</td></tr><tr><td>Lvl 2</td><td>`upgradable_farm_axe_2`</td><td>✔ (Shift+RC)</td><td>✘</td><td>x1</td><td>✘</td><td>150 blocs</td></tr><tr><td>Lvl 3</td><td>`upgradable_farm_axe_3`</td><td>✔ (Shift+RC)</td><td>✔</td><td>x2</td><td>✘</td><td>200 blocs</td></tr><tr><td>MAX</td><td>`upgradable_farm_axe_max`</td><td>✔ (Shift+RC)</td><td>✔</td><td>x3</td><td>✔</td><td>300 blocs</td></tr></tbody></table>

### Conditions d'upgrade / Upgrade conditions

<table id="bkmrk-upgrade-logs-n%C3%A9cessa"><thead><tr><th>Upgrade</th><th>Logs nécessaires</th><th>Cacao nécessaire</th></tr></thead><tbody><tr><td>Lvl 1 → Lvl 2</td><td>5 000</td><td>2 500</td></tr><tr><td>Lvl 2 → Lvl 3</td><td>15 000</td><td>7 500</td></tr><tr><td>Lvl 3 → MAX</td><td>50 000</td><td>25 000</td></tr></tbody></table>

### Stats affichées / Displayed stats

```
{log_count}   — rondins coupés / logs cut
{cocoa_count} — cacao récolté / cocoa harvested

```

> ℹ️ **Tree Feller** se toggle avec **Shift + Clic droit**. Il coupe l'arbre entier automatiquement jusqu'à la taille maximum du niveau.

---

## Boss Eggs

**FR** — Les boss eggs (behavior `boss_egg`) permettent de **spawner un boss personnalisé** en faisant clic droit sur un bloc. Le boss est entièrement configurable dans `items.yml`.  
**EN** — Boss eggs (`boss_egg` behavior) **spawn a custom boss** on right-click on a block. The boss is fully configurable in `items.yml`.

### Exemple de configuration / Example config

```yaml
boss_egg_1:
  type: EGG
  behavior: boss_egg
  boss:
    type: GIANT           # Type d'entité Minecraft
    name: "BOSS LV1"      # Nom affiché au-dessus du boss
    health: 500           # Points de vie
    effects:
      SPEED: 2            # Amplificateur (niveau = valeur - 1)
      INCREASE_DAMAGE: 4
    equipment:
      helmet:
        type: DIAMOND_HELMET
        enchants:
          DURABILITY: 5
      # chestplate, leggings, boots, sword...
    mode: FINAL_DAMAGE    # FINAL_DAMAGE ou BEST_DAMAGER
    loots:
      - "eco give %winner% 10000"

```

### Modes de victoire / Win modes

<table id="bkmrk-mode-condition-de-vi"><thead><tr><th>Mode</th><th>Condition de victoire FR</th><th>Win condition EN</th></tr></thead><tbody><tr><td>`FINAL_DAMAGE`</td><td>Le joueur qui donne le **dernier coup** gagne</td><td>The player who deals the **last hit** wins</td></tr><tr><td>`BEST_DAMAGER`</td><td>Le joueur ayant infligé le **plus de dégâts totaux** gagne</td><td>The player who dealt the **most total damage** wins</td></tr></tbody></table>

> Les commandes `loots` sont exécutées avec `%winner%` remplacé par le nom du gagnant.  
> `loots` commands are executed with `%winner%` replaced by the winner's name.