MultiblockEngine

Breaking changes:

- Refactored service implementations and extracted core tool contracts (ToolModeExecutionService, ToolModeMetricsService, ToolSessionService) into the public API (dev.darkblade.mbe.api.tool.*). - Relocated UIRuntimeRegistry to dev.darkblade.mbe.api.ui.runtime and updated UI service implementation references across core and addon modules.

Internal changes:

- Introduced AddonContext#registerMultiblockDirectory allowing addons to dynamically inject custom multiblock directory paths into the core structure catalog. - Added PanelDirectoryRegistry and PanelMappingRegistry to dev.darkblade.mbe.api.ui for dynamic panel directory management and mapping resolution. - Enhanced structure preview and blueprint placement system with Rotation support, DisplayEntityRenderer updates, PreviewPlacementController controls, and PacketEventsRendererBridge integration. - Refactored PdcItemStackBridge for improved item persistent data container (PDC) operations. - Added CodeMC Maven repositories (maven-releases and maven-snapshots) to the root build configuration. - Standardized project documentation, agent skills, and AGENTS.md to English.

Bug fixes:

- Fixed a premature dependency check execution in AddonRuntimeLifecycleService during addon initialization. - Resolved API dependency resolution across subprojects by enforcing project-level dependency references. --- Changes made by: [@DarkBladeDev](https://github.com/DarkBladeDev) Full Changelog: [4.8.5...4.9.1](https://github.com/Parallax-Development/MultiBlockEngine/…

Breaking changes:

- Removed legacy MBEServiceRegistry from the core implementation. Addons directly depending on this internal core class instead of the standard API will no longer load.

Internal changes:

- Cleaned up and improved plugin startup logs for better readability. - Bumped project version to 4.8.5.

New features:

- Extended Addon Metadata: Added support for new addon.yml fields including name, description, website, authors, capabilities, load-before, load-after, and environment. - Runtime Environment Constraints: The engine now strictly validates the environment section of addon.yml, ensuring required Java, Minecraft, and Bukkit plugin versions are met before loading an addon. - Capabilities System for Protected APIs: Addons utilizing protected core APIs (e.g. UI, Energy, Wiring, Persistence) must now explicitly declare the required capabilities in their configuration. - Enhanced Dependency Resolution: Integrated load-before and load-after directives as soft edges in the dependency graph, providing precise control over addon initialization order.

Bug fixes:

- Fixed a cyclic dependency issue in DependencyGraphResolver where a soft dependency conflicting with a hard dependency could cause infinite loops or crashes during initialization. --- Changes made by: [@DarkBladeDev](https://github.com/DarkBladeDev) Full Changelog: [4.7.5...4.8.5](https://github.com/Parallax-Development/MultiBlockEngine/…

Breaking changes:

- Command System: The main monolithic command (MultiblockCommand) has been completely removed and refactored into separate commands using the [Incendo command framework](https://cloud.incendo.org/minecraft/paper/). This may affect administrators or third-party integrations if they relied on the old command structure or its specific permissions.

Internal changes:

- Command System: Complete refactoring of commands into a modular structure based on Cloud (BlueprintCommand, DebugCommand, ExportCommand, MiscCommand), which facilitates scalability and maintenance. - Architecture: The core MultiBlockEngine class was introduced to centrally initialize the application’s infrastructure and services. - Architecture: Architectural issues related to excessive coupling of the EventBus and the service loading system were resolved. - Event System: The base interface MBEEvent and the EventBusService were added to standardize and improve the handling of internal events. - Lifecycle: The MultiblockListener class was refactored, delegating its business logic to the new MultiblockLifecycleService to maintain separation of concerns. - Platform API: The MBEItemStack abstraction was introduced into the API (along with its implementation, BukkitMBEItemStack) for better cross-platform item handling.

Bug fixes:

- WorldEdit Compatibility: Fixed a bug in the MultiblockListener that caused interaction issues when using WorldEdit’s selection tool (wand). --- Changes made by: [@DarkBladeDev](https://github.com/DarkBladeDev) Full Changelog: [3.7.5...4.7.5](https://github.com/Parallax-Development/MultiBlockEngine/…

Breaking changes:

- Command System: The main monolithic command (MultiblockCommand) has been completely removed and refactored into separate commands using the [Incendo command framework](https://cloud.incendo.org/minecraft/paper/). This may affect administrators or third-party integrations if they relied on the old command structure or its specific permissions.

Internal changes:

- Command System: Complete refactoring of commands into a modular structure based on Cloud (BlueprintCommand, DebugCommand, ExportCommand, MiscCommand), which facilitates scalability and maintenance. - Architecture: The core MultiBlockEngine class was introduced to centrally initialize the application’s infrastructure and services. - Architecture: Architectural issues related to excessive coupling of the EventBus and the service loading system were resolved. - Event System: The base interface MBEEvent and the EventBusService were added to standardize and improve the handling of internal events. - Lifecycle: The MultiblockListener class was refactored, delegating its business logic to the new MultiblockLifecycleService to maintain separation of concerns. - Platform API: The MBEItemStack abstraction was introduced into the API (along with its implementation, BukkitMBEItemStack) for better cross-platform item handling.

Bug fixes:

- WorldEdit Compatibility: Fixed a bug in the MultiblockListener that caused interaction issues when using WorldEdit’s selection tool (wand). --- Changes made by: [@DarkBladeDev](https://github.com/DarkBladeDev) Full Changelog: [2.7.5...3.7.5](https://github.com/Parallax-Development/MultiBlockEngine/…

Breaking changes:

- Restrictions that prevented add-ons from exposing their own services have been removed.

Internal changes:

- Packet handling has been migrated from ProtocolLib to PacketEvents. --- Changes made by: [DarkBladeDev](https://github.com/DarkBladeDev) Full Changelog: https://github.com/Parallax-Development/MultiBlockEngine/…

Minor changes and fixes in internal components

Full Changelog: https://github.com/Parallax-Development/MultiBlockEngine/…

v1.3.4 is here!

The project has undergone a significant restructuring, moving towards a more modular architecture driven by services and addons.

New Features

Core System and Architecture

- Centralized Tick System: Introduction of a central TickService for managing scheduled tasks. - Event-Based Service Discovery: New lifecycle and service discovery system based on events for total decoupling. - Metadata System: Implementation of a robust metadata system with integration for placeholders. - Block Registry: New central infrastructure for defining and registering custom blocks. - Preview Rendering: Structure preview system with blueprint construction guide using versioned Block Displays. - Structured Assembly Pipeline: Improvement in multiblock detection with configurable limits and detailed reports. - TrustedCommandService: Service for secure command execution with trust validation.

Addons System

- Resource Management: Added getResource and saveResource methods in AddonContext to facilitate configuration file handling by addons. - Addon Commands:** Support for registering custom commands directly from addons, including autocompletion (tab-completion). - Service API Control: Implementation of configurable policies to enforce API types in addon services.

UI and Interaction

- Inventory UI Engine: New decoupled graphical interface engine with integration for the blueprint catalog. - Runtime Panel Registration: Dynamic system to register and manage the lifecycle of UI panels. - Blueprint Crafting: Dedicated system for crafting blueprints with UI session management and slot roles. - Interaction Actions: New OpenPanelAction that allows triggering interfaces through interactions with world blocks. - Inventory Compatibility: Reflection-based compatibility service for inventory views.

Tools and Objects

- Tool System: Full implementation of a tool system with actions, switchable modes, and a centralized dispatcher. - Wrench: Improved assembly logic to provide better feedback and handle non-critical failures.

Internationalization (i18n)

- Centralized Messaging: Centralization of all plugin messages through translation keys. - Player-Sensitive i18n: Support for translations based on the client's language for holograms and item generation. - PlayerMessageService: Unified service for sending messages to players.

Refactoring and Cleanup

- Module Renaming: The core-api module has been renamed to api for greater clarity. - Network Topologies: Introduction of NetworkType to support multiple network types in the wiring system. - Dependency Resolution: Replacement of manual topological sorting with a generic implementation of DependencyGraphResolver. - Tool Modularization: Tool actions and modes are now managed through a registry system. - Legacy Removal: The old cross-reference system was removed in favor of the new service discovery system.

Submodules and Ecosystem

The following addons have been integrated as official submodules: - mbe-wiring: Physical wiring and network system. - mbe-ui: User interface extensions. - mbe-crafting: Building and crafting mechanics.

Fixes

- Support for tool interactions with air and handling of null blocks in wrench actions. - Adjustment of log levels (from WARN to TRACE) for expected failures in assembly trigger fallback. - Minor corrections in README and license links. - Improvements in thread safety (concurrency) for theappearance of holograms. ---

Improved the parsing of complex multiblocks.

Full Changelog: https://github.com/DarkBladeDev/MultiBlockEngine/compare/…

MultiBlockEngine

0.3.0-beta — 2026-01-05

Added

- Internationalization (i18n) system with locale-specific message support. - Menu (UI) API with interfaces for handling user interactions. - Item system, including: - Centralized registry - Factories - Bridge services for integration with external systems - Storage API fully integrated into the core. - UI services designed to be modular and reusable. - Service exposure for addons, allowing addons to safely consume core services.

Refactored

- Core API moved into a separate module, improving: - Maintainability - Dependency clarity - Foundations for a more robust addon ecosystem

Logging

- Structured logging system, designed for improved traceability and advanced debugging. - Improved addon dependency resolution logs, providing clearer and more actionable messages.

Implement addon dependency resolution and service registry

Full Changelog: https://github.com/DarkBladeDev/MultiBlockEngine/compare/…

Changelog — MultiBlockEngine

0.2.1-beta

Changed

- Project version updated to 0.2.1-beta. - Internal adjustments to stabilize the API and addon system. ---

0.2.0-beta

Added

- Addon system with namespaces and multiblock capabilities. - Public multiblock API ready for external extensions. - Advanced conditional actions system with variable support. - Conditions system with player context. - Rotation and state support for multiblock structures. - Actions with target selection. - Display names for multiblocks. - Debug system for structure validation. - /multiblock debug command with tab completion. - PlaceholderAPI integration. - Instance validation before spawning holograms.

Refactored

- Centralized placeholder parsing. - Fixed duplicated event execution. - Refactored MultiblockManager, isolating tick cancellation logic. - General security improvements for actions and addon handling.

Changed

- Gson moved from implementation to compileOnly. - Adjustments to the actions system for improved robustness. - Improved multiblock validation and execution flow.

Fixed

- Issues with multiple event executions. - Edge cases in multiblock instance validation. - Potential errors in misconfigured actions. ---

0.1.x — Initial versions

Added

- MultiBlockEngine core. - Base engine for detecting and managing multiblock structures. - Basic actions and states for multiblocks. - Initial variables system. - Early rotation support. - Controller blocks syntax. - Initial documentation and project roadmap.