ArrowCrates

ArrowCrates

ArrowCrates 是一个多功能的、由配置驱动的战利品箱框架，为 Minecraft 带来了动态、交互式的开箱体验！ArrowCrates 专为整合包作者和服务器管理员设计，支持多种独特的战利品箱行为——从快速的游戏内交互到完整动画的奖励小游戏——均由简单的配置文件、资源包和数据包驱动。

---

多种战利品箱类型

• 掉落箱： 即时满足型战利品箱，被破坏时直接将配置的战利品表物品掉落到世界中。
• 交互箱： 右键点击触发开启音效和效果，然后将奖励散落在方块周围。
• 转盘箱： 交互式 GUI 战利品箱， featuring 旋转奖励轮盘！玩家按下按钮即可根据配置的次数旋转轮盘抽取奖励。
• 老虎机箱： 赌场风格的多转轮老虎机 GUI，支持自定义旋转延迟（delay）、可调节转轮数量（pulls）以及匹配转轮的累积奖金倍数！

---

ArrowCrates 的工作原理

ArrowCrates 将其功能清晰地分布在配置、资源包和数据包中，以实现最大灵活性：

• 配置驱动核心： 在简单的 JSON 配置文件中定义所有战利品箱参数——类型、掉落权重、物品数量、命令执行、延迟和音效触发。
• 资源包支持： 轻松自定义视觉资源！支持自定义模型、纹理、方块状态，以及用于 advanced 战利品箱方块类型的完整 GeckoLib 动画。
• 数据包集成： 使用数据包挂钩标准原版机制，处理方块标签（定义所需挖掘工具）和方块战利品表（确保战利品箱被破坏时掉落自身）。

---

主要特性

• 灵活的奖励类型：
  • 物品掉落： 发放物品或物品堆，支持完整的 1.21+ 数据组件（自定义名称、描述、颜色等）。
  • 命令掉落： 执行控制台命令（如 effect give、xp add 等），并在动画 GUI 中搭配自定义的 displayItem 图标显示。
• 战利品箱生命周期钩子： 在关键时刻执行命令和触发音效：
  • startCommands： 当玩家开启战利品箱时，发送开箱公告（如 tellraw）或触发粒子效果。
  • endCommands： 当所有抽取完成后，播放关闭音效或触发次级奖励命令。
• JEI 集成： 直接在 JEI（Just Enough Items）中预览掉落池、权重和可能的命令奖励。

---

整合包与自定义

ArrowCrates 专为整合包开发者打造！每种战利品箱类型、模型、掉落权重、命令负载和音效触发都可以定制，以适应你的整合包进度。欢迎在任意 CurseForge 整合包中包含 ArrowCrates！