🎯 目标

设计一个模块化、流畅、高性能的弹幕系统，具有以下特点：

• 独立于主游戏相机运行（通过专用 Viewport 实现）
• 支持多种内容类型（文本、图片等）
• 弹幕可均匀分布于各轨道，或采用聚焦式分布风格
• 动态计算弹幕间距，智能避免重叠

🎬 Step-by-Step Construction

第一步：从简单开始

我们从一个基于 RichTextLabel 的弹幕节点开始：

上图展示了一个最基础的弹幕节点场景结构。每条弹幕都是一个 RichTextLabel 节点，挂载在弹幕专用的父节点下，便于统一管理和批量操作。

附加的 C# 脚本如下：

public override void _Process(double delta) {
    Position -= new Vector2(Speed * (float)delta, 0);
    if (Position.X + GetWidth() < 0) QueueFree();
}

这个方案一开始运行良好，直到我们发现弹幕出现了奇怪的偏移——即使弹幕移动到 (width, 0)，它似乎还是从不对的位置出现。

弹幕不仅没有从正确位置出现，还过早地消失了。为什么会这样？原来玩家有一个摄像机，导致屏幕显示的位置与实际位置并不一致。这就是问题所在。

第二步：与摄像机解耦

为了解决这个问题，我们将弹幕系统移动到一个独立的 Viewport 层（640x360），不再受主摄像机影响。这样弹幕无论世界如何移动，都会始终从屏幕右侧出现。

问题：弹幕是如何分布在屏幕上的？

以 B 站演唱会弹幕为例，可以看到屏幕上有多条轨道，弹幕从右向左滚动。

实际上，所有弹幕都分布在屏幕上的“隐形轨道”中，如下图所示：

第三步：添加轨道管理器

接下来，我们引入了 DanmakuTrackManager，用于管理弹幕轨道，确保弹幕不会重叠。

public class DanmakuTrackManager
{
  private readonly List<List<DanmakuTrackEntry>> _tracks;
  private readonly Node _danmakuLayer;
  private readonly int _trackCount;
  private readonly float _trackHeight;
  private readonly float _screenWidth;
  private readonly float _spacing;

  public bool IsTrackAvailable(int trackIndex)
  {
    var track = _tracks[trackIndex];
    if (track.Count == 0) return true;

    var last = track[^1];
    float lastRight = last.Entry.Position.X + last.Entry.Call("GetWidth").AsSingle();
    return lastRight + 20f < _screenWidth;
  }
}

系统会根据弹幕节点（如 RichTextDanmakuLabel）的尺寸自动计算轨道数量和间距。

第四步：添加分配器

为了灵活性的管理弹幕分配，我们需要添加一个分配器。因此我创建了一个 IDanmakuTrackDistributor，用于控制弹幕分配到哪个轨道。支持两种分配模式：

• 均匀分配：轮流填充各轨道
• 聚焦分配：集中堆叠到少数轨道，营造视觉冲击

public class EvenDistributor : IDanmakuTrackDistributor
{
  public int GetTrackIndex(int danmakuCount, int trackCount)
  {
    return danmakuCount % trackCount;
  }
}

这是最简单的轮询分配方式。实际应用中，还需结合轨道管理器判断轨道是否可用。

第五步：添加队列系统

通常我们希望弹幕批量出现但是不是一次性全都画在屏幕上，因此需要一个队列系统，统一分发弹幕。例如游戏触发某事件时，批量添加弹幕。

public partial class DanmakuSystemController : Node, ISystemModule
{
  private Queue<DanmakuQueueEntry> _danmakuQueue;
  private DanmakuTrackManager _trackManager;
  private double _lastSpawnTime = 0;

  public override void _Ready()
  {
    _danmakuQueue = new Queue<DanmakuQueueEntry>();
    _trackManager = new DanmakuTrackManager();
  }

  public void AddDanmaku(DanmakuQueueEntry entry)
  {
    _danmakuQueue.Enqueue(entry);
    ProcessQueue();
  }

