ezQuake 技术文档

1. 安装指南

1.1 玩 QuakeWorld 所需文件

为了玩 Quakeworld，你需要从原始 Quake 游戏中获取 pak0.pak 和 pak1.pak 文件。

1.2 在现有 Quake 安装中安装 ezQuake

如果你已经有了一个 Quake 安装，只需将 ezQuake 执行文件提取到你的 Quake 目录中。

注意：在安装过程中可能会遇到关于 glide2x.dll 缺失的错误。为了解决这个问题，从你的 Quake 目录中删除 opengl32.dll 文件。

1.3 升级 nQuake 安装

如果你已经安装了 nQuake 的版本，可以通过将新执行文件提取到 nQuake 目录中来升级 ezQuake。

1.4 最小化干净安装

如果你希望进行干净安装，可以按照以下步骤操作：

1. 创建一个新目录。
2. 将 ezQuake 执行文件提取到这个目录中。
3. 在这个目录中创建一个名为 id1 的子目录。
4. 将 pak0.pak 和 pak1.pak 文件复制到这个子目录中。

2. 项目使用说明

ezQuake 是一款现代化的 QuakeWorld 客户端，集成了丰富的功能和特性，使得 QuakeWorld 更加容易上手和游戏。用户可以通过内置的服务器浏览器轻松搜索和筛选在线服务器，并通过多视角支持观看游戏回放。

2.1 特性

• 现代图形
• QuakeTV 支持
• 丰富的菜单
• 多视角支持
• 众多专业游戏功能
• 内置服务器浏览器和 MP3 播放器控制
• 录制游戏浏览器
• 游戏内所有可能的图形元素定制，包括头部显示器 (HUD)
• 脚本编程可能性
• 支持 Windows、Linux、MacOSX 和 FreeBSD 平台 (SDL2)

3. 项目API使用文档

本项目未提供专门的 API 文档，因为 ezQuake 主要是作为一个客户端软件使用，不提供外部 API 接口。

4. 项目安装方式

4.1 编译 Windows 版本

使用 Visual Studio

1. 克隆 ezQuake 源代码：

   git clone --recurse-submodules https://github.com/ezQuake/ezquake-source.git ezquake
   

2. 初始化 Vcpkg 并刷新子模块：

   bootstrap.bat
   

3. 在 Visual Studio 中加载解决方案并编译目标。

使用 Ubuntu Bash (WSL)

1. 启用 Windows Bash 功能。
2. 安装所需依赖。
3. 克隆 ezQuake 源代码。
4. 确保行结束符不是 CRLF。
5. 编译 ezQuake 执行文件。

4.2 编译 Linux 版本

确保安装了所有必要的依赖项，然后克隆 git 仓库并编译执行文件。

4.3 编译 macOS 版本

使用 Homebrew 安装所需依赖，然后编译执行文件。

4.4 夜间构建

可以从夜间构建页面获取最新的构建版本。