EmakiStrengthen | Equipment Star Enhancement & Branch Growth

Added

• Config key release_default_data (default true); set false to stop writing the bundled sample strengthen recipes and script examples.
• Six configurable held-item actions: emakistrengthen_set_star, emakistrengthen_add_star, emakistrengthen_remove_star, emakistrengthen_reset_star, emakistrengthen_clear_layer, emakistrengthen_rerender.
• Localizable config precheck text and translatable load type names.
• Public API AttemptOutcome enum (NOT_COMMITTED, COMMITTED_SUCCESS, COMMITTED_FAILURE, COMPENSATION_PENDING), separating "the roll succeeded" from "the transaction committed".
• Public API idempotency key operationId, exposed through AttemptContext, AttemptResult (operationId(), outcome(), committed(), compensationPending()) and the attempt events.
• Optional soft dependency on EmakiItem, so the EmakiAttribute integration degrades gracefully when that plugin is absent.

Changed

• Economy charge failure changed from a direct refund to "rollback plus pending compensation": items and currency roll back separately and an incomplete rollback is reported as pending instead of being treated as refunded.
• StrengthenPreAttemptEvent.getTargetItem() now returns a defensive copy, so mutating it no longer affects the real strengthen input; success rate is clamped to 0-100 and non-finite values become zero.
• AttemptContext.materialInputs now keeps null placeholders so list indexes remain stable GUI slot identifiers. Callers that assumed "list length equals material count" are affected.
• The API no longer mutates the item stacks passed in through AttemptContext; callers apply AttemptResult.resultItem() themselves and handle external inventory material consumption themselves.
• Returning leftover materials after settlement now also clears the corresponding session slot state, and closing the GUI only closes the current session.
• Message prefix switched to a new brand gradient.
• api-version raised from 1.21 to 1.21.8; the build base moved from spigot-api to paper-api. Java target stays 25, folia-supported: true and the permission and subcommand sets (inspect/refresh/setstar/clearstate/clearcrack/givecatalyst) are unchanged.

Fixed

• A null-pointer in the strengthen result message path meant players received no result feedback in that case; the missing null check is added.
• /emakistrengthen reload replies are delivered on the sender's execution domain, which is required for correctness on Folia.

Removed

• The browser-based Web Console layer (web-console.yml, web-extensions/, the CSS asset, the web-console/ frontend project).
• The strengthen route preview capability, entirely. It only ever had a browser-side entry point (no in-game command or GUI), so the impact is limited to Web Console users.
• Record semantics for AttemptContext and AttemptResult, which changed from Java records to final classes. Accessor method names are preserved, but record pattern destructuring no longer works and reflection or serialization consumers relying on record semantics must adjust.
• The flat GUI slot item structure: item: "<MATERIAL>" with display_name, lore and hidden_components: [tooltip] becomes item.source with item.components.custom_name, item.components.lore and item.components.tooltip_display.hide_tooltip. Custom gui/strengthen_gui.yml must be migrated.
• The commands: section, as the descriptor moved to paper-plugin.yml. Paper is required.

Notes

• Requires EmakiCoreLib 4.6.0.
• Back up gui/strengthen_gui.yml and migrate it to the structure above; set release_default_data to false if you no longer want the bundled sample data written.
• After updating, run /emakistrengthen reload and verify the strengthen flow, material returns and result messages.