Configuration

配置说明

BlockOffensive 使用 Forge Config，分为客户端配置和通用配置。

配置文件类型

类型	作用
CLIENT	控制客户端 HUD、击杀消息和观战界面等本地显示行为。
COMMON	控制脚步声、C4、Ping、比赛投票、游戏规则和 Web Server。

如果安装 Cloth Config 或相关配置界面集成，部分配置可以在客户端图形界面中修改。

客户端配置

源码位置：BOConfig.Client

kill message

键	默认值	范围	说明
hudEnabled	true	boolean	是否显示击杀消息 HUD。
hudPosition	2	1 到 4	击杀消息位置。
messageShowTime	5	1 到 60	每条击杀消息显示秒数。
maxShowCount	5	1 到 10	同时显示的最大消息数量。

kill icon

键	默认值	范围	说明
killIconEnabled	true	boolean	是否显示击杀图标 HUD。

spectator

键	默认值	范围	说明
spectatorBombHudEnabled	true	boolean	观战时是否显示 C4 引信倒计时 HUD。
spectatorRosterEnabled	true	boolean	观战时是否显示观战者名单侧栏。

通用配置

源码位置：BOConfig.Common

step sound

键	默认值	范围	说明
teammateMuffledStepVolume	0.05	0 到 10	队友潜行脚步声音量。
teammateStepVolume	0.15	0 到 10	队友正常脚步声音量。
enemyMuffledStepVolume	0.4	0 到 10	敌人潜行脚步声音量。
enemyStepVolume	1.2	0 到 10	敌人正常脚步声音量。

c4

键	默认值	范围	说明
Fuse Time	800	1 到 3200	C4 引信 tick 数，20 tick 约等于 1 秒。默认约 40 秒。

ping

键	默认值	范围	说明
pingTtlSeconds	6	3 到 30	队友 Ping 标记的存活时间，超时后自动消失。
pingMaxDistance	256.0	16.0 到 1024.0	Ping 标记的最大渲染距离，单位为方块。

游戏规则配置

这些配置会在 CS 地图开始时应用到比赛所在世界。

键	默认值	说明
keepInventory	true	玩家死亡后保留背包。
immediateRespawn	true	玩家立即重生，不显示死亡界面。
daylightCycle	false	是否允许昼夜循环。
weatherCycle	false	是否允许自然天气变化。
mobSpawning	false	是否允许自然刷怪。
naturalRegeneration	false	是否允许自然生命恢复。
hardDifficulty	true	是否将难度设置为困难。

加时配置

键	默认值	范围或可选值	说明
overtimeMode	VOTE	VOTE、AUTO、DISABLED	12:12 时投票决定、直接进入加时或直接判平。
overtimeStartMoney	10000	0 到 100000	每段加时开局的起始经济。
overtimeVoteThreshold	0.6	0.0 到 1.0	VOTE 模式下加时投票的通过比例。
overtimeVoteSeconds	20	5 到 120	加时投票持续秒数。
overtimeMaxSegments	0	0 到 10	最大加时段数；0 表示无限，达到上限则判平。

投票配置

键	默认值	范围或可选值	说明
voteTimeoutPolicy	FAIL	FAIL、PASS_IF_MAJORITY	超时后直接失败，或按已投票玩家的多数结果结算。
voteAbstentionPolicy	COUNT_AS_NO	COUNT_AS_NO、IGNORE	弃权计为反对，或从票数分母中忽略。
unpauseVoteThreshold	1.0	0.5 到 1.0	取消暂停投票的通过比例，默认要求全票。

Web Server 配置

键	默认值	范围	说明
webServerEnabled	false	boolean	是否启用内置客户端 Web Server。
webServerPort	8080	1 到 65535	Web Server 监听端口。

Web Server 行为：

• 这是客户端侧能力，不是服务端全局 API。
• 只有在配置启用后才会尝试启动。
• 当前客户端需要处于地图中、在比赛内，并且是旁观者，才会启动。
• 离开对应状态后会停止。
• 默认接口为 GET /api/data。

CS 模式共享地图设置项

CSMap 为 cs 和 csdm 都注册以下设置项：

分类	设置项	默认值	说明
team	allowFriendlyFire	false	是否允许队友伤害。
player	allowSpecAttach	true	是否允许旁观者附身队友。
player	magazineMode	false	是否启用弹匣模式。
eco	knifeKillEconomy	1500	刀击杀奖励。
eco	smgKillEconomy	600	冲锋枪击杀奖励。
eco	sniperKillEconomy	100	狙击枪击杀奖励。
eco	shotgunKillEconomy	900	霰弹枪击杀奖励。
eco	defaultKillEconomy	300	其他武器的默认击杀奖励。
team	ctLimit	5	CT 人数上限。
team	tLimit	5	T 人数上限。

爆破模式地图设置项

cs 地图在 CSGameMap.setup() 中注册以下设置项：

设置项	默认值	说明
winnerRound	13	获胜所需回合数。
overtimeRound	3	加时回合数。
pauseTime	1200	暂停时长 tick。
winnerWaitingTime	160	回合/比赛胜者等待时间 tick。
warmUpTime	1200	热身时间 tick。
waitingTime	300	等待时间 tick。
roundTimeLimit	2300	回合时间 tick。
startEconomy	800	起始经济。
defaultLoserEconomy	1400	默认失败方经济补偿。
defuseEconomy	600	拆弹相关经济奖励。
compensationBase	500	补偿经济基础值。
tDeathRewardPer	50	T 阵营死亡相关队伍奖励单元。
closeShopTime	200	商店关闭时间 tick。
knifeSelection	false	是否启用切刀/换边选择相关流程。
c4InstantKillRadius	20	C4 即死半径。
timeoutEconomy	3250	超时相关经济奖励。
aceEconomy	3250	ACE 奖励。
defuseBombEconomy	3500	拆除 C4 的经济奖励。
detonateBombEconomy	3500	引爆 C4 的经济奖励。

死斗模式地图设置项

csdm 地图在 CSDeathMatchMap.setup() 中注册以下设置项：

设置项	默认值	说明
isTDM	false	是否启用团队死斗。
matchTimeLimit	12000	比赛时间 tick，默认 10 分钟。
spawnProtectionTime	6	重生保护时间 tick。

调整建议

• 服务器正式比赛建议保持 keepInventory=true、immediateRespawn=true、mobSpawning=false、naturalRegeneration=false。
• 如果直播覆盖层只在本机使用，Web Server 端口保持默认 8080 即可。
• 如果多个客户端在同一台机器同时运行，需要为每个客户端分配不同端口。
• 修改 C4 引信时同时确认 HUD、语音提示与赛事规则是否一致。