EcoItems [FREE] Make Custom Items! - EcoItems - 自定义物品插件

💡EcoItems：免费版自定义物品插件

EcoItems 是一款功能强大的自定义物品创建插件，无需编程知识，仅通过配置文件即可制作复杂的自定义物品。它能打造独特的 MMORPG 风格物品，并允许您自定义物品的每一个细节。此插件需要安装 eco 才能运行。

🎮核心特性

数据包物品显示

• 与其他自定义物品插件不同，EcoItems 使用数据包来保持所有物品的实时更新，确保服务器运行快速流畅。
• 您可以在物品名称和描述中使用变量，它们会自动更新，无需后台持续检查。

可升级与可成长物品

• EcoItems 原生支持物品自我升级。您可以创建随着使用而增强、随时间磨损，甚至在使用过程中自我附魔的物品。

完整的 MMORPG 体验

• 插件与大量其他插件深度集成。您可以赋予物品属性、技能，使用魔法值和金钱等，功能几乎没有限制。

自定义模型/材质支持

• 原生支持 ItemsAdder 和 Oraxen，可直接为物品应用自定义模型和材质，无需处理复杂的自定义模型数据编号。

深度集成生态

• EcoItems 是 eco 系列插件家族的一员，能与 EcoSkills、EcoJobs、EcoEnchants、EcoPets 等插件无缝协作。

自定义物品栏位

• 适用于拥有自定义物品栏系统的高级服务器。您可以设置物品仅在特定栏位（如强化栏）中生效。

极致性能优化

• 性能是我们的首要考量。EcoItems 经过反复重写与优化，在提供强大功能的同时，对服务器资源占用极低。

🔧强大的 LibreForge 效果系统

EcoItems 由史上最强大的插件效果系统 LibreForge 驱动。无需编码知识，即可创造任何您想要的物品效果。

系统规模

• 效果：超过 200 种
• 条件：超过 100 种
• 触发器：超过 100 种
• 配置组合：无限可能

主要优势

• 最多的集成：与 eco 引擎结合后，拥有超过任何其他插件的第三方插件集成支持，涵盖自定义物品、反作弊、领地保护、自定义生物、全息图等。
• 支持变量与数学表达式：任何可输入数字的地方，都可以使用包含变量的数学表达式。例如，使挖掘速度取决于 Y 坐标，或让伤害与玩家经济余额挂钩。
• 动画与粒子效果：内置动画和粒子系统，让您的配置更具反应性和生命力，以低成本实现高预算的视听反馈。
• 开源与开发者 API：效果系统完全开源且可扩展。开发者可以轻松创建自己的效果、条件、过滤器、动画等，并与自定义插件对接。
• 全面自定义：您可以自定义几乎所有方面：黑/白名单方块、实体、物品，修改消息，添加冷却、延迟、重复、消耗等。
• 持久化变量：可为玩家或服务器存储数据，用于效果或存入数据库。您甚至可以创建完整的货币、魔法值系统，或将数据存储在物品 NBT 中。内置完整且可自定义的物品升级系统。
• 自定义变量与宏：支持创建自定义变量（与 PlaceholderAPI 完全集成）和使用宏，帮助您简化复杂的效果配置，避免重复。
• 社区配置支持：您可以直接从我们的配置网站 lrcdb 导入社区制作的配置。该平台拥有超过 1300 个公开配置和总计超过 35 万个已创建的配置。

❓重要信息

要求与依赖

• 必需前置插件：eco
• 可选集成插件：ItemsAdder, Oraxen, PlaceholderAPI, EcoSkills, EcoJobs, EcoEnchants, EcoPets 等。

支持与维护

• 支持服务仅在作者的 Discord 服务器中提供。
• 请勿在插件评论区内提交功能请求或错误报告。
• 原作者：Auxilor。目前所有 eco 系列及相关插件与库均由当前维护者在 Auxilor 的明确许可下独家维护和管理。

升级到完整版

• 喜欢 EcoItems？您可以购买完整版，以创建无限数量的自定义物品和合成配方。

介绍

EcoItems 是一个强大的物品创建插件，允许你通过配置文件自定义游戏中的任何物品。你可以修改物品的名称、描述、属性、附魔、药水效果，甚至为其添加特殊能力。所有物品都支持 PlaceholderAPI 占位符，并且可以通过 Eco 插件系列实现完全的经济集成。

