inanimate/quake3

!https://raw.githubusercontent.com/InAnimaTe/docker-quake3/master/quake_logo.jpg

Quake 3专用服务器镜像

这是一个容器化的Quake 3 Arena专用服务器，基于Debian系统的ioquake3引擎构建，可帮助用户快速搭建游戏服务器，支持自定义配置以满足不同游戏需求。本镜像参考了https://hub.docker.com/r/jberrenberg/quake3%EF%BC%8C%E5%B9%B6%E6%84%9F%E8%B0%A2Debian Games Team提供的quake3-server包。

核心功能

• 支持通过server.cfg自定义服务器配置（如地图循环、游戏规则）
• 允许通过命令行参数传递配置选项（如 fraglimit）
• 默认配置包含热门地图q3dm19（Apocalypse Void）
• 支持添加机器人（bots）参与游戏
• 日志输出到stdout/stderr，方便故障排查

使用场景

• 朋友间联机游玩Quake3 Arena
• 搭建私人游戏服务器供特定用户群体使用
• 测试Quake3服务器配置与功能

配置说明

启动方式

1. 使用server.cfg配置

镜像提供docker-compose.yml.example示例，展示如何处理核心依赖（零售版pak0.pk3文件、UDP端口27960转发、自定义server.cfg）。
注意：server.cfg需放置在/usr/share/games/quake3/baseq3目录下。

你可以通过挂载文件的方式使用自定义配置：

bash
docker run -d -v ./server.cfg:/usr/share/games/quake3/baseq3/server.cfg ...

或在构建镜像时将server.cfg加入（修改Dockerfile后构建）。

2. 命令行参数方式

可通过命令行传递配置选项，例如：

bash
docker run -d -v ./pak0.pk3:/usr/share/games/quake3/baseq3/pak0.pk3 inanimate/quake3 +fraglimit 150

完整参数列表可参考这里。

地图设置

默认启动地图为q3dm19（Apocalypse Void），你可在server.cfg中配置地图循环（如按顺序或随机切换地图）。标准地图详情可参考这里。

机器人设置

需在server.cfg顶部添加seta bot_enable 1启用机器人。地图启动后，可通过以下命令添加机器人：

botadd Major 3
botadd Sorlag 2

注意：机器人名称必须是支持的角色名，不能自定义。机器人设置详情可参考这里。

故障排查

查看服务器日志：

bash
docker logs quake3

参考链接

• Quake3 Linux服务器配置指南
• TLDP Game Server HOWTO - Quake3
• Quake3私人服务器与机器人设置