TShock 5.1.2 config.json 参数整理（实战版）

本文为二次整理稿：基于公开文章《Tshock的config.json配置文件翻译（对应5.1.2版本）》做结构化归纳，便于服主快速配置与排错。

原文来源：https://blog.csdn.net/junknow/article/details/128260828

一、快速定位

• 目标文件：tshock/config.json
• 适配版本：TShock 5.1.2（不同版本字段可能有增减）
• 阅读方式：先看“推荐起步配置”，再按分组调参

二、推荐起步配置（中小型生存服）

以下是通用起步建议，适合 8-30 人的普通 PVE 服：

分组	关键参数	建议值	作用
网络	ServerPort	7777	游戏连接端口
网络	MaxSlots	16 或 24	总在线人数上限
存档	AutoSave	true	自动保存世界
存档	BackupInterval	10	备份间隔（分钟）
存档	BackupKeepFor	240	备份保留时长（分钟）
安全	SpawnProtection	true	开启出生点保护
安全	SpawnProtectionRadius	10	出生点保护半径
反作弊	RangeChecks	true	基础越界与数据检查
登录	RequireLogin	true（公服）	强制玩家登录
白名单	EnableWhitelist	false（公服）/true（私服）	是否仅允许白名单进入

三、参数分组速查

1) 基础网络与服务器信息

参数	含义	常见设置建议
ServerPassword	入服密码	私服建议设置，公服通常留空
ServerPort	监听端口	默认 7777，需同步放行防火墙/安全组
MaxSlots	玩家槽位	不要盲目拉满，受 CPU 与插件数量影响
ReservedSlots	预留槽位	建议小于总槽位，避免普通玩家长期无法进入
ServerName / UseServerName	服务器展示名	公服建议设置唯一名称

2) 日志、自动保存与备份

参数	含义	常见设置建议
LogPath	日志目录	默认即可，注意定期清理
DebugLogs	调试日志	线上建议 false，避免刷屏
AutoSave	自动保存	强烈建议 true
AnnounceSave	保存公告	可按服内体验选择开关
BackupInterval	备份间隔	常用 10-30 分钟
BackupKeepFor	备份保留	按磁盘容量设置，常见 240-1440
SaveWorldOnCrash	崩溃保存	建议 true
SaveWorldOnLastPlayerExit	最后一人退出时保存	建议 true

3) 刷怪、入侵与世界规则

参数	含义	常见设置建议
InvasionMultiplier	入侵规模倍率	默认 1，活动服可适度提高
DefaultMaximumSpawns	同屏最大刷怪数	提高会明显增加负载
DefaultSpawnRate	刷怪间隔	值越大刷怪越慢
InfiniteInvasion	无限入侵	生产服不建议开启
ForceTime	强制昼夜	仅活动服临时使用
DisableHardmode	禁止进困难模式	开荒服可阶段性启用

4) PVP、死亡与出生点保护

参数	含义	常见设置建议
PvPMode	PVP 模式	normal / always / disabled
SpawnProtection	出生保护	公服建议 true
SpawnProtectionRadius	出生保护范围	常见 10-30
DisableTombstones	关闭墓碑掉落	减少地图污染，建议 true
RespawnSeconds	普通复活时间	玩法服按难度调整
RespawnBossSeconds	Boss 战复活时间	建议大于普通复活时间

5) 建筑、领地与环境扩散

参数	含义	常见设置建议
DisableBuild	全局禁建	除活动场景外不建议开
RegionProtectChests	领地箱子保护	PVE 服建议 true
RegionProtectGemLocks	宝石锁保护	建议 true
AllowCrimsonCreep	猩红扩散	长线生存服可关
AllowCorruptionCreep	腐化扩散	长线生存服可关
AllowHallowCreep	神圣扩散	建筑服可关

6) 账号、登录与访问控制

参数	含义	常见设置建议
MaximumLoginAttempts	最大登录尝试次数	常见 3-5
EnableWhitelist	白名单模式	私服常开，公服按需
RequireLogin	强制登录	公服建议 true
AllowLoginAnyUsername	账号名与角色名可不同	多端混合服可开
AllowRegisterAnyUsername	允许任意用户名注册	公服建议 false
MinimumPasswordLength	最短密码长度	建议 6+

7) 反作弊阈值（重点）

参数	含义	调参说明
MaxDamage / MaxProjDamage	最大伤害阈值	过低会误伤高端玩家
TileKillThreshold	每秒挖掘上限	活动期间可临时调高
TilePlaceThreshold	每秒放置上限	建筑服可适度调高
TileLiquidThreshold	每秒液体操作上限	防液体刷屏与卡服
ProjectileThreshold	每秒射弹上限	法师/召唤流要实测
HealOtherThreshold	每秒治疗数据上限	防异常治疗包

配套踢出开关（如 KickOnDamageThresholdBroken）建议先观察日志再启用，避免误踢。

8) 聊天、显示与管理体验

参数	含义	常见设置建议
CommandSpecifier	指令前缀	默认 /
CommandSilentSpecifier	静默指令前缀	默认 .
ChatFormat	聊天格式模板	建议小改，避免与插件冲突
EnableGeoIP	显示 IP 地理位置	涉及隐私，通常关闭
DisplayIPToAdmins	向管理员显示玩家 IP	严格按管理制度启用

9) 数据库与 REST API

参数	含义	常见设置建议
StorageType	存储类型	小服 sqlite，多实例可转 mysql
SqliteDBPath	sqlite 文件路径	建议纳入备份策略
MySqlHost/MySqlDbName/MySqlUsername	MySQL 连接信息	外网数据库必须最小权限
RestApiEnabled	开启 REST API	非必要不要开
RestApiPort	REST 端口	开启后务必限制来源
EnableTokenEndpointAuthentication	Token 认证	建议开启
RESTMaximumRequestsPerInterval	REST 请求限流	建议保守值防刷接口

四、三种服型的推荐思路

公共生存服

• 强制登录、出生保护、领地保护全部开启。
• 反作弊阈值采用“先宽后严”策略，观察 3-7 天再收紧。
• 扩散（腐化/猩红/神圣）按服定位决定，建筑向通常关闭。

好友私服

• 可以关闭强制登录与部分反作弊阈值，换取更自由体验。
• 重点保留自动保存与备份，防止误操作回档。

活动/PVP服

• PvPMode、复活时间、刷怪参数按活动周期临时改。
• 活动结束后还原默认，避免长期影响生态。

五、改配置的标准流程（避免炸服）

1. 停服后修改 config.json，不要热改关键参数。
2. 先备份旧文件（如 config.json.bak-日期）。
3. 每次只改一组参数，重启后观察日志与玩家反馈。
4. 出现异常先回滚到上一版，再逐项定位。

六、常见坑位

• ReservedSlots 大于或接近 MaxSlots，导致普通玩家长期挤不进。
• 反作弊阈值设置过低，正常高伤武器被误判。
• 开了 REST API 但未做访问控制，带来安全风险。
• 只开自动保存不做备份，误操作后无法回档。

七、补充说明

• 不同 TShock 版本字段存在差异，升级后请对照新模板。
• 插件也可能覆盖或依赖部分配置，调参时需联动检查插件文档。

---

关键词：TShock config.json，TShock 5.1.2，泰拉瑞亚服务器配置，TShock 参数说明，TShock 反作弊阈值