# unity_wargame **Repository Path**: violent_sniper/unity_wargame ## Basic Information - **Project Name**: unity_wargame - **Description**: 兵棋游戏 - **Primary Language**: Unknown - **License**: MulanPSL-2.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-15 - **Last Updated**: 2026-11-18 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Wargame 开发与运行入口 ## 设计文档入口 - [完整设计导航](docs/README.md):主设计、12 个功能分设计、契约索引、维护规则和历史资料。 - [Wargame 当前系统架构(主设计文档)](docs/项目总纲.md):当前权威边界与分功能设计索引。 - [红蓝回合推进设计方案(WG-TURN-001)](docs/design/02-红蓝回合推进.md):红蓝提交、按回合/自动推进、层级转换、停止/结束、恢复与分阶段验收;后续相关开发按此方案维护。 测试架构、套件和执行命令见仓库根 [tests/README.md](../../tests/README.md)。统一入口从仓库根执行: ```bash python tests/run.py local --component wargame ``` ## 1. 启动与停止 以下为本地运行操作说明,不是系统设计或完整部署验收。5101 托管会话、5110 独立运行与 5130 本地/远程接入的边界见[外部接口设计](docs/design/11-外部接口与适配.md);端口以实际启动配置为准。 根目录只公开一个启动入口和一个停止入口;具体服务实现位于 `scripts/launchers/`,由 `start.sh` 按 profile 分发。 ```bash # 默认:网页与后台服务,独立 Python/Pygame 推演按需启动 ./start.sh # 按需启动单一服务或整套本地服务 ./start.sh admin ./start.sh game ./start.sh tactical --mode single_local --tacview ./start.sh full --with-game ./start.sh engine ./start.sh grpc ./start.sh geospatial ./start.sh manual ./start.sh all # 查看状态、停止全部或仅停止手工推演 ./start.sh status ./stop.sh ./stop.sh manual ``` 无参数等同于`full`,保留管理后台、5110网页、手工推演网页、5101/50051后台引擎、数据与地理服务;`core`启动管理后台和5110网页,`all`在`core`上补齐手工推演。 这些聚合入口默认不运行`src/main.py`,因此不自动加载独立世界或弹出Pygame窗口。独立推演的8080/8765/3008接口随显式`game`、`tactical`或`--with-game`启动。 `--skip-game`可明确跳过独立推演,默认启动也不会关闭已经运行的推演实例。进程身份、PID及日志路径仍由共享注册表与当前数据根管理。 默认`full`与`all`包含多人手工推演,会在启动任何子服务前统一启用认证,并通过原`one_sim_auth.runtime_secret`复用共享密钥和身份数据库路径。显式设置`ONE_SIM_AUTH_ENABLED=0`时这两个目标提前拒绝;独立`engine`、`core`等目标沿原配置启动。已有引擎的认证配置不符时仍拒绝复用,应先保存会话,再由所属受管入口安全重启。 启动、停止摘要及关键诊断默认使用中文,保留`engine_server`等服务ID和`owned_ready`等状态码便于检索。需原始机器输出时,在Bash使用`ONE_SIM_SERVICE_OUTPUT=json bash start.sh`(或`stop.sh`)。最后一行“必需服务均已就绪”且退出码为0才代表本次启动成功;单个健康检查成功不代替全组就绪。停止时“实例不匹配”表示受保护的拒绝,不会按端口强杀其他进程;大厅与AI Planning仍由各自owner管理。 ## 2. 安装依赖 首先,确保安装了所有必要的依赖: ```bash pip install -r requirements.txt ``` ## 3. 配置Tacview连接 编辑配置文件 `src/configy.yaml`,添加Tacview配置段: ```yaml tacview: enabled: true host: localhost port: 42674 ``` ## 4. 直接启动游戏进程 ### 4.1 使用默认配置 ```bash python src/main.py ``` ### 4.2 使用指定配置文件 ```bash python src/main.py --config src/configy.yaml ``` ## 5. 连接Tacview 1. 启动Tacview软件 2. 在Tacview中选择 `File` -> `Connect to Data Stream` 3. 输入配置的IP和端口(默认为 `localhost:42674`) 4. 点击 `Connect` 按钮 ## 6. 查看实时数据 连接成功后,您将在Tacview中看到游戏中单位的实时运动: - 不同颜色表示不同阵营 - 空中单位和导弹会显示在相应高度 - 单位移动轨迹会实时更新 ## 7. 配置选项说明 ### 7.1 游戏模式 在 `game` 部分可以配置游戏模式: ```yaml game: mode: single_local # 可选:single_local, single_network, multi_network, training, demo ``` ### 7.2 显示配置 在 `display` 部分可以配置显示模式: ```yaml display: mode: grpc # 可选:grpc, pygame, unity, none enable_pygame: true # 是否启用Pygame渲染器 enable_web_stream: true # 是否启用网页流 ``` ### 7.3 场景配置 在 `scenario` 部分可以配置游戏场景: ```yaml scenario: file: src/data/configs/scenarios/naval_uav_attack.yaml units_stats_file: src/data/configs/units/naval_units.yaml ``` ### 7.4 性能配置 在 `performance` 部分可以配置游戏性能: ```yaml performance: max_frames: 10000 # 最大帧数 frame_rate: 10.0 # 帧率 ``` ## 8. 快捷键 - `v`: 切换风格(矢量/六角) - `g`: 切换网格显示 - `p`: 切换路径显示 - `b`: 切换向量显示 - `a`: 显示攻击范围 - `d`: 显示探测范围 - `s`: 仅显示选中单位范围 - `Esc`: 取消选中 ## 9. 常见问题 ### 9.1 Tacview连接失败 - 确保Tacview软件已启动 - 确保配置文件中的Tacview端口与Tacview中配置的端口一致 - 确保防火墙允许连接 - 尝试重新启动游戏和Tacview ### 9.2 游戏运行缓慢 - 降低帧率配置(frame_rate) - 减小地图尺寸(width和height) - 禁用不必要的渲染选项 ### 9.3 没有看到任何单位 - 确保场景文件配置正确 - 检查单位统计文件路径是否正确 - 查看游戏日志了解是否有错误 ## 10. 游戏日志 游戏启动后,会生成 `game_debug.log` 文件,包含详细的游戏日志信息。如果遇到问题,可以查看此文件了解详细错误信息。 ## 11. 权威运行数据 engine-server 默认将运行数据统一写入 `runtime/`;可通过 `WARGAME_ENGINE_DATA_DIR` 指定外部数据根目录: ```text runtime/ ├── sessions/ # 会话检查点、索引和损坏文件隔离区 ├── replays/ # 按会话及 incarnation_id 隔离的版本化 JSONL │ ├── _archive/ # 显式归档的历史回放,不参与在线读取 │ └── _quarantine/ # 校验失败或版本不兼容的回放 └── checkpoints/ # 训练等非会话检查点的统一预留目录 ``` - 自动会话检查点默认每个会话保留最近 5 个;手工检查点不会被自动删除。 - 回放不会按时间自动删除;需要清理在线数据时使用 `ReplayStore.archive()`,原文件会移入 `_archive/`。 - 新回放记录带 schema、版本和 SHA-256 校验;旧 JSONL 在迁移期仍可读取。 - 损坏或不支持版本的数据会被移入 `_quarantine/`,API 返回结构化恢复提示,不会静默忽略。 - `runtime/`、`checkpoints/`、`logs/` 和 `output/` 不进入 Git;已有运行数据不得作为代码清理内容删除。