EmakiGem

EmakiGem gives you equipment sockets, socket openers, gem inlay, extraction, upgrades, gem resonance, gem presentation layers, and optional Attribute output, so you can add long-term progression and personal builds to your gear

Basic information

Item	Value
Module version	2.8.11
Main command	/emakigem
Aliases	/egem, /eg
Hard dependency	EmakiCoreLib
Soft dependencies	EmakiItem, EmakiAttribute, PlaceholderAPI
Main permissions	emakigem.use, emakigem.reload, emakigem.admin, emakigem.debug

Default directories

plugins/EmakiGem/
├── config.yml
├── conditions/
├── gems/
├── items/
├── resonances/
├── gui/
│   ├── gem/
│   └── open/
└── lang/

Main configuration keys

Top-level keys in config.yml:

Field	Type	Required	Default	Range	Description
version	string	No	"2.8.11"	—	Configuration structure marker maintained by the resource sync process, not a feature switch
language	string	No	"zh_CN"	A file name under lang/ (such as zh_CN, en_US)	Language file name, resolving to lang/<language>.yml
release_default_data	boolean	No	true	true / false	Whether bundled default data (gems/, items/, resonances/) is released on startup. Setting false stops those three from being restored, but gui/, conditions/, config.yml, and lang/*.yml are unaffected
socket_openers	object	No	empty (no openers)	see Socket Openers	Socket opener definitions
inlay_success	object	No	empty (source fallbacks)	see Inlay Success Rate	Inlay success rate
number_format.default	string	No	"0.##"	—	Default number format. Falls back to 0.## when the section is missing or the value is blank
op_bypass	boolean	No	false	true / false	Whether OPs bypass cost and condition checks for inlay, socket opening, and extraction. The legacy permission.op_bypass key is still read; the top-level key wins
reroll.session_ttl_seconds	integer	No	120	≥ 1	Reroll candidate session lifetime in seconds. On timeout the candidate is discarded and the charge refunded. Changes affect newly generated candidates only
gui.default_mode	string	No	"inlay"	inlay / upgrade / open (aliases open_socket, socket_open)	Default mode for the GUI service; any other value (including extract, reroll, recalibrate) falls back to inlay. Commands still require an explicit mode argument
gui.save_on_close	boolean	No	false	true / false	Whether the current operation state is saved when the view closes
condition	object	No	empty group	see CoreLib Conditions	Global condition group; when absent it is an empty group with type all_of

Shipped defaults (the top-level keys):

version: "2.8.11"
language: "zh_CN"
release_default_data: true
number_format:
  default: "0.##"
op_bypass: false
reroll:
  session_ttl_seconds: 120
gui:
  default_mode: "inlay"
  save_on_close: false

Example:

language: "en_US"
op_bypass: true
gui:
  default_mode: "open"
  save_on_close: true
reroll:
  session_ttl_seconds: 60

NOTE

op_bypass used to live at permission.op_bypass. The legacy key is still read (the top-level key wins), and it is migrated to the top level on startup with a console notice

WARNING

version has two unrelated version lines; do not mix them. The default resource value in config.yml is 2.8.11. The source additionally holds an internal migration constant CURRENT_VERSION = 2.7.8, used only for configuration migration comparison. The two serve different purposes

Feature pages

Page	Content
Commands	GUI, inspect, clear state, reload, and debug commands
Gems	Gem effects, costs, extraction, upgrades, and socket compatibility
Templates	Socket item definitions and GUI template references
Socket Openers	socket_openers, opener items, socket unlocking, and failure feedback
Resonance	Gem combinations, min_level, priority, exclusive groups, and resonance effects
Process	Inlay validation and runtime flow
Extraction	Extraction cost, return mode, and effect rollback
Inlay Success Rate	inlay_success, formulas, and failure handling
Placeholders	PlaceholderAPI output and GUI/action variables
CoreLib Actions	CoreLib actions registered by EmakiGem
API	Runtime integration and external calls
Events	Bukkit events you can listen to