创游世界道具与物体交互系统指南

一句话摘要

本文档系统介绍创游世界引擎中道具拾取、物体交互、碰撞检测的设计方法，包括可互动组件、物体检测器、碰撞脚本块的用法与典型场景。

适合谁阅读

想实现道具拾取功能的创作者
需要设计物体交互逻辑的开发者
想了解碰撞检测机制的进阶用户
需要设计采集、购买、对话等交互系统的项目架构者

你将学到什么

可互动组件的基本用法
物体检测器的用法
碰撞检测的实现方式
道具拾取系统的设计方法
交互距离与触发区域的设计
典型交互场景的实现思路

核心结论

⚠️ 说明：以下内容基于截图 OCR 与人工归纳，部分术语可能受 OCR 影响，建议在实际开发中验证。

可互动组件是交互的基础：需要点击交互的物体必须挂载该组件
物体检测器用于区域检测：可以检测进入或离开某个范围的物体
碰撞检测需要物理组件：两个物体都需要有物理组件才能触发碰撞
交互设计要注意距离控制：避免误触或无法触发的尴尬

1. 交互系统基础概念

1.1 交互的定义

交互是指玩家与游戏物体之间的行为响应，包括：

点击交互：点击物体触发事件（如打开门、对话）
碰撞交互：移动时触发事件（如踩陷阱、获得道具）
区域交互：进入或离开某个区域触发事件（如触发剧情、切换状态）

1.2 交互组件分类

根据创游世界的组件系统，交互相关组件包括：

可互动：支持点击交互
物体检测器：支持区域检测
物理组件：支持碰撞检测

2. 可互动组件

2.1 组件作用

可互动组件 使物体可以被玩家点击触发事件，是实现以下功能的基础：

对话 NPC
打开门/宝箱
触发机关
购买物品

2.2 触发时机

挂载可互动组件后，可使用以下触发时机：

当点击时：物体被点击时执行
当长按时：物体被长按时执行（如果有）

2.3 基本用法

物体脚本：
  当添加组件可互动时
    设置交互提示 "按E交互"

  当点击时
    播放动画 "打开"
    发送广播 "门已打开"

2.4 典型场景

场景 1：打开宝箱

宝箱脚本：
  当点击时
    播放动画 "打开"
    生成物品
    播放动效 "获得物品"
    等待 1 秒
    销毁自身

场景 2：与 NPC 对话

NPC脚本：
  当点击时
    发送广播 "打开对话框"
    并携带文本 "NPC01"

对话框脚本：
  当收到广播 "打开对话框" 时
    显示对话框
    显示选项

场景 3：切换物体状态

开关脚本：
  当点击时
    如果自身属性1等于 0
      设置自身属性1为 1
      播放动画 "打开"
      发送广播 "机关启动"
    否则
      设置自身属性1为 0
      播放动画 "关闭"
      发送广播 "机关停止"

3. 物体检测器

3.1 组件作用

物体检测器 用于检测特定物体进入或离开检测区域，常用于：

触发剧情
区域限制
自动门
隐藏陷阱

3.2 触发时机

当物体进入时：有物体进入检测区域时执行
当物体离开时：有物体离开检测区域时执行

3.3 基本用法

检测区域脚本：
  当物体进入时
    获取进入的物体
    如果物体是玩家
      发送广播 "玩家进入区域"

  当物体离开时
    获取离开的物体
    如果物体是玩家
      发送广播 "玩家离开区域"

3.4 典型场景

场景 1：区域触发剧情

剧情触发区脚本：
  当物体进入时
    获取进入物体
    如果物体标签是 "玩家"
      发送广播 "剧情触发"
      禁用自身检测器（防止重复触发）

场景 2：自动门

自动门脚本：
  当物体进入时
    获取进入物体
    如果物体有 "角色" 组件
      播放动画 "开门"
      发送广播 "门已开"

  当物体离开时
    获取离开物体
    播放动画 "关门"
    发送广播 "门已关"

场景 3：安全区检测

安全区脚本：
  当物体进入时
    获取进入物体
    如果物体有 "敌人" 标签
      发送广播 "敌人进入安全区"

4. 碰撞检测

4.1 组件要求

碰撞检测需要两个物体都挂载 物理组件，并且：

物理组件的碰撞检测要开启
两个物体的碰撞层要匹配

4.2 触发时机

当碰撞时：与另一个物体发生碰撞时执行

4.3 基本用法

道具脚本：
  当添加物理组件时
    开启碰撞检测
    设置碰撞层 "道具"

  当碰撞时
    获取碰撞对象
    如果碰撞对象是玩家
      拾取道具
      销毁自身

4.4 典型场景

场景 1：拾取金币

金币脚本：
  当碰撞时
    获取碰撞对象
    如果碰撞对象有 "角色" 组件
      增加玩家金币
      播放动效 "金币飘字"
      销毁自身

场景 2：踩到陷阱

陷阱脚本：
  当碰撞时
    获取碰撞对象
    如果碰撞对象有 "角色" 组件
      发送广播 "玩家受伤"
      并携带数字 10
      播放动效 "陷阱触发"

