Files
custom_ore_gem/README.md
T
2026-01-04 22:08:42 +01:00

21 KiB

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 :

    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

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


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