Etapa 01 · obrigatório
Identidade da definição
O loader usa estes campos para localizar o arquivo, escolher o comportamento e validar a definição. Comece pelo esqueleto obrigatório.
Identificação
O id precisa ser exatamente <namespace>:<path> do arquivo.
Somente 2 é aceito.
Minúsculas, números e _ . -.
Minúsculas, números e _ . / -.
data/infinity_nexus_multiblock/multiblock/minha_maquina.json
Tipo de máquina
Define se o controller processa receitas ou apenas expõe inventorário e capabilities.
Metadados opcionais
Valores no padrão são omitidos do JSON final.
Metadado; mínimo 1.
Maior prioridade vence em sobreposição.
Só vale sem item_slots; não reposiciona slots com x/y.
Campos preservados
Estes campos vieram do JSON importado. Eles serão mantidos no download, mas ainda não são editados nem validados nesta fase.
Etapa 02 · obrigatório
Pattern da estrutura
Pinte as camadas de baixo para cima. A orientação canônica olha para south; o jogo rotaciona tudo conforme o FACING do controller.
Editor de camadas
3 × 1 × 3
Clique ou arraste para pintar. Botão direito apaga. Com foco na grade, use as setas, Enter e Backspace.
Etapa 03 · obrigatório
Matchers dos símbolos
Cada símbolo não-âncora precisa apontar para um bloco, uma tag ou um bloco/tag com blockstate específico.
Símbolos usados
A ordem dos matchers não importa para o loader.
/reload.
Etapa 04 · opcional
Slots de itens
Define o inventário por item_slots. Com x/y, o layout padrão respeita a posição; sem posição, usa a grade automática.
item_slots
Sem item_slots; o inventário usa inventory_rows.
x/y válidos mantêm a posição e os demais entram na grade automática de 18 px. Em GUI customizada, slots sem posição ficam apenas para automação.
O filter aceita item ou tag; sem filtro, o slot aceita qualquer item. Slots output não usam filtro.
Etapa 05 · opcional
Energia, fluidos, chemicals, mana e essentia
Define capabilities.energy, capabilities.fluids, capabilities.chemical, capabilities.mana, capabilities.essentia e os filtros de bloco em capability_ports. Itens usam o inventário da máquina; energia, tanques e essentia são opcionais.
capabilities
Sem capabilities; a máquina não expõe energia/fluidos/chemicals/mana/essentia.
capability_ports
Sem filtro; todas as capabilities usam qualquer bloco formado.
Sempre disponível via inventário. Use [] para não expor item.
Símbolos disponíveis no pattern: C, I.
Vazio libera a capability em qualquer bloco formado. Use [] para não expor nenhum bloco. Separe vários seletores por vírgula ou espaço.
energy.id é o identificador usado por uma energy_bar; fluids[].id identifica cada tanque e não é o tipo do fluido.
filter aceita um fluido ou tag, como minecraft:water ou #c:water.
fluids[].port limita o tanque a uma key do pattern (ex.: Z); sem ela, todos os ports de fluido acessam o tanque.
chemical.tanks[].filter aceita um chemical ou tag e pode listar vários separados por vírgula; portas chemical não usam port por tanque.
Chemical exige o addon Mekanism e aparece em chemical_bar com capability: "chemical" e slot igual ao id do tanque.
Mana usa um tanque único com capacity, aparece em chemical_bar com capability: "mana" e slot: "mana", e exige um addon que registre a capability mana.
Essentia usa range (1 a 32), aparece em resource_list com capability: "essentia" e width/height múltiplos de 18, e exige o addon Thaumaturge.
Etapa 06 · opcional
Controller único e receita
Todas as definições usam o mesmo bloco e item controller. Aqui você configura texturas opcionais por definição e a receita shaped que cria esse item.
controller compartilhado
Todas as definições usam o mesmo controller; as texturas por definição são opcionais.
O bloco, o item e o block entity são registrados uma única vez pelo mod:
infinity_nexus_multiblock:multiblock_controller
Cada definição é associada ao controller pelo componente infinity_nexus_multiblock:multiblock_definition.
textures
Sem texturas por definição; usa o modelo padrão do controller.
Ids completos como minecraft:block/stone. Faces omitidas caem no modelo padrão. particle cai em front quando vazio. Building herda idle/active; sem texturas por definicao, usa o modelo padrao com front_on_building.
Idle controller parado
Active opcional, controller processando
Building opcional, controller montando a estrutura
recipe
Sem receita shaped para o controller.
Pattern 3x3 clique na letra e depois no slot
Use o botão direito em um slot para apagar. A key abaixo acompanha automaticamente os símbolos usados.
Key automática informe apenas o item
Aceita item ou tag, como minecraft:iron_ingot ou #c:ingots/copper.
textures permite sobrescrever as texturas por definição (idle/active/building). O campo top-level recipe é opcional e gera data/<namespace>/recipe/controller/<path>.json com resultado infinity_nexus_multiblock:multiblock_controller.
Etapa 07 · opcional
GUI e elementos
Personaliza o layout da GUI. Sem uma GUI customizada, o loader usa 176x166 e o inventário do jogador.
gui
Sem GUI customizada; o loader usa o layout fallback 176x166.
Layout visual arraste para posicionar
Arraste energia, fluidos, progresso, entidade e demais elementos para ajustar x/y. Os campos numéricos continuam valendo para largura, altura e demais propriedades.
Novos elementos começam com o layout do spawner: título em 8,4, texto em 8,75, inventário em 8,84, barras em 158/148/138,10 com 8x64 e entidade em 96,18 com 36x36. Slots começam em 8,16 e avançam 18 px, com 9 por linha.
Elementos opcional
player_inventory. item_slots só é obrigatório quando houver elementos slot ou posições x/y; sem slots de item, a GUI pode ter só barras. Barras precisam apontar para a energia, o tanque ou a mana existente; resource_list exige capabilities.essentia, capability: "essentia" e width/height múltiplos de 18; progress_bar, arrow e entity só valem em máquinas type=recipe. entity mostra as entidades de inputs/outputs da receita, usa x/y/width/height e exige width/height múltiplos de 18 (mínimo 18), com paginação quando não couberem. Elementos slot usam a referência de item_slots; slots com x/y não podem ser misturados com eles.
Etapa 08 · opcional
Sons
Escolha um som vanilla na lista ou digite um namespace:path do seu próprio resource pack. processing toca enquanto a receita avança; finish toca ao completar.
sounds
Sem sons; a máquina permanece silenciosa.
Toca a cada 20 ticks enquanto houver progresso. Vazio desativa o som.
Toca uma vez quando a receita completa. Vazio desativa o som.
Carregando lista de sons vanilla...
data/minecraft_sounds.json, gerada a partir do sounds.json do Minecraft 26.1.2 (1902 eventos).
Você pode digitar qualquer identifier; para usar um som próprio, adicione a entrada em
assets/<namespace>/sounds.json e o arquivo .ogg correspondente.
Sons só são reproduzidos em máquinas type=recipe.
Etapa 09 · opcional
Receitas data-driven
Crie os arquivos de receita em data/<namespace>/recipe/. O tipo é fixo e o builder preenche definition automaticamente.
storage; receitas não serão processadas por ela. Use uma máquina type=recipe.
Receitas
Nenhuma receita adicionada.
inputs: lista tipada com item, fluid, entity e energy. Itens usam ingredient e count; fluidos usam ingredient e amount; entidades usam id ou tag (exatamente um, tag com #) e spawn opcional (sem seletor, a entidade de saída surge dentro da área do multibloco); energia usa amount. outputs: cada entrada aceita chance de 0 a 1 (default 1) e itens podem ter components. Cole o JSON do /inmb hand no id/tag para separar os campos automaticamente. O builder valida slots, tanques e capacidade de energia e limita a soma dos outputs. Toda receita usa type: infinity_nexus_multiblock:multiblock e recebe definition com o id desta maquina. O JEI mostra multiplos outputs e a chance de cada um. /inmb hand para gerar o input de ingredients e o objeto de output. O input não serve como output e vice-versa; no builder, cole o input no id/tag do ingrediente e o output no id da saída para separar os campos automaticamente. /inmb look envia o ID puro, o matcher completo e o state separado. No campo Bloco dos matchers, cole o ID puro ou o matcher completo: o builder separa bloco e propriedades automaticamente. As linhas no chat são clicáveis e copiam o texto. O alias /infinity_nexus_multiblock faz o mesmo.
Etapa 10 · opcional
Herança e templates
Compartilhe pattern, slots, capabilities e GUI com um pai usando extends ou family. O filho declara apenas o que muda.
Herança
Sem herança; a definição é autocontida.
Use apenas um dos dois; eles são equivalentes no loader.
ID completo de outra definição, de preferência um template. O pai é resolvido recursivamente.
Objeto aplicado depois dos campos do filho; vence qualquer campo igual. Arrays substituem o valor inteiro.
extends, family, overrides e template não são herdados. Ciclos, pai inexistente, os dois campos juntos ou overrides inválido são rejeitados pelo servidor.
Etapa 11 · revisão
JSON e checklist
Revise o resultado, copie o JSON e salve no caminho indicado. O jogo continua sendo a autoridade final.
Receitas
Arquivos separados em data/<namespace>/recipe/.
Assets e registro
O builder não cria PNGs, modelos ou classes Java. Confira os caminhos manuais.
JSON gerado
Somente a definição da máquina; receitas são exportadas separadamente.
Checklist do loader
As mesmas checagens que bloqueiam a exportação.
data/.../multiblock/....json exatamente com esse nome e rode /reload. O id é o caminho do arquivo: não renomeie depois de baixar. O controller é único e já registrado pelo mod; qualquer namespace pode apontar para ele.