Roman/custom_ore_gem
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

MAJ .md

Browse Source
This commit is contained in:
roman
2025-12-30 14:13:54 +01:00
parent ea4bcfbbeb
commit ace3ec118b
1 changed files with 184 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+184 -97
View File
@@ -2,7 +2,9 @@
## Description ## Description
Custom Ore Gem est un mod Minecraft développé avec MCreator pour Forge 1.20.1. Ce mod enrichit l'expérience minière du jeu en ajoutant une variété de nouveaux minerais, de nouveaux objets et d'outils personnalisés, offrant aux joueurs plus de possibilités et une progression plus intéressante. 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 ## Informations Techniques
@@ -10,148 +12,160 @@ Custom Ore Gem est un mod Minecraft développé avec MCreator pour Forge 1.20.1.
- **Mod Loader** : Forge (version 47.3.0) - **Mod Loader** : Forge (version 47.3.0)
- **Version de Java** : Java 17 - **Version de Java** : Java 17
- **Mod ID** : `custom_ore_gen` - **Mod ID** : `custom_ore_gen`
- **Outil de développement** : MCreator - **Version** : 1.0.0
- **Auteur** : Aulyrius (créé via MCreator)
- **Site web** : https://lanro.eu
## Fonctionnalités Principales ## Fonctionnalités Principales
### Nouveaux Minerais (23 au total) ### Nouveaux Minerais (16 blocs)
Le mod ajoute plusieurs variantes de minerais personnalisés : Le mod ajoute plusieurs variantes de minerais personnalisés :
#### Variantes de Diamant #### Variantes de Diamant
- **Shard Diamond Ore** : Un minerai de diamant qui droppe des éclats de diamant (tous biomes) - **Shard Diamond Ore** (`sharddiamondblockore`) : Un minerai de diamant qui droppe des éclats de diamant
- **Deepslate Shard Diamond Ore** : Version deepslate du minerai d'éclats de diamant - Se génère dans tous les biomes (forge:any)
- **Concentrated Diamond Ore** : Un minerai de diamant plus concentré (zones froides uniquement) - 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 #### Variantes d'Or
- **Impure Gold Ore** (normal & deepslate) : Un minerai d'or impur - **Pure Golden Ore** (`puregoldenore`) : Un minerai d'or pur de haute qualité
- **Pure Golden Ore** (normal & deepslate) : Un minerai d'or pur de haute qualité (zones chaudes uniquement) - 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 #### Variantes de Charbon
- **Ash Coal Ore** : Un type de charbon spécial - **Concentrated Coal Ore** (`concentratedcoalore`) : Charbon plus concentré
- **Concentrated Coal Ore** : Charbon plus concentré (biomes tempérés uniquement) - Se génère dans les biomes tempérés (tempered_biomes)
- Drop : 2-4 Charbons
#### Variantes de Fer #### Variantes de Fer
- **Impure Iron Ore** (normal & deepslate) : Un minerai de fer impur (biomes tempérés) - **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 #### Variantes d'Émeraude
- **High Emerald Ore** : Émeraude de haute qualité (montagnes uniquement) - **High Emerald Ore** (`highemeraldore`) : Émeraude de haute qualité
- **Lower Emerald Ore** : Émeraude de basse qualité (biomes très rares uniquement) - 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)
#### Minerais Additionnels #### Variantes de Redstone
- Iron Ore (normal & deepslate) - **Redstone Ore** (`redstoneore`) : Variante personnalisée du minerai de redstone
- Redstone Ore (normal & deepslate) - **Deepslate Redstone Ore** (`deepslateredstoneore`) : Version deepslate
- Lapis Lazuli Ore (normal & deepslate)
- Copper Ore (variantes haute et basse) #### 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 ### Nouveaux Objets
#### Diamond Shard (Éclat de Diamant) #### Diamond Shard (Éclat de Diamant) (`diamondshard`)
- **Description** : Un éclat de diamant avec des étincelles - **Description** : "Diamond sparkle, to create tools or to create a diamond"
- **Rareté** : RARE
- **Stack** : 64
- **Utilisation** : - **Utilisation** :
- Peut être crafté en diamant complet (9 éclats = 1 diamant)
- Permet de créer des outils en éclats de diamant - Permet de créer des outils en éclats de diamant
- **Rareté** : Plus commun que le diamant complet, mais nécessite d'être accumulé - Peut être crafté en diamant complet (9 éclats = 1 diamant)
#### Autres Objets
- **Ash Coal** : Charbon spécial dropé par l'Ash Coal Ore
### Outils en Diamond Shard ### Outils en Diamond Shard
Le mod introduit une nouvelle catégorie d'outils située entre le fer et le diamant : Le mod introduit une nouvelle catégorie d'outils située entre le fer et le diamant :
#### Pioche en Éclat de Diamant (Shard Diamond Pickaxe) #### Pioche en Éclat de Diamant (`sharddiamondpickaxe`)
- **Durabilité** : 200 utilisations - **Durabilité** : 200 utilisations
- **Vitesse de minage** : 7f - **Vitesse de minage** : 7.0
- **Enchantabilité** : 9 niveaux - **Dégâts d'attaque** : 1
- **Réparation** : Utilise des Diamond Shards - **Réparation** : Utilise des Diamond Shards
#### Pelle en Éclat de Diamant (Shard Diamond Shovel) #### Pelle en Éclat de Diamant (`sharddiamondshovel`)
- **Durabilité** : 200 utilisations - **Durabilité** : 200 utilisations
- **Vitesse de minage** : 4f - **Vitesse de minage** : 4.0
- **Enchantabilité** : 9 niveaux - **Dégâts d'attaque** : 2
#### Hache en Éclat de Diamant (Shard Diamond Axe) #### Hache en Éclat de Diamant (`sharddiamondaxe`)
- **Durabilité** : 200 utilisations - **Durabilité** : 200 utilisations
- **Vitesse de minage** : 7f - **Vitesse de minage** : 7.0
- **Enchantabilité** : 9 niveaux - **Dégâts d'attaque** : 6
- **Dégâts** : Équilibré pour le combat
## 📍 Distribution des Minerais par Biomes ## Distribution des Minerais par Biomes
Le mod utilise une classification logique des biomes pour la génération des minerais : Le mod utilise une classification logique des biomes pour la génération des minerais via les biome modifiers de Forge.
### 🏔️ mountain_biomes (7 biomes) ### Classification des Biomes
**Utilisé par** : High Emerald Ore
Biomes de montagne et hauts plateaux : #### forge:any
- windswept_hills, windswept_gravelly_hills, snowy_slopes **Utilisé par** : Shard Diamond Ore
- frozen_peaks, jagged_peaks, stony_peaks - TOUS les biomes
- meadow
### ❄️ cold_biomes (16 biomes) #### cold_biomes
**Utilisé par** : Concentrated Diamond, Lapis, Redstone (deepslate) **Utilisé par** : Concentrated Diamond Ore
Zones froides et montagnes enneigées :
- snowy_slopes, snowy_beach, snowy_plains, snowy_taiga, ice_spikes - snowy_slopes, snowy_beach, snowy_plains, snowy_taiga, ice_spikes
- old_growth_pine_taiga, old_growth_spruce_taiga, taiga - old_growth_pine_taiga, old_growth_spruce_taiga, taiga
- cold_ocean, deep_cold_ocean - cold_ocean, deep_cold_ocean
- frozen_peaks, jagged_peaks, stony_peaks - frozen_peaks, jagged_peaks, stony_peaks
- dripstone_caves, deep_dark - dripstone_caves, deep_dark
### 🔥 hot_biomes (15 biomes) #### hot_biomes
**Utilisé par** : Pure Golden, Redstone, Copper (toutes variantes) **Utilisé par** : Pure Golden Ore, Copper High/Lower Ore
Zones chaudes et tropicales :
- desert, badlands, eroded_badlands, wooded_badlands - desert, badlands, eroded_badlands, wooded_badlands
- deep_lukewarm_ocean, lukewarm_ocean - deep_lukewarm_ocean, lukewarm_ocean
- mangrove_swamp, warm_ocean - mangrove_swamp, warm_ocean
- bamboo_jungle, jungle, sparse_jungle - bamboo_jungle, jungle, sparse_jungle
- deep_dark - deep_dark
### 🌤️ tempered_biomes (13 biomes) #### tempered_biomes
**Utilisé par** : Concentrated Coal, Iron (toutes variantes) **Utilisé par** : Concentrated Coal Ore, Iron Ore
Biomes tempérés de surface et souterrains :
- birch_forest, dark_forest, flower_forest, forest - birch_forest, dark_forest, flower_forest, forest
- old_growth_birch_forest, windswept_forest, swamp - old_growth_birch_forest, windswept_forest, swamp
- cherry_grove, windswept_gravelly_hills - cherry_grove, windswept_gravelly_hills
- deep_ocean, ocean - deep_ocean, ocean
- lush_caves, deep_dark - lush_caves, deep_dark
### ⭐ rare_biomes (2 biomes) #### mountain_biomes
**Utilisé par** : High Emerald Ore
- windswept_hills, windswept_gravelly_hills, snowy_slopes
- frozen_peaks, jagged_peaks, stony_peaks
- meadow
#### rare_biomes
**Utilisé par** : Lower Emerald Ore **Utilisé par** : Lower Emerald Ore
- mushroom_fields, ice_spikes
Biomes très rares :
- mushroom_fields
- ice_spikes
### 🔵 forge:any
**Utilisé par** : Shard Diamond Ore (toutes les variantes)
- **TOUS les biomes**
## Mécaniques de Jeu ## Mécaniques de Jeu
### Génération du Monde ### Génération du Monde
- **Distribution des minerais** : Utilise le système de génération de minerais de Minecraft avec des tags de biomes personnalisés - **Distribution des minerais** : Utilise le système de biome modifiers de Forge avec des tags de biomes personnalisés
- **Profondeur** : Configuré pour la génération souterraine - **Profondeur** : Configurable pour chaque type de minerai via le fichier de configuration
- **Taille des filons** : Varie selon le type de minerai - **Taille des filons** : Configurable via le fichier de configuration
### Mécaniques de Drop ### Mécaniques de Drop
- **Expérience** : Tous les minerais personnalisés dropent des orbes d'expérience lorsqu'ils sont minés Le mod utilise un système de drops configurable (`ConfigurableOreDropsProcedure`) :
- **Silk Touch** : Les minerais peuvent être minés avec l'enchantement Silk Touch pour obtenir le bloc entier
- **Fortune** : L'enchantement Fortune est supporté pour augmenter les drops
### Système de Progression - **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)
Le mod introduit une progression intéressante : ### Caractéristiques des Blocs
1. **Début de jeu** : Utilisation des outils en fer, exploration des surface pour Shard Diamond Ore - **Light Block** : 15 (les minerais bloquent la lumière)
2. **Milieu de jeu** : Acquisition des Diamond Shards et craft des outils en Diamond Shard - **Sound Type** : STONE
3. **Fin de jeu** : Exploration des zones froides pour Concentrated Diamond, accumulation de diamants complets - **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 ## Recettes de Craft
@@ -172,18 +186,16 @@ Les recettes suivent le pattern standard des outils Minecraft :
## Intégration ## Intégration
### Mode Créatif ### Mode Créatif
- **Onglet Ingrédients** : Diamond Shards et blocs de minerais Les items sont intégrés via `CustomOreGenModTabs` :
- **Onglet Outils** : Outils en Diamond Shard - Diamond Shards et blocs de minerais
- **Onglets Standard Minecraft** : Intégration native dans les onglets vanilla - Outils en Diamond Shard
### Langue ### Langue
Le mod inclut des fichiers de localisation en anglais et français avec des noms descriptifs pour tous les blocs et objets. Le mod inclut des fichiers de localisation en anglais (`en_us.json`) avec des noms descriptifs pour tous les blocs et objets.
## Configuration ## Configuration
Le mod inclut un système de configuration qui permet aux utilisateurs et aux pack makers de personnaliser certains aspects du mod. 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.
> **Note** : Les stats des outils (durabilité, vitesse) ne sont pas configurables car les items sont créés avant le chargement de la configuration par Forge.
### Emplacement du Fichier de Configuration ### Emplacement du Fichier de Configuration
@@ -194,14 +206,37 @@ config/custom_ore_gen-common.toml
### Options de Configuration ### Options de Configuration
#### 🪨 Génération des Minerais #### Génération des Minerais [ore_generation]
Contrôlez où et comment les minerais se génèrent - **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
#### 💎 Drops des Minerais #### Stats des Outils [tool_stats]
Contrôlez ce que les minerais dropent - **shard_diamond_tools** : Durabilité, vitesse, dégâts pour pioche, hache et pelle
#### 🎛️ Activation des Fonctionnalités #### Drops des Minerais [drops]
Activez ou désactivez facilement les fonctionnalités du mod - **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 ## Installation
@@ -209,22 +244,74 @@ Activez ou désactivez facilement les fonctionnalités du mod
2. Placez le fichier .jar du mod dans le dossier `mods` de votre installation Minecraft 2. Placez le fichier .jar du mod dans le dossier `mods` de votre installation Minecraft
3. Lancez le jeu avec le profil Forge 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 ## Philosophie du Mod
Custom Ore Gem est conçu pour : Custom Ore Gem est conçu pour :
- **Augmenter la variété des minerais** avec de nouvelles variantes et raretés - **Modifier la distribution des ressources** Minecraft avec de nouvelles variantes de minerais
- **Introduire un système de progression** à travers les Diamond Shards - **Fournir un système de drops configurable** pour les pack makers et moddeurs
- **Équilibrer la collecte de ressources** avec des récompenses d'expérience - **Introduire une progression intermédiaire** à travers les Diamond Shards
- **Fournir des options d'outils personnalisés** entre les niveaux fer et diamant - **S'intégrer avec KubeJS** pour permettre des modifications avancées
- **Enrichir le gameplay** avec une distribution logique des minerais par biome
## Crédits ## Crédits
- Développé avec MCreator - **Auteur** : Aulyrius
- Framework Minecraft Forge 1.20.1 - **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 **Version** : 1.0.0
**Pour Minecraft** : 1.20.1 **Pour Minecraft** : 1.20.1
**License** : Consultez le fichier license.txt pour plus d'informations **Mod ID** : custom_ore_gen
**License** : Not specified