NexusCore

[1.1.0] - Production Hardening & Faster Mod Authoring

Highlights

• Added API stability annotations so public APIs can be marked as stable, experimental, internal, or deprecated.
• Added Nexus Doctor diagnostics and a new /nexus command tree for in-game validation and inspection.
• Added stronger release validation with API surface reports, binary compatibility checks, docs generation, and release metadata output.
• Added Datagen 2.0 helpers for incremental generation, validation reports, recipe diagnostics, golden files, and content manifests.
• Added data component helpers to reduce direct raw NBT usage for new item data.
• Added starter templates and an optional NexusCore Gradle plugin for faster project setup and scaffolding.

Added

API lifecycle and stability

• Added @NexusStable, @NexusExperimental, @NexusInternal, and @NexusDeprecated annotations.
• Added API surface report generation for release review.
• Added JApiCmp-based binary compatibility checking through checkBinaryCompatibility.
• Added checkStableApiCompatibility to enforce explicit stability annotation coverage.
• Added api-baselines/README.md for ABI baseline guidance.

Developer workflow and Gradle tooling

• Added the nexus-gradle module.
• Added optional Gradle plugin support with project setup and scaffolding tasks.
• Added scaffold tasks for items, blocks, block sets, config, packets, screens, GameTests, and compatibility modules.
• Added runNexusValidation to run release validation and write CI-friendly reports.
• Added generateDocsSite for a versioned documentation site with search.
• Added generateReleaseMetadata for dependency tables, loader support matrix, release checklist, and known release notes.
• Added gradle/nexuscore.versions.toml.

Diagnostics, commands, and debugging

• Added NexusDoctor, doctor reports, issue severities, crash hint classification, and error references.
• Added /nexus version.
• Added /nexus doctor.
• Added /nexus dump registries.
• Added /nexus dump content.
• Added /nexus dump config-schema.
• Added /nexus dump packets.
• Added /nexus validate assets, /nexus validate tags, and /nexus validate recipes.
• Added /nexus inspect held-item.
• Expanded the debug screen with Doctor and network diagnostics sections.
• Added NexusProfilerHud for runtime profiler display.

Datagen and validation

• Added content ownership tracking through nexus.content.json.
• Added NexusContentManifest for generated and registered content metadata.
• Added IncrementalDatagen for hash-based incremental output.
• Added DatagenReportWriters for JSON, Markdown, and HTML reports.
• Added RecipeDiagnostics for recipe conflict checks.
• Added GoldenFiles helpers for generated output snapshots.
• Expanded NexusDataValidator and validation reports.
• Added generated example resources for sapphire block and ore content.

Config schema, sync, and migrations

• Added ConfigSchemaExporter for JSON schema and Markdown documentation.
• Added ConfigDependencyGraph for dependency and conflict analysis.
• Added ConfigSyncDiagnostics for client/server config comparison.
• Expanded config options with metadata for grouping, translation keys, visibility, dependencies, conflicts, restart/world reload flags, and server sync behavior.
• Added migration diagnostics with NexusMigrations, MigrationDiagnostics, MigrationIssue, and migration severity tracking.

Data components

• Added NexusComponents, NexusComponentBuilder, and NexusComponentSpec.
• Added component copy strategies, component debug output, and NBT-to-component migration helpers.
• Added item component support with codecs, network sync, defaults, caching, tooltips, validation, and recipe-aware metadata.

Networking

• Added protocol version diagnostics to networking channels.
• Added packet diagnostics output through /nexus dump packets.
• Added NetworkMonitor for packet count, byte size, and exception summaries.
• Added PacketTestHarness for packet encode/decode round-trip testing.
• Added RequestResponse, SyncBatcher, and SyncProfile helpers.

Recipe viewer compatibility

• Added RecipeViewerControlSupport with a portable support matrix for JEI, EMI, and REI controls.
• Added factory helpers for advanced controls such as tooltips, buttons, recipe transfer buttons, recipe trees, hide-craftable toggles, shapeless markers, and badges.
• Added deterministic fallback text for unsupported advanced recipe viewer controls.
• Added optional strict mode for recipe viewer controls that should fail when unsupported.
• Updated Fabric and NeoForge JEI, EMI, and REI integrations to handle the expanded control model.

Content builders and registries

• Added NexusBlockSet and NexusBlockSets for faster creation of related block families.
• Added helpers for gem, stone, metal, and decorative block sets.
• Added registry group child groups, tags, default creative tabs, translation prefixes, asset path prefixes, datagen defaults, and validation rules.
• Added content manifest recording for registry entries.
• Added data component registration support in registry groups.

Machines, inventory, menus, and UI

• Added MachineStatus, ProcessingTimer, RedstoneControl, and SideConfiguration.
• Expanded MachineState with more status and runtime information.
• Added InventoryLayouts.
• Added MenuBinding.
• Added UI form helpers with FormBuilder, FormField, and WidgetDescriptor.
• Added ScreenRouter for simple screen navigation and breadcrumbs.

Performance and testing

• Added BenchmarkCase, BenchmarkResult, BenchmarkSuite, NexusBenchmarks, NamedProfiler, and reload-aware memoized suppliers.
• Added benchmark Markdown output for CI-friendly reports.
• Added GameTest scenarios for config schema export, datagen validation, packet diagnostics, recipe viewer controls, and performance benchmarks.
• Added new GameTest structures for v1.1 scenarios.

Compatibility and safe loading

• Added CompatModuleLoader for optional integrations.
• Added SafeClassloading helpers.
• Expanded compatibility module metadata with optional mod requirements and config enablement checks.

Documentation and templates

• Added versioned v1.1 docs for API stability, Datagen 2.0, config schema sync, packet protocols, performance benchmarks, recipe viewer controls, Nexus Doctor, testing/CI, compatibility modules, troubleshooting, and migration.

• Added starter templates:

  • minimal-item-block
  • block-entity
  • config-driven
  • content-heavy
  • library-consumer
  • test-first
  • ui-heavy

Changed

• Updated project version metadata from 1.0.0-build.3 to 1.1.0-build.2.
• Updated the README to describe v1.1 as a production hardening and authoring-speed release.
• Expanded the /nexus command builder with nested command support and usage preview helpers.
• Expanded the debug screen to show Nexus Doctor and network channel diagnostics.
• Expanded NexusEnvironment with additional environment/version support.
• Expanded registry groups to support richer metadata and generated content tracking.
• Expanded datagen validation and reports.
• Expanded networking diagnostics with protocol versions and packet IDs.
• Expanded recipe viewer integrations across Fabric and NeoForge.
• Expanded the example mod with generated sapphire block and ore resources.
• Expanded Fabric and NeoForge GameTest registration to cover the new v1.1 scenarios.

Migration Notes

• v1.1 is intended to keep v1 source compatibility for existing item, block, config, networking, and recipe viewer code.

• Existing mods can keep using v1 APIs and adopt the new v1.1 APIs gradually.

• Recommended upgrades:

  • Mark public extension APIs with @NexusStable or @NexusExperimental.
  • Use RecipeViewerDisplay.builder(...) and the new advanced control helpers for custom recipe viewer layouts.
  • Use ConfigSchemaExporter to publish config documentation.
  • Use NexusNetworking.channel(...).protocolVersion("1.1") for clearer protocol diagnostics.
  • Use NexusComponents for new item data instead of raw NBT.
  • Run runNexusValidation in CI.
  • Use NexusMigrations.forMod(modid).removedConfigKey(...) to report removed config keys.