Godot Voxel 项目教程

Godot Voxel 项目教程

godot_voxel Voxel module for Godot Engine 项目地址: https://gitcode.com/gh_mirrors/go/godot_voxel

1. 项目目录结构及介绍

godot_voxel/
├── constants/
├── doc/
├── edition/
├── editor/
├── engine/
├── generators/
├── meshers/
├── misc/
├── modifiers/
├── project/
├── shaders/
├── storage/
├── streams/
├── terrain/
├── tests/
├── thirdparty/
├── util/
├── clang-format
├── gitignore
├── readthedocs.yml
├── LICENSE.md
├── README.md
├── SConstruct
├── SCsub
├── common.py
├── config.py
├── gource_view.sh
├── nuget.config
├── register_types.cpp
├── register_types.h
└── voxel_version.py

目录结构介绍

• constants/: 包含项目的常量定义。
• doc/: 包含项目的文档文件。
• edition/: 包含编辑器相关的代码。
• editor/: 包含编辑器扩展的代码。
• engine/: 包含与 Godot 引擎集成的代码。
• generators/: 包含生成体素数据的代码。
• meshers/: 包含体素网格化的代码。
• misc/: 包含杂项代码。
• modifiers/: 包含体素修改器的代码。
• project/: 包含项目配置文件。
• shaders/: 包含着色器代码。
• storage/: 包含体素存储相关的代码。
• streams/: 包含数据流处理的代码。
• terrain/: 包含地形生成的代码。
• tests/: 包含测试代码。
• thirdparty/: 包含第三方库。
• util/: 包含实用工具代码。
• clang-format: 代码格式化配置文件。
• gitignore: Git 忽略文件配置。
• readthedocs.yml: ReadTheDocs 配置文件。
• LICENSE.md: 项目许可证文件。
• README.md: 项目介绍文件。
• SConstruct: SCons 构建配置文件。
• SCsub: SCons 子构建配置文件。
• common.py: 通用 Python 脚本。
• config.py: 配置文件。
• gource_view.sh: Gource 可视化脚本。
• nuget.config: NuGet 配置文件。
• register_types.cpp: 类型注册 C++ 代码。
• register_types.h: 类型注册头文件。
• voxel_version.py: 体素版本管理脚本。

2. 项目启动文件介绍

项目的启动文件主要是 register_types.cpp 和 register_types.h。这两个文件负责在 Godot 引擎中注册自定义的体素类型。

register_types.cpp

#include "register_types.h"
#include "voxel_version.h"

void register_voxel_types() {
    // 注册体素类型
}

void unregister_voxel_types() {
    // 注销体素类型
}

register_types.h

#ifndef REGISTER_TYPES_H
#define REGISTER_TYPES_H

void register_voxel_types();
void unregister_voxel_types();

#endif // REGISTER_TYPES_H

3. 项目配置文件介绍

项目的配置文件主要包括 nuget.config 和 readthedocs.yml。

nuget.config

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" />
  </packageSources>
</configuration>

readthedocs.yml

version: 2

sphinx:
  configuration: doc/conf.py

python:
  version: 3.8
  install:
    - requirements: doc/requirements.txt

这些配置文件分别用于 NuGet 包管理和 ReadTheDocs 文档构建。

godot_voxel Voxel module for Godot Engine 项目地址: https://gitcode.com/gh_mirrors/go/godot_voxel