? CustomItems
AI 将你的插件创意变为现实,提供即插即用的 .JAR 文件
快来看看吧
一个基于 YAML 的强大自定义物品引擎(适用于 Paper)
CustomItems 是一个框架式插件,允许服务器管理员仅使用 YAML 创建高级自定义物品。
无需编写代码。
无需重新编译。
无上限限制。
使用简洁的 触发 → 条件 → 动作 系统来设计挖掘工具、PvP 武器、技能、连击、冷却时间、范围效果等。
只要你能用逻辑描述它,你就能构建它。
✨ 功能特性
- 完全由 YAML 驱动的自定义物品
- 触发 → 条件 → 动作引擎
- 支持 PvP 和 PvE
- 与保护类及战斗类插件兼容
- 无静默失败(控制台会有清晰警告)
- 安全且性能友好的执行方式
- 无限数量的自定义物品
- 设计为框架,而非一次性插件
⚙️ 核心概念
每个自定义物品都遵循相同的结构:
当发生某事时 → 触发 (Trigger)
如果规则通过 → 条件 (Conditions)
则执行某事 → 动作 (Actions)
示例:
ENTITY_HIT:
conditions:
- type: COOLDOWN
seconds: 5
actions:
- type: DAMAGE
amount: 4
**? 触发器 (WHEN)
触发器定义物品何时激活。
| 触发器 | 描述 |
| :--- | :--- |
| BLOCK_BREAK | 当方块被破坏时 |
| ENTITY_HIT | 当实体被击中时 |
| RIGHT_CLICK | 当玩家右键点击时 |
**? 条件 (IF)
条件决定动作是否可以运行。
可用条件
| 条件 | 描述 |
| :--- | :--- |
| COOLDOWN | 每个物品的冷却时间 |
| HIT_COUNTER | 每 N 次命中触发一次 |
条件示例
冷却时间:
```yaml
- type: COOLDOWN
seconds: 5
命中连击:
- type: HIT_COUNTER
every: 3
**⚡ 动作 (WHAT)
动作定义物品实际执行的操作。
战斗与技能动作
| 动作 |
描述 |
| DAMAGE |
造成额外伤害 |
| APPLY_EFFECT |
施加药水效果 |
| APPLY_VELOCITY |
推或拉实体 |
| SELECT_HIT_ENTITY |
选择被击中的实体 |
| SELECT_NEARBY_ENTITIES |
选择附近的实体 |
| SELECT_SELF |
选择玩家自己 |
工具动作
| 动作 |
描述 |
| BREAK_PATTERN |
3×3 / 立方体挖掘 |
| DURABILITY_COST |
自定义耐久度消耗 |
**? 目标系统 (非常重要)
某些动作需要知道它们影响谁。
**? 黄金法则
如果你使用了 from: → 你必须先选择一个目标
目标关键词
| 关键词 |
含义 |
| self |
玩家 |
| targets |
已选择的实体 |
敌人减益效果示例
- type: SELECT_HIT_ENTITY
store: targets
- type: APPLY_EFFECT
from: targets
effect: SLOW
duration: 60
玩家增益效果示例
- type: SELECT_SELF
store: targets
- type: APPLY_EFFECT
from: targets
effect: INCREASE_DAMAGE
duration: 80
**? 示例物品
**? 3×3 挖掘镐子
BLOCK_BREAK:
actions:
- type: BREAK_PATTERN
radius: 1
shape: CUBE
**❄️ 冰霜连击剑
ENTITY_HIT:
conditions:
- type: HIT_COUNTER
every: 3
actions:
- type: SELECT_HIT_ENTITY
- type: APPLY_EFFECT
effect: SLOW
**? 虚空牵引之刃
ENTITY_HIT:
actions:
- type: SELECT_NEARBY_ENTITIES
radius: 5
- type: APPLY_VELOCITY
mode: TOWARDS_PLAYER
**? 兼容性
Paper / Purpur
Minecraft 1.20+ / 1.21+
兼容以下插件:
区域保护插件
PvP 插件
战斗标记插件
反作弊插件
**? 性能与安全
安全的事件优先级
尊重被取消的事件
无法绕过区域保护
不会导致 NaN 速度崩溃
不会发生配置静默失败
专为长期运行的服务器设计
**? 配置文件
items.yml → 定义所有自定义物品
config.yml → 常规设置(未来扩展)
**? 可扩展框架
开发者可以添加:
新触发器
新条件
新动作
而不会破坏现有物品。
**⚠️ 常见错误
效果未生效? → 你忘了 SELECT 目标
物品无反应? → 检查控制台警告以查找拼写错误
伤害过高? → 记住伤害会与原版伤害叠加
**? 计划中的功能
粒子动作
声音动作
数学/缩放表达式
基于生命值的目标条件
GUI 物品编辑器
**? 最终说明
CustomItems 不仅仅是一个插件——它是一个框架。
一旦你理解了:
SELECT(选择)→ APPLY(应用)
你就可以创造任何东西。
? CustomItems
AI WHICH MAKES YOUR PLUGIN IDEAS INTO REALITY GIVES A READY TO IMPLEMENT .JAR FILE
CHECK IT OUT
A powerful YAML-based custom item engine for Paper
CustomItems is a framework-style plugin that allows server owners to create advanced custom items using only YAML.
No coding.
No recompiling.
No limits.
Design mining tools, PvP weapons, abilities, combos, cooldowns, AoE effects, and more using a clean Trigger → Condition → Action system.
If you can describe it in logic, you can build it.
✨ Features
- Fully YAML-driven custom items
- Trigger → Condition → Action engine
- PvP & PvE ready
- Works with protection & combat plugins
- No silent failures (clear console warnings)
- Safe, performance-friendly execution
- Unlimited custom items
- Designed as a framework, not a one-off plugin
⚙️ Core Concept
Every custom item follows the same structure:
WHEN something happens → Trigger
IF rules pass → Conditions
DO something → Actions
Example:
ENTITY_HIT:
conditions:
- type: COOLDOWN
seconds: 5
actions:
- type: DAMAGE
amount: 4
**? Triggers (WHEN)
Triggers define when an item activates.
Trigger Description
BLOCK_BREAK When a block is broken
ENTITY_HIT When an entity is hit
RIGHT_CLICK When the player right-clicks
? Conditions (IF)
Conditions decide whether actions are allowed to run.
Available Conditions
Condition Description
COOLDOWN Per-item cooldown
HIT_COUNTER Triggers every N hits
Condition Examples
Cooldown:
- type: COOLDOWN
seconds: 5
Hit combo:
- type: HIT_COUNTER
every: 3
**⚡ Actions (WHAT)
Actions define what the item actually does.
Combat & Ability Actions
Action Description
DAMAGE Deal extra damage
APPLY_EFFECT Apply potion effects
APPLY_VELOCITY Push or pull entities
SELECT_HIT_ENTITY Select the hit entity
SELECT_NEARBY_ENTITIES Select nearby entities
SELECT_SELF Select the player
Tool Actions
Action Description
BREAK_PATTERN 3×3 / cube mining
DURABILITY_COST Custom durability usage
? Target System (VERY IMPORTANT)
Some actions need to know who they affect.
**? Golden Rule
If you use from: → you MUST select a target first
Target Keywords
Keyword Meaning
self The player
targets Selected entities
Enemy Debuff Example
- type: SELECT_HIT_ENTITY
store: targets
- type: APPLY_EFFECT
from: targets
effect: SLOW
duration: 60
Player Buff Example
- type: SELECT_SELF
store: targets
- type: APPLY_EFFECT
from: targets
effect: INCREASE_DAMAGE
duration: 80
**? Example Items
**? 3×3 Mining Pickaxe
BLOCK_BREAK:
actions:
- type: BREAK_PATTERN
radius: 1
shape: CUBE
**❄️ Frost Combo Sword
ENTITY_HIT:
conditions:
- type: HIT_COUNTER
every: 3
actions:
- type: SELECT_HIT_ENTITY
- type: APPLY_EFFECT
effect: SLOW
**? Void Pull Blade
ENTITY_HIT:
actions:
- type: SELECT_NEARBY_ENTITIES
radius: 5
- type: APPLY_VELOCITY
mode: TOWARDS_PLAYER
**? Compatibility
Paper / Purpur
Minecraft 1.20+ / 1.21+
Compatible with:
Region protection plugins
PvP plugins
Combat-tag plugins
Anti-cheat plugins
**? Performance & Safety
Safe event priorities
Cancelled events respected
No region bypass
No NaN velocity crashes
No silent config failures
Designed for long-running servers
**? Configuration
items.yml → Define all custom items
config.yml → General settings (future expansion)
**? Extensible Framework
Developers can add:
New triggers
New conditions
New actions
Without breaking existing items.
**⚠️ Common Mistakes
Effects not applying? → You forgot to SELECT a target
Item does nothing? → Check console warnings for typos
Damage too high? → Remember damage stacks with vanilla damage
**? Planned Features
Particle actions
Sound actions
Math / scaling expressions
Health-based conditions
GUI item editor
**? Final Note
CustomItems is not just a plugin — it’s a framework.
Once you understand:
SELECT → APPLY
You can create anything.
评论 0
登录后参与评分
还没有评论,来抢沙发吧