本页目录

Godot 体素游戏演示(voxelgame)

voxelgame · Zylann/voxelgame

基于 Godot Engine 4.4 的体素世界原型/演示项目,依赖 C++ 模块 Voxel,包含方块世界、方块地形与平滑地形等可运行场景;其中方块游戏类似 Minecraft 风格并支持基础多人同步,项目自述并非完整游戏,部分功能可能未完成。

动作游戏 Godot GDScript 网络联机 渲染技术 中级
★ Stars 777 Forks 117 License 未明确 更新 2026-11-04

国内开发环境适配

Windows
未知
Linux
未知
macOS
未知
引擎 / 框架:Godot 暂无中文教程标记 未标记站长实测
需先获取并编译 Godot 的 C++ 模块 Voxel,通常要拉取 Godot 引擎源码与模块仓库,国内访问 GitHub 可能较慢,建议配置镜像或代理;编译工具链与具体步骤以模块仓库文档为准,待核验。

中文项目介绍

voxelgame 是作者 Zylann 为自研 Godot C++ 模块 Voxel 配套搭建的一组演示场景集合。项目的出发点很直接:把体素模块放进真实可玩的 Godot 工程里跑一跑,验证地形、方块外观、平滑地形等不同用法是否工作正常,同时给使用者提供可以直接打开、直接运行的参考样例。

因此它并不是一款包装完整的商业作品,仓库自述中明确写道:方块游戏只是「用 VoxelTerrain 做出方块观感的实用示例」,部分功能可能尚不完整,项目本身也没有做成一款成品游戏的打算。阅读或运行这个工程时,把它当作可交互的技术演示会比当作游戏更贴切。

工程基于 Godot Engine 4.4,主语言为 GDScript;核心的体素能力来自外部的 C++ 模块,而不是仓库内自带的脚本实现。作者另有一条 full_gdscript 分支保存了早期纯 GDScript 版本,该分支已不再维护,仅作历史参考。

技术架构分析

技术要点

  • 模块化体素能力:真正的体素数据结构、地形网格生成与编辑逻辑位于独立的 C++ 模块仓库中,本工程只负责调用与展示。这意味着只看本仓库无法理解底层算法,需要同时阅读模块源码。
  • 两种地形表现:方块地形与 Transvoxel 平滑地形并存,同一套 VoxelTerrain 用法能呈现截然不同的视觉风格。
  • 场景驱动的验证方式:每个功能点对应一个独立场景,便于单独调试,也便于读者按需挑选参考。
  • GDScript 作为工程主语言:玩法逻辑、场景组织与 UI 侧代码以 GDScript 编写,降低了阅读门槛;只有在需要体素核心能力时才涉及 C++ 模块。

依赖与构建

运行前必须先准备好模块依赖:

  1. 获取 C++ 模块 Voxel,按该仓库的说明编译并集成到 Godot 中;
  2. 使用 Godot Engine 4.4 打开本工程(版本与模块需匹配,否则可能出现接口不兼容);
  3. 打开上文中任一 .tscn 场景运行。

需要注意,由于依赖自定义模块,通常不能直接用官方预编译的编辑器打开就跑,而需要使用带模块的构建版本。README 没有给出各平台的详细编译步骤与系统要求,具体流程应以模块仓库的文档为准。

补充说明

可运行场景

README 中列出了三个可直接打开的场景,覆盖体素模块的三种典型用法:

  • blocky_game/main.tscn:方块风格的「类 Minecraft」演示,包含若干随机要素,是三个场景里内容最丰富的一个。
  • blocky_terrain/main.tscn:方块地形的基础测试场景,用于观察方块化地形的生成与显示。
  • smooth_terrain/main.tscn:Transvoxel 平滑地形的测试场景,展示与方块外观不同的连续曲面地形表现。

三个场景定位不同:后两个偏向「最小验证」,用于单独观察地形模块的表现;第一个则把地形、玩家、联机等要素组合在一起,更接近实际项目中的使用方式。

方块游戏与多人同步

blocky_game 是仓库的重点演示,官方定位是「VoxelTerrain 配合方块外观」的实践样例。README 对它的描述包含两点:

  • 可多人游玩:既可以作为主机开一局,也可以加入别人的游戏,还可以完全不开联机、单人游玩。
  • 同步机制非常基础:玩家的物理状态由各自客户端负责(本地权威),而体素数据由服务器下发,并且体素的编辑操作都在服务器上执行。

这是一套刻意简化的模型——把物理交给客户端换取手感与响应,把世界数据的权威留在服务端以保证一致性。它足够支撑演示,但作者并未声称这是健壮的网络方案,也没有在文档中给出延迟、丢包或反作弊方面的处理说明。想要做正式联机项目的人,应把这里视为起点而非终点。

学习建议

  • 想弄清「一个体素世界在 Godot 里怎么搭起来」的读者,可以先从两个 *_terrain 场景入手,观察最小配置,再读 blocky_game 的完整组合。
  • 关注联机的读者,建议重点阅读服务器下发体素、客户端编辑后回传的处理流程,理解「客户端权威物理 + 服务端权威世界」这种分工的取舍。
  • 需要体素底层实现的读者,请直接转到模块仓库;本工程是使用方的示例,不含核心算法说明。
  • 由于项目自述功能可能不完整,遇到缺失或半成品的行为属于预期情况,不建议直接以此为基础承诺产品级需求。

开源许可证与版权说明

许可证标识:未明确。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目