  public override void _Process(double delta)
  {
    if (_danmakuQueue.Count == 0) return;
    // Peek queue and if time passed, spawn a danmaku
    if (Time.GetTicksMsec() > _lastSpawnTime + SpawnInterval)
    {
      // If the next track is available on the track manager
      if (_trackManager.HasTrackSpace())
      {
        var danmakuData = _danmakuQueue.Dequeue();
        _trackManager.AddDanmakuToTrack(danmakuData.Data);
        _lastSpawnTime = Time.GetTicksMsec();
      }
    }
  }
}

这样可以在 _Process 方法中逐帧检查队列和轨道空间，轨道可用时再生成弹幕，避免重叠。

第六步：修复超车问题

出现了一个 bug：同一轨道上速度快的弹幕会“超车”慢弹幕，导致重叠。B 站等平台也有类似现象。解决方法是引入“速度修正”机制，确保在轨道添加的新的弹幕速度不会超过轨道里已有弹幕的最大速度。

可以在在 DanmakuTrackManager 中添加如下代码：

// 设置初始速度，限制最大速度防止超车
danmakuData.Speed = Math.Max(GetMaxSpeedInTrack(trackIndex), danmakuData.Speed);

然后实现 GetMaxSpeedInTrack 方法：

private float GetMaxSpeedInTrack(int trackIndex)
{
  var track = _tracks[trackIndex];
  if (track.Count == 0) return 0;

  // 遍历轨道，获取最大速度
  return track.Max(entry => entry.Entry.Speed);
}

第七步：系统整合

现在我们已经实现了 DanmakuTrackManager、IDanmakuTrackDistributor、DanmakuSystemController 和 RichTextDanmakuLabel，可以在主场景中将它们整合起来。

最终效果

总结

现在的弹幕系统已经模块化、高性能且易于扩展，支持文本、图片等多种内容类型，弹幕分布可以均匀或聚焦，动态计算间距有效避免重叠。

这也是我用 Godot 4 和 C# 实现复杂功能、同时保持架构清晰的一个实践。如果你也想在 Godot 4 里做弹幕系统，希望这篇文章能帮到你！有问题或想法欢迎留言交流。Happy coding!

“Hello World.” —— 是我最初写下的第一行代码。
“GoodBye()” —— 是我在系统尽头，留给世界的函数调用。

👋 我是谁

我是一名程序员。也是一名独立游戏开发者。
目前，这款游戏是我一个人做的。策划、美术、程序、写作，全靠夜里那一点点不甘心和心里那些说不出口的事。

从前我真的很喜欢写代码。直到有一天，我发现自己已经不再为自己写东西了。
我写给 Jira，写给老板，写给面试官，写给 KPI，写给那个“足够理性、足够稳定”的职业形象。

后来我意识到，我不是不热爱写代码了。
我只是，太久没有为自己写下什么了。

💬 为什么做这款游戏？

因为有太多话，我在现实中说不出口。

我想说我很努力，但还是很累。
我想说我不想再背面试题了。
我想说，我写的每一行代码不是为了积分，不是为了 review 评论里的“well done”，
而是因为我曾经真的相信，代码是创造的语言。

这不是一个励志故事。
这是一场“从 Hello 到 GoodBye()”的过程。
不是失败，而是一次自我恢复。

🎮 这是什么游戏？

它是一个平台动作游戏。像素风，带叙事。
它的主角是一名程序员。你可以理解为我，也可以理解为你。

这款游戏没有宏大叙事，没有救世主，没有打败邪恶的结局。
它只是记录了一个人，在职场系统中逐渐失控，然后重新找回自我的过程。

或者更准确地说：

它是我为自己写下的，一行还没 return 的函数。

🛠 当前状态

游戏仍在开发中。Demo 制作进行中，没有发布日期，没有宣传片。
但我会持续更新这个博客，记录制作过程和一路上的小情绪。

如果你也曾有过一瞬间，
觉得自己好像不是“人”了，只是一个“进程”，
那欢迎你来看看这款游戏。

HelloWorld.GoodBye()
不是一个项目，是一句话。
写给系统，也写给你自己。

“我懂。”
“你没有问题。”
“你被看见了。”