NexusCore v1.2.0 Changelog

Summary

NexusCore v1.2 expands the library from registration, datagen, config, diagnostics, and compatibility helpers into a fuller gameplay-systems toolkit. This release adds machine processing, inventory transfer rules, side-aware energy and fluid storage, generated machine UI descriptors, worldgen helpers, entity descriptors, typed datapack loading, stronger diagnostics, new Gradle scaffolds, a much larger example mod, and new v1.2 documentation.

Added

Machine Framework

• Added NexusMachineDefinition and NexusMachines for describing and registering machine contracts.
• Added MachineRecipeDefinition for portable item, fluid, energy, timing, priority, group, and category recipe metadata.
• Added MachineProcessingEngine for ticking machine recipes against inventory, energy, fluid, redstone, side configuration, and upgrades.
• Added MachineProcessResult and MachineStallReason for clearer machine tick results and failure reasons.
• Added MachineUpgrade helpers for speed, energy, and capacity-style upgrades.
• Added MachineScreenLayout.generated(...) for generating standard machine UI layouts from machine definitions.
• Added PULSE to RedstoneControlMode and updated MachineState.redstoneAllows(...) to support pulse-style control.

Inventory Transfer

• Added SlotRole and SlotGroup for naming and categorizing machine inventory ranges.
• Added TransferRule, TransferResult, and InventoryTransfer for rule-based item movement.
• Added transfer actors for player, automation, and hopper-style routing.
• Added InventorySnapshot for capturing and diffing inventory changes.
• Added InventoryDropPolicy for documenting close, break, and migration behavior.

Energy And Fluid Systems

• Added NexusEnergyStorage, a side-aware extension of the existing energy storage API.
• Added EnergyAccess and NexusEnergyTransfer for direction-aware energy movement and traceable transfer results.
• Added NexusFluidTank, a side-aware extension of the existing fluid tank API.
• Added FluidAccess and NexusFluidTransfer for direction-aware fluid movement.
• Added storage builder APIs for capacity, IO rate limits, side access, filters, locked tanks, and change listeners.

Client Runtime And Machine UI

• Added ClientEffectSpec, ClientEffectRegistry, and ClientEffectRuntime for concrete client-side effects.
• Added runtime registration helpers for keybinds, HUD layers, entity renderers, block entity renderers, render layers, item colors, and block colors.
• Added NexusMachineScreen and NexusMachineScreens for rendering generated machine layouts with owo.
• Added machine screen support for progress arrows, energy bars, fluid tanks, redstone controls, side config controls, item slot groups, labels, text, buttons, and fallback custom widgets.
• Added a machine preview button to the NexusCore debug screen.

Worldgen

• Added NexusWorldgen and OreGenerationBuilder for descriptor-driven ore generation.
• Added BiomeSelector for include/exclude biome targeting.
• Added WorldgenValidationReport for ore descriptor validation.
• Added generated configured feature, placed feature, and NeoForge biome modifier output.
• Added a Fabric worldgen bridge that registers ore descriptors through Fabric biome modification hooks.

Entities And Combat Metadata

• Added NexusEntityDefinition, NexusEntityDefinitions, and RegisteredNexusEntity for entity descriptor registration.
• Added projectile descriptors through ProjectileDefinition.
• Added CombatProfile for describing damage, armor, toughness, knockback resistance, and loot-related combat metadata.
• Added entity descriptor datagen integration through NexusDataProvider.

Typed Resources And Datapack Loading

• Added TypedDataLoader<T> for schema-backed datapack JSON parsing.
• Added DataDrivenRegistry<T> for loading typed datapack values into a registry-style map.
• Added ResourceValidationReport for loaded/error/warning summaries.
• Added typed loader examples for ruby_traits in the example mod.

Security And Runtime Guards

• Added ClientActionGuard for validating client-originated actions before accepting them.
• Added PlayerAttachmentSpec for documenting player attachment sync, copy, persistence, and client-write policies.
• Added EventDiagnosticRegistry for event diagnostic metadata.
• Added MenuDebugInfo for menu inspection snapshots.

Commands And Diagnostics

• Added /nexus report machines, /nexus report worldgen, and /nexus report entities.
• Added /nexus validate machines, /nexus validate worldgen, and /nexus validate entities.
• Added /nexus inspect machine, /nexus inspect inventory, /nexus inspect energy, /nexus inspect fluid, and /nexus inspect menu.
• Added module metadata entries for nexus-machine, nexus-transfer, nexus-worldgen, nexus-entity, and nexus-resource.
• Added GameTest coverage for machine processing, inventory transfer traces, side-aware energy/fluid transfer, worldgen/entity descriptors, and typed datapack loader validation.

