creator-mods-suite

# Creator Mods Suite **Creator Mods Suite** é uma suíte de mods abrangente projetada especificamente para criadores de conteúdo, YouTubers e streamers de Minecraft que jogam a versão 1.21.1. Ela fornece um conjunto de oito recursos ativáveis individualmente que aprimoram a jogabilidade para fins de gravação, com suporte aos loaders NeoForge e Fabric dentro de uma única base de código multi-loader. ## Propósito Central A suíte funciona como um "kit de ferramentas do diretor" para Minecraft, permitindo que criadores acionem eventos complexos, gerenciem ângulos de câmera e modifiquem regras de jogo em tempo real usando comandos ou atalhos de teclado. Isso elimina a necessidade de pausar, sair para menus ou reiniciar o jogo durante sessões de gravação, garantindo filmagens fluidas e com aparência profissional. ## Principais Recursos A suíte é composta por oito módulos distintos, cada um com uma função criativa específica: 1. **Director's Toolkit (`/toolkit`)**: Um auxiliar de gravação com claquete na tela, marcadores de tomada, interruptores de congelamento para mobs/jogadores, geradores de ondas, snapshots de arena, favoritos de câmera e alternâncias de HUD para quadros limpos. Permite controle preciso sobre as tomadas de gravação. 2. **Ashen Colossus (`/colossus`)**: Uma luta contra chefe animada em três fases, alimentada por GeckoLib. Inclui mecânicas como golpes de onda de choque, chuva de lava, ondas de lacaios e uma fase de fúria com anel de fogo. 3. **Power Kit (`/power`)**: Fornece seis habilidades ativadas por atalhos, como dash, rajada de fogo, impacto no solo, puxão do End, domo de escudo e congelamento de mobs. Inclui cooldowns autoritativos do servidor e feedback visual por meio de uma linha na hotbar. 4. **Rule Engine (`/rule`, `/shop`)**: Permite modificação ao vivo das regras de jogo com onze opções acumuláveis (por exemplo, drops aleatórios, crafting multiplicado, pisos de lava, mobs gigantes). Suporta presets de data pack para troca fácil. 5. **Evolve (`/evolve`)**: Um sistema de transformação de jogador em cinco estágios, no qual os jogadores ganham tamanho, aumentos de atributos e habilidades passivas a cada nível, acompanhados por efeitos de partículas e trocas de modelo. 6. **Event Director (`/event`)**: Aciona eventos mundiais direcionados, como luas de sangue, meteoros, cercos, chuvas da sorte e ascensões do vazio. Os eventos são baseados em fases e podem ser reagendados, pulados ou interrompidos por comandos. 7. **Arsenal (`/arsenal`)**: Introduz quatro armas únicas: Grapple Blade, Storm Bow, Gravity Hammer e Soul Scythe, cada uma com interações mecânicas distintas. 8. **Cursed Vault (`/vault`)**: Uma estrutura de masmorra estilo jigsaw contendo um Altar Amaldiçoado que invoca um mini-chefe (Vault Keeper) e baús selados que se abrem após sua derrota. Inclui um recurso de reset com um único comando. ## Design Voltado ao Criador * **Controle por Linha de Comando**: Cada recurso é controlável por comandos de chat (por exemplo, `/colossus phase 3`, `/event skip`), permitindo ajustes em tempo real sem interromper a jogabilidade. * **Modo Silencioso**: Os comandos podem ser configurados para exibir feedback apenas na barra de ação, em vez do log de chat, evitando poluição nas filmagens gravadas enquanto mantém mensagens de erro visíveis ao operador. * **Ativação Independente**: Cada um dos oito recursos pode ser ativado ou desativado individualmente por configuração ou comandos. Recursos desativados não registram nada no mundo do jogo, garantindo zero sobrecarga de desempenho ou interferência visual quando não estão em uso. * **HUD Não Intrusiva**: Todas as camadas de HUD personalizadas respeitam o modo tela cheia F1 vanilla e podem ser limpas por jogador usando comandos, auxiliando configurações com múltiplas câmeras. * **Segurança de Câmera**: Jogadores nos modos Criativo ou Espectador são ignorados por mecânicas hostis (ataques de chefe, perigos ambientais), permitindo que operadores de câmera voem pelas cenas com segurança. ## Detalhes Técnicos * **Compatibilidade**: Suporta Minecraft 1.21.1 com NeoForge 21.1.250+ e Fabric Loader 0.19.5+. Java 21 é necessário. * **Arquitetura**: Usa um módulo compartilhado `common/` para lógica de jogabilidade, com módulos separados `fabric/` e `neoforge/` para pontos de entrada e mixins específicos de plataforma. Isso garante comportamento idêntico entre os loaders. * **Configuração**: Gerenciada por um único arquivo `config/creatormods.json`. Valores de balanceamento são constantes codificadas; dados dinâmicos usam data packs do Minecraft. * **Testes**: O projeto inclui testes extensivos, compreendendo 486 testes unitários JUnit 5 e 134 GameTests no mundo por loader, cobrindo lógica, rede e cenários interativos de jogabilidade. * **Assets**: Os assets atuais são placeholders gerados programaticamente (texturas em Python, áudio com ffmpeg) para garantir que o mod funcione sem recursos ausentes. Assets artísticos reais estão planejados, mas ainda não foram incluídos. ## Instalação Os usuários devem compilar o mod a partir do código-fonte ou usar JARs fornecidos, se disponíveis. As dependências incluem GeckoLib (necessária para animações) e Fabric API (para builds Fabric). O mod deve ser instalado tanto no lado do cliente quanto no do servidor para funcionalidade completa. ## Licença O projeto é licenciado sob a Licença MIT, permitindo forking, modificação e uso em servidor privado sem publicação obrigatória de alterações.