scp5k配置文件功能参考 - SCP：5K容器详细参数

附录：SCP: 5K 核心配置文件与参数全量参考

在 Docker 部署环境下，SCP: 5K 的核心配置文件保存在数据卷映射的目录中。具体绝对路径为容器内的 /scp5k/Pandemic/Saved/Config/LinuxServer/（如果你按照教程设置了本地目录映射，可以在宿主机的对应 data 文件夹下直接找到它们）。

游戏运行主要依赖以下几个 .ini 格式的文本文件，你可以使用文本编辑器直接修改：

1. 权限与黑白名单配置文件

OwnerIDs.ini (最高服主权限)
- 主要功能：存放服务器所有者（Owner）的名单。
- 配置方法：每行单独填写一个玩家的 SteamID64（17位纯数字）。
- 权限级别：拥有绝对的最高权限。除了可以使用游戏内的所有管理面板功能，还能完整执行后台 RCON 指令，以及赋予或撤销其他玩家的管理员权限。
AdminIDs.ini (普通管理员权限)
- 主要功能：存放普通管理员（Admin）的名单。
- 配置方法：每行单独填写一个玩家的 SteamID64。
- 权限级别：拥有游戏内的基础管理权限（如踢人、封禁、切换地图、刷取物品等），但层级低于 Owner，无法修改底层服务器规则。适合分配给协助你管理服务器的朋友。
BannedIDs.ini (封禁黑名单)
- 主要功能：存放被服务器拉黑的玩家名单。
- 配置方法：每行记录一个被封禁者的 SteamID64。当你在游戏内或通过 RCON 面板封禁某位玩家时，系统会自动将该玩家的 ID 写入此文件。
- 解封操作：如果需要手动解除对某位玩家的封禁，只需用编辑器打开此文件，删除对应的那一行 SteamID64，保存后重启服务器即可。
WhitelistIDs.ini (白名单通行证)
- 主要功能：用于打造严格的“私人专属服务器”。
- 配置方法：每行填写一个允许进入该服务器的 SteamID64。
- 生效机制：如果该文件中存在记录且白名单功能已启用，服务器将拦截所有未记录在此名单上的玩家。这个功能极其适合主播或只希望和几个固定朋友私密游玩的服主，能从根源上杜绝陌生人进入。

2. ServerConfig.ini 主配置文件参数详解

ServerConfig.ini 是游戏服务端最核心的配置文件，掌控着服务器的基础运行逻辑。

注意事项：如果你在 docker-compose.yml 的环境变量中设定了参数（如 PORT、SERVER_NAME），并且开启了覆盖开关（OVERWRITE_CONFIG=true），每次重启容器时，环境变量的值都会强行重置此文件。为了保留你在此文件中的自定义修改，务必在 docker-compose.yml 中将 OVERWRITE_CONFIG 设为 false。

在 ServerConfig.ini 文件中，除了基础的名字和端口，还包含了大量用于自定义游戏体验的底层参数。你可以根据需要对以下数值进行修改：

📌 基础服务器与访问控制

参数名	默认值	详细说明
`ServerName`	`SCP: 5K Server`	服务器在大厅中显示的名称。
`MaxPlayerCount`	`4`	服务器最大玩家承载数。
`bUseServerPassword`	`False`	是否启用服务器密码 (`True`/`False`)。
`ServerPassword`	(空)	如果启用了密码，在此处填写具体的密码内容。
`bUseWhitelist`	`False`	是否启用白名单（配合 `WhitelistIDs.ini` 使用）。
`bFriendsOnly`	`False`	是否仅限 Steam 好友加入。
`bShouldAdvertise`	`True`	是否向 Steam 官方大厅广播你的服务器（设为 `False` 别人就搜不到了）。
`bAdminsAlwaysJoin`	`True`	管理员是否拥有满员强制进入的特权。
`AFKTimer`	`300.000000`	挂机自动踢出时间（单位：秒。300即5分钟）。

⚔️ 游戏对局与规则设定

参数名	默认值	详细说明
`ScoreToWin`	`25.000000`	团队死斗等模式下的获胜分数要求。
`RoundTimer`	`0.000000`	回合时间限制（0代表无限制）。
`bTeamDamageEnabled`	`True`	是否开启友军伤害（痛击我的队友）。
`TeamDamageReflection`	`0.300000`	友军伤害反弹比例（例如 0.3 代表你打队友 100 滴血，自己会扣 30 滴血，用于惩罚恶意 TK 的玩家）。
`bRestartServerEachGame`	`False`	每局游戏结束后是否强制重启服务器进程。
`bUseSeamlessTravel`	`True`	是否开启无缝地图切换（加载下一张地图时不强制断开连接）。
`EmptyServerRestartTime`	`15.000000`	服务器内没有玩家时，多久后自动重启服务（秒）。

🧟 丧尸与 AI 生成机制

参数名	默认值	详细说明
`ZombieSpawnAmount`	`1.000000`	丧尸生成数量倍率（1.0为默认数量，想增加难度可以调高）。
`MaxZombieCount`	`100`	同一时间内地图上存在的最大丧尸数量上限。
`ZombieRespawnTime`	`600`	丧尸波次刷新的间隔时间。
`ResetZombieSpawners`	`False`	是否在特定阶段强制重置丧尸生成点。

⚖️ 投票踢人与反作弊封禁系统

参数名	默认值	详细说明
`bUseVoteKicking`	`True`	是否允许玩家在局内发起投票踢人。
`VoteKickRequiredPercentage`	`0.510000`	投票踢人成功所需的赞成票比例（默认 51% 超过半数即成功）。
`VoteKickCooldownDuration`	`60.000000`	发起下一次投票的冷却时间（秒）。
`VoteKickVoteDuration`	`60`	投票持续时间（秒）。
`bVoteKickEndAfterAllVoted`	`True`	如果所有人都投完票了，是否无视剩余时间提前结束投票。
`bDenyVACBan` / `bDenyGameBan`	`False`	是否禁止拥有 Steam VAC 封禁或游戏封禁记录的玩家加入。
`MinDaysSinceLastBan`	`150`	如果开启了拒绝封禁记录者加入，距离上次封禁超过这个天数（如150天）的人可以被网开一面。

🔫 硬核战斗参数 (GameplayConfig)

你可以通过修改 GameplayConfig=(...) 括号内的一长串参数来深度定制手感和难度。 注意：必须先将 bOverrideDefaults=False 改为 bOverrideDefaults=True，以下参数才会生效。

参数名	详细说明
`RecoilMultiplier`	后坐力倍数（>1.0 后坐力变大，<1.0 变小）。
`SpreadMultiplier`	子弹散布倍数（决定枪械的精准度）。
`MovementSpeedMultiplier`	玩家基础移动速度倍数。
`CharacterDamageMultiplier`	玩家受到的伤害倍数（调高可实现“魂系”受苦难度）。
`CharacterHealthMultiplier`	玩家基础血量倍数。
`ReloadSpeedMultiplier`	换弹速度倍数。
`ADSSpeedMultiplier`	开镜（瞄准）速度倍数。
`bCanSprint`	是否允许玩家奔跑 (`True` 允许 / `False` 只能走)。
`bCanADSInNightVision`	是否允许在使用夜视仪时开镜瞄准 (`False` 默认禁止，更贴近现实物理)。