113 lines
4.2 KiB
Markdown
113 lines
4.2 KiB
Markdown
# 灵灯技能实现计划
|
||
|
||
## 现有系统分析
|
||
|
||
- **光照系统**: `LightSource` 组件注册到 `LightMaskSystem`，由 `DarknessOverlay` shader 在遮罩层挖洞实现光照效果
|
||
- **伤害系统**: `HealthSystem.Damage(int)` 通用扣血，敌人碰到的标准伤害接口
|
||
- **技能参考**: `EchoSystem` (E键摇铃) 是现有最接近的技能模板，有冷却、按键触发的成熟模式
|
||
- **命名空间**: 新脚本放在 `IndianOceanAssets.Engine2_5D` 命名空间，与现有 2.5D 引擎脚本一致
|
||
|
||
## Task 1: 创建 SpiritLanternSystem.cs（玩家技能管理组件）
|
||
|
||
**文件**: `Assets/eco/SpiritLanternSystem.cs`
|
||
|
||
挂载到玩家物体上，负责：
|
||
- 管理灵灯数量（初始 5 个，`[SerializeField] private int maxLanterns = 5`）
|
||
- 按键 U 触发放置（`[SerializeField] private KeyCode lanternKey = KeyCode.U`）
|
||
- 冷却时间控制（`[SerializeField] private float cooldown = 3f`）
|
||
- 放置时实例化灵灯 Prefab 到玩家当前位置
|
||
- 跟踪所有已放置的灵灯，回收时增加可用数量
|
||
- 提供 `public int RemainingLanterns` 属性供 UI 使用
|
||
|
||
核心逻辑：
|
||
```csharp
|
||
// 按 U 且 CD 就绪 且 还有灵灯 → 放置
|
||
if (Input.GetKeyDown(lanternKey) && remainingLanterns > 0 && Time.time > lastPlaceTime + cooldown)
|
||
{
|
||
PlaceLantern();
|
||
}
|
||
```
|
||
|
||
放置时：
|
||
1. 实例化 `lanternPrefab` 在玩家位置
|
||
2. `remainingLanterns--`，记录 `lastPlaceTime`
|
||
3. 订阅灵灯的 `OnLanternRecalled` 事件（回收时 `remainingLanterns++`）
|
||
|
||
## Task 2: 创建 SpiritLantern.cs（灵灯行为组件）
|
||
|
||
**文件**: `Assets/eco/SpiritLantern.cs`
|
||
|
||
挂在灵灯 Prefab 上，负责单个灵灯的行为：
|
||
- **存在时间**: `[SerializeField] private float lifetime = 10f`，倒计时结束触发回收
|
||
- **碰撞检测**: 使用 `CircleCollider2D` (trigger) 检测怪物接触
|
||
- `OnTriggerEnter2D` → 调用 `HealthSystem.Damage(1)` 扣怪物 1 血 → 灵灯消失 → 通知 `SpiritLanternSystem` 回收
|
||
- **光照**: 挂载 `LightSource` 组件（复用现有光照系统，与主角遮罩效果一致）
|
||
- **回收事件**: `public event Action OnLanternRecalled`，供 `SpiritLanternSystem` 订阅
|
||
- **Layer**: 灵灯 Prefab 需放在 `whatIsEnemy` 能检测到的层，或使用独立的碰撞检测方式
|
||
|
||
碰撞逻辑：
|
||
```csharp
|
||
private void OnTriggerEnter2D(Collider2D other)
|
||
{
|
||
var health = other.GetComponent<HealthSystem>();
|
||
if (health != null && !other.isPlayer) // 排除玩家
|
||
{
|
||
health.Damage(1);
|
||
Recalled(); // 灵灯消失 + 通知回收
|
||
}
|
||
}
|
||
```
|
||
|
||
超时回收：
|
||
```csharp
|
||
private void Update()
|
||
{
|
||
lifetime -= Time.deltaTime;
|
||
if (lifetime <= 0)
|
||
Recalled();
|
||
}
|
||
```
|
||
|
||
## Task 3: 创建灵灯 Prefab
|
||
|
||
**文件**: `Assets/eco/Prefabs/SpiritLantern.prefab`
|
||
|
||
Prefab 组成：
|
||
- 空 GameObject（或灯笼 Sprite）
|
||
- `SpriteRenderer` — 灯笼外观（需要美术资源，可先用临时 Sprite）
|
||
- `LightSource` 组件 — 配置光照半径和强度（复用现有光照系统）
|
||
- `SpiritLantern` 脚本 — 管理生命周期和碰撞
|
||
- `CircleCollider2D` (isTrigger = true) — 检测怪物接触
|
||
- `Rigidbody2D` (isKinematic = true) — Collider 需要 Rigidbody 才能触发
|
||
|
||
## Task 4: 配置与集成
|
||
|
||
1. 在 `PlayerController` 的 `[RequireComponent]` 中添加 `SpiritLanternSystem`（可选，也可以手动挂载）
|
||
2. 在 Inspector 中配置：
|
||
- `SpiritLanternSystem` 的 `lanternPrefab` 引用
|
||
- `LightSource` 的光照半径/强度
|
||
- 冷却时间、灵灯数量、存在时间等参数
|
||
3. 确保灵灯 Prefab 的 Layer 不与玩家/敌人碰撞冲突
|
||
|
||
## 数据流总结
|
||
|
||
```
|
||
按 U 键
|
||
→ SpiritLanternSystem.PlaceLantern()
|
||
→ 实例化 SpiritLantern Prefab（带 LightSource）
|
||
→ LightSource 自动注册到 LightMaskSystem → 遮罩挖洞（照亮区域）
|
||
→ 怪物碰触 → HealthSystem.Damage(1) → 灵灯 Recalled() → remainingLanterns++
|
||
→ 超时 → Recalled() → Destroy → remainingLanterns++
|
||
```
|
||
|
||
## 可配置参数汇总
|
||
|
||
| 参数 | 默认值 | 所在脚本 |
|
||
|------|--------|----------|
|
||
| maxLanterns | 5 | SpiritLanternSystem |
|
||
| cooldown | 3s | SpiritLanternSystem |
|
||
| lanternKey | U | SpiritLanternSystem |
|
||
| lifetime | 10s | SpiritLantern |
|
||
| lightRadius | 4f | LightSource (Prefab上) |
|
||
| lightIntensity | 1f | LightSource (Prefab上) |
|