custom_ore_gem/README.md

# Custom Ore Gem Mod

## Description

Custom Ore Gem est un mod Minecraft développé avec MCreator pour Forge 1.20.1. Ce mod modifie la distribution des ressources dans Minecraft en ajoutant de nouvelles variantes de minerais avec des drops configurables et des outils personnalisés.

> **Note importante** : Ce mod est conçu pour être utilisé avec KubeJS et ne doit pas être utilisé seul.

## Informations Techniques

- **Version de Minecraft** : 1.20.1
- **Mod Loader** : Forge (version 47.3.0)
- **Version de Java** : Java 17
- **Mod ID** : `custom_ore_gen`
- **Version** : 1.0.0
- **Auteur** : Aulyrius (créé via MCreator)
- **Site web** : https://lanro.eu


## Avant garde

Il est recommandé pour la bonne utilisation du mods d'utilisé des mods complémentaire :

* **Biomes O' Plenty** - Pour profiter des biomes supplémentaires (69 biomes BOP supportés)
* **Biome Replacer** pour supprimer les biomes caves, qui n'ont pas de sens de température et d'un point de vue joueur est pas logique.

  biome_replacer.properties :

  ```javascript
  minecraft:deep_dark > null
  minecraft:dripstone_caves > null
  minecraft:lush_caves > null
  ```
* KubeJS pour supprimer la génération de base avec le script suivant :

  *remove.js*

  ```javascript
  // priority: 0
  
  WorldgenEvents.remove(event => {
      var minecraftOreList = [
          'minecraft:coal_ore',
          'minecraft:deepslate_coal_ore',
          'minecraft:copper_ore', 
          'minecraft:deepslate_copper_ore',
          'minecraft:iron_ore',
          'minecraft:deepslate_iron_ore', 
          'minecraft:gold_ore',
          'minecraft:deepslate_gold_ore',
          'minecraft:redstone_ore',
          'minecraft:deepslate_redstone_ore',
          'minecraft:emerald_ore', 
          'minecraft:deepslate_emerald_ore',
          'minecraft:diamond_ore',
          'minecraft:deepslate_diamond_ore',
          'minecraft:lapis_ore',
          'minecraft:deepslate_lapis_ore'
      ];
  
      event.removeOres(props => {
          props.blocks = minecraftOreList
      });
  });
  ```
## Fonctionnalités Principales

### Nouveaux Minerais (16 blocs)

Le mod ajoute plusieurs variantes de minerais personnalisés :

#### Variantes de Diamant
- **Shard Diamond Ore** (`sharddiamondblockore`) : Un minerai de diamant qui droppe des éclats de diamant
  - Se génère dans tous les biomes (forge:any)
  - Hauteur : 0 à 15
  - Taille des filons : 8 blocs
  - Drop : 1-2 Diamond Shards (Fortune supporté)
- **Deepslate Shard Diamond Ore** (`deepslatesharddiamondore`) : Version deepslate du minerai d'éclats de diamant
- **Concentrated Diamond Ore** (`concentrateddiamondore`) : Un minerai de diamant plus concentré
  - Se génère dans les biomes froids (cold_biomes)
  - Drop : 1-2 Diamants (Fortune supporté)

#### Variantes d'Or
- **Pure Golden Ore** (`puregoldenore`) : Un minerai d'or pur de haute qualité
  - Se génère dans les biomes chauds (hot_biomes)
  - Hauteur : 0 à 256
  - Drop : 2-4 Pépites d'or
- **Deepslate Pure Golden Ore** (`deepslatepuregoldenore`) : Version deepslate du minerai d'or pur

#### Variantes de Charbon
- **Concentrated Coal Ore** (`concentratedcoalore`) : Charbon plus concentré
  - Se génère dans les biomes tempérés (tempered_biomes)
  - Drop : 2-4 Charbons

#### Variantes de Fer
- **Iron Ore** (`ironore`) : Variante personnalisée du minerai de fer
  - Se génère dans les biomes tempérés (tempered_biomes)
- **Deepslate Iron Ore** (`deepslateironore`) : Version deepslate du minerai de fer

