仪式

本指南假设您之前没有使用过 Minecraft 数据包。数据包是一个特殊文件夹，可以为您的 Minecraft 世界添加新功能。

1. 下载数据包

• 如果您收到的是一个 ZIP 文件，可以直接使用
• 如果您有文件夹结构，请先将其压缩为 ZIP 文件

2. 找到您的世界保存文件夹

• 打开 Minecraft，记下您要添加此数据包的世界名称
• 关闭 Minecraft（重要！）
• 找到您的 Minecraft 存档文件夹：
  • Windows: 按下 Win + R，输入 %appdata%\.minecraft\saves 并按回车
  • Mac: 按下 Cmd + Space，输入 ~/Library/Application Support/minecraft/saves 并按回车
  • Linux: 导航到 ~/.minecraft/saves

3. 安装数据包

• 找到您世界名称的文件夹
• 打开里面的 datapacks 文件夹（如果不存在，请创建它）
• 将数据包 ZIP 文件（或文件夹）放入此 datapacks 文件夹中

4. 启用数据包

• 启动 Minecraft 并打开您的世界
• 您应该在聊天中看到一条消息："[Totem Rituals] Datapack loaded successfully!"
• 如果您没有看到该消息，请在聊天中输入 /reload 并按回车

5. 开始使用

• 输入 /function rituals:give/all 获取所有图腾物品
• 您现在就可以进行仪式了！

服务器管理员可以禁用火焰献祭并恢复旧的自动激活方式：

/data modify storage rituals:config require_fire_sacrifice set value false
/function rituals:config/reload

或者启用奇异果模式以便于测试：

/function rituals:admin/enable_kiwi_mode

共有六个等级的图腾，效果威力依次递增。所有图腾都使用基于等级的范围，更高等的图腾提供更强的效果和更大的区域。

等级 1 - 木质图腾

• 材料: 橡木木板 + 木棍
• 范围: 水平 2×2，向上 3 格，向下 3 格
• 效果威力: 基础
• 视觉效果: 顶部带有物品展示的橡木栅栏柱

等级 2 - 铜质图腾

• 材料: 铜锭
• 范围: 水平 3×3，向上 4 格，向下 4 格
• 效果威力: 改进
• 视觉效果: 铜色柱子

等级 3 - 铁质图腾

• 材料: 铁锭
• 范围: 水平 4×4，向上 5 格，向下 5 格
• 效果威力: 强力
• 视觉效果: 带有粒子的铁栏杆

等级 4 - 金质图腾

• 材料: 金锭
• 范围: 水平 5×5，向上 6 格，向下 6 格
• 效果威力: 非常强力
• 视觉效果: 带有粒子的金色柱子

等级 5 - 钻石质图腾

• 材料: 钻石
• 范围: 水平 6×6，向上 7 格，向下 7 格
• 效果威力: 强大
• 视觉效果: 带有青色粒子的钻石柱子

等级 6 - 下界合金质图腾

• 材料: 下界合金锭
• 范围: 水平 7×7，向上 8 格，向下 8 格
• 效果威力: 最大
• 视觉效果: 带有紫色粒子的下界合金柱子

范围可视化

      [物品]  ← 顶部物品展示
        |     ← 图腾柱（栅栏柱）
    ███████   ← 5×5×6 效果区域
    ███████     （向上 3 格，向下 3 格）
    ███████

所有图腾等级效果范围的视觉对比

有关详细的范围规格，请查看 RANGE_DIAGRAM.md。

该数据包包含一个全面的互动菜单系统，可通过命令访问：

主菜单

• 访问: /function rituals:menu/main
• 功能:
  • 图腾浏览器，包含所有可用等级
  • 快速访问指南书
  • 管理工具和配置选项

图腾浏览器

• 访问: 通过主菜单或 /function rituals:menu/totems
• 功能:
  • 所有图腾等级的视觉预览
  • 合成配方展示
  • 范围和效果信息
  • 一键获得物品

管理工具

• 调试模式: /function rituals:admin/enable_debug_mode
  • 显示详细的仪式计时和范围信息
  • 显示用于故障排除的粒子效果
