PineappleTech/MRFishingMaster
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
78e7da158cd204b996dcfd310ef1a4f2a2fe29e1
MRFishingMaster/Assets/_FishingMaster/Scripts/Statue/README_StatueSystem.md

8.5 KiB
Raw Blame History

海底雕像事件系统 - 设置文档

系统概述

海底雕像事件是一个周期性的收集玩法：

  • 每60秒生成3个漂流瓶，从不同角度游入
  • 击中漂流瓶后，碎片带拖尾光效飞到石像位置
  • 石像由10个碎片组成，初始不显示，飞到一个显示一个
  • 10个碎片都到达后，石像拼凑完成
  • 完成后材质从灰色变为彩色，播放完成特效
  • 共3个雕像，集齐后事件结束

核心脚本

1. DriftBottle.cs - 漂流瓶

挂载在漂流瓶预制体上，控制漂流瓶的移动和被击中逻辑。

2. DriftBottleManager.cs - 管理器（单例）

管理漂流瓶的生成、雕像进度、事件状态。

3. DriftBottlePathGenerator.cs - 路径生成器

动态生成3条不同角度的漂流瓶移动路径。

4. DriftBottleBulletHit.cs - 子弹击中检测

处理子弹和AOE伤害对漂流瓶的击中判定。

5. FragmentFlyEffect.cs - 碎片飞行效果

碎片从漂流瓶位置飞到石像位置的动画效果（带拖尾）。

6. StatueAssembler.cs - 石像拼凑器

管理石像碎片的显示和拼凑动画，控制材质变化和完成特效。

Unity场景设置步骤

步骤1：创建碎片飞行特效预制体

  1. 创建空物体 FragmentFlyEffect
  2. 添加组件 FragmentFlyEffect.cs
  3. 添加子物体：
    • Trail: ParticleSystem（拖尾效果）
      • 使用发光材质
      • 设置拖尾长度和颜色
    • Light: Point Light（发光效果）
      • 颜色：金色或蓝色
      • 范围：2-3米
    • Mesh: 碎片模型（可选）
      • 小石块或水晶模型
  4. 保存为预制体

步骤2：创建石像预制体

  1. 创建空物体 Statue_01

  2. 添加组件 StatueAssembler.cs

  3. 配置参数：

    • Statue Index: 0
    • Statue Name: 海神雕像
    • Total Fragments: 10
    • Fragment Meshes: 10个碎片模型
      • 将完整石像模型拆成10个子物体
      • 按顺序放入数组（0-9）
    • Gray Material: 灰色/石质材质
    • Color Material: 彩色/金色材质
    • Complete Effect: 完成时的粒子特效
    • Glow Effect: 发光效果物体
    • Complete Light: 完成时的光照

  4. 复制创建另外2个石像（Statue_02, Statue_03）

步骤3：创建漂流瓶预制体

  1. 在场景中创建一个空物体，命名为 DriftBottle

  2. 添加组件：

    • DriftBottle.cs
    • DriftBottleBulletHit.cs
    • SplineController (来自Curvy插件)
    • Collider (BoxCollider或SphereCollider，勾选IsTrigger)
    • Rigidbody (勾选IsKinematic)

  3. 添加模型作为子物体：

    • 创建一个子物体 Model
    • 添加漂流瓶3D模型

  4. 添加特效：

    • 创建子物体 HitEffect，添加ParticleSystem（破碎效果）

  5. 将 DriftBottle 拖入Project窗口创建预制体

步骤4：创建漂流瓶管理器

  1. 在场景中创建一个空物体，命名为 DriftBottleManager
  2. 添加组件 DriftBottleManager.cs
  3. 配置参数：
    • Spawn Interval: 60 (生成间隔秒数)
    • Spawn Count Per Wave: 3 (每次生成数量)
    • Drift Bottle Prefab: 步骤3创建的预制体
    • Fragment Fly Prefab: 步骤1创建的飞行特效预制体
    • Statue Transforms: 拖拽3个石像物体
    • Statue Show Offset: 石像相对于玩家的位置偏移

步骤5：创建路径生成器

  1. 在场景中创建一个空物体，命名为 DriftBottlePathGenerator
  2. 添加组件 DriftBottlePathGenerator.cs
  3. 配置参数：
    • Path Count: 3 (路径数量)
    • Start Distance: 12 (起始距离)
    • End Distance: 8 (结束距离)
    • Horizontal Spread: 60 (水平分散角度，左-30°、中0°、右+30°)
    • Vertical Height: 2 (垂直高度)

步骤6：设置层级和碰撞

  1. 创建新层级 DriftBottle
  2. 将漂流瓶预制体设置为 DriftBottle 层级
  3. 确保子弹的LayerMask包含 DriftBottle 层级

步骤7：配置音效