#### Variantes d'Émeraude
- **High Emerald Ore** (`highemeraldore`) : Émeraude de haute qualité
  - Se génère dans les biomes de montagne (mountain_biomes)
- **Lower Emerald Ore** (`loweremeraldore`) : Émeraude de basse qualité
  - Se génère dans les biomes très rares (rare_biomes : mushroom_fields, ice_spikes)

#### Variantes de Redstone
- **Redstone Ore** (`redstoneore`) : Variante personnalisée du minerai de redstone
- **Deepslate Redstone Ore** (`deepslateredstoneore`) : Version deepslate

#### Variantes de Lapis
- **Lapis Ore** (`lapisore`) : Variante personnalisée du minerai de lapis
- **Deepslate Lapis Ore** (`deepslatelapisore`) : Version deepslate

#### Variantes de Cuivre
- **Copper High Ore** (`copperhighore`) : Variante haute du minerai de cuivre
  - Se génère dans les biomes chauds (hot_biomes)
- **Copper Lower Ore** (`copperlowerore`) : Variante basse du minerai de cuivre
  - Nom affiché : "deepslate copper ore"

### Nouveaux Objets

#### Diamond Shard (Éclat de Diamant) (`diamondshard`)
- **Description** : "Diamond sparkle, to create tools or to create a diamond"
- **Rareté** : RARE
- **Stack** : 64
- **Utilisation** :
  - Permet de créer des outils en éclats de diamant
  - Peut être crafté en diamant complet (9 éclats = 1 diamant)

### Outils en Diamond Shard

Le mod introduit une nouvelle catégorie d'outils située entre le fer et le diamant :

#### Pioche en Éclat de Diamant (`sharddiamondpickaxe`)
- **Durabilité** : 200 utilisations
- **Vitesse de minage** : 7.0
- **Dégâts d'attaque** : 1
- **Réparation** : Utilise des Diamond Shards

#### Pelle en Éclat de Diamant (`sharddiamondshovel`)
- **Durabilité** : 200 utilisations
- **Vitesse de minage** : 4.0
- **Dégâts d'attaque** : 2

#### Hache en Éclat de Diamant (`sharddiamondaxe`)
- **Durabilité** : 200 utilisations
- **Vitesse de minage** : 7.0
- **Dégâts d'attaque** : 6

## Distribution des Minerais par Biomes

Le mod utilise une classification logique des biomes pour la génération des minerais via les biome modifiers de Forge. Le support de **Biomes O' Plenty** est inclus avec 69 biomes supplémentaires.

### Vue d'ensemble

| Catégorie | Minerais | Biomes Vanilla | Biomes BOP |
|-----------|----------|:--------------:|:----------:|
| **Cold** | Lapis, Deepslate Lapis, Concentrated Diamond | 22 | 11 |
| **Hot** | Pure Gold, Deepslate Pure Gold, Copper High, Copper Lower, Redstone, Deepslate Redstone | 20 | 15 |
| **Mountain** | High Emerald | 22 | 10 |
| **Rare** | Lower Emerald | 10 | 10 |
| **Tempered** | Iron, Deepslate Iron, Concentrated Coal | 23 | 23 |
| **All** | Shard Diamond, Deepslate Shard Diamond | - | - |

---

### 🔷 forge:any (Tous les biomes)
**Minerais** : Shard Diamond Ore, Deepslate Shard Diamond Ore
- **TOUS** les biomes (vanilla + mods)

---

### ❄️ cold_biomes (Biomes Froids)
**Minerais** : Lapis Ore, Deepslate Lapis Ore, Concentrated Diamond Ore

**Biomes Vanilla (22)** :
| Nom du Biome | Traduction |
|--------------|------------|
| snowy_slopes | Pentes enneigées |
| snowy_beach | Plage enneigée |
| snowy_plains | Plaines enneigées |
| snowy_taiga | Taïga enneigée |
| ice_spikes | Pics de glace |
| old_growth_pine_taiga | Taïga ancienne de pins |
| old_growth_spruce_taiga | Taïga ancienne d'épicéas |
| taiga | Taïga |
| cold_ocean | Océan froid |
| deep_cold_ocean | Océan profond froid |
| frozen_ocean | Océan gelé |
| deep_frozen_ocean | Océan profond gelé |
| frozen_peaks | Pics gelés |
| jagged_peaks | Pics déchiquetés |
| stony_peaks | Pics pierreux |
| dripstone_caves | Grottes de spéléothèmes |
| deep_dark | Deep Dark |
| frozen_river | Rivière gelée |
| grove | Bosquet |

