Each item is fully configurable: material, name, lore, model data, glow, enchants and vanilla-style attributes bound to specific equipment slots (hand, off-hand, armor). On top of that, every item can react to a wide range of triggers - right-click, left-click, sneak-click, hitting an entity, taking damage, holding/wearing the item passively, shooting projectiles, mining blocks and more.
With 60+ ability actions you can build almost anything: potion effects, custom damage, knockback, teleports, area waves, summons, traps, cages, healing, lightning, stuns and more - freely combined on a single item. Each item supports its own cooldown, usage limit, activation chance and optional region protection, so abilities can't be abused in safe zones.
NCustomItems also includes a built-in, configurable GUI to browse and hand out items in-game, plus custom sounds, particles and titles for polished feedback. It's a strong choice for PvP, survival, RPG and event-based servers that want unique, repeatable and fully customizable gear.
Features
- 100% Configurable - Define every item entirely in YAML, no code needed.
- 60+ Ability Actions - Effects, damage, knockback, teleports, waves, summons, traps, healing and more.
- Many Triggers - Right/left/sneak click, hit entity, receive damage, passive hand/off-hand/armor, projectiles, mining.
- Item Attributes - Vanilla attribute modifiers per equipment slot (attack damage, max health, speed...).
- Enchants & Visuals - Custom enchants, glow, model data, names and lore.
- Cooldowns & Limits - Per-item cooldown, usage limit and activation chance.
- Region Protection - Block item abilities and targeting inside protected regions.
- Built-in GUI - Browse and click-to-receive items, with a fully configurable look.
- Sounds, Particles & Titles - Polished feedback for every activation.
- High Performance - Lightweight, event-driven and easy to maintain.
Complete list of presets: https://github.com/nussesindgesund/NCustomItem
- Install NCustomItems and all required dependencies on your server.
- Restart the server to generate the plugin files.
- Open the config.yml file and register your new item:
YAML:
items:
your_new_custom_item_name:
enabled: true
file: your_new_custom_item.yml- Copy the default example_custom_item.yml file.
- Rename the copied file to your_new_custom_item.yml.
- Configure the new item file however you want.
- Reload or restart the plugin.
- Done, your new custom item has been added successfully.
| Command | Description |
|---|---|
/nci give <player> <item> <amount> | Gives the specified custom item to a player. (Permission: ncustomitems.give) |
/nci gui [page] | Opens a paginated GUI with every registered item — click to receive it. (Permission: ncustomitems.gui) |
/nci region loc1 | loc2 | Sets the two corners of a protected region at your current position. (Permission: ncustomitems.admin) |
/nci region create <name> | Creates a region in which items flagged with block-in-region are disabled. (Permission: ncustomitems.admin) |
/nci region remove <name> | Removes the specified protected region. (Permission: ncustomitems.admin) |
/nci reload | Reloads all configuration files and reloads every custom item. (Permission: ncustomitems.admin) |
/ncustomitem
YAML:
# Language file (loaded from /lang)
lang: pl
# Appearance of the /nci gui menu.
# Placeholders: [PAGE], [TOTAL], [COUNT], [ITEMS]. Colors: MiniMessage.
gui:
title: "<gold>✦ <white>Custom Items <gray>(page [PAGE]/[TOTAL])"
filler-material: GRAY_STAINED_GLASS_PANE
prev-page:
material: ARROW
name: "<red>« Previous page"
next-page:
material: ARROW
name: "<green>Next page »"
info:
material: BOOK
name: "<gold>Page [PAGE] / [TOTAL]"
# Registered items. Each entry points to a file in /customitems.
items:
example_custom_item:
enabled: true
file: example_custom_item.yml
YAML:
id: 'example_custom_item'
# Global item settings.
settings:
chance: 1.0 # 1.0 = 100% chance to trigger abilities
cooldown: 10 # cooldown in seconds
visual: true # show the vanilla cooldown animation
cooldownmessage: true # send a message when on cooldown
block-in-region: true # disable this item inside protected regions
allow-offhand: false # allow placing the item in the off-hand
# The physical item.
item:
material: DIAMOND_SWORD
name: "<#55FFFF><bold>Frost Blade</bold>"
lore:
- "<gray>Right-click to dash forward."
- "<gray>Your hits freeze the enemy."
model-data: 1001
usage: -1 # -1 = unlimited uses; N = item is consumed after N uses
unbreakable: true
glow: true
enchants:
sharpness: 5
unbreaking: 3
# Vanilla attribute modifiers, applied per equipment slot.
# slot: HAND | OFF_HAND | HEAD | CHEST | LEGS | FEET | ALL
attributes:
- type: GENERIC_ATTACK_DAMAGE
amount: 8.0
slot: HAND
- type: GENERIC_MAX_HEALTH
amount: 4.0 # +2 hearts while held
slot: HAND
# Sound played on activation.
sound:
enabled: true
type: 'ENTITY_PLAYER_ATTACK_SWEEP'
# Particles played on activation.
particles:
enabled: false
type: 'SNOWFLAKE'
# On-screen titles (damager = the user, victim = the target).
titles:
damager:
enabled: true
title: ""
subtitle: "<aqua>Frozen!"
fadeIn: 0
stay: 20
fadeOut: 0
victim:
enabled: false
title: ""
subtitle: ""
fadeIn: 0
stay: 20
fadeOut: 0
# Abilities: a trigger -> a list of actions.
# You can find all triggers and abilities in the documentation
abilities:
# Right-click: dash forward.
'RIGHT_CLICK':
action:
- type: DASH
target: ATTACKER
power: 2.5
vertical-boost: 0.3
# Hitting an entity: stun + slowness on the victim.
'HIT_ENTITY':
action:
- type: STUN
target: VICTIM
duration: 3
- type: EFFECT
target: VICTIM
effects:
- potion: SLOWNESS
amplifier: 2
duration: 4Support & Community
Need help, found a bug, or want to suggest a feature?Join the Discord server below. Feedback and suggestions are reviewed, and improvements are included in future updates.
Join our Discord
