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
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
@@ -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)
- **Version de Java** : Java 17
- **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
### Nouveaux Minerais (23 au total)
### Nouveaux Minerais (16 blocs)
Le mod ajoute plusieurs variantes de minerais personnalisés :
#### Variantes de Diamant
- **Shard Diamond Ore** : Un minerai de diamant qui droppe des éclats de diamant (tous biomes)
- **Deepslate Shard Diamond Ore** : Version deepslate du minerai d'éclats de diamant
- **Concentrated Diamond Ore** : Un minerai de diamant plus concentré (zones froides uniquement)
- **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
- **Impure Gold Ore** (normal & deepslate) : Un minerai d'or impur
- **Pure Golden Ore** (normal & deepslate) : Un minerai d'or pur de haute qualité (zones chaudes uniquement)
- **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
- **Ash Coal Ore** : Un type de charbon spécial
- **Concentrated Coal Ore** : Charbon plus concentré (biomes tempérés uniquement)
- **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
- **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
- **High Emerald Ore** : Émeraude de haute qualité (montagnes uniquement)
- **Lower Emerald Ore** : Émeraude de basse qualité (biomes très rares uniquement)
- **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)
#### Minerais Additionnels
- Iron Ore (normal & deepslate)
- Redstone Ore (normal & deepslate)
- Lapis Lazuli Ore (normal & deepslate)
- Copper Ore (variantes haute et basse)
#### 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)
- **Description** : Un éclat de diamant avec des étincelles
#### Diamond Shard (Éclat de Diamant) (`diamondshard`)
- **Description** : "Diamond sparkle, to create tools or to create a diamond"
- **Rareté** : RARE
- **Stack** : 64
- **Utilisation** :
- Peut être crafté en diamant complet (9 éclats = 1 diamant)
- Permet de créer des outils en éclats de diamant
- **Rareté** : Plus commun que le diamant complet, mais nécessite d'être accumulé
#### Autres Objets
- **Ash Coal** : Charbon spécial dropé par l'Ash Coal Ore
- 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 (Shard Diamond Pickaxe)
#### Pioche en Éclat de Diamant (`sharddiamondpickaxe`)
- **Durabilité** : 200 utilisations
- **Vitesse de minage** : 7f
- **Enchantabilité** : 9 niveaux
- **Vitesse de minage** : 7.0
- **Dégâts d'attaque** : 1
- **Réparation** : Utilise des Diamond Shards
#### Pelle en Éclat de Diamant (Shard Diamond Shovel)
#### Pelle en Éclat de Diamant (`sharddiamondshovel`)
- **Durabilité** : 200 utilisations
- **Vitesse de minage** : 4f
- **Enchantabilité** : 9 niveaux
- **Vitesse de minage** : 4.0
- **Dégâts d'attaque** : 2
#### Hache en Éclat de Diamant (Shard Diamond Axe)
#### Hache en Éclat de Diamant (`sharddiamondaxe`)
- **Durabilité** : 200 utilisations
- **Vitesse de minage** : 7f
- **Enchantabilité** : 9 niveaux
- **Dégâts** : Équilibré pour le combat
- **Vitesse de minage** : 7.0
- **Dégâts d'attaque** : 6
## 📍 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)
**Utilisé par** : High Emerald Ore
### Classification des Biomes
Biomes de montagne et hauts plateaux :
- windswept_hills, windswept_gravelly_hills, snowy_slopes
- frozen_peaks, jagged_peaks, stony_peaks
- meadow
#### forge:any
**Utilisé par** : Shard Diamond Ore
- TOUS les biomes
### ❄️ cold_biomes (16 biomes)
**Utilisé par** : Concentrated Diamond, Lapis, Redstone (deepslate)
Zones froides et montagnes enneigées :
#### cold_biomes
**Utilisé par** : Concentrated Diamond Ore
- 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
### 🔥 hot_biomes (15 biomes)
**Utilisé par** : Pure Golden, Redstone, Copper (toutes variantes)
Zones chaudes et tropicales :
#### hot_biomes
**Utilisé par** : Pure Golden Ore, Copper High/Lower Ore
- desert, badlands, eroded_badlands, wooded_badlands
- deep_lukewarm_ocean, lukewarm_ocean
- mangrove_swamp, warm_ocean
- bamboo_jungle, jungle, sparse_jungle
- deep_dark
### 🌤️ tempered_biomes (13 biomes)
**Utilisé par** : Concentrated Coal, Iron (toutes variantes)
Biomes tempérés de surface et souterrains :
#### tempered_biomes
**Utilisé par** : Concentrated Coal Ore, Iron Ore
- birch_forest, dark_forest, flower_forest, forest
- old_growth_birch_forest, windswept_forest, swamp
- cherry_grove, windswept_gravelly_hills
- deep_ocean, ocean
- 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
Biomes très rares :
- mushroom_fields
- ice_spikes
### 🔵 forge:any
**Utilisé par** : Shard Diamond Ore (toutes les variantes)
- **TOUS les biomes**
- mushroom_fields, ice_spikes
## Mécaniques de Jeu
### 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
- **Profondeur** : Configuré pour la génération souterraine
- **Taille des filons** : Varie selon le type de minerai
- **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
- **Expérience** : Tous les minerais personnalisés dropent des orbes d'expérience lorsqu'ils sont minés
- **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
Le mod utilise un système de drops configurable (`ConfigurableOreDropsProcedure`) :
### 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
2. **Milieu de jeu** : Acquisition des Diamond Shards et craft des outils en Diamond Shard
3. **Fin de jeu** : Exploration des zones froides pour Concentrated Diamond, accumulation de diamants complets
- **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
@@ -172,18 +186,16 @@ Les recettes suivent le pattern standard des outils Minecraft :
## Intégration
### Mode Créatif
- **Onglet Ingrédients** : Diamond Shards et blocs de minerais
- **Onglet Outils** : Outils en Diamond Shard
- **Onglets Standard Minecraft** : Intégration native dans les onglets vanilla
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 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
Le mod inclut un système de configuration qui permet aux utilisateurs et aux pack makers de personnaliser certains aspects du mod.
> **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.
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
@@ -194,14 +206,37 @@ config/custom_ore_gen-common.toml
### Options de Configuration
#### 🪨 Génération des Minerais
Contrôlez où et comment les minerais se génèrent
#### 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
#### 💎 Drops des Minerais
Contrôlez ce que les minerais dropent
#### Stats des Outils [tool_stats]
- **shard_diamond_tools** : Durabilité, vitesse, dégâts pour pioche, hache et pelle
#### 🎛️ Activation des Fonctionnalités
Activez ou désactivez facilement les fonctionnalités du mod
#### 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
@@ -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
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 :
- **Augmenter la variété des minerais** avec de nouvelles variantes et raretés
- **Introduire un système de progression** à travers les Diamond Shards
- **Équilibrer la collecte de ressources** avec des récompenses d'expérience
- **Fournir des options d'outils personnalisés** entre les niveaux fer et diamant
- **Enrichir le gameplay** avec une distribution logique des minerais par biome
- **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
- Développé avec MCreator
- Framework Minecraft Forge 1.20.1
- **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
**License** : Consultez le fichier license.txt pour plus d'informations
**Mod ID** : custom_ore_gen
**License** : Not specified