**Biomes BOP (11)** :
| Nom du Biome | Traduction |
|--------------|------------|
| snowy_coniferous_forest | Forêt de conifères enneigée |
| snowy_maple_woods | Bois d'érables enneigés |
| snowy_orchard | Verger enneigé |
| snowy_fir_clearing | Clairière de sapins enneigée |
| alpine_foothills | Contreforts alpins |
| alpine | Alpin |
| snowy_tundra | Toundra enneigée |
| snowy_plains | Plaines enneigées |
| glacier | Glacier |
| ice_spikes | Pics de glace |
| icy_beach | Place verglacée |

---

### 🔥 hot_biomes (Biomes Chauds)
**Minerais** : Pure Golden Ore, Deepslate Pure Golden Ore, Copper High Ore, Copper Lower Ore, Redstone Ore, Deepslate Redstone Ore

**Biomes Vanilla (20)** :
| Nom du Biome | Traduction |
|--------------|------------|
| desert | Désert |
| badlands | Badlands |
| eroded_badlands | Badlands érodés |
| wooded_badlands | Badlands boisés |
| deep_lukewarm_ocean | Océan profond tiède |
| lukewarm_ocean | Océan tiède |
| warm_ocean | Océan chaud |
| mangrove_swamp | Marais de mangroves |
| bamboo_jungle | Jungle de bambous |
| jungle | Jungle |
| sparse_jungle | Jungle clairsemée |
| savanna | Savane |
| savanna_plateau | Plateau de savane |
| windswept_savanna | Savane balayée par le vent |
| basalt_deltas | Deltas de basalte |
| crimson_forest | Forêt écarlate |
| nether_wastes | Déserts du Nether |
| soul_sand_valley | Vallée de sable des âmes |
| warped_forest | Forêt distordue |
| deep_dark | Deep Dark |

**Biomes BOP (15)** :
| Nom du Biome | Traduction |
|--------------|------------|
| tropical_rainforest | Forêt tropicale |
| tropics | Tropiques |
| bayou | Bayou |
| arid_highlands | Hautes terres arides |
| scrubland | Broussailles |
| volcano | Volcan |
| wasteland | Terres désolées |
| wasteland_steppe | Steppe désolée |
| oasis | Oasis |
| outback | Outback |
| rocky_rainforest | Forêt tropicale rocheuse |
| rocky_shrubland | Broussailles rocheuses |
| seasonal_forest | Forêt saisonnière |
| temperate_rainforest | Forêt tempérée humide |

---

### ⛰️ mountain_biomes (Biomes Montagneux)
**Minerais** : High Emerald Ore

**Biomes Vanilla (22)** :
| Nom du Biome | Traduction |
|--------------|------------|
| windswept_hills | Collines balayées par le vent |
| windswept_gravelly_hills | Collines graveleuses balayées |
| snowy_slopes | Pentes enneigées |
| frozen_peaks | Pics gelés |
| jagged_peaks | Pics déchiquetés |
| stony_peaks | Pics pierreux |
| meadow | Prairie |
| extreme_hills | Collines extrêmes |
| extreme_hills_edge | Bord des collines extrêmes |
| extreme_hills_plus | Collines extrêmes plus |
| extreme_hills_plus_trees | Collines extrêmes arborees |
| modified_wooded_badlands_plateau | Plateau badlands boisé modifié |
| modified_badlands_plateau | Plateau badlands modifié |
| badlands_plateau | Plateau badlands |
| wooded_badlands_plateau | Plateau badlands boisé |
| eroded_badlands | Badlands érodés |
| modified_gravelly_mountains | Montagnes graveleuses modifiées |
| gravelly_mountains | Montagnes graveleuses |
| modified_gravelly_mountains_plus | Montagnes graveleuses plus modifiées |
| gravelly_mountains_plus | Montagnes graveleuses plus |
| sunflower_plains | Plaines de tournesols |

