creator-mods-suite

# Creator Mods Suite **Creator Mods Suite** is a comprehensive modding suite designed specifically for Minecraft content creators, YouTubers, and streamers playing version 1.21.1. It provides a set of eight independently toggleable features that enhance gameplay for recording purposes, supporting both NeoForge and Fabric loaders within a single multi-loader codebase. ## Core Purpose The suite acts as a "director's toolkit" for Minecraft, allowing creators to trigger complex events, manage camera angles, and modify game rules on the fly using commands or keybindings. This eliminates the need to pause, exit to menus, or restart the game during recording sessions, ensuring smooth and professional-looking footage. ## Key Features The suite comprises eight distinct modules, each serving a specific creative function: 1. **Director's Toolkit (`/toolkit`)**: A recording aid featuring an on-screen clapperboard, take markers, freeze switches for mobs/players, wave spawners, arena snapshots, camera bookmarks, and clean-frame HUD toggles. It allows precise control over recording takes. 2. **Ashen Colossus (`/colossus`)**: An animated, three-phase boss fight powered by GeckoLib. It includes mechanics like shockwave slams, lava rain, minion waves, and a ring of fire enrage phase. 3. **Power Kit (`/power`)**: Provides six keybind-activated abilities such as dash, fire burst, ground pound, ender pull, shield dome, and mob freeze. These include server-authoritative cooldowns and visual feedback via a hotbar row. 4. **Rule Engine (`/rule`, `/shop`)**: Allows live modification of game rules with eleven stackable options (e.g., random drops, multiplied crafting, lava floors, giant mobs). Supports data-pack presets for easy switching. 5. **Evolve (`/evolve`)**: A five-stage player transformation system where players gain size, stat boosts, and passive abilities at each rung, accompanied by particle effects and model swaps. 6. **Event Director (`/event`)**: Triggers directed world events like blood moons, meteors, sieges, lucky rains, and void rises. Events are phase-based and can be retimed, skipped, or stopped via commands. 7. **Arsenal (`/arsenal`)**: Introduces four unique weapons: Grapple Blade, Storm Bow, Gravity Hammer, and Soul Scythe, each with distinct mechanical interactions. 8. **Cursed Vault (`/vault`)**: A jigsaw dungeon structure containing a Cursed Altar that summons a mini-boss (Vault Keeper) and sealed chests that open upon its defeat. Includes a one-command reset feature. ## Creator-Focused Design * **Command-Line Control**: Every feature is controllable via chat commands (e.g., `/colossus phase 3`, `/event skip`), enabling real-time adjustments without interrupting gameplay. * **Silent Mode**: Commands can be configured to output feedback only to the action bar rather than the chat log, preventing clutter in recorded footage while keeping error messages visible to the operator. * **Independent Toggling**: Each of the eight features can be enabled or disabled individually via configuration or commands. Disabled features register nothing in the game world, ensuring zero performance overhead or visual interference when not in use. * **Non-Intrusive HUD**: All custom HUD layers respect the vanilla F1 full-screen mode and can be cleaned per-player using commands, aiding multi-camera setups. * **Camera Safety**: Players in Creative or Spectator modes are ignored by hostile mechanics (boss attacks, environmental hazards), allowing camera operators to fly through scenes safely. ## Technical Details * **Compatibility**: Supports Minecraft 1.21.1 with NeoForge 21.1.250+ and Fabric Loader 0.19.5+. Java 21 is required. * **Architecture**: Uses a shared `common/` module for gameplay logic, with separate `fabric/` and `neoforge/` modules for platform-specific entry points and mixins. This ensures identical behavior across loaders. * **Configuration**: Managed via a single `config/creatormods.json` file. Balance values are hardcoded constants; dynamic data uses Minecraft data packs. * **Testing**: The project includes extensive testing, comprising 486 JUnit 5 unit tests and 134 in-world GameTests per loader, covering logic, networking, and interactive gameplay scenarios. * **Assets**: Current assets are placeholders generated programmatically (Python textures, ffmpeg audio) to ensure the mod runs without missing resources. Real artistic assets are planned but not yet included. ## Installation Users must build the mod from source or use provided JARs if available. Dependencies include GeckoLib (required for animations) and Fabric API (for Fabric builds). The mod must be installed on both client and server sides for full functionality. ## License The project is licensed under the MIT License, allowing forforking, modification, and private server use without mandatory publication of changes.