⚖️ Referência completa de regras de jogo GameRules

Todos os parâmetros de configuração do Agrarian Reform são registrados como GameRules nativas na categoria Agrarian Reform (agrarian_reform:*), gerenciadas pelo DynamicGameRuleManager da DasikLibrary. São salvas no level.dat de cada mundo e podem ser ajustadas no jogo ou via comandos do servidor.

📊 Tabela de referência de GameRules estáticas

Chave da GameRule	Tipo	Padrão	Intervalo Válido	Lado de Execução	Descrição
`agrarian_reform:hydration_source_range`	Inteiro	`8`	`0` a `32`	Servidor e Cliente	Raio (em blocos) no qual uma fonte de água hidrata a terra arada via anéis de Chebyshev.
`agrarian_reform:hydration_flowing_range`	Inteiro	`4`	`0` a `32`	Servidor e Cliente	Raio (em blocos) no qual a água corrente fornece hidratação para a terra arada.
`agrarian_reform:pure_water_hydration_only`	Booleano	`false`	`true` / `false`	Servidor e Cliente	Quando ativado, blocos encharcados e caldeirões são ignorados; apenas água pura hidrata a terra.
`agrarian_reform:rain_growth_acceleration`	Inteiro	`1`	`0` a `10`	Servidor	Estágios extras de crescimento concedidos a plantações sob chuva por tick aleatório.
`agrarian_reform:growth_biodiversity_bonus`	Booleano	`true`	`true` / `false`	Servidor	Concede um bônus de +10% na probabilidade de crescimento quando espécies diferentes são plantadas juntas.
`agrarian_reform:total_trample_immunity`	Booleano	`false`	`true` / `false`	Servidor	Concede 100% de imunidade contra destruição de terra arada por pulos ou quedas de entidades.
`agrarian_reform:trample_immunity_players_only`	Booleano	`false`	`true` / `false`	Servidor	Junto à imunidade total, protege apenas jogadores e animais domesticados; monstros continuam pisoteando.
`agrarian_reform:always_wet_farmland`	Booleano	`false`	`true` / `false`	Servidor e Cliente	Força toda a terra arada a manter nível de umidade 7 permanentemente sem precisar de água.
`agrarian_reform:seeds_grow_grass`	Booleano	`true`	`true` / `false`	Servidor e Cliente	Clicar com o botão direito na terra com sementes consome 1 semente e transforma o bloco em grama.
`agrarian_reform:right_click_harvest`	Booleano	`true`	`true` / `false`	Servidor e Cliente	Clicar com o botão direito na plantação madura colhe os frutos e replanta no estágio 0.
`agrarian_reform:universal_bonemeal`	Booleano	`true`	`true` / `false`	Servidor e Cliente	Acelera o crescimento de plantas que nativamente não aceitam farinha de osso (cacto, cana, fungo do Nether, vinhas).
`agrarian_reform:global_growth_multiplier`	Inteiro	`100`	`0` a `2147483647`	Servidor	Multiplicador global em porcentagem para crescimento e simulação offline (100 = 1x vanilla).
`agrarian_reform:ambient_crop_rustle`	Booleano	`true`	`true` / `false`	Cliente	Reproduz efeitos sonoros de folhas ao se mover pelas plantações ou no avanço de estágios.
`agrarian_reform:ambient_vitality_particles`	Booleano	`true`	`true` / `false`	Cliente	Emite partículas verdes sutis de aldeão feliz em transições de crescimento bem-sucedidas.
`agrarian_reform:debug_mode`	Booleano	`false`	`true` / `false`	Servidor	Ativa logs de diagnóstico detalhados no console do servidor. Temporário: redefine para `false` ao reiniciar.

🌾 GameRules dinâmicas de multiplicador por cultura

Sempre que uma nova cultura (modificada ou vanilla) for descoberta ou registrada via datapacks, o Agrarian Reform registra dinamicamente uma GameRule dedicada:

$$\text{GameRule Key} = \text{agrarian_reform:growth_}\langle \text{namespace} \rangle\text{_}\langle \text{path} \rangle$$

Resolution Hierarchy:

Multiplicador específico ($> 0$): Um número positivo (ex: 200) define a velocidade exata (200% = 2x), ignorando o valor global.
Estado congelado ($-1$): Em -1, o crescimento dessa cultura é totalmente congelado (velocidade 0%), sem avanço offline.
Herança do multiplicador global ($0$): Se definido como 0 (padrão), a planta herda automaticamente agrarian_reform:global_growth_multiplier.

bash

# Configurar trigo para crescer a 3x da velocidade
/gamerule agrarian_reform:growth_minecraft_wheat 300

# Congelar totalmente o crescimento de cana-de-açúcar
/gamerule agrarian_reform:growth_minecraft_sugar_cane -1

# Redefinir cenouras para herdarem o multiplicador global
/gamerule agrarian_reform:growth_minecraft_carrots 0

⚡ Registro dinâmico durante o jogo (sem reiniciar)

Instanciação sob demanda: Ao explorar novas áreas ou plantar novas sementes, AgrarianCropRules cria a GameRule na hora.
Disponibilidade imediata: A nova GameRule pode ser consultada e alterada instantaneamente via /gamerule com autocompletar.
Compatibilidade com /reload: Usar /reload reescaneia os registros e adiciona novas tags de culturas automaticamente.

🛡️ Remoção de mods e ciclo de dormência à prova de falhas

Desacoplamento total: As regras utilizam strings e Identifier vanilla sem depender de classes fixas.
Estado dormente: Se um mod for desinstalado, a regra correspondente fica inativa, sem usar CPU nem gerar falhas.
Recuperação perfeita ao reinstalar: Reinstalar o mod reativa imediatamente as configurações salvas em level.dat e no JSON.

🛠️ Exemplos de comandos de administração

bash

# Consultar raio atual de fontes de água
/gamerule agrarian_reform:hydration_source_range

# Definir alcance de irrigação de fontes para 12 blocos
/gamerule agrarian_reform:hydration_source_range 12

# Ativar imunidade ao pisoteamento apenas para jogadores
/gamerule agrarian_reform:total_trample_immunity true
/gamerule agrarian_reform:trample_immunity_players_only true

# Ativar temporariamente logs detalhados de depuração
/gamerule agrarian_reform:debug_mode true

⚖️ Referência completa de regras de jogo GameRules ​

📊 Tabela de referência de GameRules estáticas ​

🌾 GameRules dinâmicas de multiplicador por cultura ​

Resolution Hierarchy: ​

⚡ Registro dinâmico durante o jogo (sem reiniciar) ​

🛡️ Remoção de mods e ciclo de dormência à prova de falhas ​