**Biomes BOP (10)** :
| Nom du Biome | Traduction |
|--------------|------------|
| highland | Hautes terres |
| highland_moor | Landes de haute altitude |
| alpine_foothills | Contreforts alpins |
| alpine | Alpin |
| mountain | Montagne |
| mountain_foothills | Contreforts montagneux |
| overgrown_cliffs | Falaises envahies |
| cliffs | Falaises |
| rocky_mountains | Montagnes rocheuses |
| rocky_peak | Pic rocheux |

---

### ✨ rare_biomes (Biomes Rares)
**Minerais** : Lower Emerald Ore

**Biomes Vanilla (10)** :
| Nom du Biome | Traduction |
|--------------|------------|
| mushroom_fields | Champignonnières |
| sparse_jungle | Jungle clairsemée |
| savanna_plateau | Plateau de savane |
| sunflower_plains | Plaines de tournesols |
| windswept_gravelly_hills | Collines graveleuses balayées |
| cherry_grove | Bosquet de cerisiers |
| flower_forest | Forêt fleurie |
| deep_dark | Deep Dark |
| old_growth_birch_forest | Forêt de bouleaux ancienne |
| ice_spikes | Pics de glace |

**Biomes BOP (10)** :
| Nom du Biome | Traduction |
|--------------|------------|
| rainbow_hills | Collines arc-en-ciel |
| origin_valley | Vallée d'origine |
| tropics | Tropiques |
| volcano | Volcan |
| mystic_grove | Bosquet mystique |
| bamboo_grove | Bosquet de bambous |
| jade_cliffs | Falaises de jade |
| visceral_heap | Tas viscéral |
| crystalline_chasm | Abîme cristallin |
| withered_abyss | Abîme flétri |

---

### 🌳 tempered_biomes (Biomes Tempérés)
**Minerais** : Iron Ore, Deepslate Iron Ore, Concentrated Coal Ore

**Biomes Vanilla (23)** :
| Nom du Biome | Traduction |
|--------------|------------|
| plains | Plaines |
| sunflower_plains | Plaines de tournesols |
| river | Rivière |
| beach | Plage |
| stony_shore | Rivage pierreux |
| birch_forest | Forêt de bouleaux |
| dark_forest | Forêt sombre |
| flower_forest | Forêt fleurie |
| forest | Forêt |
| old_growth_birch_forest | Forêt de bouleaux ancienne |
| windswept_forest | Forêt balayée par le vent |
| swamp | Marais |
| mushroom_fields | Champignonnières |
| cherry_grove | Bosquet de cerisiers |
| old_growth_pine_taiga | Taïga ancienne de pins |
| windswept_gravelly_hills | Collines graveleuses balayées |
| deep_ocean | Océan profond |
| ocean | Océan |
| lush_caves | Grottes luxuriantes |
| deep_dark | Deep Dark |
| dripstone_caves | Grottes de spéléothèmes |

**Biomes BOP (23)** :
| Nom du Biome | Traduction |
|--------------|------------|
| maple_woods | Bois d'érables |
| maple_forest | Forêt d'érables |
| orchard | Verger |
| flower_meadow | Prairie fleurie |
| deciduous_forest | Forêt de feuillus |
| deciduous_forest_cleared | Forêt de feuillus défrichée |
| shrubland | Broussailles |
| lush_grassland | Pâturage luxuriant |
| lush_swamp | Marais luxuriant |
| marsh | Marais |
| moor | Landes |
| bog | Tourbière |
| dead_forest | Forêt morte |
| dead_swamp | Marais mort |
| mediterranean_forest | Forêt méditerranéenne |
| mediterranean_woodland | Bois méditerranéen |
| dense_forest | Forêt dense |
| woodland | Bois |
| coniferous_forest | Forêt de conifères |
| fir_clearing | Clairière de sapins |
| spruce_woods | Bois d'épicéas |
| field | Champ |
| prairie | Prairie |

