-
Notifications
You must be signed in to change notification settings - Fork 0
zh Configuration Reference
soizo edited this page Mar 30, 2026
·
1 revision
源码：
config.h
所有可调引擎常量集中在 config.h 中。子系统头文件从这些值派生其限制。
| 常量 | 值 | 说明 |
|---|---|---|
WINDOW_WIDTH |
1280 | 窗口宽度（像素） |
WINDOW_HEIGHT |
720 | 窗口高度（像素） |
TARGET_FPS |
60 | 目标帧率 |
| 常量 | 值 | 说明 |
|---|---|---|
RENDER_WIDTH |
640 | 帧缓冲宽度（放大至窗口） |
RENDER_HEIGHT |
360 | 帧缓冲高度 |
帧缓冲以最近邻插值放大。
| 常量 | 值 | 说明 |
|---|---|---|
TEX_WIDTH |
64 | 纹理宽度（像素） |
TEX_HEIGHT |
64 | 纹理高度（像素） |
TEX_MIP_LEVELS |
3 | MIP 链深度（64→32→16） |
MAP_MAX_TEXTURES |
32 | 每张地图最大纹理数 |
| 常量 | 值 | 说明 |
|---|---|---|
MAP_DEFAULT_WIDTH |
24 | 默认网格宽度 |
MAP_DEFAULT_HEIGHT |
24 | 默认网格高度 |
MAX_LIGHTS |
32 | 每张地图最大光源数 |
MAX_BILLBOARDS |
64 | 每张地图最大布告板数 |
| 常量 | 值 | 说明 |
|---|---|---|
LIGHTMAP_SCALE |
4 | 光照贴图分辨率倍数（4 倍网格） |
LOS_SAMPLES_PER_UNIT |
12 | 光线视线检测的射线步进密度 |
| 常量 | 值 | 说明 |
|---|---|---|
KEY_MOVE_FWD |
W | 前进 |
KEY_MOVE_FWD_ALT |
Up | 前进（备用） |
KEY_MOVE_BACK |
S | 后退 |
KEY_MOVE_BACK_ALT |
Down | 后退（备用） |
KEY_STRAFE_LEFT |
A | 左平移 |
KEY_STRAFE_LEFT_ALT |
Left | 左平移（备用） |
KEY_STRAFE_RIGHT |
D | 右平移 |
KEY_STRAFE_RIGHT_ALT |
Right | 右平移（备用） |
KEY_TOGGLE_MINIMAP |
M | 切换小地图 |
| 常量 | 值 | 说明 |
|---|---|---|
GAMEPAD_ID |
0 | 第一个连接的手柄 |
GAMEPAD_DEADZONE |
0.15 | 摇杆死区阈值 |
GAMEPAD_LOOK_SPEED |
2.5 | 右摇杆偏航速度（rad/s） |
GAMEPAD_PITCH_SPEED |
1.5 | 右摇杆俯仰速度因子 |
| 常量 | 值 | 说明 |
|---|---|---|
MOVE_SPEED |
3.0 | 移动速度（单位/秒） |
ROT_SPEED |
2.0 | 旋转速度（rad/s） |
FOV_FACTOR |
0.66 | tan(FOV/2)，约 66° |
MOUSE_SENSITIVITY |
0.002 | 鼠标偏航灵敏度 |
MOUSE_PITCH_SENSITIVITY |
0.002 | 鼠标俯仰灵敏度 |
MAX_PITCH_ANGLE |
1.047（60°） | 最大垂直视角 |
PLAYER_RADIUS |
0.22 | 玩家碰撞半径 |
BILLBOARD_DEFAULT_COLLISION_RADIUS |
0.3 | 默认布告板碰撞半径 |
PLAYER_EYE_HEIGHT |
0.5 | 地板以上眼高 |
EYE_TRACK_SPEED |
10.0 | 平滑地板跟踪速率 |
MAX_PITCH_FRACTION |
0.42 | 最大俯仰占高度比例 |
| 常量 | 值 | 说明 |
|---|---|---|
ENABLE_DISTANCE_FOG |
1 | 启用/禁用雾效 |
BILLBOARD_ALPHA_THRESHOLD |
128 | 透明度裁剪阈值 |
FOG_FLOOR_START |
4.5 | 地板雾起始距离 |
FOG_FLOOR_RANGE |
8.5 | 地板雾渐变范围 |
FOG_WALL_START |
5.0 | 墙面雾起始距离 |
FOG_WALL_RANGE |
14.0 | 墙面雾渐变范围 |
WALL_SIDE_DARKEN |
0.5 | N/S 面变暗系数 |
LIGHT_SAMPLE_OFFSET |
0.18 | 墙面光照查找偏移 |
MAX_DDA_STEPS |
64 | 最大射线步进次数 |
| 常量 | 值 | 说明 |
|---|---|---|
AMBIENT_FLOOR_R/G/B |
0.22 | 地板基础照明 |
AMBIENT_CEIL_R |
0.28 | 天花板基础红色 |
AMBIENT_CEIL_G |
0.30 | 天花板基础绿色 |
AMBIENT_CEIL_B |
0.36 | 天花板基础蓝色 |
SUN_FLOOR_BOUNCE |
0.55 | 地板太阳反弹系数 |
| 常量 | 值 | 说明 |
|---|---|---|
MINIMAP_SCALE |
4 | 每单元格像素数 |
MINIMAP_OFFSET |
4 | 屏幕边距（像素） |
MINIMAP_DIR_LENGTH |
6 | 方向指示器长度 |
| 常量 | 值 | 说明 |
|---|---|---|
AUDIO_MAX_SAMPLES |
64 | 最大加载采样数 |
AUDIO_MAX_AMBIENT |
8 | 最大环境音数 |
AUDIO_MAX_POSITIONAL |
16 | 最大空间音频数 |
AUDIO_SAMPLE_DIR |
assets/audio/samples |
采样目录 |
AUDIO_AMBIENT_DIR |
assets/audio/ambient |
环境音目录 |
AUDIO_POSITIONAL_DIR |
assets/audio/positional |
空间音频目录 |
AUDIO_UDP_PORT_SEND |
7701 | 游戏 → Strudel UDP 端口 |
AUDIO_UDP_PORT_RECV |
7700 | Strudel → 游戏 UDP 端口 |
AUDIO_STATE_SEND_HZ |
8 | 每秒状态更新次数 |
| 常量 | 值 | 说明 |
|---|---|---|
DEFAULT_MAP_PATH |
assets/maps/default.json |
默认地图文件 |
DEFAULT_TEXTURE_DIR |
assets/textures |
默认纹理目录 |