EmakiStrengthen | Equipment Star Strengthening

### Added - Provider-based equipment, affix, and gem enhancement targets; affix progression; multi-track pity; item mastery; and explicit cost-consumption timing. ### Optimised - New target transactions use snapshots, validation, compensation-aware results, persistent pity state, and retry diagnostics. ### Breaking Changes - Migrate legacy `match`/`source_ids` conditions and related star-recipe fields to the current matcher/target schema; migrate historical enhancement PDC keys through CoreLib. ### Upgrade Notes - Back up configuration, player items, and pity state; preview the legacy conversion; then test every target mode, cost boundary, failure/refund path, pity track, mastery flow, branch, and optional integration.

### Added - Public API `StrengthenTransferOutcome` and `StrengthenTransferCompletedEvent`, fired once a star transfer completes, carrying the source, target, target recipe id, source star and decay rate. - Public API `catalog().successRate()`, `catalog().recipes()`, `catalog().recipe(String)`, `operations().transfer()`, `operations().refreshItem()`, `operations().refreshPlayer()` and `operations().openGui()`. ### Changed - Actions use a new syntax, and you do not have to rewrite anything yourself. On first startup CoreLib rewrites the config files of every Emaki plugin under `plugins/`, once only. Each edited file keeps the original beside it with a `.legacy-backup` suffix. A line that cannot be converted leaves your config untouched and goes into a separate `.v2-failed` file, with the file and line listed in the console. - The six strengthen actions are yours to rename by hand; automatic rewriting does not cover them. Drop the `emakistrengthen` prefix for `strengthen`: - `emakistrengthen_set_star` → `strengthen_set_star` - `emakistrengthen_add_star` → `strengthen_add_star` - `emakistrengthen_remove_star` → `strengthen_remove_star` - `emakistrengthen_reset_star` → `strengthen_reset_star` - `emakistrengthen_clear_layer` → `strengthen_clear_layer` - `emakistrengthen_rerender` → `strengthen_rerender` - Strengthen variables inside a recipe's `actions:` block need a `var.` prefix, also by hand. What used to be `%star%` is now `%var.star%`. Available names: `star`, `temper`, `was_star`, `dropped`, `protected`, `operation_id`, `strengthen_star`, `strengthen_temper`, `strengthen_recipe`, `strengthen_recipe_id`, `strengthen_max_star`, `strengthen_success_rate`, `strengthen_show_item`, `strengthen_result_slot`, `strengthen_operation_id`. The old `%show_item%` is gone; use `%var.strengthen_show_item%`. - Placeholders elsewhere in a recipe are unchanged: `%star%`, `%temper%`, `%max_temper%` and `%temper_color%` in `lore_actions` and `name_actions`, and `%base_cost%` and `%star%` in `cost_formula`. Only action lines take the prefix, and adding it elsewhere breaks them. - The preview, temper and confirm slots are supplied through placeholders. If you keep your old `gui/strengthen_gui.yml`, set `custom_name` of `preview_display` to `%preview_title%` and its `lore` to a single `%preview_lines%`; set the `lore` of `temper_display` to a single `%temper_lines%`, keeping your own title; set `custom_name` of `confirm` to `%confirm_title%` and its `lore` to a single `%confirm_lines%`. Each placeholder expands one entry per line, so no extra lines are needed. The wording lives under `gui.preview.*`, `gui.temper.*` and `gui.confirm.*` in the lang files. - "Forge mark" and "crack" are both called temper now, renamed from `Crack` to `Temper` in English, across GUI titles, the messages and help text of `/emakistrengthen clearcrack`, the failure messages, and the sample recipe comments and lore. The `clearcrack` command name, the permissions, the config keys (`max_temper`, `temper_chance_bonus_per_level`, `temper_boost`) and the placeholder names are unchanged; only player-facing wording moved. - Config check lines in the console are coloured by severity, yellow for warnings and red for errors. - A star transfer attempted without ownership of the target player's thread fails outright instead of skipping `StrengthenTransferEvent` and completing anyway, which used to bypass third-party listeners. - For developers: `EmakiStrengthenApi.available()` is replaced by `status()`, returning `ApiStatus`. `canStrengthen()`, `readState()`, `preview()`, `attempt()` and `rebuild()` move behind `catalog()` for read-only queries and `operations()` for state changes. Every fallible call returns `EmakiResult<T>`, and an absent plugin yields `EmakiResult.unavailable()` instead of throwing or returning a fabricated empty object. `EmakiStrengthenApi.Bridge` is now `@ApiStatus.NonExtendable`, and `install()`/`uninstall()` are `@ApiStatus.Internal`. - For developers: the model classes move from `emaki.jiuwu.craft.strengthen.model` to `emaki.jiuwu.craft.strengthen.api.model` (`AttemptContext`, `AttemptResult`, `AttemptPreview`, `AttemptCost`, `AttemptMaterial`, `AttemptOutcome`, `StrengthenState`, `StrengthenRecipe` and the rest). Contract types such as `EmakiResult`, `ApiStatus` and `ItemSourceRef` come from `emaki.jiuwu.craft.corelib.api`, so the build base needs CoreLib's API artifact too. ### Fixed - The preview, temper status and confirm slots in the strengthen GUI showing nothing but fixed text, with no success rate, cost, failure penalty, material checklist or current temper. Those three slots configure their own name and lore in `gui/strengthen_gui.yml`, and that config overwrote everything the plugin had worked out, so players only ever saw the two hint lines from the file. Content is fed into placeholders now: your config owns the layout, the plugin supplies the live values. The material checklist is not new work either, it was always being worked out and simply swallowed; this is the first time you get to see it, listing every material the current star needs one per line, counted as "amount placed in the GUI / amount required", green when satisfied and red when short, with any other materials already in the GUI in their own section. - The confirm button keeping its anvil icon while requirements were unmet, which made it look clickable. It switches to `BARRIER` with a "cannot strengthen" title as intended. - `gui_template` in a recipe being ignored. The key was always accepted but never read, so every item opened `strengthen_gui` regardless. The GUI now follows the recipe matched by the item in hand and falls back to `strengthen_gui` when the named template does not exist. - A broken config being half applied. `/emakistrengthen reload` could leave the language file swapped while the recipes had failed to load, stranding the server between old and new. Everything is checked as a set first, and a failure keeps the whole previous config active, with the offending file and line named in the console. ### Removed - JS scripting, including strengthen chance rules (`registerChanceRule`) and result hooks (`onResult`). There is no automatic conversion, so use a recipe's `condition` and `actions` for the same effect. The bundled `scripts/examples/strengthen_success.js` sample is gone as well. - `EmakiStrengthenApiProvider`; call the static methods on `EmakiStrengthenApi` directly. - `EmakiStrengthenApi.canStrengthen()`, with no direct replacement. Decide it yourself from `catalog().readState()`. ### Notes - Update EmakiCoreLib to `4.7.0` first. - Back up your whole `plugins/EmakiStrengthen/` folder before upgrading, especially `gui/strengthen_gui.yml` and `recipes/`. - Four things need doing by hand: renaming the six `emakistrengthen_*` actions, prefixing strengthen variables in recipe action lines with `var.`, rewriting JS chance rules and result hooks as recipe conditions and actions, and converting the three display slots in an old `gui/strengthen_gui.yml` to the placeholder form. Everything else is rewritten for you. - Strengthen layers, stars and temper already on player equipment are unaffected and need no migration. The recipe structure itself has not changed; only the writing inside `actions:` needs adjusting. - After updating, run `/emakistrengthen reload` and open the strengthen GUI to confirm the success rate, cost and material checklist all show up. # Emaki Strengthen v4.6.0 ## MineBBS 更新日志 ### 破坏性变更与必要迁移 - 【破坏性】GUI 槽位物品结构改为嵌套组件：原 `item: "<MATERIAL>"` 搭配 `display_name`、`lore`、`hidden_components: [tooltip]`，现改为 `item.source` 搭配 `item.components.custom_name`、`item.components.lore`、`item.components.tooltip_display.hide_tooltip`。自定义 `gui/strengthen_gui.yml` 必须迁移。 - 【破坏性】插件描述文件迁移到 `paper-plugin.yml`，其中的 `commands:` 段已移除，必须使用 Paper 系服务端。 - 【破坏性】`AttemptContext` 与 `AttemptResult` 从 Java record 改为 final 类：访问器方法名保持不变，但 record 模式解构不再可用，依赖 record 语义的反射或序列化使用方需要调整。 - 【移除】浏览器端 Web Console 层整体移除：`web-console.yml`、`web-extensions/`、对应的 CSS 资源以及 `web-console/` 前端项目。 - 【移除】强化路线预览能力整体移除。它此前只有浏览器端入口，没有游戏内命令或 GUI，因此影响范围仅限 Web Console 用户。 ### 新增功能 - 新增配置项 `release_default_data`（默认 `true`）；设为 `false` 后不再释放自带的示例强化配方与脚本示例。 - 新增六个可配置手持物品动作：`emakistrengthen_set_star`、`emakistrengthen_add_star`、`emakistrengthen_remove_star`、`emakistrengthen_reset_star`、`emakistrengthen_clear_layer`、`emakistrengthen_rerender`。 - 配置预检文本可本地化，加载类型名称可翻译。 - 公开 API 新增 `AttemptOutcome` 枚举（`NOT_COMMITTED`、`COMMITTED_SUCCESS`、`COMMITTED_FAILURE`、`COMPENSATION_PENDING`），把「判定成功」与「事务已提交」区分开。 - 公开 API 新增幂等键 `operationId`，通过 `AttemptContext`、`AttemptResult`（`operationId()`、`outcome()`、`committed()`、`compensationPending()`）以及强化尝试相关事件暴露。 - 新增对 EmakiItem 的可选软依赖；未安装该插件时，EmakiAttribute 对接会降级运行，不再直接失败。 ### API 行为调整 - `StrengthenPreAttemptEvent.getTargetItem()` 改为返回防御性副本，修改它不再影响真正的强化输入；成功率会被限制在 0–100，非有限数值按 0 处理。 - `AttemptContext.materialInputs` 现在保留 null 占位，使列表下标可以继续作为稳定的 GUI 槽位标识。此前假设「列表长度等于材料数量」的调用方会受影响。 - API 不再修改通过 `AttemptContext` 传入的物品堆：调用方需要自己应用 `AttemptResult.resultItem()`，并自行处理外部背包中的材料消耗。 ### 结算与会话可靠性 - 经济扣费失败的处理从直接退款改为「回滚加待补偿」：物品与货币分别回滚，未完成的回滚会被报告为待补偿，而不是当作已退款。 - 结算后返还剩余材料时会同时清理对应的会话槽位状态，关闭 GUI 只会关闭当前会话。 - 消息前缀更换为新的品牌渐变配色。 ### 修复 - 强化结果消息路径存在空指针，导致该情况下玩家收不到结果反馈；现已补上缺失的空值检查。 - `/emakistrengthen reload` 的回复改为在发送者自身的执行域上送达，这是 Folia 上的正确行为所必需的。 ### 运行环境与兼容性 - `api-version` 由 `1.21` 提升到 `1.21.8`；构建基座由 spigot-api 改为 paper-api，使用本插件 API 的开发者需要同步切换编译基座。 - Java 目标版本仍为 25，`folia-supported: true` 保持不变，权限集与子命令集保持不变（inspect/refresh/setstar/clearstate/clearcrack/givecatalyst）。 ### 升级说明 - 需要 EmakiCoreLib `4.6.0`。 - 升级前请备份 `gui/strengthen_gui.yml` 并按上述结构迁移；如不希望再释放示例数据，可将 `release_default_data` 设为 `false`。 - 升级后建议执行一次 `/emakistrengthen reload`，并验证强化流程、材料返还与结果提示是否正常。 ## SpigotMC Update Log [CENTER][SIZE=6][B]◆ Emaki Strengthen v4.6.0 Release ◆[/B][/SIZE][/CENTER] [CENTER]Outcome and idempotency additions to the API, rollback with pending compensation, a new GUI item structure, and a Paper-only 1.21.8+ baseline.[/CENTER] [CENTER][B]━━━━━━━━━━━━━━━━━━━━[/B][/CENTER] [LIST] [*]Added the config key release_default_data (default true); set it to false to stop writing the bundled sample strengthen recipes and script examples. [*]Added six configurable held-item actions: emakistrengthen_set_star, emakistrengthen_add_star, emakistrengthen_remove_star, emakistrengthen_reset_star, emakistrengthen_clear_layer, emakistrengthen_rerender. [*]Config precheck text is localizable and load type names are translatable. [*]The public API adds an AttemptOutcome enum (NOT_COMMITTED, COMMITTED_SUCCESS, COMMITTED_FAILURE, COMPENSATION_PENDING), separating "the roll succeeded" from "the transaction committed". [*]The public API adds an idempotency key operationId, exposed through AttemptContext, AttemptResult (operationId(), outcome(), committed(), compensationPending()) and the attempt events. [*]Added an optional soft dependency on EmakiItem; the EmakiAttribute integration now degrades gracefully when that plugin is absent. [*]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. [*]Fixed a null-pointer in the strengthen result message path that left players with no result feedback in that case. [*]Fixed /emakistrengthen reload replies so they are delivered on the sender's execution domain, which is required for correctness on Folia. [*]Breaking: AttemptContext and AttemptResult 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. [*]Breaking: GUI slot items move to nested components - item.source plus item.components.custom_name, item.components.lore, and item.components.tooltip_display.hide_tooltip. Custom gui/strengthen_gui.yml must be migrated. [*]Breaking: the descriptor moved to paper-plugin.yml and its commands section is gone; Paper is required. [*]Removed: the browser-based Web Console layer (web-console.yml, web-extensions/, the CSS asset, the web-console/ frontend project). [*]Removed: the strengthen route preview capability. It only ever had a browser-side entry point, with no in-game command or GUI, so the impact is limited to Web Console users. [*]api-version raised from 1.21 to 1.21.8 and the build base moved from spigot-api to paper-api. Java target stays 25, folia-supported stays true, and the permission and subcommand sets are unchanged. [*]Requires EmakiCoreLib 4.6.0. Back up gui/strengthen_gui.yml before updating. [/LIST] ## Modrinth Changelog ### 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.