---

## Support Biomes O' Plenty

Le mod inclut un support complet pour **Biomes O' Plenty** avec des biome modifiers dédiés pour chaque catégorie :
- `cold_bop_biomes` (11 biomes)
- `hot_bop_biomes` (15 biomes)
- `mountain_bop_biomes` (10 biomes)
- `rare_bop_biomes` (10 biomes)
- `tempered_bop_biomes` (23 biomes)

Les minerais se génèrent automatiquement dans les biomes BOP correspondants à leur catégorie vanilla.

## Mécaniques de Jeu

### Génération du Monde

- **Distribution des minerais** : Utilise le système de biome modifiers de Forge avec des tags de biomes personnalisés
- **Profondeur** : Configurable pour chaque type de minerai via le fichier de configuration
- **Taille des filons** : Configurable via le fichier de configuration

### Mécaniques de Drop

Le mod utilise un système de drops configurable (`ConfigurableOreDropsProcedure`) :

- **Expérience** : Tous les minerais personnalisés dropent 2 orbes d'expérience (configurable)
- **Silk Touch** : Supporté - les minerais peuvent être minés avec l'enchantement Silk Touch
- **Fortune** : Supporté pour Shard Diamond Ore et Concentrated Diamond Ore (configurable)

### Caractéristiques des Blocs

- **Light Block** : 15 (les minerais bloquent la lumière)
- **Sound Type** : STONE
- **Resistance** : Variable selon le type (3f pour Concentrated Diamond/Coal, 1.3f pour Shard Diamond)
- **Requires Correct Tool** : Tous les minerais nécessitent l'outil approprié pour être minés

## Recettes de Craft

### Diamant à partir d'Éclats
```
[Éclat] [Éclat] [Éclat]
[Éclat] [Éclat] [Éclat]
[Éclat] [Éclat] [Éclat]
    = 1 Diamant
```

### Outils en Diamond Shard
Les recettes suivent le pattern standard des outils Minecraft :
- **Pioche** : 2 Diamond Shards + 3 bâtons
- **Pelle** : 1 Diamond Shard + 2 bâtons
- **Hache** : 3 Diamond Shards + 2 bâtons

## Intégration

### Mode Créatif
Les items sont intégrés via `CustomOreGenModTabs` :
- Diamond Shards et blocs de minerais
- Outils en Diamond Shard

### Langue
Le mod inclut des fichiers de localisation en anglais (`en_us.json`) avec des noms descriptifs pour tous les blocs et objets.

## Configuration

Le mod inclut un système de configuration complet (`ModConfigs.java` avec `ConfigHelper.java`) qui permet aux utilisateurs et aux pack makers de personnaliser de nombreux aspects.

### Emplacement du Fichier de Configuration

Après le premier lancement du mod, un fichier de configuration est généré à :
```
config/custom_ore_gen-common.toml
```

### Options de Configuration

#### Génération des Minerais [ore_generation]
- **shard_diamond_ore** : Hauteur min/max, filons par chunk, taille des filons
- **concentrated_diamond_ore** : Filons par chunk, taille des filons
- **pure_golden_ore** : Filons par chunk, hauteur min/max
- **concentrated_coal_ore** : Filons par chunk
- **impure_ores** : Filons de fer/or par chunk
- **emerald_ores** : Filons high/lower par chunk
- **copper_ores** : Filons high/lower par chunk

#### Stats des Outils [tool_stats]
- **shard_diamond_tools** : Durabilité, vitesse, dégâts pour pioche, hache et pelle

#### Drops des Minerais [drops]
- **shard_diamond_ore** : Min/max drops, activation Fortune
- **concentrated_diamond_ore** : Min/max drops, activation Fortune
- **concentrated_coal_ore** : Min/max drops
- **pure_golden_ore** : Min/max drops
- **ash_coal_ore** : Min/max drops
- **impure_ores** : Min/max drops pour fer et or
- **oreExperience** : Expérience droppée par les minerais personnalisés