• 奇异果模式: /function rituals:admin/enable_kiwi_mode
  • 禁用火焰献祭要求，便于测试
  • 非常适合创造模式和实验
• 全部重置: /function rituals:admin/reset_all
  • 清除所有活跃仪式并重置配置
• 列出图腾: /function rituals:admin/list_totems
  • 显示所有已放置的图腾及其当前状态

木质图腾（高型）

木质图腾（矮型）

铜质图腾（高型）

铜质图腾（矮型）

铁质图腾（高型）

铁质图腾（矮型）

金质图腾（高型）

金质图腾（矮型）

钻石质图腾（高型）

钻石质图腾（矮型）

下界合金质图腾（高型）

下界合金质图腾（矮型）

获取命令

这些命令会给你图腾物品。只有拥有管理员权限的玩家（或在创造模式下）才能使用。

• /function rituals:give/all - 给你每种等级图腾各一个
• /function rituals:give/totem_basic - 给你一个木质图腾（高型）
• /function rituals:give/totem_basic_short - 给你一个木质图腾（矮型）
• /function rituals:give/totem_copper - 给你一个铜质图腾（高型）
• /function rituals:give/totem_copper_short - 给你一个铜质图腾（矮型）
• /function rituals:give/totem_gold - 给你一个金质图腾（高型）
• /function rituals:give/totem_gold_short - 给你一个金质图腾（矮型）
• /function rituals:give/totem_advanced - 给你一个钻石质图腾（高型）
• /function rituals:give/totem_advanced_short - 给你一个钻石质图腾（矮型）
• /function rituals:give/totem_master - 给你一个下界合金质图腾（高型）
• /function rituals:give/totem_master_short - 给你一个下界合金质图腾（矮型）
• /function rituals:give/guidebook - 给你图腾仪式指南书

菜单命令

• /function rituals:menu/main - 打开主互动菜单
• /function rituals:menu/totems - 打开图腾浏览器
• /function rituals:help - 显示游戏内帮助菜单

系统命令

• /reload - 重新加载所有数据包（如果数据包不工作，请使用此命令）
• /function rituals:config/reload - 重新加载配置更改

管理命令

• /function rituals:admin/enable_debug_mode - 启用调试模式以进行故障排除
• /function rituals:admin/disable_debug_mode - 禁用调试模式
• /function rituals:admin/enable_kiwi_mode - 启用简单模式（无需火焰献祭）
• /function rituals:admin/disable_kiwi_mode - 禁用简单模式
• /function rituals:admin/list_totems - 列出所有已放置的图腾
• /function rituals:admin/reset_all - 重置所有仪式和配置

性能考虑

• 数据包使用交互实体进行图腾放置（Minecraft 1.19.4+）
• 仪式每 20 游戏刻（每秒一次）检查一次激活状态
• 效果以一定间隔（20-40 游戏刻）应用，以保持性能
• 每个图腾使用 3-4 个实体：1 个交互实体、1-2 个方块展示实体、1 个物品展示实体
• 物品展示实体具有流畅的动画（旋转 + 上下浮动），插值时间为 10 游戏刻

兼容性

• 应与大多数其他数据包兼容
• 使用自定义记分板目标（均以"rituals."为前缀）
• 使用存储命名空间"rituals:config"和"rituals:temp"
• 自定义标签均位于"rituals"命名空间中

架构

• 主循环: rituals:tick 从 minecraft:tick 运行
• 初始化: rituals:load 从 minecraft:load 运行
• 实体系统: 使用交互实体提供碰撞箱/数据，使用展示实体提供视觉效果
• ID 系统: 每个图腾获得一个唯一的 ID，用于关联其各个实体

记分板

• rituals.data - 常量和全局数据
• rituals.timer - 用于冷却/持续时间的游戏刻计数器
• rituals.distance - 图腾范围值
• rituals.tier - 图腾等级 (1-6)
• rituals.effect - 活跃仪式效果类型
• rituals.temp - 临时计算
• rituals.id - 实体关联系统

实体标签

