Additions API - 自定义物品与材质

💡Demo Additions

Demo Additions 是一个轻量级的 Minecraft 插件，旨在为服务器管理员提供一系列实用的演示和测试功能。它允许你快速生成示例实体、物品和结构，方便进行插件兼容性测试、展示或教学。

⭐主要功能

• 生成演示实体：快速生成各种被动型、中立型和敌对型生物。
• 生成演示物品：获取带有自定义附魔、名称和描述的示例物品。
• 生成演示结构：在指定位置生成简单的结构，如房屋、塔楼或迷宫。
• 清理功能：一键移除所有由本插件生成的实体和结构。
• 配置系统：通过配置文件自定义生成实体的数量、物品的属性等。

🎮命令与权限

主命令

插件的主命令是 /demoadd 或简称 /da。

命令列表

• /demoadd spawn <实体类型> - 生成一个指定类型的演示实体。

- 权限: `demoadditions.spawn`

• /demoadd item <物品类型> - 获取一个指定的演示物品。

- 权限: `demoadditions.item`

• /demoadd structure <结构名称> - 在玩家位置生成一个演示结构。

- 权限: `demoadditions.structure`

• /demoadd clear - 清除所有由插件生成的实体和结构。

- 权限: `demoadditions.clear`

• /demoadd reload - 重新加载插件配置文件。

- 权限: `demoadditions.reload`

权限节点摘要

• demoadditions.* - 授予所有插件权限。
• demoadditions.spawn - 允许使用生成实体命令。
• demoadditions.item - 允许使用获取物品命令。
• demoadditions.structure - 允许使用生成结构命令。
• demoadditions.clear - 允许使用清理命令。
• demoadditions.reload - 允许重新加载配置。

🔧安装与配置

安装步骤

• 确保服务器运行的是 Spigot、Paper 或兼容的衍生服务端（版本 1.16.5+）。
• 将下载的 DemoAdditions.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 首次运行后，插件会在 plugins/DemoAdditions 目录下生成配置文件 config.yml。

基础配置

编辑 plugins/DemoAdditions/config.yml 文件以自定义插件行为。

# 生成实体的默认数量
spawn-default-count: 1

# 是否在生成时给予实体自定义名称
custom-names-enabled: true

# 允许生成的结构列表
allowed-structures:
  - house
  - tower
  - maze

修改后，请使用 /demoadd reload 命令或在服务器控制台输入 reload confirm 来应用更改。

❓常见问题

插件兼容性

• 问：Demo Additions 与 EssentialsX、WorldEdit 兼容吗？
• 答：是的，Demo Additions 被设计为与大多数主流插件兼容。如果遇到冲突，请检查控制台错误日志。

性能影响

• 问：生成大量实体会导致服务器卡顿吗？
• 答：会。虽然插件本身是轻量级的，但生成过多实体（尤其是敌对生物）会增加服务器负载。建议在测试区域使用，并及时使用 /demoadd clear 进行清理。

权限问题

• 问：玩家无法使用命令，提示没有权限。
• 答：请确保已通过权限管理插件（如 LuckPerms）为玩家或组分配了正确的权限节点（例如 demoadditions.spawn）。

✨支持与反馈

如果你遇到漏洞或有功能建议，请访问插件的官方资源页面提交反馈。

• 支持版本：1.16.5 至 1.20.x
• 依赖：无硬性依赖，但建议安装 Vault 以支持更高级的权限功能。