### 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.

### Added - Held-item strengthen actions for rerendering, star changes, reset, and layer clearing. - Manifest v2 Web Console integration for route preview, branches, stars, materials, economy, and effects. - Command suggestions after `/emakistrengthen `. ### Fixed / Improved - Fixed a possible null pointer when returning materials after closing the GUI. - Fixed strengthened item names flattening localized vanilla base names. - Improved Web Console route preview style loading. - Aligned with the Paper API / `paper-plugin.yml` 1.21.8+ baseline. ### Notes - Update with the matching CoreLib release. - Breaking: Action aliases were removed; use canonical action IDs. - Legacy config fields remain consolidated (`es_skills`, `stars`).

### Added - Public Bukkit events `StrengthenPreAttemptEvent` (cancellable, success-rate editable) and `StrengthenAttemptEvent`. - JavaScript extensions for strengthen success-rate rules and result hooks. - Config precheck on startup and reload. ### Fixed - Fixed a crash when opening the strengthen GUI with empty material slots. - Fixed suffixed strengthen names flattening localized base item names. ### Notes - Legacy compatibility fields are consolidated (`es_skills`, `stars`); migrate older formats if still in use.

### Added - Web Console Strengthen route preview. - Strengthen layered item preview support. - Star-stage name/lore action payloads. - Branch star preview data. ### Fixed - Fixed stage name/lore actions not affecting rebuilt item displays. - Fixed Item final preview missing reached Strengthen stage actions. - Fixed branch-aware attribute and skill writing. - Fixed overly broad example recipe matching. ### Refactored - StarStage API data. - Strengthen recipe parsing and rebuild flow. - Web Console route preview registration. ### Improved - Better recipe selection in Item preview. - Clearer route preview for configuration checks. - Better final-preview integration with CoreLib and Item.