💡主要特性

• 完全可定制：创建具有自定义名称、描述、材质、附魔、属性、药水效果和更多特性的物品。
• 特殊能力：为物品添加能力，例如飞行、传送、治疗、给予药水效果、执行命令等。
• 经济集成：与 Vault、PlayerPoints、Tokens 和所有 Auxilor 经济插件原生集成，用于物品购买和销售。
• 占位符支持：在物品名称和描述中使用 PlaceholderAPI 占位符，实现动态文本。
• 物品生成：通过命令生成物品，或将其设置为生物掉落、宝箱战利品、合成配方等。
• 条件系统：基于权限、地点、世界、时间等条件限制物品的使用或获取。
• 多语言支持：轻松实现物品名称和描述的多语言本地化。

🎮命令与权限

命令

• /ecoitems give <玩家> <物品ID> [数量] - 给予指定玩家自定义物品。
• /ecoitems get <物品ID> [数量] - 给自己一个自定义物品。
• /ecoitems list - 列出所有可用的自定义物品。
• /ecoitems reload - 重载插件配置。

权限

• ecoitems.command.give - 允许使用 /ecoitems give 命令。
• ecoitems.command.get - 允许使用 /ecoitems get 命令。
• ecoitems.command.list - 允许使用 /ecoitems list 命令。
• ecoitems.command.reload - 允许使用 /ecoitems reload 命令。
• ecoitems.use.<物品ID> - 允许使用特定 ID 的自定义物品（如果该物品设置了使用条件）。

🔧使用方法

创建自定义物品

• 安装 EcoItems 插件并启动服务器。
• 进入插件配置文件夹 (plugins/EcoItems/items)。
• 复制现有的示例 .yml 文件并重命名，或创建一个新的 .yml 文件。
• 编辑文件以定义你的物品。你可以设置：
• material: 物品材质（例如 DIAMOND_SWORD）。
• name: 物品显示名称（支持颜色代码和占位符）。
• lore: 物品描述（支持多行）。
• enchantments: 附魔列表。
• attributes: 属性修饰符（例如攻击伤害、生命值）。
• durability: 物品耐久度。
• unbreakable: 物品是否不可破坏。
• potion-effects: 携带或使用时获得的药水效果。
• abilities: 物品的特殊能力列表。

配置物品能力

在物品配置的 abilities 部分，你可以定义物品被右键点击、左键点击、穿戴等时触发的动作。例如：

abilities:
  - type: heal
    amount: 4
    trigger: right_click

这将在玩家右键点击物品时治疗他们 2 颗心。

生成物品

• 使用 /ecoitems get <物品ID> 命令给自己物品。
• 使用 /ecoitems give <玩家> <物品ID> 命令给其他玩家物品。
• 配置物品通过宝箱战利品、生物掉落或自定义合成（配合 Eco 系列其他插件）自然生成。

✨依赖项

必需插件

• Eco (auxilor.eco) - 提供核心框架和功能。

可选插件（用于增强功能）

• PlaceholderAPI - 用于在物品名称和描述中使用动态占位符。
• Vault - 用于经济系统集成（配合支持的经济插件）。
• PlayerPoints、Tokens 或其他 Auxilor 经济插件 - 用于替代货币交易。

❓常见问题

如何添加一个在特定世界才能使用的物品？

在物品配置中使用 conditions 部分。例如，添加条件 world: world_nether 可以限制该物品只能在下界使用或生效。

物品支持 NBT 标签吗？

EcoItems 使用自己的配置系统来定义物品属性，这比直接使用 NBT 标签更强大且易于管理。你可以在配置中设置几乎所有原版 NBT 能实现的效果。

我可以让物品有使用次数限制吗？

可以。通过结合 durability（作为使用次数）设置，并配置当耐久耗尽时触发的能力（例如 type: break 或执行命令移除物品），可以实现使用次数限制。

如何让物品在点击时执行控制台命令？

在物品的 abilities 中添加一个类型为 command 的能力，并将 executor 设置为 console。例如：

- type: command
  command: "say 玩家 %player% 使用了物品！"
  executor: console
  trigger: right_click

配置修改后需要重启服务器吗？

不需要。使用 /ecoitems reload 命令即可重载所有物品配置。