> For the complete documentation index, see [llms.txt](https://wiki.novadev.ovh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.novadev.ovh/novatolls/05-configuration.md).

# 05 configuration

Tout se configure dans `plugins/NovaTools/config.yml`. Après modification, faites `/tools reload` pour appliquer les changements sans redémarrer le serveur.

> La plupart des paramètres sont également modifiables directement en jeu via `/tools config`.

## 5.1 Licence

```yaml
license:
  key: "VOTRE-CLE-DE-LICENCE-ICI"
```

## 5.2 Paramètres généraux

```yaml
settings:
  break_item_when_zero: false       # true = l'outil disparait quand durabilite = 0
  enable_tool_settings_gui: true    # true = double-sneak ouvre le GUI de reglages par joueur
  durability_display: ACTION_BAR    # NONE | ACTION_BAR | BOSS_BAR

  effects:
    particles: true                 # Particules lors des activations de pouvoirs
    sounds: true                    # Sons lors des activations de pouvoirs

  statistics:
    enabled: true                   # Enregistrement des statistiques d'utilisation

  xp_repair:
    enabled: false                  # Reparation d'outils par experience
    durability_per_level: 100       # Points de durabilite restaures par niveau XP consomme
```

## 5.3 Raretés

```yaml
rarities:
  commune:
    color: "&a"
  rare:
    color: "&9"
  epique:
    color: "&#8A2BE2"
  occulte:
    color: "&#9400D3"
  legendaire:
    color: "&#FFD700"
```

Les raretés sont chargees dans l'ordre du fichier. Cet ordre est celui affiche dans le GUI des raretés et dans le selecteur de l'editeur d'outils. Vous pouvez ajouter autant de raretés que vous voulez.

**Codes couleur supportes :**

* Codes Minecraft : `&0` a `&f`, `&l`, `&o`, `&n`, `&m`, `&k`, `&r`
* Codes hexadecimaux : `&#RRGGBB`

## 5.4 Outils

```yaml
tools:
  pioche_elite:                         # ID unique de l'outil
    name: "&bPioche Elite"              # Nom affiche (codes couleur supportes)
    type: PICKAXE                       # PICKAXE | AXE | SHOVEL | HOE | SWORD | MULTI
    material: DIAMOND                   # WOOD | STONE | GOLD | IRON | DIAMOND | NETHERITE
    rarity: epique                      # Cle d'une rarete configuree
    max_durability: 5000                # Durabilite maximale de l'outil
    repairable: true                    # Peut etre repare via la Forge
    soulbound: false                    # Conserve a la mort du joueur
    sword_mode: false                   # Permet d'utiliser cet outil comme une epee
    itemsadder_id: ""                   # ID ItemsAdder (vide = item vanilla)
    lore:
      - "&7Une pioche d'exception."
      - "&7Forgee dans les profondeurs."
    enchantments:
      efficiency: 5
      unbreaking: 3
      fortune: 3
    powers:
      # --- Fonte automatique (PICKAXE, MULTI) ---
      auto_smelt: true
      auto_smelt_chance: 1.0
      auto_smelt_cost: 0.0
      auto_smelt_cooldown: 0
      auto_smelt_sound: "BLOCK_FURNACE_FIRE_CRACKLE"
      auto_smelt_particle: "FLAME"

      # --- Labour en rayon (HOE) ---
      till_radius: 0                    # 0 = desactive, 1 = 3x3, 2 = 5x5...
      till_radius_chance: 1.0
      till_radius_cost: 0.0
      till_radius_cooldown: 0
      till_radius_sound: "ITEM_HOE_TILL"
      till_radius_particle: "BLOCK_DUST"

      # --- Recolte en rayon (HOE) ---
      harvest_radius: 0
      harvest_radius_chance: 1.0
      harvest_radius_cost: 0.0
      harvest_radius_cost_per_block: false
      harvest_radius_cooldown: 0
      harvest_radius_sound: "BLOCK_CROP_BREAK"
      harvest_radius_particle: "VILLAGER_HAPPY"

      # --- Replantation (HOE) ---
      replant: false
      replant_from_inventory: false
      replant_chance: 1.0
      replant_cost: 0.0
      replant_cooldown: 0
      replant_sound: ""
      replant_particle: ""

      # --- Abattage d'arbre (AXE) ---
      tree_feller: false
      tree_feller_chance: 1.0
      tree_feller_cost: 0.0
      tree_feller_cost_per_block: false
      tree_feller_cooldown: 0
      tree_feller_sound: "BLOCK_WOOD_BREAK"
      tree_feller_particle: "SWEEP_ATTACK"

      # --- Kill instantane (SWORD) ---
      instant_kill: false
      instant_kill_chance: 1.0
      instant_kill_cost: 0.0
      instant_kill_cooldown: 0
      instant_kill_sound: "ENTITY_PLAYER_ATTACK_CRIT"
      instant_kill_particle: "CRIT"

      # --- General ---
      durability_per_block: 1           # Durabilite consommee par bloc ou action
```

## 5.5 Orbes

```yaml
orbs:
  orbe_commun:
    name: "&aOrbe de Reparation"
    durability: 1000                    # Points de durabilite restaures
    itemsadder_id: ""
    lore:
      - "&7Repare 1000 points de durabilite."
      - "&7Utilisable a la Forge."
```

## 5.6 Coffrets

```yaml
random_tools:
  coffret_bronze:
    name: "&6Coffret Bronze"
    itemsadder_id: ""
    lore:
      - "&7Contient un outil aleatoire."
    tools:
      pioche_fer: 60.0                  # Poids (probabilite relative)
      pioche_or: 30.0
      pioche_diamant_elite: 10.0
```

Les poids sont relatifs entre eux. Dans l'exemple : pioche\_fer a 60 % de chances, pioche\_or 30 %, pioche\_diamant\_elite 10 %.

## 5.7 Forge

```yaml
forge:
  enabled: true
  commands:                             # Commandes alternatives a /tools forge
    - forge
  refund_ratio: 0.5                     # Ratio du reste d'orbe (0.0 = desactive, 0.5 = 50 %)
  refund_orb_id: ""                     # ID ItemsAdder du "reste d'orbe" (vide = PRISMARINE_SHARD)
  refund_orb_name: "&7Reste d'Orbe &e({dur} utilisations)"
  gui:
    title: "&8Forge - Reparation"
    rows: 3                             # Nombre de rangees (3 a 6)
    slot_tool: 10                       # Slot de l'outil a reparer
    slot_orb: 16                        # Slot de l'orbe
    slot_preview: 13                    # Slot de l'apercu
    slot_action: 22                     # Slot du bouton d'action
    background_item: ""                 # ID ItemsAdder pour le fond du GUI
    button_repair: ""                   # ID ItemsAdder pour le bouton "Reparer"
    button_disabled: ""                 # ID ItemsAdder pour le bouton inactif
```

## 5.8 Recyclage

```yaml
recycle:
  enabled: true
  commands:
    - recycle
  gui:
    title: "&8Recyclage - Orbe"
    rows: 3
    slot_tool: 10                       # Slot de l'outil a recycler
    slot_button: 13                     # Slot du bouton d'action
    slot_preview: 16                    # Slot de l'apercu de l'orbe
    background_item: ""
    button_recycle: ""
    button_disabled: ""
```

## 5.9 ItemsAdder

```yaml
itemsadder:
  namespace: "novatools"              # Namespace de vos items ItemsAdder
```

## 5.10 Messages

```yaml
messages:
  no-permission: "&cVous n'avez pas la permission."
  reload-success: "&aConfiguration rechargee avec succes."
  give-success: "&aDonne &e{amount}x {name} &aa &e{player}&a."
  give-received: "&aVous avez recu &e{amount}x {name}&a."
  invalid-tool: "&cID introuvable : &e{id}"
```

Les placeholders disponibles sont indiques entre `{}` dans les valeurs par defaut.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.novadev.ovh/novatolls/05-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