在GameManager中配置以下音效名称：

  • 漂流瓶出现 - 每次生成时播放
  • 漂流瓶破碎 - 击中漂流瓶时播放
  • 碎片到达 - 碎片飞到石像时播放
  • 石像完成 - 石像拼凑完成时播放
  • 雕像事件完成 - 所有雕像完成时播放

石像预制体结构参考

Statue_01 (Root)
├── StatueAssembler.cs
│
├── Fragment_01 (碎片1 - 初始隐藏)
│   └── MeshRenderer (灰色材质)
├── Fragment_02 (碎片2 - 初始隐藏)
│   └── MeshRenderer (灰色材质)
├── ... (共10个碎片)
├── Fragment_10 (碎片10 - 初始隐藏)
│   └── MeshRenderer (灰色材质)
│
├── CompleteEffect (完成粒子特效 - 初始隐藏)
├── GlowEffect (发光效果 - 初始隐藏)
└── CompleteLight (光照 - 初始隐藏)

碎片飞行特效预制体结构

FragmentFlyEffect (Root)
├── FragmentFlyEffect.cs
├── Trail (ParticleSystem - 拖尾)
│   ├── 发光材质
│   └── 拖尾设置
├── Light (PointLight - 发光)
└── Mesh (碎片模型 - 可选)

关键配置参数说明

DriftBottleManager 配置

参数 默认值 说明
spawnInterval 60 每60秒生成一波漂流瓶
spawnCountPerWave 3 每次生成3个，分散在不同路径
totalStatues 3 总共3个雕像需要收集
fragmentsPerStatue 10 每个雕像需要10个碎片

FragmentFlyEffect 配置

参数 默认值 说明
flyDuration 1.5s 碎片飞行时间
flyHeight 3m 飞行弧线高度
rotateSpeed 720°/s 碎片旋转速度

StatueAssembler 配置

参数 默认值 说明
totalFragments 10 石像由10个碎片组成
grayMaterial - 未激活时的灰色材质
colorMaterial - 完成后的彩色材质
materialTransitionDuration 1s 材质变化时间

视觉效果流程

  1. 漂流瓶生成：每60秒从3个角度游入3个漂流瓶
  2. 击中漂流瓶：播放破碎效果
  3. 碎片飞出：带拖尾光效的碎片从漂流瓶位置飞出
  4. 飞行过程：碎片沿弧线飞向石像位置，持续旋转发光
  5. 到达石像：碎片弹跳一下后消失
  6. 显示碎片：石像上对应位置的碎片显示出来（从缩放0弹出）
  7. 重复10次：10个碎片依次显示
  8. 石像完成：
    • 10个碎片材质从灰色渐变为彩色
    • 播放完成粒子特效
    • 石像震动并发光
    • 播放完成音效

调试功能

在 DriftBottleManager 中开启 Debug Mode 后：

  • 按键盘 B 键可以立即生成一波漂流瓶

事件流程

  1. 游戏开始10秒后，启动雕像事件
  2. 立即生成第一波3个漂流瓶（碎片1-3）
  3. 开始60秒倒计时
  4. 玩家击中漂流瓶，碎片飞向他对应的石像
  5. 碎片到达后，石像上显示对应碎片
  6. 60秒后生成第二波3个漂流瓶（碎片4-6）
  7. 重复直到所有30个碎片生成完毕
  8. 收集完10个碎片后，石像拼凑完成，播放完成动画
  9. 继续收集完成第二、第三个石像
  10. 所有石像完成后，事件结束，不再生成漂流瓶

代码集成示例

监听雕像事件

void Start()
{
    if (DriftBottleManager.Instance != null)
    {
        DriftBottleManager.Instance.OnStatueCompleted += OnStatueCompleted;
        DriftBottleManager.Instance.OnAllStatuesCompleted += OnAllStatuesCompleted;
    }
}

void OnStatueCompleted(int statueIndex)
{
    Debug.Log($"石像 {statueIndex + 1} 拼凑完成！");
    // 发放奖励等
}

void OnAllStatuesCompleted()
{
    Debug.Log("所有石像收集完成！");
    // 发放最终奖励
}

注意事项

  1. 石像模型：需要将完整石像模型拆分成10个子模型，每个对应一个碎片
  2. 材质设置：灰色材质和彩色材质需要有相同的Shader，以便平滑过渡
  3. 拖尾效果：FragmentFlyEffect的拖尾ParticleSystem需要设置合适的材质和参数
  4. 性能优化：最多同时存在3个漂流瓶和3个飞行碎片，对性能影响很小
  5. 位置设置：石像位置可以通过statueTransforms数组设置，或使用默认的偏移计算

扩展建议

  1. 不同碎片形状：每个石像的10个碎片可以有不同的形状
  2. 飞行路径：可以自定义碎片的飞行路径（曲线、螺旋等）
  3. 完成奖励：石像完成后可以掉落金币或宝箱
  4. 音效增强：可以为不同石像配置不同的完成音效
  5. 特效增强：完成时可以添加震动、闪光等效果
Reference in New Issue View Git Blame Copy Permalink