Mise à jour README.md version 2.1.5

- Documentation de la dépendance obligatoire KubeJS
- Création automatique du script de suppression des minerais vanilla
- Nouvel onglet créatif personnalisé
- Changelog complet de la version 2.1.5
- Architecture mise à jour avec KubeJSIntegration et ShardDiamondArmorMaterial

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
feldenr
2026-01-07 14:18:04 +01:00
parent 11d596b788
commit 93cfa0dfe3
2 changed files with 125 additions and 68 deletions
+85 -50
View File
@@ -12,57 +12,64 @@ 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`
- **Version** : 1.0.0
- **Version** : 2.1.5
- **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 :
### Dépendances Requises
* **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.
* **KubeJS** (OBLIGATOIRE) - Ce mod ne peut pas fonctionner sans KubeJS installé
- Le mod refusera de se lancer si KubeJS n'est pas présent
- Le mod crée automatiquement le script de suppression des minerais vanilla au premier lancement dans `kubejs/startup_scripts/custom_ore_gen_remove_vanilla_ores.js`
biome_replacer.properties :
* **Biomes O' Plenty** (Recommandé) - Pour profiter des biomes supplémentaires (69 biomes BOP supportés)
```javascript
* **Biome Replacer** (Optionnel) - Pour supprimer les biomes caves qui n'ont pas de sens de température
```properties
biome_replacer.properties:
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*
### Script KubeJS Automatique
```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
});
});
```
Le mod crée automatiquement le script suivant au premier lancement dans `kubejs/startup_scripts/custom_ore_gen_remove_vanilla_ores.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
});
});
```
> **Note** : Le script n'est recréé que s'il n'existe pas déjà. Vous pouvez le modifier manuellement sans risque.
## Fonctionnalités Principales
### Nouveaux Minerais (16 blocs)
@@ -79,6 +86,8 @@ Le mod ajoute plusieurs variantes de minerais personnalisés :
- Se génère dans les biomes froids (cold_biomes)
- Drop : 1-2 Diamants (Fortune supporté)
> **Note** : La version surface du minerai Shard Diamond a été désactivée dans la version 2.1.5. Seule la version deepslate est disponible.
#### 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)
@@ -531,10 +540,16 @@ Minerais trouvables:
## Intégration
### Mode Créatif
Les items sont organisés dans les onglets créatifs via `CustomOreGenModTabs` :
- **INGREDIENTS** : Diamond Shards et blocs de minerais
- **TOOLS_AND_UTILITIES** : Pioche, pelle, hache, paxel et Ore Biome Finder
- **COMBAT** : Armure complète en Diamond Shard (casque, plastron, jambières, bottes)
Le mod ajoute un onglet créatif personnalisé **"Custom Ore Gen"** contenant tous les items du mod :
- Tous les minerais (15 blocs - le minerai surface Shard Diamond est désactivé)
- Diamond Shards et Ore Biome Finder
- Tous les outils Diamond Shard (pioche, pelle, hache, paxel)
- Toute l'armure Diamond Shard (casque, plastron, jambières, bottes)
Les items restent également disponibles dans les onglets vanilla Minecraft :
- **INGREDIENTS** : Diamond Shards
- **TOOLS_AND_UTILITIES** : Outils et Ore Biome Finder
- **COMBAT** : Armure 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.
@@ -587,10 +602,12 @@ config/custom_ore_gen-common.toml
## 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
2. **Installez KubeJS** (OBLIGATOIRE) - Le mod ne fonctionnera pas sans KubeJS
3. Placez le fichier `.jar` du mod dans le dossier `mods` de votre installation Minecraft
4. Lancez le jeu avec le profil Forge
5. Le mod créera automatiquement le script KubeJS nécessaire au premier lancement
> **Important** : Ce mod est conçu pour être utilisé avec KubeJS et ne doit pas être utilisé seul.
> **Important** : Ce mod nécessite KubeJS pour fonctionner. Le script de suppression des minerais vanilla sera créé automatiquement dans `kubejs/startup_scripts/custom_ore_gen_remove_vanilla_ores.js`.
## Architecture du Code
@@ -600,7 +617,9 @@ config/custom_ore_gen-common.toml
net.mcreator.customoregen/
├── CustomOreGenMod.java # Classe principale du mod
├── OresCommand.java # Commande /ores pour détecter les minerais
├── block/ # Classes des blocs (16 minerais)
├── KubeJSIntegration.java # Création automatique du script KubeJS
├── ShardDiamondArmorMaterial.java # Classe de matériau d'armure Diamond Shard
├── block/ # Classes des blocs (15 minerais)
│ ├── SharddiamondblockoreBlock.java
│ ├── ConcentrateddiamondoreBlock.java
│ ├── ConcentratedcoaloreBlock.java
@@ -635,7 +654,7 @@ net.mcreator.customoregen/
│ ├── ConfigurableOreDropsProcedure.java # Drops configurables
│ └── OreexperienceProcedure.java # Drops d'XP
└── init/ # Registres Forge
├── CustomOreGenModBlocks.java # 16 blocs
├── CustomOreGenModBlocks.java # 15 blocs
├── CustomOreGenModItems.java # Items + BlockItems
└── CustomOreGenModTabs.java # Onglets créatifs
```
@@ -643,6 +662,8 @@ net.mcreator.customoregen/
### Classes Principales
- **CustomOreGenMod** : Point d'entrée du mod, gère l'initialisation et le réseau
- **KubeJSIntegration** : Crée automatiquement le script KubeJS de suppression des minerais vanilla au premier lancement du jeu
- **ShardDiamondArmorMaterial** : Classe de matériau d'armure Diamond Shard avec gestion des textures
- **OresCommand** : Commande `/ores` pour identifier les minerais du biome actuel
- **OreBiomeFinderItem** : Item utilisable pour détecter les minerais du biome (clic droit)
- **SharddiamondpaxelItem** : Paxel combinant pioche + pelle + hache en un seul outil
@@ -653,15 +674,29 @@ net.mcreator.customoregen/
## 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 (outils et armure)
Custom Ore Gen est conçu pour :
- **Modifier la distribution des ressources** Minecraft avec de nouvelles variantes de minerais basées sur la température des biomes
- **Fournir une dépendance obligatoire à KubeJS** avec création automatique du script de suppression des minerais vanilla
- **Introduire une progression intermédiaire** à travers les Diamond Shards (outils et armure entre fer et diamant)
- **Offrir des outils d'exploration** avec l'Ore Biome Finder et la commande `/ores`
- **Proposer un outil tout-en-un** avec le Paxel en Diamond Shard (1000 durabilité)
- **Fournir une armure intermédiaire** entre fer et diamant (17 protection, 1060 durabilité)
- **S'intégrer avec KubeJS** pour permettre des modifications avancées
- **Faciliter l'installation** avec création automatique des scripts KubeJS nécessaires
- **Supporter Biomes O' Plenty** avec 69 biomes supplémentaires classés par température
- **Fournir un onglet créatif dédié** regroupant tous les items du mod
## Changements de Version
### Version 2.1.5
- ✅ Ajout de l'armure complète Diamond Shard (casque, plastron, jambières, bottes)
- ✅ Ajout du Paxel Diamond Shard (outil tout-en-un : pioche + pelle + hache)
- ✅ Création d'un onglet créatif personnalisé "Custom Ore Gen"
- ✅ KubeJS est maintenant une dépendance obligatoire (le mod refuse de se lancer sans KubeJS)
- ✅ Création automatique du script KubeJS de suppression des minerais vanilla au premier lancement
- ✅ Nouvelle texture Diamond Shard (32x32 pixels)
- ✅ Correction des textures d'armure (plus de texture violette)
- ✅ Désactivation du minerai Shard Diamond en surface (seulement la version deepslate reste disponible)
- ✅ Amélioration du système de matériau d'armure avec `ShardDiamondArmorMaterial`
## Crédits