ACI - Amai's Custom Items

ACI – Amai Custom Items Plugin
ACI is a powerful Minecraft plugin for version 1.21+ that allows server admins to create custom items with unique properties, enchantments, and effects — all configurable via simple YAML files.

Features

• Easily create custom items by defining their ID, material, name (with color codes), lore, and CMD (coming in next update).
  
  
• ✨ Add enchantments, including hidden ones to keep your items looking clean.
  
  
• Apply custom potion effects to the player holding the item.
  
  
• ⚔️ Apply effects to opponents when they are hit.
  
  
• Unique custom effects:
  
  • JUMP — launches the opponent into the air
    
    
  • FIRE — ignites the opponent
    
    
  • KNOCK — knockback effect
    
    
  • LIGHTNING — strikes lightning
    
    
  • DAMAGE — direct HP damage
    
    
  • MAGNET — pulls enemies closer (with different levels of strength)
    
• /aci reload — reload your items configuration without restarting the server.
  
  
• Tab completion for easier command usage.
  

Example Configuration (YAML)
ID: test_sword
ITEM: minecraft:netherite_sword
NAME: "&c&lTest &f&lSword"
NBT: 1001
LORE:
- "&7This is the ultimate test sword."
enchants:
- unbreaking 1
- sharpness 1
effects:
- minecraft:regeneration 1
giveneffects:
- minecraft:blindness 60,0
customeffects:
- #JUMP 100%
- #FIRE 100%
- #KNOCK 100%
- #LIGHTNING 100%
- #DAMAGE 1 100%
- #MAGNET 1 100%
- #EXPLODE 2 100%
- POISONCLOUD 10 2 100%

YAML files can also be downloaded as an additional file on Discord.

Installation

1. Download the plugin .jar file.
   
   
2. Place it in your server's plugins folder.
   
   
3. Run the server once to generate the configuration folders.
   
   
4. Create your custom item YAML files inside plugins/ACI/Items. (Test Custom Item included for reference)
   
   
5. Use /aci give <ID> [player] to give items.
   
   
6. Reload the configuration with /aci reload.
   

Commands

• /aci give <ID> [player] — Gives a custom item by its ID
  
  
• /aci reload — Reloads the custom items configuration