Item System | ⭐ Premium ⭐ [1.16 - 1.21.x]

⚡ Overview

UC_ItemSystem is designed to transform your server gameplay with the most advanced, secure, and feature-rich custom item system. From custom stats to a powerful in-game editor, this plugin allows you to create swords, armor, tools, and food with custom textures, models, and stats.

Available in two versions: Free (Core Essentials) and Premium (Advanced Features).

🆚 Version Comparison

📸 GUI's (Only Premium Version)

Item Manager	Category Items
Give Items	Edit Items
Edit Display Name	Select Material
Set Glow Colors	Edit Required Level
Edit Enchants	Edit Custom Model Data
Edit Particles	Edit Stats
Set Abilities	Set Commands
Edit Lore

🌟 Premium Features Spotlight

🖥️ In-Game GUI Editor

Manage everything from within the game! No need to edit files manually.

• 
  
• Visual Editing: Edit item properties, stats, and abilities with a user-friendly interface.
• Live Updates: Changes are applied instantly without reloading the server.
• Easy Management: Organize items into categories.

⚔️ Advanced Custom Items

Create unique items that stand out.

• 
  
• Custom Model Data: Easily apply custom textures via Resource Pack.
• Modern Models: Support for Minecraft 1.21.4+ item_model component.
• Custom Stats: Add Critical Chance, Movement Speed, and more to any item.

✨ Abilities & Triggers

Powerful ability system with granular control.

• 
  
• Triggers: Right-Click, Left-Click, Shift-Click, Consume, Kill, etc.
• Actions: Execute commands, apply potion effects, launch projectiles, or run scripts.
• Conditions: Set requirements like cooldowns, permissions, or specific biomes.

🧪 Custom Potions

Revolutionize alchemy on your server.

• 
  
• RGB Colors: Create potions with any color you can imagine.
• Custom Effects: Combine vanilla effects with custom abilities.
• Throwable: Enable throwable mechanics for any potion type.

Example: Yggdrasil Sword
File: items/weapons/Yggdrasil Sword.yml

base:
  internal-name: 'Yggdrasil Sword' # Used to search and select it in-game
  material: GOLDEN_SWORD # Base template item to use, only use any item that has a weapon component
  custom-model-data: 1002 # Set to FALSE to disable custom model data
  custom-item-model: 'universalcores:yggdrasil_sword'
  model-enabled: false # Whether the custom item model is enabled
  deal-damage-on-hit: true # Whether the weapon deals damage on normal hit (default true)
  required-level: 75 # false to disable or set required level
  glow: true # Whether the weapon glows
  glow-color: 'YELLOW' # Glow color, see https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Color.html for more colors or hexadecimal
  glow-player: true # Whether the player glows when holding the item
  particles: true # Whether the weapon emits particles when used
  unbreakable: true # Whether the item is unbreakable
  enchantments: true
  abilities:
    right-click: true
    left-click: true
    shift-right-click: true
    shift-left-click: true
  commands:
    right-click: true
    left-click: true
    shift-right-click: true
    shift-left-click: true
  name: '&e&lYGGDRASIL SWORD'
  lore:
    - '&7A humble wooden branch imbued'
    - '&7with the power of the world tree.'
    - ''
    - '{{unbreakable}}'
    - '{{required-level}}'
    - ''
    - '{{abilities}}'
    - ''
    - '&8&m--------------------------'
    - '{{stats}}'
    - '&8&m--------------------------'
    - '{{enchantments}}'
  stats:
    health: 10.0 # Additional health value
    armor: 8.0 # Base armor value
    armor-toughness: 4.0 # Base armor toughness value
    max-health: 10.0 # Base max health value
    knockback-resistance: 0.2 # Knockback force when hitting an entity
    attack-damage: 20.0 # Base attack damage value
    attack-speed: 2.5 # Base attack speed value
    critical-strike-chance: 15.0 # Chance of dealing extra damage
    critical-strike-damage: 100.0 # Extra damage when a critical strike occurs
    movement-speed: 0.1 # Additional movement speed value
particles: # Format: PARTICLE_NAME || speed || amount 
  - 'VILLAGER_HAPPY || 0.05 || 3'
enchantments: # Format: ENCHANTMENT_NAME || level
  - 'SHARPNESS || 15'
  - 'KNOCKBACK || 5'
  - 'UNBREAKING || 10'
  - 'BANE_OF_ARTHROPODS || 5'
abilities: # Format: ABILITY_NAME || magnitude || damage || cooldown
  right-click:
    display-name: '&fCelestial Leap'
    list:
      - 'LEAP || 1.5 || 10 || 5'
  left-click: # Triggers on hitting an entity
    display-name: '&fSolar Flare (On Hit)'
    list:
      - 'FIREBALL || 1.5 || 10 || 2'
  shift-right-click:
    display-name: '&5Void Call'
    list:
      - 'EXPLOSION || 2.0 || 25 || 10'
      - 'LIGHTNING || 1.0 || 15 || 8'
  shift-left-click:
    display-name: '&bNature Restoration'
    list:
      - 'HEAL || 10.0 || 0 || 20'
commands:
  right-click:
    - 'say hi, execute right-click command'
  left-click:
    - 'say hi, execute left-click command'
  shift-right-click:
    - 'say hi, execute shift-right-click command'
  shift-left-click:
    - 'say hi, execute shift-left-click command'

🛠️ Commands & Permissions

🟢 Core Commands (Free & Premium)

🟡 Advanced Commands (Premium Only)

📂 Configuration Structure

The config.yml file handles core settings. Here's a glimpse:

settings:
  default-language: "English"
  enable-prefix: true
  use-modern-item-models: false # Support for 1.21.4+ item_model component

storage:
  type: "yaml" # Options: yaml, sqlite, mysql
  sqlite:
    file: "data.db"
  mysql:
    host: "localhost"
    database: "uc_itemsystem"
    
features:
  combat: true
  cooldowns: true
  audit-logs: true # (Internal logging)
  
enabled-commands:
  help: true
  backup: true
  restore: true
  save: true
  reload: true
  gui: true
  lang: true
  migrate: true
  items: true

Free Version Files:

• 
  
• config.yml
• features/general.yml
• features/combat.yml
• features/cooldowns.yml
• items/ (weapons, tools, armor, food, potions, blocks)

Premium Version Files:

• 
  
• config.yml
• features/general.yml
• features/combat.yml
• features/cooldowns.yml
• items/ (weapons, tools, armor, food, potions, blocks, Generic)
• gui/ (menus configuration)

📦 Installation

1. 
   
2. Download the UC_ItemSystem.jar plugin.
3. Place it in your server's plugins/ folder.
4. Start the server.
5. (Optional) Configure the database in config.yml.
6. Run /uc_item admin gui to start configuring items!

🗺️ Development Roadmap

Check out our official website for all developed plugins: minecraft.universalcores.com

Universal Cores Suite Progress:

• 
  
•  PermissionSystem (Completed)  
•  EconomySystem (Completed)  
•  ItemSystem (Completed)  
•  TradeSystem (In Development)
•  TeleportSystem (In Development)
•  FriendSystem (In Development)
•  KitSystem (In Development)
•  RankSystem
•  AuctionSystem
•  SellerSystem
•  PartySystem
•  RewardSystem
•  QuestSystem
•  ArenaSystem
•  GuildSystem
•  PetSystem
•  MountSystem
•  BoosterSystem
•  MailSystem
•  PortalSystem

🤝 Support & Contact

Want to support the development?

Have questions before buying? Need help with configuration?