Welcome to SagaGem, a comprehensive gem socketing system plugin for Minecraft Paper servers! This plugin allows players to enhance their weapons by socketing various types of gems to gain powerful attribute bonuses.
Getting Started
What is SagaGem?
SagaGem is a plugin that adds a gem socketing system to your Minecraft server. Players can:

• ️ Socket gems into weapons for attribute bonuses
• Use an intuitive GUI interface for gem management
• ⚡ Enhance their gameplay with customizable gem effects
• Manage gem sockets through simple commands

Available Commands
Basic Commands
Command Description Permission
/sagagem gui ️ Open the gem socketing interface sagagem.gui
/sagagem get weapon [slots] ⚔️ Get a test weapon with specified socket slots sagagem.admin
/sagagem get gem <gem_id> Get a specific gem by ID sagagem.admin
/sagagem addsockets <amount> Add socket slots to held item sagagem.admin
/sagagem reload Reload plugin configuration sagagem.admin
Command Examples
/sagagem gui # Open gem socketing interface
/sagagem get weapon 3 # Get a weapon with 3 socket slots
/sagagem get gem ruby # Get a ruby gem
/sagagem addsockets 2 # Add 2 socket slots to held item

How to Use the Gem System
Step 1: Getting Started

1. Get a weapon: Use /sagagem get weapon [slots] to get a test weapon
2. Get gems: Use /sagagem get gem <gem_id> to obtain gems
3. Open GUI: Use /sagagem gui while holding a socketed weapon

Step 2: Using the GUI Interface

1. Hold your weapon in your main hand
2. Run /sagagem gui to open the socketing interface
3. Click on empty socket slots to insert gems
4. Click on filled socket slots to remove gems
5. View your weapon's enhanced attributes in the item lore

Step 3: Managing Sockets

• Adding Sockets: Use /sagagem addsockets <amount> while holding an item
• Socket Limit: Each item can have multiple socket slots
• Socket Status: Empty slots show as available, filled slots display the socketed gem

Gem Types and Effects
Available Gems
The plugin supports various gem types, each with unique attributes and effects:

• Diamond Gems: High-tier gems with powerful bonuses
• Ruby Gems: Fire-based attributes and effects
• Sapphire Gems: Water/ice-based enhancements
• Emerald Gems: Nature-based bonuses
• Topaz Gems: Lightning/energy effects

Note: Specific gem types and their effects depend on server configuration

Attribute System
Gems provide various attribute bonuses:

• ⚔️ Attack Damage: Increases weapon damage
• ️ Defense: Reduces incoming damage
• ⚡ Speed: Enhances movement speed
• Fire Damage: Adds fire-based damage
• ❄️ Ice Damage: Adds ice-based effects
• And many more based on server setup

GUI Interface Guide
️ Main Interface
The gem socketing GUI displays:

• Weapon Slot: Shows your current weapon
• Socket Slots: Empty slots available for gems
• Filled Slots: Slots with socketed gems
• Information: Weapon stats and gem effects

️ Interaction Guide

• Left Click: Insert gem into empty slot or remove gem from filled slot
• Right Click: View detailed gem information
• Shift + Click: Quick actions (if enabled)

⚙️ Configuration
For Server Administrators
Administrators can customize:

• Gem Types: Add new gems with custom attributes
• Socket Limits: Set maximum sockets per item type
• GUI Layout: Customize interface appearance
• Permissions: Control who can use which features

Configuration Files

• config.yml: Main plugin configuration
• messages.yml: Customizable text messages
• gems.yml: Gem definitions and attributes

️ Troubleshooting
❓ Common Issues
Q: The GUI won't open

• ✅ Make sure you're holding a weapon with sockets
• ✅ Check you have the required permission
• ✅ Verify the plugin is properly loaded

Q: Gems won't socket

• ✅ Ensure the item has available socket slots
• ✅ Check if the gem is compatible with the weapon
• ✅ Verify you have the correct gem item

Q: Attributes not applying

• ✅ Check server configuration for attribute effects
• ✅ Ensure gems are properly socketed
• ✅ Contact server administrator for effect implementation