Godotline模板手册

Godotline模板 V0.0.1 使用手册

---

• 本页面将会介绍模板的使用方法。Godot基本操作本页面不予讲解，如遇问题请自行查询和解决。本教程适用于最新版模板
• 完全理解本教程需要掌握一些基本的Godot操作。如对Godot的基本操作尚不熟悉，建议熟悉后再阅读本教程

---

一、预设场景进入方法

打开模板后，并不会直接进入预设场景。需进入#Template/[Scenes]路径下找到Scene场景文件，双击进入预设场景

二、预设场景物件介绍

物件结构

LevelHolder：关卡统括物体 - 关卡内等级最高的父物体，所有物体都为其子物体
- Objects：关卡基础物体 - 包含关卡内的基本要素，如光源、相机和线
-- Directional Light：定向光源 - 关卡内最基本的光源
-- CameraFollower：相机根物体 - 控制相机跟随线运动
--- Camera：相机
-- Mainline：线
-- AnimationPlayer: 动画节点
-- gameui: ui
- Scene：场景统括物体 - 关卡内所有场景都放在此物体之下
-- Ground：地面

注：如无特别需求，除地面外其他物体不可随意删除

三、预制物体介绍

#Template下

• [Materials]：用于存放材质的文件夹
• [Music]：用于存放音乐的文件夹
• [Scenes]：用于存放场景的文件夹
• [Resources]：用于存放一些可能不会用到的文件的文件夹
• Crown：检查点
• Diamond：收集物
• BaseFloor：地面
• BaseWall：障碍物
• Percentage：百分比
• Ending：金字塔
• Trigger：触发器

五、初识线与跟随相机

线

面板数据

关于CharacterBody3D的介绍请移步：https://docs.godotengine.org/zh-cn/4.x/classes/class_characterbody3d.html

事件

Godot中亦作信号
事件仅在特定条件下触发，可用于实现特定效果。事件控制代码也在线上

• onturn ()：在线转向时调用

跟随相机

• Player：跟随目标物体。即线
• Add Position：相机初始偏移
• Rotation Offset：相机初始旋转角度
• Following：是否启用跟随

在启动播放时，相机的偏移、旋转角度和缩放会自动更改为 Default Offset 、 Default Rotation 和 Default Scale 。因此需提前设置好这三个数据

六、引导线的使用

铺设引导线

方法一：导入osu!谱面生成

先从osu!中导出你制作的谱面，将导出的.osz文件的后缀名更改为.zip，然后解压并得到.osu文件。接着将.osu文件的后缀名改为.txt，并导入工程

成功导入后，在Godot中复制其路径，在场景中新建一个Node3d节点，并绑定上BeatmapReader.gd脚本。
Player选择Mainline；Beatmap Path粘贴刚刚的路径；Box Prefab选择GuideTap

之后，点击 Create Guideline Taps By Beatmap 按钮即可生成引导线。实际生成可能存在误差，可通过修改Offset参数解决问题

十、触发器的使用

触发器，即 Trigger ，从Project窗口拖出即可使用。使用时，将其放置在线所经过的路上即可

添加代码

在触发器面板下，有 Script 按钮，点击并搜索要添加的代码，然后点击目标代码，即可添加

注：触发器面板上的其他组件无需修改
视频教程：

🛠️ UGC（用户生成内容）系统

项目支持完整的 UGC 功能，允许玩家创建和分享自定义关卡，目前仅ShinnLine适配。

运作流程

1. 制作关卡
2. 保存场景
3. 配置元数据：创建 LevelPatchMeta 资源定义关卡信息
4. 生成补丁：运行 GenerateLevelPatch.gd 编辑器脚本集成到游戏

元数据字段

- name: 关卡英文名
- chinese_name: 关卡中文名
- star: 难度星级 (0-6)
- level_maker: 关卡制作者
- music_maker: 音乐制作者
- tiny_levels: 关联的场景路径数组

从Unity（冰焰模板3）迁移

本模板内置了从Unity（冰焰模板3）迁移的工具包

📁 项目结构

godot-line/
├── #Template/                    # 核心模板资源
│   ├── [Materials]/              # 材质资源（地板、墙壁等）
│   ├── [Music]/                  # 背景音乐
│   ├── [Resources]/              # 模型、贴图、音效等资源
│   │   ├── Models/               # 3D 模型（钻石、皇冠等）
│   │   └── ui/                   # UI 贴图
│   ├── [Scenes]/                 # 场景模板
│   ├── [Scripts]/                # 核心脚本
│   │   ├── CameraScripts/        # 摄像机控制脚本
│   │   ├── GuideLine/            # 引导线脚本
│   │   ├── Trigger/              # 各类触发器脚本
│   │   └── ...                   # 其他功能脚本
│   └── level_patch_meta.tres     # 关卡元数据模板
├── .godot/                       # Godot 编辑器缓存（已忽略）
├── .vscode/                      # VSCode 配置
├── UGC.md                        # UGC 功能详细文档
├── base.pck                      # 基础资源包
├── export_presets.cfg            # 导出预设配置
└── project.godot                 # 项目配置文件

推荐插件

Unidot Importer