Extractor

Extractor

Extractor removes a filled socket and returns the socket item through a GUI.

Files

• Settings: modules/extractor/settings.yml

• Tools: tool_armor.yml, tool_wpn.yml in items/

• Bundled resources on GitHub

Commands and permissions

• extractor open [player] — divinity.extractor.cmd.open
• GUI access — divinity.extractor.gui
• Shared list, get, give, drop, and reload — divinity.admin

Configuration and example

extraction.price sets prices by socket type and category. The tool's level ranges can restrict which target item levels are valid.

Administrator notes

• Extraction prices depend on socket type and category; verify every configured category has an intentional price.
• Test extraction with the economy provider unavailable, insufficient funds, a full inventory, and multiple filled sockets.
• Narrow tool requirements so armor and weapon extractors cannot target unintended modules or level ranges.
• Grant the GUI and open-command permissions separately when moderators may open the interface for other players.

items/tool_armor.yml — bundled extraction tool

material: SHEARS
name: 'Armor Extraction Tool'
tier: common
level:
  min: 1
  max: 3
uses-by-level:
  '1': 1
  '2': 2
  '3': 3
target-requirements:
  type:
    - ARMOR
  level:
    '1': '1:5'
    '2': '6:15'
    '3': '16:30'
  module:
    - '*'

See Modules and Commands and Permissions.