#### Activation des Fonctionnalités [features]
- **enableShardDiamondTools** : Active les outils en éclats de diamant
- **enableShardDiamondOre** : Active la génération du minerai d'éclats
- **enableConcentratedOres** : Active les minerais concentrés (Diamant, Charbon)
- **enableImpureOres** : Active les minerais impurs (Fer, Or)
- **enableAshCoalOre** : Active le minerai de charbon de cendre
- **enablePureGoldenOre** : Active le minerai d'or pur
- **enableCustomEmeraldOres** : Active les minerais d'émeraude personnalisés
- **enableCustomCopperOres** : Active les minerais de cuivre personnalisés
- **enableVanillaOreVariants** : Active les variantes de minerais vanilla

## Installation

1. Assurez-vous d'avoir Minecraft 1.20.1 installé avec Forge 47.3.0+
2. Placez le fichier .jar du mod dans le dossier `mods` de votre installation Minecraft
3. Lancez le jeu avec le profil Forge

> **Important** : Ce mod est conçu pour être utilisé avec KubeJS et ne doit pas être utilisé seul.

## Architecture du Code

### Structure des Paquets

```
net.mcreator.customoregen/
├── CustomOreGenMod.java          # Classe principale du mod
├── block/                        # Classes des blocs (16 minerais)
│   ├── SharddiamondblockoreBlock.java
│   ├── ConcentrateddiamondoreBlock.java
│   ├── ConcentratedcoaloreBlock.java
│   ├── PuregoldenoreBlock.java
│   ├── DeepslatepuregoldenoreBlock.java
│   ├── IronoreBlock.java
│   ├── DeepslateironoreBlock.java
│   ├── LapisoreBlock.java
│   ├── DeepslatelapisoreBlock.java
│   ├── RedstoneoreBlock.java
│   ├── DeepslateredstoneoreBlock.java
│   ├── CopperhighoreBlock.java
│   ├── CopperloweroreBlock.java
│   ├── HighemeraldoreBlock.java
│   ├── LoweremeraldoreBlock.java
│   └── DeepslatesharddiamondoreBlock.java
├── config/                       # Système de configuration
│   ├── ModConfigs.java          # Configuration Forge
│   └── ConfigHelper.java        # Helper pour la configuration
├── item/                         # Classes des items
│   ├── DiamondshardItem.java    # Item Diamond Shard (RARE)
│   ├── SharddiamondpickaxeItem.java
│   ├── SharddiamondshovelItem.java
│   └── SharddiamondaxeItem.java
├── procedures/                   # Procédures et logique
│   ├── ConfigurableOreDropsProcedure.java  # Drops configurables
│   └── OreexperienceProcedure.java         # Drops d'XP
└── init/                         # Registres Forge
    ├── CustomOreGenModBlocks.java  # 16 blocs
    ├── CustomOreGenModItems.java   # Items + BlockItems
    └── CustomOreGenModTabs.java    # Onglets créatifs
```

### Classes Principales

- **CustomOreGenMod** : Point d'entrée du mod, gère l'initialisation et le réseau
- **ModConfigs** : Configuration complète avec 4 sections (ore_generation, tool_stats, drops, features)
- **ConfigurableOreDropsProcedure** : Gère les drops des minerais avec support Fortune/Silk Touch
- **OreexperienceProcedure** : Gère les drops d'expérience lors du minage

## Philosophie du Mod

Custom Ore Gem est conçu pour :
- **Modifier la distribution des ressources** Minecraft avec de nouvelles variantes de minerais
- **Fournir un système de drops configurable** pour les pack makers et moddeurs
- **Introduire une progression intermédiaire** à travers les Diamond Shards
- **S'intégrer avec KubeJS** pour permettre des modifications avancées

## Crédits

- **Auteur** : Aulyrius
- **Outil de développement** : MCreator (https://mcreator.net/about)
- **Site web** : https://lanro.eu
- **Framework** : Minecraft Forge 1.20.1 (version 47.3.0)

---

**Version** : 1.0.0
**Pour Minecraft** : 1.20.1
**Mod ID** : custom_ore_gen
**License** : Not specified