• rituals.totem - 主要图腾交互实体
• rituals.short_totem - 矮型变体图腾（1 格高）
• rituals.totem_visual - 用于图腾视觉效果的方块展示实体
• rituals.totem_display - 用于手持物品的物品展示实体
• rituals.totem_barrier - 用于碰撞的屏障方块展示实体
• rituals.has_item - 已展示物品的图腾
• rituals.active_ritual - 参与仪式的图腾
• rituals.[仪式类型]_ritual - 特定仪式类型标签

文件结构

data/
├── rituals/
│   ├── advancement/      # 成就系统
│   ├── function/
│   │   ├── load.mcfunction
│   │   ├── tick.mcfunction
│   │   ├── give/        # 物品获取命令
│   │   ├── totem/       # 图腾放置/交互
│   │   ├── ritual/      # 仪式效果
│   │   ├── config/      # 配置系统
│   │   └── admin/       # 管理工具
│   ├── recipe/          # 合成配方
│   ├── predicate/       # 随机概率谓词
│   ├── item_modifier/   # 物品修改
│   └── tags/            # 自定义标签
├── minecraft/
│   └── tags/
│       └── function/
└── pack.mcmeta

有关详细的技术文档，请查看 SYSTEM_OVERVIEW.md。

您可以使用配置存储系统自定义各种数据包设置。

查看当前配置

/data get storage rituals:config

修改设置

/data modify storage rituals:config <键> set value <值>
/function rituals:config/reload

可用设置

• min_totems_required - 仪式所需的最少图腾数量（默认：1）
• max_totem_distance - 图腾之间的最大距离（单位：方块）（默认：32）
• ritual_duration - 仪式持续时间（单位：游戏刻）（默认：600 = 30 秒）
• require_fire_sacrifice - 仪式是否需要火焰献祭（默认：true）
• kiwi_mode - 禁用火焰献祭的简单模式（默认：false）
• debug_mode - 启用调试信息和粒子（默认：false）

有关完整的配置文档，请查看 CONFIG_GUIDE.md。

您可以通过用红石为图腾供电来可视化其效果范围！

使用方法：

1. 在图腾旁边或下方放置一个拉杆、红石火把、红石块或通电的红石线
2. 红色粒子将显示确切的仪式范围（因等级而异）
3. 关闭红石电源以隐藏显示

支持的红石源：

• 红石火把（始终开启）
• 红石块（始终开启）
• 拉杆（切换开/关）
• 按钮（临时）
• 通电的红石线

有关详细的范围规格，请查看 RANGE_DIAGRAM.md！

图腾无法放置：

• 确保你是右键点击（不需要潜行！）
• 确保你要放置图腾的位置有空白空间（空气方块）
• 检查你是否有实际的图腾物品（应该具有自定义名称和彩色文本）

物品无法在图腾上展示：

• 确保你右键点击的是图腾本身，而不是它附近的地面
• 图腾一次只能持有一个物品
• 尝试先移除当前物品（空手右键点击）

仪式无法激活：

• 默认情况下，只需要 1 个图腾（如果更改过，请检查配置）
• 默认情况下，图腾单独工作（可配置为需要多个）
• 物品必须放置在图腾上（在它们上方浮动）
• 放置最后一个物品后等待 1 秒（系统每 20 游戏刻检查一次）
• 检查火焰献祭：在图腾周围丢下 4 个催化剂物品并点火

阵列仪式无法工作：

• 使用红石查看粒子指南以获得正确位置
• 确保所有图腾都有完全正确的所需物品
• 检查图腾是否在正确的距离（大多数阵列为 5 格）
• 验证中央图腾拥有该仪式类型所需的正确物品

数据包不工作：

• 在聊天中输入 /reload
• 检查数据包是否在正确的文件夹中 (world/datapacks/)
• 确保文件夹结构正确（pack.mcmeta 应该在根目录）
• 确保你使用的是 Minecraft 1.21 或更高版本

资源包问题：

• 资源包是可选的，但提供自定义纹理
• 将其放入您的 resourcepacks 文件夹并在游戏中启用
• 如果纹理不显示，请确保该包在列表中位于其他资源包之上

调试模式：

• 启用调试模式：/function rituals:admin/enable_debug_mode
• 这将显示详细的计时、范围和效果信息
• 完成后禁用：/function rituals:admin/disable_debug_mode