EmakiGem | Resonance-Powered Gem Socketing System -----
Socket, embed, extract, upgrade — full gem lifecycle management with a unique resonance system for h
◆ Emaki Gem v2.3.0 Release ◆
Safer Gem GUIs, richer layered previews, shared conditions, and cleaner module boundaries.
━━━━━━━━━━━━━━━━━━━━
Safer Gem GUIs, richer layered previews, shared conditions, and cleaner module boundaries.
━━━━━━━━━━━━━━━━━━━━
Added
- Added Gem script module access through emaki.module("gem").
- Added Gem layered preview support for Item final previews.
- Added preview controls for inlay state, gem level, action count, resonance, conflicts, and dependency summaries.
- Added shared condition system integration for Gem configs.
Fixed
- Fixed Gem, socket, and upgrade GUIs automatically carrying player items into the GUI in unclear situations.
- Fixed meaningless empty values appearing when no compatible gem preview was available.
- Fixed default Gem conditions and examples not fully matching the shared condition system.
Refactored
- Refactored Gem API access to the static facade + Bridge model.
- Refactored Gem script module registration and cleanup.
- Refactored Gem layered preview provider around CoreLib preview APIs.
- Refactored Web Console frontend entry and registration.
Improved
- Improved Gem GUI, socket GUI, upgrade GUI, and example configuration consistency.
- Improved final item inspection for equipment combined with gems.
- Improved Web Console gem editing through shared CoreLib editors and previews.
- Improved default resources for long-term maintenance.
Before Updating
- Review custom Gem configurations, GUI behavior, and final item previews after updating.
- Players now place target equipment into Gem GUIs manually.
- Back up gem configs, GUI files, and related player Gem data before production updates.
- Update CoreLib, Item, and Gem together for final preview support.
◆ Emaki Gem v2.2.0 Release ◆
Safer Gem GUI interactions, better display refreshes, and cleaner module ownership.
━━━━━━━━━━━━━━━━━━━━
Safer Gem GUI interactions, better display refreshes, and cleaner module ownership.
━━━━━━━━━━━━━━━━━━━━
Highlights
- Gem can now be accessed from scripts through emaki.module("gem").
- Gem, socket, and upgrade GUIs now open with empty target slots instead of automatically taking the player's held item.
Quality Improvements
- Gem GUI display slots respect configured template icons, names, and lore more consistently.
- Gem items and socketed equipment display data are refreshed from the latest configuration after reload.
- Creative-mode item refresh behavior is more stable and avoids repeated inventory updates.
- Gem now registers its own Assembly layer namespace and script module.
- Web Console editing benefits from shared CoreLib effect and action editors.
- bStats, runtime dependency handling, and versioned resource notices are aligned with CoreLib.
Before Updating
- Gem GUIs now follow an empty-on-open, manual-place interaction model.
- Update CoreLib together with Gem.
◆ EmakiGem v2.1.0 Release ◆
GUI redesign, item obtain system, Web console, and resonance restructure.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ New Features
GUI redesign, item obtain system, Web console, and resonance restructure.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ New Features
- Gem Item Obtain: New listener for configuring gem acquisition through mob drops, quest rewards, and other sources.
- Web Console & Item Editor: EmakiGem now integrates with the Web console for browser-based gem definition, socket item, and resonance editing. Includes an item editor for custom gem items.
- Resonance Structure Restructured: Resonance effect configuration reorganized with clearer hierarchy and more intuitive structure.
♻️ Improvements
- All gem GUIs completely refactored — inlay, open, and upgrade interfaces rewritten for smoother experience.
- Gem Lore builder refactored for more polished and standardized display.
- Gem snapshot builder optimized for faster state refresh.
- Gem action coordinator optimized for more efficient execution.
- Gem definition and parser updated with richer configuration options.
- Language files significantly expanded.
◆ EmakiGem 2.0.0 Release ◆
Gem Resonance System & Name/Lore Actions
Gem combination bonuses, reversible item text modifications, and fully configurable UI text
Gem Resonance System & Name/Lore Actions
Gem combination bonuses, reversible item text modifications, and fully configurable UI text
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
New Features
New Features
- Gem Resonance System — Define gem combination effects in the resonances/ directory. When socketed gems match specific combinations, resonance activates bonus attributes, skills, name/lore changes, and actions. Supports ordered and unordered matching by gem type or ID.
- Name/Lore Actions — Gem effects support name_action / lore_action types. Socketing a gem can modify equipment name/lore; removing the gem auto-reverts changes via the Item Operation Ledger.
- PAPI Placeholders — %emakigem_item_definition_id%, %emakigem_resonance_count%, %emakigem_slot_<N>_type%.
- Fully Configurable Lore Text — All gem slot lore text (overview headers, slot status lines) is now customizable in language files with placeholder support.
- Fully Configurable GUI Text — Nearly all UI text in inlay/open/upgrade GUIs is now in language files.
- Detailed Cost Error Messages — Insufficient currency and materials now show separate messages with specific names and amounts.
Improvements
- Unified effects list format with type field (variables / ea_attribute / es_skill / name_action / lore_action).
- Socket item match field supports item_sources, slot_groups, and lore_contains matching.
- Config and language files auto-merge new keys on upgrade.
- Extract mode is now integrated into the inlay GUI (no longer a separate GUI entry).
Breaking Changes
- tier → level, item_source → item_sources (list), stats → variables, attributes → ea_attributes.
- structured_presentation removed — use name_actions / lore_actions.
- Action fields moved under actions block (e.g., inlay_success_actions → actions.inlay_success).
- default_open_slots changed from count to index list (e.g., [0, 1]).
- Skill effect type: "skill" → "es_skill", skills → es_skills.
- Formula variables: {tier} → {level}, {tier_chance} → {level_chance}.
- Old built-in examples replaced by example_gem.yml, example_socket_item.yml, example_resonance.yml.
Upgrade Notes
- Migrate existing gem definitions to the new format — refer to example_gem.yml.
- Resonance is optional; basic socketing works without the resonances/ directory.
- Config version updated to 2.0.0.
◆ EmakiGem 1.4.0 Release ◆
Language Resources, Cleaner Config Loading, and Gem Service Stability
Socket opening, inlay, extraction, upgrades, config parsing, and English language support
Language Resources, Cleaner Config Loading, and Gem Service Stability
Socket opening, inlay, extraction, upgrades, config parsing, and English language support
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Highlights
Highlights
- Added English language resource file: lang/en_US.yml.
- Cleaned up gem and equipment template loading for the current config format.
- Gem and equipment definitions should now explicitly define key fields such as IDs.
- Improved gem definition parsing for IDs, types, upgrade data, and presentation content.
- Improved equipment template parsing and matching behavior.
- Adjusted gem inlay validation and execution flow.
- Adjusted gem extraction flow and equipment state write-back.
- Updated gem upgrade handling for success rates, failure penalties, material costs, and money costs.
- Updated socket opener handling to match the current main config structure.
- Updated command routing, reload flow, default config, and Chinese language resources.
◆ EmakiGem 1.3.0 Dev Update ◆
Gem GUI Item Safety and Language Fixes
A Gem maintenance update focused on safer GUI item flow and cleaner language resources
Gem GUI Item Safety and Language Fixes
A Gem maintenance update focused on safer GUI item flow and cleaner language resources
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Highlights ✦
✦ Highlights ✦
- ◆ GemPdcAttributeWriter now uses PdcAttributeGateway instead of reflection.
- ◆ Inlay and extract modes now open an empty gem GUI instead of taking the player's main-hand item automatically.
- ◆ The GUI checks gem type, socket compatibility, same-type limits, and same-gem limits before entering pending confirmation.
- ◆ Pending input items are returned when switching modes, replacing the target item, or closing the GUI.
- ◆ GUI inlay failures can preserve the input gem and refund charged economy or materials.
- ◆ Runtime exceptions during GUI operations are logged and the plugin attempts to return involved items.
- ◆ Gem lore generation can use CoreLib structured text configs and random_text.
- ◆ zh_CN.yml now has the GUI messages under the top-level gui path.
- ◆ Gem definition parsing moved into GemDefinitionParser.
◆ Upgrade Notes ◆
No upgrade notes.
◆ EmakiGem 1.2.0 ◆
PlaceholderAPI Support for Gem Socket State
A gem-system update for menus, scoreboards, socket visibility, and current attribute naming
PlaceholderAPI Support for Gem Socket State
A gem-system update for menus, scoreboards, socket visibility, and current attribute naming
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Highlights ✦
✦ Highlights ✦
- ◆ A new emakigem PlaceholderAPI expansion exposes main-hand opened slots, total slots, filled slots, and per-slot gem state.
- ◆ Default attack, defense, and utility gems continue using the current non-EA-prefixed attribute names.
- ◆ config.yml and zh_CN.yml now use the unified version field for 1.2.0.
- ◆ The recommended GUI command remains /emakigem gui (inlay|extract|open|upgrade).
- ◆ The clearstate admin command can remove the gem layer from the held item.
- ◆ Gem state, snapshot building, PDC attribute writes, and structured presentation output received consistency cleanup.
◆ Upgrade Notes ◆
- ◆ Run this release on Java 25.
- ◆ Install PlaceholderAPI if you want socket state in scoreboards, menus, or quest conditions.
- ◆ Keep custom gem attributes on the current non-EA-prefixed names.
- ◆ Use version as the schema key in custom config and language files.
- ◆ Update player instructions to use /emakigem gui (mode).
◆ EmakiGem 1.1.0 ◆
GUI Rule Cleanup, Item-Source Defaults, and Return-Flow Fixes
A focused gem-system update that cleans up GUI rules, default item recognition, and failure or return behavior
GUI Rule Cleanup, Item-Source Defaults, and Return-Flow Fixes
A focused gem-system update that cleans up GUI rules, default item recognition, and failure or return behavior
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✦ Highlights ✦
✦ Highlights ✦
- ◆ Default gem and opener recognition now follows the item_source path, and the bundled defaults were moved closer to plain vanilla item-source definitions.
- ◆ Default gem or opener items no longer depend on bundled display names, lore, or custom model data just to be recognized.
- ◆ GUI access was standardized around /emakigem gui (inlay|extract|open|upgrade), and the help / completion flow was cleaned up around that command entry.
- ◆ The old give subcommand and its related item-distribution path were removed after the default pack stopped relying on the previous generated-item route.
- ◆ Main GUI and upgrade GUI no longer auto-load the held item, and upgrade materials now follow a provided-only GUI rule instead of silently topping up from the player inventory.
- ◆ Structured presentation is now the only maintained display path, replacing the older name_operations and lore_operations compatibility chain.
- ◆ Socket-opening failures now reach the service layer correctly so failure_actions can run, and upgrade-close return fallback was fixed by reading the real target_gem slot with a delayed return safeguard.
◆ Upgrade Notes ◆
- ◆ Replace any admin workflow that still depends on the removed give subcommand.
- ◆ Migrate custom display configs to structured_presentation.
- ◆ Update player instructions to match the current GUI rules: target items and materials must be placed manually, and upgrade materials are no longer pulled from the backpack automatically.
Resource Information
Author:
----------
Total Downloads: 5
First Release: Apr 24, 2026
Last Update: Jun 16, 2026
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings