HiveWE 开源项目安装与使用指南

1. 项目目录结构及介绍

HiveWE 是一个专注于快速和易用性的魔兽争霸III世界编辑器。它极大地改进了原生的世界编辑器，在处理大型地图时尤为显著，提高了加载速度、渲染效率和编辑流畅性。以下是其主要的目录结构概述：

• src: 包含核心源代码，是编译项目的主体部分。
• CMakeLists.txt: CMake的配置文件，用于控制构建过程。
• vcpkg.json: VCPKG依赖管理文件，定义了项目的外部依赖项。
• LICENSE: 许可证文件，采用AGPL-3.0许可协议。
• README.md: 项目的主要说明文档，包括简要介绍、安装步骤等。
• .gitignore: 指示Git在版本控制中忽略哪些文件或文件夹。
• editorconfig: 编辑器配置文件，用于跨编辑器保持代码风格一致。
• CMakePresets.json: CMake预设文件，简化构建环境设置。

其他如clang-format, data, 和 screenshots 等目录分别用于代码格式化配置、数据文件和截图存储。

2. 项目的启动文件介绍

HiveWE 的启动涉及到编译后的可执行文件。在成功构建项目后，通常会在项目的构建目录（由CMake指定，例如 build）下生成该可执行文件。由于这是一个C++项目，并且通过CMake进行构建，具体的启动文件名称可能为 HiveWE 或者在调试模式下为 HiveWE_d，这依赖于你的构建配置。

启动前准备：

• 必须先通过VCPKG安装所有必要的依赖。
• 使用Visual Studio作为管理员打开项目并构建，以便处理符号链接等权限需求。

3. 项目的配置文件介绍

系统环境变量配置

• VCPKG_ROOT: 设置此环境变量指向vcpkg的安装位置，比如 C:\vcpkg。这对于确保CMake能够找到正确的库至关重要。

CMakeLists.txt

项目的主要配置位于 CMakeLists.txt 文件中。这个文件定义了如何构建项目，包括源文件的路径、链接的库、编译标志等。对于开发者来说，修改这个文件可以改变编译选项或添加额外的源文件。

其他潜在配置

• 根据需要，.editorconfig 能够影响开发者的编辑器设置，保证代码格式的一致性，但这并非运行项目所必需。
• 用户特定的配置或偏好设置通常不会直接在源码目录中提供，而是依赖于应用程序运行时读取的配置文件或环境变量。

为了成功使用HiveWE，重点在于正确配置开发环境，尤其是VCPKG和Visual Studio的部分，确保所有的依赖被正确安装并且拥有足够的权限来构建和运行项目。通过遵循上述指导，你可以顺利地搭建起开发或使用HiveWE的基础环境。