Skip to main content

Configurações e datapacks

No Weave Network, todos os valores críticos devem ser configuráveis.

Isso é uma decisão estrutural do mod.
Nenhum número sensível a balanceamento deve ficar preso em código.

Estratégia recomendada​

A customização do mod é dividida por camadas, cada uma com um propósito claro:

  • Config comum
    Usada para valores padrão e ajustes rápidos em singleplayer ou desenvolvimento.

  • Config de servidor
    Usada para balanceamento em ambientes multiplayer, garantindo consistência entre clientes.

  • Datapacks
    Usados para receitas, transformações, progressão e gating avançado.

Essa separação evita conflitos, reduz hardcode e facilita manutenção.

Objetivos da customização​

O sistema de configuração existe para permitir que pack makers consigam:

  • ajustar o sweet spot de cada tier
  • evitar números mágicos ou valores fixos no código
  • integrar o Weave Network à economia e progressão do modpack
  • aplicar gating coerente com a proposta do pack

O que é considerado customizável​

O Weave Network foi desenhado para permitir ajustes amplos sem quebrar as invariantes do sistema.

Pack maker pode ajustar​

É esperado que packs ajustem:

  • throughput por tier e por payload
  • limites de canais por tier
  • buffers do Controller, Ports e Fibers
  • consumo em standby e demais custos estruturais
  • tempos de reboot e recondensação
  • custos lógicos por regra e multiplicadores de regras compostas
  • receitas do Loom e cadeias de transformação de materiais
  • gating de singularidades, incluindo custos e requisitos

Invariantes do sistema​

Alguns princípios não devem ser alterados via configuração:

  • energia não paga transporte por unidade
  • throughput é por canal, não global
  • um Controller ativo equivale a um grafo lógico
  • o scheduler é determinístico, sem heurística invisível
  • a rede nunca perde itens por falta de energia

Se um pack altera essas invariantes, o resultado deixa de ser balanceamento e passa a ser outro mod.

Resumo por camada​

  • Config
    Defaults e ajustes rápidos.

  • Server config
    Balanceamento multiplayer.

  • Datapack
    Receitas, progressão e gating.

Essa abordagem permite liberdade total de ajuste sem comprometer a identidade ou a previsibilidade do Weave Network.