Skip to main content

MMOItemsGemSlot

MMOItemsGemSlot is a gem slot management plugin for MMOItems equipment. It provides GUI-based perforation, gem socketing, gem removal, configurable slot colors, per-item slot limits, tool costs, and compatibility preservation for data written by other MMOItems extension plugins.

The plugin is designed for servers that want controlled gem progression instead of unrestricted native drag-and-drop socketing. Administrators can decide which equipment types can receive slots, how many slots are allowed, which slot colors are available, how much each operation costs, and whether special tool items are consumed.

Features​

  • Adds gem slots to MMOItems equipment through a perforation GUI.
  • Provides an optional custom gem socketing GUI.
  • Provides a gem removal GUI and configurable remover tool.
  • Supports multiple gem slot colors matched against MMOITEMS_GEM_COLOR.
  • Supports per-item and per-type slot color limits.
  • Supports money and experience costs through Vault and server experience.
  • Preserves configured NBT tags during perforation, socketing, and removal.
  • Supports configurable GUI files for perforation, socketing, and gem removal.
  • Supports English, Simplified Chinese, Traditional Chinese, Russian, and German message files.

Requirements​

  • Paper or compatible Bukkit server.
  • Minecraft 1.20+ server API environment.
  • MMOItems.
  • MythicLib.
  • Vault.

File Layout​

After first startup, the plugin generates configuration under:

plugins/MMOItemsGemSlot/

Important files:

config.yml
perforation_gui.yml
socket_gui.yml
gem_removal_gui.yml
translations/en_US.yml
translations/zh_CN.yml
translations/zh_TW.yml
translations/ru_RU.yml
translations/de_DE.yml

Quick Start​

  1. Install MMOItems, MythicLib, and Vault.
  2. Put MMOItemsGemSlot into the server plugins folder.
  3. Start the server once to generate configuration files.
  4. Edit plugins/MMOItemsGemSlot/config.yml.
  5. Configure allowed weapon types and gem slot types.
  6. Give yourself a perforator with /mmogemslot perforator <player> [amount].
  7. Open the perforation GUI with /mmogemslot perforate.

If you want players to use this plugin's socket GUI instead of MMOItems native drag-and-drop socketing, set gem-socket.disable-native-socketing to true and use /mmogemslot socket.