# TItems — Configuration

#  

## config.yml

```yaml
float-format: '%.2f'

```

Définit le format d'affichage des nombres décimaux (ex: prix d'une vente).  
`%.2f` = 2 décimales (ex: `1234.56`). / Defines the decimal display format (e.g. sale prices). `%.2f` = 2 decimal places.

---

## lang.yml — Référence complète / Full Reference

### Section `items`

<table id="bkmrk-cl%C3%A9-%2F-key-descriptio"><thead><tr><th>Clé / Key</th><th>Description FR</th><th>Description EN</th></tr></thead><tbody><tr><td>`items.give.usage`</td><td>Syntaxe de la commande</td><td>Command syntax</td></tr><tr><td>`items.give.player-not-found`</td><td>Joueur introuvable (`%name%`)</td><td>Player not found</td></tr><tr><td>`items.give.no-item`</td><td>Item inexistant (`%name%`)</td><td>Item doesn't exist</td></tr><tr><td>`items.give.invalid-item`</td><td>Item mal configuré (`%name%`)</td><td>Misconfigured item</td></tr><tr><td>`items.give.invalid-amount`</td><td>Quantité invalide</td><td>Invalid amount</td></tr><tr><td>`items.give.success`</td><td>Don réussi (`%player%`, `%item%`, `%amount%`)</td><td>Successful give</td></tr><tr><td>`items.scepter.not-combat`</td><td>Sceptre hors combat</td><td>Scepter outside combat</td></tr><tr><td>`items.scepter.cooldown`</td><td>Sceptre en cooldown (`%time%`)</td><td>Scepter on cooldown</td></tr><tr><td>`items.scepter.teleport-delay`</td><td>Délai téléportation (`%time%`)</td><td>Teleport delay</td></tr></tbody></table>

### Section `listeners`

<table id="bkmrk-cl%C3%A9-%2F-key-descriptio-1"><thead><tr><th>Clé / Key</th><th>Description</th></tr></thead><tbody><tr><td>`listeners.entity-killed`</td><td>Argent gagné sur kill mob (`%money%`)</td></tr><tr><td>`listeners.harvested`</td><td>Vente de récolte (`%money%`)</td></tr><tr><td>`listeners.placer-dont`</td><td>Builder utilisé dans zone interdite</td></tr><tr><td>`listeners.sell-stick.success`</td><td>Vente sell stick réussie (`%money%`)</td></tr><tr><td>`listeners.sell-stick.cannot-access`</td><td>Coffre inaccessible</td></tr><tr><td>`listeners.lootbag.opened`</td><td>Lootbag ouvert (`%tier%`, `%reward%`)</td></tr><tr><td>`listeners.lootbag.inventory-full`</td><td>Inventaire plein, item dropped</td></tr><tr><td>`listeners.farm-axe.tree-feller-enabled`</td><td>Tree Feller activé</td></tr><tr><td>`listeners.farm-axe.tree-feller-disabled`</td><td>Tree Feller désactivé</td></tr><tr><td>`listeners.farm-axe.upgraded`</td><td>Hache upgradée (`%level%`)</td></tr><tr><td>`listeners.mask.equipped`</td><td>Masque équipé (`%mask%`)</td></tr><tr><td>`listeners.boss.spawned`</td><td>Boss spawné</td></tr><tr><td>`listeners.boss.killed`</td><td>Boss tué (`%winner%`)</td></tr><tr><td>`listeners.boss.base-name`</td><td>Placeholder nom vide (leaderboard boss)</td></tr><tr><td>`listeners.boss.base-value`</td><td>Placeholder valeur vide (leaderboard boss)</td></tr></tbody></table>

### Section `reload`

<table id="bkmrk-cl%C3%A9-%2F-key-descriptio-2"><thead><tr><th>Clé / Key</th><th>Description</th></tr></thead><tbody><tr><td>`reload.success`</td><td>Rechargement réussi</td></tr><tr><td>`reload.error`</td><td>Erreur lors du rechargement</td></tr></tbody></table>

---

## items.yml — Structure des items

### Item standard (armor, basic)

```yaml
items:
  farm:
    effects:
      - type: FAST_DIGGING
        amplifier: 1
      - type: SPEED
        amplifier: 1
      - type: FIRE_RESISTANCE
    helmet:
      type: IRON_HELMET
      damage: 0
      display-name: '&e&lFarming Helmet'
      lore:
        - '&7Ligne de lore'

```

### Item custom — Propriétés communes