Strengthen v4.2.0 focuses on cleaner module ownership and better integration with the shared CoreLib toolset. ### Highlights - Strengthen script module access through `emaki.module("strengthen")`. - Strengthen-owned script examples. ### Improved - Strengthen registers its own Assembly namespace. - Shared CoreLib effect/action editor integration in Web Console. - CoreLib-aligned bStats, runtime dependency handling, and versioned resource notices.

# EmakiStrengthen v4.1.0 > Branch tree system, strengthen transfer, Web console, and unified recipe format. --- ### ✨ New Features #### Strengthen Branch Tree Equipment can now define multiple upgrade branches instead of a single linear path. Each branch provides unique stat bonuses, giving players meaningful choices at branch points — choose the upgrade direction that fits your playstyle. #### Strengthen Transfer A new transfer service allows you to move strengthen levels from one piece of equipment to another. Preserve your hard-earned upgrades when switching gear. #### Web Console Integration EmakiStrengthen is now accessible through the built-in Web management console, allowing you to edit strengthen recipes and GUI configurations directly in your browser. #### Unified Recipe Format Recipe configuration has been unified into a cleaner `success` branch format, grouping all results, failure handling, stat bonuses, and lore effects together for better readability. ### ♻️ Improvements - The strengthen GUI has been redesigned for a better user experience. - Recipe models have been extracted to the API module for cross-plugin reference. - Language files have been fully updated with new translations. - Snapshot building and refresh logic has been optimized for better performance.

## EmakiStrengthen 4.0.0 Release This release introduces a branching enhancement system, expression variables, and name/lore actions, significantly expanding enhancement gameplay depth. ### New Features - **Branching Enhancement System**: Recipes support `branch_tree` for tree-based enhancement paths. Players choose different branches at specified star levels (e.g., Sharp → Crit, Heavy → High Damage). Branches can be nested. Paths are recorded as slash-separated strings (e.g., `sharp/lethal`). - **Name/Lore Actions**: New `name_actions` / `lore_actions` fields modify item names and lore on successful enhancement. Star-level effects also support `type: "lore_action"` for per-star lore control. - **Expression Variables**: Star-level attributes support expressions (e.g., `"5 * {star}"`) for dynamic scaling. - **PAPI Placeholders**: `%emakistrengthen_item_max_star%`, `%emakistrengthen_item_success_rate%` (real-time with temper bonus), `%emakistrengthen_item_crack_level%`. - **Enhanced Action Context**: Success/failure actions now have `{strengthen_max_star}` and `{strengthen_success_rate}` placeholders. ### Improvements - Unified `effects` list format with `type` field. - Conditions support structured `ConditionGroup` parsing. - Two new comprehensive example files: `example_recipe.yml` (linear) and `example_branch_recipe.yml` (branching). - Config and language files auto-merge new keys on upgrade. ### Breaking Changes - `stats` → `variables` (supports expressions), `attributes` → `ea_attributes` in star configs. - `success_actions` / `failure_actions` → `actions.success` / `actions.failure`. - Material `item` → `item_sources` list format. - `structured_presentation` removed — replaced by `name_actions` / `lore_actions`. - Skill effect type: `"skill"` → `"es_skill"`, `skills` → `es_skills`. - All old built-in recipes removed; replaced by `example_recipe.yml` and `example_branch_recipe.yml`. ### Upgrade Notes - Existing recipes must be migrated to the new format — refer to the new example files. - Branching is optional; recipes without `branch_tree` still work as linear enhancement. - Config version updated to `4.0.0`. [View Full Documentation](https://jiuwu02.github.io/Emaki_Series/) | [Join Discord Community](https://discord.gg/FV4GFQbvCM) | [QQ Group](https://qm.qq.com/q/GqGrzHp0wU)

## EmakiStrengthen 3.5.0 Release This release improves strengthen recipe parsing and execution stability while aligning with the CoreLib 3.5.0 dependency line. - Improved strengthen recipe parsing and field handling. - Improved strengthen attempt execution, cost, failure, and result write-back flows. - Removed deprecated lifecycle cleanup calls. - Updated dependency alignment to CoreLib `3.5.0`. - Synchronized plugin, config, and language versions to `3.5.0`. ### Upgrade Notes - Existing recipe fields remain compatible. - Retest success, failure, material cost, and attribute write-back flows after updating. [View Full Documentation](https://jiuwu02.github.io/Emaki_Series/) | [Join Discord Community](https://discord.gg/FV4GFQbvCM) | [QQ Group](https://qm.qq.com/q/GqGrzHp0wU)