v1.0.2 - NeoForge 1.21.1

v1.0.2 - NeoForge 1.21.1

Per-Entry Config Gating

• config/Entries.java - universal TOML toggle per ModEntryBuilder registration, default enabled
• ModEntry.isEnabled() - single accessor read live per-call, so config reload takes effect without restart
• Enforced in creative tab (every entry kind), GlobalBlockEntity.serverTick (disabled = inert), and block menu open
• Disabled entries stay registered (inert + hidden), not unregistered; Processors aligned to the unified gate

New Registry Builders

• Registers: PARTICLE_TYPES, ENTITY_TYPES, SOUND_EVENTS, MOB_EFFECTS, ATTACHMENT_TYPES
• ModEntryBuilder: addParticleType, addEntityType, addSoundEvent, addMobEffect, addWorldCapability, addEntityCapability
• World/entity persistent data backed by AttachmentType (uniform DeferredRegister path)

Catalyst System

• CatalystType (ENERGY / SPEED / EFFICIENCY), abstract Catalyst with power + preTick/postTick, CatalystRegistry, CatalystDef, CatalystFactory
• Concrete EnergyCatalyst, SpeedCatalyst, EfficiencyCatalyst
• ModEntryBuilder.addCatalyst(name, type, factory) registers the catalyst item + def; .catalysts(types...) declares processor support
• UniversalProcessorBE attaches active catalysts from the catalyst slot and runs hooks around operation; power = catalyst item count

Tag-Based Recipe Outputs

• Item and fluid recipe outputs may be tags; recipe/ItemOutput + recipe/FluidOutput union types with either-form codecs
• TagOutputResolver resolves a tag to one concrete stack via mod_tag_priority (config/Common); global cache refreshed on config reload
• Empty tags mark a recipe incomplete (runtime skip); item-tag datagen emits a NOT(tag_empty) condition (no native fluid-tag condition in NeoForge 21.1.228)
• UniversalProcessorRecipe carries union outputs + getOutputStack/getOutputFluidStack; RecipeInfo.produceOutputs resolves at production
• JEI/EMI display all tag members, priority-ordered

Custom Rendering

• BillboardingEffectRenderer - draws a camera-facing animated sprite at any world position
• CustomEffect - billboard descriptor (texture sprite-sheet grid, position, RGBA color, scale)
• DelayedRenderHandler - per-frame translucent render queue; depth-sorted, flushed at AFTER_TRANSLUCENT_BLOCKS, translated to world origin
• DistortShader - screen-space lens distortion post effect; DistortionSource registry keyed by arbitrary object; depth-buffer occlusion; per-source radius/magnification
• ModRenderType.BILLBOARD render type + ModShaders (billboard core shader + distort post chain), auto-registered via RegisterShadersEvent
• Shaders: rendertype_billboard core (POSITION_TEX_COLOR), distort post chain + program GLSL

Docs

• docs/entry-config-gating.md - per-entry config gating guide
• docs/registry-builders.md - new registry builder reference
• docs/catalysts.md - catalyst system guide
• docs/tag-outputs.md - tag-based recipe output guide
• docs/custom-rendering.md - billboard + distortion guide with worked "Anomaly" block chain example (block + block entity + BlockEntityRenderer)

v1.0.1 - NeoForge 1.21.1

v1.0.1 - NeoForge 1.21.1

Multiblock API

• MultiblockEntryBuilder - fluent registration for controller + ports, casing/interior block predicates, or NBT structure templates
• MultiblockRegistry holds all multiblock entries; capabilities auto-wired in Main.registerCapabilities
• IMultiblockValidator / IMultiblockLogic / IMultiblockCache interfaces with default impls (CubicMultiblockValidator, DeterminedMultiblockValidator, MultiblockLogicImpl, MultiblockCacheImpl)
• MultiblockPattern + BlockPredicate for declarative shape definitions
• MultiblockStructure + .nbt template loading for arbitrary structures
• MultiblockControllerBlock / MultiblockPartBlock with form/break lifecycle and port linking
• MultiblockControllerBE / MultiblockPartBE - controller aggregates port I/O; ports forward capabilities to controller
• MultiblockControllerContainer / MultiblockPortContainer + screens with structure preview
• StructurePreviewRenderer - in-world ghost rendering of unformed structure
• PacketMultiblockFormed / PacketMultiblockBroken network sync
• multiblocks TOML config gates entries

Recipe Integration

• JEI: MultiblockExampleCategory + MultiblockStructureRecipe show multiblock assembly
• EMI: MultiblockExampleEmiRecipe mirrors JEI integration
• KubeJS: multiblock recipe schema (foo_controller/dirt_silver_to_water example)
• FooMultiblockRecipes datagen example

ComputerCraft

• ControllerPerihperal - peripheral exposing multiblock controller state, I/O, recipe progress to CC programs

Example Content

• foo_controller + foo_port blocks demonstrating full multiblock setup
• foo_multiblock.nbt example structure

Docs

• docs/multiblocks.md - full multiblock registration guide

v1.0.0 - NeoForge 1.21.1

Release Notes

v1.0.0 - NeoForge 1.21.1

Core Framework

• Single-point registration via ModEntryBuilder - one builder chain registers block, block entity, menu, screen, recipe type, serializer, and creative tab entry
• ModEntry record holds all deferred references in one object

Machine / Processor System

• Universal processor block, block entity, container, screen, and recipe classes - reusable across any machine type
• Side configuration system: per-slot, per-face push/pull/disable for items and fluids; NBT-persistent; auto-transfer via SidedContentHandler
• Block updates propagated on content handler changes

GUI

• Energy bar widget (EnergyBar) - renders live FE fill bar with hover tooltip
• Slot layout fixes and GUI rendering improvements
• Side config button and panel
• Fluid rendering in GUI

Materials

• addMetalOreMaterial / addCrystalOreMaterial - registers full material set (ore, ingot, dust, plate, nugget, raw ore, storage block, molten fluid, bucket) from one call
• Fluid, item, and block tags auto-registered per material

World Generation

• Automatic ore worldgen: configured features, placed features, and biome modifiers auto-registered when worldgenQty > 0
• Height range and vein counts driven by live TOML config

Recipe Integration

• JEI: dynamic category, catalyst, and recipe registration for every processor entry
• EMI support - recipe viewer integration + transfer to AE2 pattern encoder
• KubeJS: processor recipe schemas auto-registered for all entries
• Recipe datagen via UniversalProcessorRecipeBuilder (fluent API, item/fluid I/O, process time, energy cost)
• Incomplete recipes filtered from displays

Networking

• Network sync for GUI fluid/item state

Datagen

• Providers: block states, item models, loot tables, recipes, tags (block/item/fluid), language files
• Dynamic JEI category datagen