custom_ore_gem/CONFIG_INTEGRATION_GUIDE.md

Guide d'Intégration de la Configuration

Alerte statut (post-migration NeoForge 1.21, v3.2) : ce guide décrit l'ancienne approche MCreator. La majorité des intégrations « restantes » ci-dessous sont désormais réalisées :

• Drops de minerais : gérés par CustomOreLootModifier (Global Loot Modifier auto-enregistré), pas par une procédure de bloc MCreator. OreBreakEventHandler dispatche l'XP et appelle ConfigurableOreDropsProcedure.
• Feature toggles : câblés (commit 48a0d797) via ConfigGatedFeaturesModifier + les biome modifiers data/custom_ore_gen/neoforge/biome_modifier/add_*_ores.json (type custom_ore_gen:config_gated_features). Cela gate la génération des ores, pas l'enregistrement des blocs.
• Outils : lisent TOOL_STATS config (ModConfigs.isLoaded() ? config : fallback). Les étapes MCreator détaillées plus bas sont conservées à titre historique mais ne sont plus nécessaires.

Vue d'Ensemble

Le système de configuration est maintenant en place. Voici ce qui a été implémenté :

✅ Déjà Fonctionnel

1. Stats des Outils (Shard Diamond)

Les outils utilisent déjà les valeurs de configuration !

Fichier : src/main/java/net/mcreator/customoregen/item/Sharddiamond*Item.java

// La durabilité est lue depuis la configuration
public int getUses() {
    return ModConfigs.TOOL_STATS.shardDiamondPickaxeDurability.get();
}

Pour tester : Modifiez pickaxeDurability dans config/custom_ore_gen-common.toml après le premier lancement.

2. Procédure de Drops Configurables

Une procédure Java a été créée pour gérer les drops configurables.

Fichier : src/main/java/net/mcreator/customoregen/procedures/ConfigurableOreDropsProcedure.java

🔧 Intégration Restante (Requiert MCreator)

Pour que les drops de minerais utilisent la configuration, vous devez lier la procédure aux blocs via MCreator.

Étape 1 : Ouvrir MCreator

Ouvrez votre workspace MCreator pour ce mod.

Étape 2 : Créer une Procédure

1. Allez dans Workspace procedures
2. Cliquez sur Add new procedure
3. Nommez-la : configurable_ore_drops
4. Dans la procédure, ajoutez un appel à la procédure Java :

Dans MCreator, utilisez les blocs suivants :

• Event trigger: On block destroyed by player/explosion
• Condition: Has ore data → vérifiez si c'est un de vos minerais
• Action: Call custom procedure → ConfigurableOreDropsProcedure

Étape 3 : Lier la Procédure aux Blocs

Pour chaque minerai que vous voulez rendre configurable :

1. Ouvrez le bloc dans MCreator (ex: Shard Diamond Ore)
2. Allez dans l'onglet Triggers
3. Pour "When block destroyed by player" ou "After block destroyed by explosion"
4. Ajoutez la procédure avec le paramètre oreType :
   • Pour Shard Diamond Ore : oreType = "shard_diamond"
   • Pour Concentrated Diamond Ore : oreType = "concentrated_diamond"
   • Pour Ash Coal Ore : oreType = "ash_coal"
   • Etc.

Étape 4 : Rebuild le Mod

Après avoir modifié les blocs dans MCreator :

1. Cliquez sur Build → Build mod
2. Le code sera régénéré avec vos liaisons

📊 Configuration des Features Toggles

Les options d'activation/désactivation des fonctionnalités sont définies dans ModConfigs.java :

enableShardDiamondTools = true
enableShardDiamondOre = true
enableConcentratedOres = true
etc.

Pour implémenter ces toggles, vous devrez ajouter des conditions dans :

• L'enregistrement des blocs (pour la génération)
• L'enregistrement des items (pour les outils)
• Les recettes de craft

Exemple d'Implémentation des Toggles

Dans CustomOreGenModBlocks.java ou votre classe d'enregistrement :

// Au lieu d'enregistrer directement :
// SHARDDIAMONDBLOCKORE.register(bus);

// Faites :
if (ModConfigs.FEATURES.enableShardDiamondOre.get()) {
    SHARDDIAMONDBLOCKORE.register(bus);
}

🎯 Ce Que Vous Poulez Faire Maintenant

Option 1 : Utiliser MCreator pour Intégrer les Drops

• Ouvrez MCreator
• Liez la procédure ConfigurableOreDropsProcedure à vos blocs
• Rebuild

Option 2 : Modifier Directement les Blocs Java

Pour chaque bloc de minerai, modifiez la méthode onDestroy pour appeler la procédure.

Exemple pour SharddiamondblockoreBlock.java :

@Override
public void onDestroy(Level world, BlockPos pos, BlockState state) {
    Entity entity = // obtenir l'entité qui mine
    ConfigurableOreDropsProcedure.execute(
        world,
        pos.getX(),
        pos.getY(),
        pos.getZ(),
        entity,
        "shard_diamond"
    );
}

Option 3 : Continuer avec les Loot Tables Actuelles

Les loot tables JSON actuelles continueront de fonctionner. La configuration des drops n'affectera le jeu que si vous intégrez la procédure.

📝 Résumé des Fichiers Modifiés

Fichier	Statut	Description
ModConfigs.java	✅ Créé	Classe de configuration principale
ConfigHelper.java	✅ Créé	Classe utilitaire pour accéder aux configs
ConfigurableOreDropsProcedure.java	✅ Créé	Procédure pour les drops configurables
SharddiamondpickaxeItem.java	✅ Modifié	Utilise les configs
SharddiamondshovelItem.java	✅ Modifié	Utilise les configs
SharddiamondaxeItem.java	✅ Modifié	Utilise les configs (et bug de réparation corrigé)
CustomOreGenMod.java	✅ Modifié	Enregistre la configuration
custom_ore_gen-common.toml	✅ Créé	Fichier de config par défaut

🚀 Test

Pour tester que les outils utilisent bien les configs :

1. Lancez le mod une fois pour générer le fichier de config
2. Fermez le jeu
3. Ouvrez config/custom_ore_gen-common.toml
4. Modifiez pickaxeDurability = 500
5. Relancez le jeu
6. Craft une pioche en Shard Diamond
7. Vérifiez qu'elle a bien 500 de durabilité (F3 + H pour voir les stats avancées)

💡 Besoin d'Aide ?

Si vous avez besoin d'aide pour intégrer la configuration via MCreator, n'hésitez pas à demander !

---

Note : Le système de configuration est en place et fonctionne pour les outils. Pour les drops et la génération des minerais, l'intégration dépend de comment vous voulez procéder (via MCreator ou modification directe du code).