CustomItems+

插件

· 作者 DevilOO7

以完全自由的方式创建自定义物品

0 本站下载 0 关注 更新于 9 个月前

最新 1.2.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? 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(应用)

你就可以创造任何东西。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源