creator-mods-suite

# Creator Mods Suite **Creator Mods Suite** est une suite de modding complète conçue spécifiquement pour les créateurs de contenu Minecraft, les YouTubeurs et les streamers jouant à la version 1.21.1. Elle fournit un ensemble de huit fonctionnalités activables indépendamment qui améliorent le gameplay à des fins d'enregistrement, prenant en charge à la fois les chargeurs NeoForge et Fabric au sein d'une seule base de code multi-chargeur. ## Objectif principal La suite agit comme une « boîte à outils de réalisateur » pour Minecraft, permettant aux créateurs de déclencher des événements complexes, de gérer les angles de caméra et de modifier les règles du jeu à la volée à l'aide de commandes ou de raccourcis clavier. Cela élimine le besoin de mettre en pause, de quitter vers les menus ou de redémarrer le jeu pendant les sessions d'enregistrement, garantissant des séquences fluides et d'aspect professionnel. ## Fonctionnalités clés La suite comprend huit modules distincts, chacun remplissant une fonction créative spécifique : 1. **Director's Toolkit (`/toolkit`)** : Une aide à l'enregistrement comprenant un clap de cinéma à l'écran, des marqueurs de prise, des interrupteurs de gel pour les créatures/joueurs, des générateurs de vagues, des instantanés d'arène, des signets de caméra et des bascules de HUD pour cadre propre. Il permet un contrôle précis des prises d'enregistrement. 2. **Ashen Colossus (`/colossus`)** : Un combat de boss animé en trois phases propulsé par GeckoLib. Il inclut des mécaniques telles que des frappes d'onde de choc, une pluie de lave, des vagues de sbires et une phase de rage en cercle de feu. 3. **Power Kit (`/power`)** : Fournit six capacités activées par raccourcis clavier telles que dash, salve de feu, coup de poing au sol, attraction d'ender, dôme de bouclier et gel des créatures. Elles incluent des temps de recharge côté serveur et un retour visuel via une rangée de barre d'action. 4. **Rule Engine (`/rule`, `/shop`)** : Permet la modification en direct des règles du jeu avec onze options cumulables (par exemple, butins aléatoires, artisanat multiplié, sols de lave, créatures géantes). Prend en charge des préréglages de packs de données pour un changement facile. 5. **Evolve (`/evolve`)** : Un système de transformation du joueur en cinq étapes où les joueurs gagnent en taille, en bonus de statistiques et en capacités passives à chaque palier, accompagné d'effets de particules et de changements de modèle. 6. **Event Director (`/event`)** : Déclenche des événements mondiaux scénarisés comme des lunes de sang, des météores, des sièges, des pluies chanceuses et des montées du vide. Les événements sont basés sur des phases et peuvent être reprogrammés, ignorés ou arrêtés via des commandes. 7. **Arsenal (`/arsenal`)** : Introduit quatre armes uniques : Grapple Blade, Storm Bow, Gravity Hammer et Soul Scythe, chacune avec des interactions mécaniques distinctes. 8. **Cursed Vault (`/vault`)** : Une structure de donjon en puzzle contenant un Autel Maudit qui invoque un mini-boss (Vault Keeper) et des coffres scellés qui s'ouvrent à sa défaite. Inclut une fonction de réinitialisation en une commande. ## Conception axée sur les créateurs * **Contrôle par ligne de commande** : Chaque fonctionnalité est contrôlable via des commandes de chat (par exemple, `/colossus phase 3`, `/event skip`), permettant des ajustements en temps réel sans interrompre le gameplay. * **Mode silencieux** : Les commandes peuvent être configurées pour n'afficher les retours que dans la barre d'action plutôt que dans le journal de chat, évitant l'encombrement des séquences enregistrées tout en gardant les messages d'erreur visibles pour l'opérateur. * **Activation indépendante** : Chacune des huit fonctionnalités peut être activée ou désactivée individuellement via la configuration ou des commandes. Les fonctionnalités désactivées n'enregistrent rien dans le monde du jeu, garantissant aucune surcharge de performance ni interférence visuelle lorsqu'elles ne sont pas utilisées. * **HUD non intrusif** : Toutes les couches de HUD personnalisées respectent le mode plein écran vanilla F1 et peuvent être nettoyées par joueur à l'aide de commandes, facilitant les configurations multi-caméras. * **Sécurité de la caméra** : Les joueurs en modes Créatif ou Spectateur sont ignorés par les mécaniques hostiles (attaques de boss, dangers environnementaux), permettant aux opérateurs de caméra de traverser les scènes en toute sécurité. ## Détails techniques * **Compatibilité** : Prend en charge Minecraft 1.21.1 avec NeoForge 21.1.250+ et Fabric Loader 0.19.5+. Java 21 est requis. * **Architecture** : Utilise un module `common/` partagé pour la logique de gameplay, avec des modules séparés `fabric/` et `neoforge/` pour les points d'entrée et les mixins spécifiques à la plateforme. Cela garantit un comportement identique sur tous les chargeurs. * **Configuration** : Gérée via un seul fichier `config/creatormods.json`. Les valeurs d'équilibrage sont des constantes codées en dur ; les données dynamiques utilisent des packs de données Minecraft. * **Tests** : Le projet inclut des tests approfondis, comprenant 486 tests unitaires JUnit 5 et 134 GameTests en monde par chargeur, couvrant la logique, le réseau et les scénarios de gameplay interactifs. * **Ressources** : Les ressources actuelles sont des espaces réservés générés par programmation (textures Python, audio ffmpeg) pour garantir que le mod fonctionne sans ressources manquantes. De véritables ressources artistiques sont prévues mais pas encore incluses. ## Installation Les utilisateurs doivent compiler le mod à partir des sources ou utiliser les JARs fournis s'ils sont disponibles. Les dépendances incluent GeckoLib (requis pour les animations) et Fabric API (pour les builds Fabric). Le mod doit être installé à la fois côté client et côté serveur pour une fonctionnalité complète. ## Licence Le projet est sous licence MIT, autorisant le fork, la modification et l'utilisation sur serveur privé sans publication obligatoire des changements.