ItemJoin - 进服物品

ItemJoin 是一款功能强大的自定义物品管理插件，允许在玩家加入、重生、切换世界、进入/离开区域、首次加入或首次进入世界时，向其发放高度自定义的物品。它适用于多种服务器类型，如大厅、小游戏、生存、领地、空岛等，并支持为无限数量的物品指定生效的世界。

💡核心特性

• 多场景触发：物品可在玩家加入、重生、世界切换、区域进入/离开、首次加入、首次进入世界时发放。
• 世界限定：可为每个物品指定生效的世界，避免物品被带入非指定世界。
• 高度自定义：支持自定义物品标志（ItemFlags）、触发条件（Triggers）、物品命令（ItemCommands）等。
• 丰富交互：物品命令可绑定多种点击动作（左/右键、物理交互、背包点击），并支持经济扣费、冷却、粒子效果与音效。
• 广泛兼容：支持自定义头颅、药水箭、书、旗帜、烟花、皮革盔甲、地图等多种特殊物品。
• 动态更新：物品名称、描述等可随 PlaceholderAPI 的变量实时更新。
• 灵活管理：可限制物品按IP发放、按游戏模式发放、设置发放概率、清除规则等。
• 插件联动：可与 ChestCommands、BossShop、DeluxeMenus、CustomGUI 等菜单插件无缝配合，通过物品执行命令打开菜单或传送。

🎮命令列表

主命令为 /itemjoin 或 /ij。

基础与信息命令

• /itemjoin - 显示插件信息及帮助菜单。
• /itemjoin help [页码] - 显示指定页码的帮助。
• /itemjoin info - 显示手中物品的信息（如材质类型）。
• /itemjoin world - 显示当前所在世界（用于调试）。
• /itemjoin list - 列出所有已定义的自定义物品及其生效世界。
• /itemjoin updates - 检查插件更新。
• /itemjoin upgrade - 强制更新插件至最新版本（需重启服务器）。
• /itemjoin permissions [页码] - 显示玩家拥有的权限节点。

物品管理命令

• /itemjoin get <物品名> [数量] [玩家名] - 给予指定玩家自定义物品。
• /itemjoin getOnline <物品名> [数量] - 给予所有在线玩家自定义物品。
• /itemjoin getall [玩家名] - 给予玩家所有可用的自定义物品。
• /itemjoin remove <物品名> [数量] [玩家名] - 从玩家背包移除指定自定义物品。
• /itemjoin removeOnline <物品名> [数量] - 从所有在线玩家背包移除指定物品。
• /itemjoin removeall [玩家名] - 移除玩家背包中所有自定义物品。

功能控制命令

• /itemjoin enable [玩家名] [世界名] - 为玩家（全局或指定世界）启用自定义物品。
• /itemjoin disable [玩家名] [世界名] - 为玩家（全局或指定世界）禁用自定义物品。
• /itemjoin reload - 重载所有插件配置文件。
• /itemjoin menu - 打开GUI菜单，用于查看、修改和创建自定义物品。
• /itemjoin purge <数据类型> [玩家名] - 清除数据库文件中的数据（如 first-join, first-world, ip-limits）。

🔧权限节点

权限区分大小写，包括世界名称。

管理权限

• itemjoin.* 或 itemjoin.all - 授予所有插件权限（默认 false）。
• itemjoin.use - 使用基础命令（默认 true）。
• itemjoin.reload - 使用重载命令（默认 false）。
• itemjoin.menu - 打开GUI菜单（默认 false）。
• itemjoin.updates - 检查更新（默认 false）。
• itemjoin.upgrade - 强制更新（默认 false）。
• itemjoin.permissions - 查看权限（默认 true）。
• itemjoin.list - 列出物品（默认 false）。
• itemjoin.purge - 清除数据（默认 false）。
• itemjoin.get - 给予自己物品（默认 false）。
• itemjoin.get.others - 给予他人物品（默认 false）。
• itemjoin.remove - 移除自己物品（默认 false）。
• itemjoin.remove.others - 移除他人物品（默认 false）。
• itemjoin.enable - 为自己启用物品（默认 false）。
• itemjoin.enable.others - 为他人启用物品（默认 false）。
• itemjoin.disable - 为自己禁用物品（默认 false）。
• itemjoin.disable.others - 为他人禁用物品（默认 false）。
• itemjoin.bypass.inventorymodify - 绕过物品移动限制（默认 false）。

物品获取权限

默认情况下，所有物品的权限要求是关闭的。如需启用，请在 config.yml 中设置 Permissions.Obtain-Item: TRUE。

• itemjoin.<世界>.<物品> - 允许玩家在指定世界获得特定物品。
• itemjoin.<世界>.* - 允许玩家在指定世界获得所有物品。

您也可以为单个物品设置完全自定义的权限节点（如 chicken.fingers），只需在物品配置中添加 permission-node: '自定义权限' 即可。

❓常见问题

支持 PlaceholderAPI 吗？

• 是的。在 config.yml 中设置 PlaceholderAPI: true 即可启用，可在物品名称、描述、头颅所有者等任何地方使用占位符。

支持多世界吗？

• 是的。每个物品都可以在 items.yml 中指定生效的世界。未列出的世界不会发放物品。
• 还可与 Multiverse-Inventories、xInventories、PerWorldInventory 等多世界背包插件联动，实现世界切换时自动更换物品而不清空背包。

可以只在首次加入时给物品吗？

• 可以。只需在物品配置中添加 first-join 物品标志（ItemFlag）即可。

可以按IP限制物品发放吗？

• 可以。只需在物品配置中添加 ip-limit 物品标志即可将物品限制在特定IP地址。可与 first-join 标志组合使用。

有依赖项吗？

• 没有强制依赖。但以下可选插件可增强体验：
• Vault：为物品命令添加经济系统支持。
• PlaceholderAPI：提供丰富的占位符。
• Multiverse-Core/MyWorlds：便于多世界管理。
• Multiverse-Inventories/xInventories/PerWorldInventory：实现多世界独立背包。
• AuthMe：玩家登录/注册后才发放物品。
• WorldGuard：实现区域限定物品（进入区域给予，离开收回）。
• TokenEnchant：为物品附加 TokenEnchant 附魔。
• BetterNick：解决玩家使用昵称时物品可能异常的问题。
• HeadDatabase：使用 <hdb-head id> 获取自定义头颅。

有自定义API吗？

• 是的。其他插件可通过 me.RockinChaos.itemjoin.api.ItemJoinAPI 接入。具体方法请查看 Available Methods。如需新方法，可在 GitHub 提交请求。

✨更多信息与支持

• 详细文档：请访问 GitHub Wiki。
• 问题反馈：请勿在评论区提交BUG，请加入我们的 Discord 频道获取帮助。
• 支持开发：感谢所有捐助者的支持！您的捐助是插件持续更新的动力。
• 功能请求：如需新功能，请通过私信联系开发者。

支持平台：Spigot, Bukkit, Paper, Purpur, Folia

您可以在我们的 Wiki 上了解如何安装和使用 ItemJoin。

💡关于 ItemJoin

ItemJoin 是一款功能强大的 Minecraft 插件，允许服务器管理员为玩家配置自定义的加入物品。这些物品可以在玩家首次加入服务器、每次重生或执行特定命令时获得，极大地丰富了玩家的入门体验和服务器互动。

🎮快速链接

• 官方 Wiki（文档与教程）: 您可以在我们的 Wiki 上找到完整的安装指南、配置说明和功能详解。
• 下载与支持: 请访问插件的官方发布页面以下载最新版本并获取支持。

🔧开始使用

要开始使用 ItemJoin，请访问我们的 Wiki 以获取完整的安装和配置步骤。通常流程如下：

安装步骤

• 确保您的服务器运行的是受支持的 Minecraft 版本。
• 将下载的 ItemJoin.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载您的服务器。
• 插件会自动生成配置文件和文件夹，之后您就可以根据 Wiki 的指引进行详细配置了。

主要功能

• 自定义加入物品: 配置玩家进入服务器时获得的特定物品。
• 多种触发方式: 支持首次加入、每次重生或通过命令触发。
• 全版本兼容: 支持多种 Minecraft 服务器版本。
• 高度可配置: 通过 YAML 文件轻松管理物品、权限和触发条件。

❓需要帮助？

如果您在安装或使用过程中遇到任何问题，查阅官方 Wiki 通常是解决问题最快的方式。那里提供了从基础设置到高级配置的所有信息。

祝您使用愉快！