Skip to main content

👋 Getting Started

This chapter guides you through installing MMOItemsGemslot and using its core interfaces.

đŸ“Ĩ Installation Steps​

  1. Ensure MMOItems and MythicLib are installed.
  2. Place MMOItemsGemslot.jar in your plugins folder.
  3. Restart your server to generate default configurations.
  4. Verify your language settings in config.yml.

🔧 Command Reference​

The plugin primarily functions through commands that invoke GUIs:

  • /mgs gem: Opens the Gem Socketing interface.
  • /mgs perforation: Opens the Slot Perforation interface.
  • /mgs removal: Opens the Gem Removal interface.
  • /mgs reload: Reloads configuration files (Admin only).

💎 Basic Workflow​

1. Forcing GUI Socketing​

To force players to use the GUI (allows charging money/XP), update config.yml:

gem-socket:
  disable-native-socketing: true # Disables native drag-drop

2. Preparing a Perforator​

To open a new slot, players need a "Perforator" item (by default, a Diamond Pickaxe named &bGem Perforator). Place this and the target item in the perforation GUI.

3. Preserving Upgrade Data​

If items are enhanced via MMOItemsUpgrade, ensure the MMOitemsUpgrade tag is in global.preserve-nbt-tags to prevent data loss during socket operations.

[!NOTE] All UI layouts and messages can be deeply customized in their respective _gui.yml files.