```yaml
custom-items:
  mon_item:
    type: DIAMOND_SWORD       # Type de matériau Minecraft (obligatoire)
    behavior: god_dager       # Behavior (obligatoire, voir liste ci-dessous)
    damage: 0                 # Dommage initial (durabilité utilisée)
    unbreakable: true         # Rend l'item indestructible
    can-drop: false           # Empêche le drop manuel
    drop-on-death: false      # Empêche le drop à la mort
    display-name: '&eNom'     # Nom coloré (codes & supportés)
    flags:
      - HIDE_ENCHANTS         # Masque les enchantements dans le lore
    lore:
      - '&7Ligne 1'
      - '&7Ligne 2'
    enchants:
      DAMAGE_ALL: 5
      FIRE_ASPECT: 1
      DURABILITY: 4

```

### Propriétés spécifiques par behavior

**`placer`**

```yaml
place:
  type: OBSIDIAN
  data: 0
period: 15       # Ticks entre chaque pose
max-uses: 30
face: block      # Face du bloc cliqué

```

**`sell_stick`**

```yaml
max-uses: 235
multiplier: 1.5

```

**`lootbag`**

```yaml
tier: common
sound: LEVEL_UP
effect: HAPPY_VILLAGER
loots:
  1:
    item: DIAMOND         # OU command: "eco give %player% 500"
    amount: 1
    chance: 30
    name: '&bDiamond'

```

**`mask`**

```yaml
mask-name: 'Money Mask'
money-multiplier: 1.5
jobs-multiplier: 1.0

```

**`harvester`**

```yaml
range: 0
multiplier: 2
auto-sell: false
upgrade:
  farms:
    CROPS: 10000
    NETHER_WARTS: 10000
    CARROT: 10000
  item: harvester_2     # Clé de l'item vers lequel upgrader

```

**`upgradable_farm_axe`**

```yaml
tree-feller: true
auto-replant-cocoa: true
multiplier: 2
auto-sell: false
max-tree-size: 200
upgrade:
  farms:
    LOG: 50000
    COCOA: 25000
  item: upgradable_farm_axe_max

```

**`boss_egg`**

```yaml
boss:
  type: GIANT
  name: "BOSS LV1"
  health: 500
  effects:
    SPEED: 2
    INCREASE_DAMAGE: 4
  equipment:
    helmet:
      type: DIAMOND_HELMET
      enchants:
        DURABILITY: 5
  mode: FINAL_DAMAGE   # ou BEST_DAMAGER
  loots:
    - "eco give %winner% 10000"

```

---

## Liste de tous les behaviors / Full Behavior List

<table id="bkmrk-behavior-item%28s%29-ass"><thead><tr><th>Behavior</th><th>Item(s) associé(s)</th></tr></thead><tbody><tr><td>`basic`</td><td>god\_chestplate, god\_rod (item lié sans logique custom)</td></tr><tr><td>`hammer`</td><td>hammer3</td></tr><tr><td>`orbe`</td><td>orbe\_fire, orbe\_speed, orbe\_force, orbe\_haste, orbe\_magique</td></tr><tr><td>`farm_armor`</td><td>Armure de ferme (set)</td></tr><tr><td>`god_dager`</td><td>god\_dager</td></tr><tr><td>`god_bow`</td><td>god\_bow</td></tr><tr><td>`scepter`</td><td>scepter</td></tr><tr><td>`placer`</td><td>obsi, iron, sand, dirt, soul\_sand, lava</td></tr><tr><td>`sell_stick`</td><td>sell\_stick, sell\_stick3, sell\_stick4</td></tr><tr><td>`harvester`</td><td>harvester\_1, harvester\_2</td></tr><tr><td>`hook`</td><td>hook</td></tr><tr><td>`potioncounter`</td><td>potioncounter</td></tr><tr><td>`armorcounter`</td><td>armorcounter</td></tr><tr><td>`multitool`</td><td>farm\_axe</td></tr><tr><td>`farming_sword`</td><td>farming\_sword\_1, farming\_sword\_2</td></tr><tr><td>`exp_pickaxe`</td><td>exp\_pickaxe</td></tr><tr><td>`boss_egg`</td><td>boss\_egg\_1</td></tr><tr><td>`lootbag`</td><td>lootbag\_common, lootbag\_rare, lootbag\_epic, lootbag\_legendary</td></tr><tr><td>`mask`</td><td>money\_mask, jobs\_mask, ultimate\_mask</td></tr><tr><td>`upgradable_farm_axe`</td><td>upgradable\_farm\_axe\_1/2/3/max</td></tr></tbody></table>