Pyrite64编辑器100分入门:11个窗口与核心功能速览(N64游戏编辑指南)
【免费下载链接】pyrite64N64 Game-Engine and Editor using libdragon & tiny3d项目地址: https://gitcode.com/GitHub_Trending/py/pyrite64
Pyrite64 是一款基于libdragon + tiny3d构建的 N64 游戏引擎与可视化编辑器,无需任何专有 N64 SDK,即可在真实 N64 主机或高精度模拟器上运行你制作的 3D 游戏。本文带你用 10 分钟速览编辑器的 11 个窗口与核心功能,快速建立完整的开发心智模型。🎮
什么是 Pyrite64:可视化编辑器 + 运行时引擎
Pyrite64 由两部分组成:
- 可视化编辑器:围绕中央 3D 视口排布的一组可停靠窗口,负责场景、对象、资产、脚本的全部编辑工作;
- 运行时引擎(n64/engine/):处理场景管理、渲染、碰撞、音频等,并支持 HDR+Bloom 与 256x256 大纹理渲染。
默认布局:11 个窗口一图速览
打开项目后,默认布局为:
- 左侧:Graph、Scene、Layers
- 中央:3D Viewport
- 右侧:Object、Asset、Model
- 底部:Files、Log、ROM
所有面板均可拖拽停靠、分栏或悬浮,随时可通过View > Reset Layout一键还原。
| 窗口 | 位置 | 作用速览 |
|---|---|---|
| 3D Viewport | 中央 | 实时渲染场景,自由飞行相机导航,选择与变换对象 |
| Graph | 左侧 | 场景对象层级树:重命名、拖拽改父子关系、启用/选择开关 |
| Scene | 左侧 | 场景列表与切换 |
| Layers | 左侧 | 图层管理,控制对象对相机的可见性 |
| Object Inspector | 右侧 | 查看选中对象的名称、变换(位置/旋转/缩放)与全部组件 |
| Asset Inspector | 右侧 | 查看/修改单个资产的导入设置 |
| Model Editor | 右侧 | 按材质编辑模型:颜色混合器、纹理、渲染标志、混合与雾效 |
| Files (Asset Browser) | 底部 | 缩略图浏览项目资产,拖入场景即可使用,支持新建脚本/场景 |
| Log | 底部 | 编辑器与构建输出,报错时第一时间来这里排查 |
| ROM | 底部 | 构建后按类别拆解卡带容量占用,定位最大的资产文件 |
| Node Editor | 独立窗口 | 可视化脚本编辑器:右键添加节点、拖拽连线搭建逻辑 |
💡 选中状态在所有窗口间共享:视口里点一下,Graph 和 Object 检查器会同步高亮,这是 Pyrite64 N64 游戏编辑器最高效的协作方式。
3D 视口导航速查
| 操作 | 按键 |
|---|---|
| 自由飞行视角 | 按住右键移动鼠标 |
| 飞行时位移 | 按住鼠标 +WASD(E/Q升降) |
| 环绕 | Alt+ 左键拖拽 |
| 平移 / 缩放 | 中键拖拽 / 滚轮 |
| 加速移动 | 按住Shift |
右上角的方向立方体可点击轴线快速对齐视角,每个视口各有一个。
核心功能一:模型导入与材质编辑
从 Blender 导出GLTF模型即可导入,并完整支持fast64材质。在 Model Editor 中,每个材质可独立配置:
- Override:默认继承项目设置,开启后才能自定义;
- Color Combiner:N64 标志性的 1/2 周期颜色混合器;
- Textures / Render Flags / Blending & Fog:纹理、Unlit、顶点特效、面剔除等选项。
完整材质系统说明见 docs/docs/manual/editor/materials/。
核心功能二:节点图可视化脚本
不想写 C++?双击 Files 窗口中的节点图资产即可打开 Node Editor:
- 右键画布→ 搜索并添加节点(内置 Flow、Value、Object、Debug 等分类,见 data/nodes/builtin/);
- 拖拽连线:从节点输出引脚拉到另一节点输入引脚;
- 将图挂到对象上,即可控制基本逻辑流程,例如拾取金币后播放音效、加载下一关卡。
核心功能三:构建与运行
- 菜单栏最右侧的绿色播放按钮(快捷键
F12)= Build & Run,一键编译并在模拟器中运行游戏; - 构建完成后,ROM 窗口会显示卡带容量预算条:按 Texture / Model / Audio / Font 等类别着色统计,点击表头可按大小排序,轻松找出最占空间的资产;
- 编译报错或行为异常?Log 窗口是第一个要看的地方,支持一键复制与另存为日志文件。
快速上手清单 ✅
- 用启动器新建项目(自动安装 Windows 工具链);
- 在 Files 窗口拖入 GLTF 模型到 3D 视口,实例化一个对象;
- 在 Object Inspector 中为对象添加 Model、Camera、Light 等组件;
- 右键 Graph 行 →To Prefab,把重复内容存为预制体;
- 右键画布搭一个节点图挂到对象上,实现交互逻辑;
- 按
F12构建运行,再打开 ROM 窗口检查卡带容量是否达标。
延伸阅读
- 官方文档:docs/docs/manual/editor/windows.rst(全部 11 个窗口详解)
- 场景结构与生命周期:docs/docs/manual/editor/objLifecycle.md
- 预制体系统:docs/docs/manual/editor/prefabs.md
- 碰撞与角色控制器:docs/docs/manual/editor/collision/characterBody.md
- 编辑器主程序入口:src/editor/pages/launcher.cpp
- 完整示例项目(含资产、场景与节点图):n64/examples/jam25/
⚠️ Pyrite64 仍处于早期开发阶段,API 可能随时变更;项目聚焦真实硬件,PC 上测试请使用 Ares(v147+)或 gopher64 等高精度模拟器。
【免费下载链接】pyrite64N64 Game-Engine and Editor using libdragon & tiny3d项目地址: https://gitcode.com/GitHub_Trending/py/pyrite64
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考