Gradle Plugin And Tooling

• Added scaffold tasks for:

  • nexusCreateMachine
  • nexusCreateMachineRecipe
  • nexusCreateEnergyStorage
  • nexusCreateFluidTank
  • nexusCreateWorldgenFeature
  • nexusCreateOreFeature
  • nexusCreateEntity
  • nexusCreateProjectile
  • nexusCreateDatapackLoader

• Added richer scaffold output that uses actual NexusCore APIs instead of placeholder classes.

• Added v1.2 to the generated documentation site version switcher.

• Added Team Reborn Energy API to release metadata output.

• Added Gradle TestKit coverage for the expanded plugin behavior.

Documentation

• Added a v1.2 docs set:

  • docs/v1.2/getting-started.md
  • docs/v1.2/machines.md
  • docs/v1.2/transfer-energy-fluid.md
  • docs/v1.2/client-runtime.md
  • docs/v1.2/worldgen-entities-resources.md
  • docs/v1.2/testing-diagnostics-gradle.md
  • docs/v1.2/migration-v1.1-to-v1.2.md

• Added docs/system-catalog.md as a broad subsystem reference.

• Added docs/example-mod-walkthrough.md as a guided tour of the example mod.

• Expanded the existing architecture, config, datagen, debugging, registry, machine, networking, testing, item/block, compatibility, getting started, and worldgen guides with v1.2 content.

Example Mod

• Added NexusCoreExampleSystems as a large subsystem exercise suite.
• Added a ruby press example using the new machine definition, recipe, processing engine, machine state, inventory, energy, fluid, layout, and bindings.
• Added a sapphire block set example with generated blockstates, models, loot tables, tags, and recipe output.
• Added ruby ore worldgen output for Fabric and NeoForge.
• Added a ruby marker entity descriptor example.
• Added generated datapack/resource examples, including ruby_traits/polished_ruby.json.
• Added example debug sections for machine state, validation, datapack loading, registry reports, benchmarks, and other subsystem snapshots.
• Expanded example recipe viewer coverage with fluids, animated progress, multi-page displays, catalysts, tooltips, transfer controls, and viewer-specific controls.

Changed

• Updated the project version from 1.1.0-build.2 to 1.2.0-build.2.
• Updated the version catalog from 1.1.0-build.1 to 1.2.0-build.1.
• Updated the README to describe v1.2 gameplay systems, transfer APIs, worldgen/entity descriptors, typed datapack loaders, generated machine UI, diagnostics, examples, and GameTests.
• Updated BaseMachineBlockEntity to use NexusEnergyStorage and NexusFluidTank internally while still exposing the older EnergyStorage and FluidTank return types.
• Added nexusEnergy() and nexusFluidTank() accessors to BaseMachineBlockEntity for code that wants the new side-aware APIs directly.
• Updated NexusDataProvider so registered worldgen and entity descriptor data is written automatically before generated assets/data are emitted.
• Updated generated release checklist guidance so Fabric and NeoForge GameTests are expected to finish without the old Architectury Transformer shutdown trace.
• Updated generated known-issues metadata to document the Architectury Transformer pin.

Fixed / Improved

• Pinned architectury-transformer to 5.2.91 to avoid the older post-success TransformerRuntime.removeDuplicates shutdown trace during GameTest runs.
• Ignored generated .architectury-transformer output so local transformer artifacts are not committed.
• Improved command diagnostics by making machines, worldgen, entities, inventory, energy, fluid, and menu state easier to inspect.
• Improved release confidence with expanded shared GameTest scenarios for both Fabric and NeoForge.
• Improved machine debugging by adding a debug-screen machine preview path.

Compatibility Notes

• v1.2 is intended to be additive and keeps v1.0/v1.1 stable APIs compatible.
• Existing v1.1 item, block, config, datagen, networking, recipe viewer, and diagnostics code should continue to work.
• Mods with exhaustive switch handling for RedstoneControlMode should add handling for the new PULSE value.
• Machine block entities can keep using the older energy/fluid accessors, but new code should prefer nexusEnergy() and nexusFluidTank() when side-aware behavior is needed.
• The recommended migration path is to move custom machine state, transfer routing, energy/fluid bridges, datapack parsing, worldgen, and entity metadata into the new v1.2 descriptor APIs over time.