Pyrite64编辑器100分入门:11个窗口与核心功能速览(N64游戏编辑指南)
2026/9/17 23:35:54 网站建设 项目流程

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 视口导航速查

操作按键
自由飞行视角按住右键移动鼠标
飞行时位移按住鼠标 +WASDE/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:

  1. 右键画布→ 搜索并添加节点(内置 Flow、Value、Object、Debug 等分类,见 data/nodes/builtin/);
  2. 拖拽连线:从节点输出引脚拉到另一节点输入引脚;
  3. 将图挂到对象上,即可控制基本逻辑流程,例如拾取金币后播放音效、加载下一关卡。

核心功能三:构建与运行

  • 菜单栏最右侧的绿色播放按钮(快捷键F12)= Build & Run,一键编译并在模拟器中运行游戏;
  • 构建完成后,ROM 窗口会显示卡带容量预算条:按 Texture / Model / Audio / Font 等类别着色统计,点击表头可按大小排序,轻松找出最占空间的资产;
  • 编译报错或行为异常?Log 窗口是第一个要看的地方,支持一键复制与另存为日志文件。

快速上手清单 ✅

  1. 用启动器新建项目(自动安装 Windows 工具链);
  2. 在 Files 窗口拖入 GLTF 模型到 3D 视口,实例化一个对象;
  3. 在 Object Inspector 中为对象添加 Model、Camera、Light 等组件;
  4. 右键 Graph 行 →To Prefab,把重复内容存为预制体;
  5. 右键画布搭一个节点图挂到对象上,实现交互逻辑;
  6. 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询