# 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

## 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.

### Compatibilité Biomes O' Plenty

Le mod est entièrement compatible avec **Biomes O' Plenty**. Les biomes de BOP sont automatiquement intégrés dans les catégories appropriées :

#### forge:any
**Utilisé par** : Shard Diamond Ore
- TOUS les biomes (vanilla + mods)

#### cold_biomes
**Utilisé par** : Concentrated Diamond Ore
- **Vanilla** : snowy_slopes, snowy_beach, snowy_plains, snowy_taiga, ice_spikes, old_growth_pine_taiga, old_growth_spruce_taiga, taiga, cold_ocean, deep_cold_ocean, frozen_peaks, jagged_peaks, stony_peaks, dripstone_caves, deep_dark
- **Biomes O' Plenty** : alps, cold_desert, glacier, snowy_coniferous_forest, snowy_fir_clearing, snowy_maple_woods, snowy_plains, tundra

#### hot_biomes
**Utilisé par** : Pure Golden Ore, Copper High/Lower Ore
- **Vanilla** : desert, badlands, eroded_badlands, wooded_badlands, deep_lukewarm_ocean, lukewarm_ocean, mangrove_swamp, warm_ocean, bamboo_jungle, jungle, sparse_jungle, deep_dark
- **Biomes O' Plenty** : bamboo_blossom_grove, bayou, brushland, canyon, chaparral, dead_forest, dryland, grassland, hot_springs, jungle_edge, kelp_forest, lake, land_of_lakes, lavender_field, lush_desert, mangrove, marsh, moor, mystic_grove, oasis, outback, pasture, poppy_field, prairie, rainforest, redwood_forest, scrub, shield, shrubland, tropical_rainforest, tropics, volcano, wasteland, wetland, woodland

#### tempered_biomes
**Utilisé par** : Concentrated Coal Ore, Iron Ore
- **Vanilla** : birch_forest, dark_forest, flower_forest, forest, old_growth_birch_forest, windswept_forest, swamp, mushroom_fields, cherry_grove, old_growth_pine_taiga, windswept_gravelly_hills, deep_ocean, ocean, lush_caves, deep_dark
- **Biomes O' Plenty** : aspen_forest, clover_patch, coniferous_forest, deciduous_forest, dunes, fen, fir_clearing, highland, lowlands, maple_woods, meadow, mystic_plains, origin_beach, seasonal_forest, temperate_rainforest, yardangs

#### mountain_biomes
**Utilisé par** : High Emerald Ore
- **Vanilla** : windswept_hills, windswept_gravelly_hills, snowy_slopes, frozen_peaks, jagged_peaks, stony_peaks, meadow
- **Biomes O' Plenty** : crag, highland_meadow, overgrown_cliffs, snowy_alps

#### rare_biomes
**Utilisé par** : Lower Emerald Ore
- **Vanilla** : mushroom_fields, ice_spikes
- **Biomes O' Plenty** : cherry_blossom_grove, coral_reef, glowshroom_bayou, pumpkin_patch, spectral_garden, visceral_heap

## 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

## Compatibilité de Mods

### Biomes O' Plenty

Le mod est entièrement compatible avec **Biomes O' Plenty**. Les tags de biomes incluent automatiquement les biomes de BOP dans les catégories appropriées, permettant une génération de minerais naturelle dans tous les biomes du mod.

### Ajout de Support pour d'Autres Mods de Biomes

Pour ajouter le support pour d'autres mods de biomes (ex: Terralith, Oh The Biomes You'll Go, etc.), vous pouvez utiliser KubeJS ou éditer manuellement les fichiers de tags dans :

```
src/main/resources/data/custom_ore_gen/tags/worldgen/biome/
```

Les fichiers à modifier sont :
- `cold_biomes.json` - Pour les biomes froids
- `hot_biomes.json` - Pour les biomes chauds
- `tempered_biomes.json` - Pour les biomes tempérés
- `mountain_biomes.json` - Pour les biomes de montagne
- `rare_biomes.json` - Pour les biomes rares

Exemple pour ajouter un biome :
```json
{
  "replace": false,
  "values": [
    "minecraft:plains",
    "other_mod_id:biome_name"
  ]
}
```

## 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