场景 3：触发机关

机关触发器脚本：
  当碰撞时
    获取碰撞对象
    如果碰撞对象标签是 "玩家"
      发送广播 "平台出现"
      禁用自身碰撞（防止重复触发）

5. 交互距离设计

5.1 距离控制的重要性

合理的交互距离设计可以：

避免误触（太远也能触发）
防止卡死（够不到无法触发）
提升体验（精确控制触发时机）

5.2 实现方式

方式 1：交互范围组件

交互区域脚本：
  当物体进入时
    获取进入物体
    如果是玩家
      显示 "按E交互"
      设置玩家在交互范围内为 真

  当物体离开时
    隐藏 "按E交互"
    设置玩家在交互范围内为 假

方式 2：距离判断

检查交互脚本：
  无限循环 {
    获取最近可交互物体
    计算与玩家的距离
    如果距离小于 2
      显示交互提示
      如果按E
        触发交互
    否则
      隐藏交互提示
    等待 0.1 秒
  }

6. 交互提示设计

6.1 提示内容

交互提示应清晰表达：

交互方式（如"按E"、"点击"）
交互对象（如"打开门"、"对话"）

6.2 提示位置

物体UI：显示在物体上方
地图UI：显示在屏幕固定位置
操作UI：覆盖显示在屏幕中央

6.3 提示时机

提示控制脚本：
  当玩家进入交互范围时
    显示交互提示

  当玩家离开交互范围时
    隐藏交互提示

  当玩家按下交互键时
    如果在交互范围内
      发送广播 "执行交互"

7. 常见问题

Q：点击没有反应怎么办？

A：检查清单：

物体是否挂载了「可互动」组件
脚本是否有「当点击时」触发时机
脚本是否保存了
是否在试玩模式

Q：碰撞没有触发怎么办？

A：检查清单：

两个物体是否都有物理组件
物理组件的碰撞检测是否开启
两个物体的碰撞层是否匹配
碰撞脚本是否在正确的触发时机下

Q：区域检测不准怎么办？

A：检查：

物体检测器的大小和位置是否正确
检测区域的触发时机是否设置正确
是否需要调整检测层或标签

Q：多个物体都可以交互怎么办？

A：处理方式：

优先交互最近的一个
显示多个选项让玩家选择
设置交互优先级

8. 注意事项

交互反馈要明确：玩家操作后要有明显的视觉或声音反馈
避免误触：通过距离或条件控制交互触发
交互要有目的：每个交互都应有意义，不要堆砌无意义的交互
注意性能：大量交互物体时注意优化检测逻辑

待验证问题

以下问题需要进一步验证：

问题	状态	验证方向
可互动组件的具体参数说明	🔄 待验证	需要官方文档确认
物体检测器的检测范围设置方式	🔄 待验证	需要实际测试
碰撞层的具体配置方法	🔄 待验证	需要官方文档确认
交互提示的最佳实践	🔄 待验证	需要更多项目案例

📝 说明：交互系统核心用法已稳定，具体参数属于进阶内容。

后续优化方向

[ ] 补充具体积木块的截图示例
[ ] 添加更多交互系统的设计案例
[ ] 完善碰撞检测的详细说明
[ ] 增加交互反馈的设计指南

本轮维护说明

本轮检查了文档的规范化状态，确认文档格式已统一。

创游世界道具与物体交互系统指南 ​

一句话摘要 ​

适合谁阅读 ​

你将学到什么 ​

核心结论 ​

1. 交互系统基础概念 ​

1.1 交互的定义 ​

1.2 交互组件分类 ​

2. 可互动组件 ​

2.1 组件作用 ​

2.2 触发时机 ​

2.3 基本用法 ​

2.4 典型场景 ​

场景 1：打开宝箱 ​

场景 2：与 NPC 对话 ​

场景 3：切换物体状态 ​

3. 物体检测器 ​

3.1 组件作用 ​

3.2 触发时机 ​

3.3 基本用法 ​

3.4 典型场景 ​

场景 1：区域触发剧情 ​

场景 2：自动门 ​

场景 3：安全区检测 ​

4. 碰撞检测 ​

4.1 组件要求 ​

4.2 触发时机 ​

4.3 基本用法 ​

4.4 典型场景 ​

场景 1：拾取金币 ​

场景 2：踩到陷阱 ​

场景 3：触发机关 ​

5. 交互距离设计 ​

5.1 距离控制的重要性 ​

5.2 实现方式 ​

方式 1：交互范围组件 ​

方式 2：距离判断 ​

6. 交互提示设计 ​

6.1 提示内容 ​

6.2 提示位置 ​

6.3 提示时机 ​

7. 常见问题 ​

Q：点击没有反应怎么办？ ​

Q：碰撞没有触发怎么办？ ​

Q：区域检测不准怎么办？ ​

Q：多个物体都可以交互怎么办？ ​

8. 注意事项 ​

相关页面 ​

待验证问题 ​

后续优化方向 ​

本轮维护说明 ​

发现文档问题？