Server Tweaks / VSCN 文明模拟主模组

Description
Files

Tags:
Author:: HansJack
Side:
Both
Created:
Sep 29th at 11:37 AM
Last modified:
14 hours ago
Downloads:
48: Recommended download (for Vintage Story 1.22.3 - 1.22.7):
vscncivilizationsimulation_1.0.8.zip 1-click install

For Chinese community servers only.

面向玩家

部落

按 Ctrl+Shift+S 打开文明模拟窗口。

文明模拟窗口包含：

部落
世界

科技树页面及科技进度扫描已移除；既有存档中的科技记录暂予保留。

创建部落

在当前位置创建自己的部落：

创建者自动成为部落首领。
创建时会向同维度 10 格内未加入部落的玩家发送邀请。
可以邀请其他玩家加入部落。
可以退出当前部落。
首领可以踢出成员。
可以向其他部落首领申请转入。
其他部落的首领可以审批转入申请。
邀请和转入申请保留 120 秒。
单人部落也会保留。
最后一名成员离开后，部落自动解散。
首领离开后，由剩余成员接任首领。

部落领地

创建部落后，部落会拥有一个主领地。

主领地会在世界画面显示本部落的蓝色悬浮旗帜。

附庸地显示为蓝色火焰。

领地：

默认半径为 50 格。
按同维度 X/Z 水平距离判定。
不限制高度。
不显示领地圆圈。
领地之间不能重叠。
只有本部落成员在同维度附近 100 格内可以看到本部落的悬浮标记。
实际领地坐标也只同步给本部落成员。

世界页面中：

自己的主领地显示为蓝色圆点。
自己的附庸地显示为蓝色火焰。
其他部落显示为红色圆点和火焰。
附庸地连接至所属主领地。
主领地连接至世界出生点。
不会向原版地图添加标记。

附庸地

部落成员人数决定可以拥有的附庸地数量：

部落成员	可拥有领地
1–3 人	仅主领地
4–5 人	主领地 + 1 个附庸地
6 人及以上	主领地 + 2 个附庸地

人数包括离线成员。

部落首领可以在部落页面：

建立附庸地
迁移领地中心

建立附庸地或迁移领地时，使用首领当前所在位置。

新领地不能与其他领地重叠。

领地中心创建或迁移后默认需要等待 60 分钟才能再次迁移。冷却时间会随存档保存。

当部落人数下降时，超出当前人数允许数量的附庸地会按照创建顺序移除；人数恢复后可以重新建立。

部落效果

效果只对位于自己部落主领地或附庸地中的成员生效。

重叠领地不会叠加效果。

未加入部落的玩家不会受到离境惩罚。

部落页面会显示当前启用的效果、数值以及领地迁移剩余等待时间。

默认效果：

效果	默认值	说明
部落亢奋	+500 kcal	额外休息值及休息容量，需要 BodyPhys
部落休养	+5	睡眠或坐下时额外回复休息值，需要 BodyPhys
离境休息减量	-100 kcal	离开本部落全部领地后的休息值减量，需要 BodyPhys
部落就是我的家	+5%	原版移动速度增量
英雄难过温柔乡	×0.95	攻击最终进入受伤流程前降低 5%，包括近战和投射物
一切由部落控制	+10%	VS Roping 套索成功率增加 10 个百分点，最高 100%
最大生命值	+0	原版最大生命值增加
劳损增长速率	+0	BodyPhys 劳损增长速率修正

HomeRestBonus 和 AwayRestPenalty 使用 BodyPhys 窗口中的休息 kcal 单位，不会直接增加或减少食物、脂肪能量。

默认 BodyPhys 内部 100 点等于 5200 kcal，领地内默认上限为 5700 kcal。

如果未安装 BodyPhys 或 VS Roping，对应效果会自动跳过。

世界页面

世界页面显示：

部落
世界出生点
部落之间的关系
主领地
附庸地

世界页面上的示意点位置不直接使用真实世界坐标，也不会发送部落成员资料。

实际世界中的领地标记会另外同步领地中心位置。

聚落出生

服务器会为玩家分配聚落出生点。

聚落支持：

Sequential
Balanced
Random

已有玩家重新连接时不会重新传送。

聚落人数按照历史玩家 UID 分配累计，并不等于当前在线人数。

首次没有分配记录的玩家，会在客户端进入可游玩状态后开始分配。

安全出生点会检查：

地面是否坚实
脚部空间是否可通行
头部空间是否可通行
地面、脚部和头部是否存在液体

找到安全点后才会传送，并写入出生点与归属。

如果所有候选位置均失败，会保留玩家原来的位置、出生点和归属。

重生次数与保护

服务器可以使用生命次数系统。

例如世界设置：

playerlives=3

玩家死亡次数重置后，会恢复 3 次生命。

重置不会修改：

个人出生点
时空齿轮使用次数
物品
聚落归属

也不会自动复活已经死亡的玩家。

重生保护默认持续 10 秒。

重生保护从实际复活时开始计时，可以阻挡普通伤害，包括跌落和攻击伤害，同时允许复活治疗。

面向管理员

安装与迁移

服务端和客户端安装同一份 ZIP。

替换旧 ClusterSpawns 时：

移除旧模组。
保留原世界存档。
保留 ModConfig/clusterspawns_config.json。
保留并更新 Algernon's Terrain Sampler 1.3.0 前置。

首次启动会生成：

VintagestoryData/ModConfig/VscnCivilizationSimulation.json

如果存在旧配置，首次安装时会导入其聚落布局和分配规则。

已有存档会继续使用 clusterSpawnsState 中保存的：

聚落坐标
玩家 UID 归属
顺序分配计数

不会因为新配置中的聚落数量变化而重新生成。

损坏的旧状态会报错，不会静默覆盖。

配置热重载

配置文件示例：

config/VscnCivilizationSimulation.example.json

修改服务器配置后执行：

/vscncs reload config

无效配置会拒绝重载。

布局参数只影响以后生成的聚落。

已经保存的聚落必须通过：

/vscncs cluster reroll

显式重新生成。

模组清单策略

默认：

"Mode": "Whitelist",
"IncludeServerMods": true

自动允许：

服务端已经启用的模组
服务器模组搜索目录中的 side: Client ZIP/文件夹
对应模组 ID 和精确版本

服务器目录中不存在的客户端模组，需要写入：

ModPolicy.Mods

例如：

"Mods": [
  {
    "ModId": "examplemod",
    "Version": "1.2.3"
  }
]

配置字段：

字段	含义
`Enabled`	是否启用校验
`Mode`	`Whitelist` 仅允许匹配条目；`Blacklist` 拒绝匹配条目
`IncludeServerMods`	白名单自动包含服务端模组及服务器目录中的客户端模组；黑名单仅使用手动清单
`ReportTimeoutSeconds`	清单审计上报超时日志时间，默认 30 秒
`Mods`	手动清单，每条必须有有效 ID 和精确版本

服务器会通过原版连接握手下发：

ServerModIdBlackList
ServerModIdWhiteList

客户端在启动服务器模组前，会根据 ID 和版本禁用不允许的模组，而不是进入世界后再踢出玩家。

修改策略后，玩家需要重新连接服务器。

该机制无法阻止客户端连接服务器前运行本地代码，也不是防作弊远程证明系统。

管理员命令

生命次数

命令	行为
`/vscncs reset <玩家名>`	在线玩家立即重置；离线玩家下次连接时重置
`/vscncs resetall`	在线玩家立即重置，离线玩家下次连接时重置一次
`/vscncs reset start n`	从执行时起，每位玩家之后前 `n` 次连接分别重置一次
`/vscncs reset stop`	停止登录重置活动
`/vscncs reload config`	热重载配置并重新检查在线玩家模组

reset start 1 是每位玩家各有一次额度，而不是全服只重置第一个玩家。

同一玩家退出后重新进入不会重复消耗同一次额度。

reset start 2 表示该玩家前两次连接各重置一次，第三次连接不再重置。

活动及消耗记录会随世界保存。

手动重置不会消耗登录活动额度。

聚落管理

命令	权限与行为
`/vscncs cluster info`	普通玩家查看自己的聚落
`/vscncs cluster infoall`	管理员查看完整状态与在线人数
`/vscncs cluster list`	管理员列出绝对、相对坐标
`/vscncs cluster who <玩家名>`	管理员查询在线或离线玩家归属
`/vscncs cluster tp <编号>`	管理员传送到安全的聚落中心，不修改自己的出生点
`/vscncs cluster assign <目标玩家> <好友玩家>`	管理员在好友重生点附近重新分配在线目标玩家
`/vscncs cluster reset <玩家名>`	管理员重新分配在线玩家聚落和出生点
`/vscncs cluster resetall`	管理员清空归属并重新分配，离线玩家下次加入时分配
`/vscncs cluster reroll`	管理员重新选址，成功后清空归属并重新分配

除 cluster info 外，所有命令需要 controlserver 权限；控制台可以执行不需要玩家位置的命令。按 Ctrl+Shift+S 打开文明模拟窗口。部落页向同维度 10 格内未入部落的玩家发起建部落邀请，至少一人接受后才在发起者当时的位置成立部落，发起者成为首领；并支持邀请、修改名称、退出、踢出、向其他部落首领申请转向及审批。部落少于两人时自动解散；首领离开且仍有至少两人时由剩余成员接任。邀请和申请保留 120 秒。世界页按部落领地中心和附庸地的真实世界 X/Z 坐标等比例显示部落与世界出生点，并绘制归属连线；不发送成员资料。世界画面标记另行同步领地中心的实际位置。聚落页仅管理员可见，显示原聚落出生点地图；悬浮点的半透明黑色提示位于点上方，可查看绝对、相对坐标、距离、分配与在线人数、半径、软容量、模式、当前填充状态和成员名单（最多 40 人）。聚落详情只发送给有 controlserver 权限的玩家。

部落管理命令	行为
`/vscncs tribe list`	列出全部部落的名称、首领、人数、领地中心相对世界出生点的 X/Z、Y、维度和附庸地数
`/vscncs tribe delete <部落名>`	按完整名称解散指定部落，保存更改并刷新在线玩家；控制台也可执行

文明模拟窗口提供部落、世界和仅管理员可见的聚落页面。按 Ctrl+Shift+S 打开窗口；不再注册手册入门页的 U 键。科技树页面及科技进度扫描已移除；既有存档中的科技记录暂予保留。

卸载后，已经写入的专属出生点仍保留在游戏玩家数据中；聚落分配、窗口、校验及本模组保护停止。

聚落页面

聚落页面仅管理员可见。

页面显示：

原聚落出生点地图
聚落编号
绝对坐标
相对坐标
距离
分配情况
在线人数
聚落半径
软容量
分配模式
当前填充状态
成员名单

成员名单最多显示 40 人。

聚落详情只发送给拥有 controlserver 权限的玩家。

领地配置

服务器配置文件：

ModConfig/VscnCivilizationSimulation.json

修改后执行：

/vscncs reload config

无效配置会拒绝重载。

Territory 配置：

字段	默认值	含义
`Radius`	`50`	主领地和附庸地半径，1–1000 格
`FirstOutpostMembers`	`4`	建立第一个附庸地所需成员数
`SecondOutpostMembers`	`6`	建立第二个附庸地所需成员数
`MaxOutposts`	`2`	附庸地上限，0–2
`CenterCooldownMinutes`	`60`	创建后及两次迁移之间的等待分钟数，0 表示无等待
`HomeRestBonus`	`500`	部落亢奋：额外休息值及休息容量，单位 kcal，需要 BodyPhys
`HomeRestRateBonus`	`5`	部落休养：领地内睡眠或坐下时额外回复的休息值/游戏小时，需要 BodyPhys
`AwayRestPenalty`	`100`	离开本部落全部领地后的休息值减量，单位 kcal，需要 BodyPhys
`SpeedBonus`	`0.05`	部落就是我的家：原版 walkspeed 增量
`AttackDamageBonus`	`-0.05`	英雄难过温柔乡：攻击最终进入受伤流程前乘以 0.95
`RopingChanceBonus`	`0.10`	一切由部落控制：VS Roping 成功率增加 10 个百分点，最高 100%
`HealthBonus`	`0`	原版最大生命值增加的点数
`ExertionRateBonus`	`0`	BodyPhys 劳损增长速率修正

休息值说明

HomeRestBonus 和 AwayRestPenalty 使用 BodyPhys 的休息 kcal 单位。

默认 BodyPhys 内部：

100 点 = 5200 kcal
默认领地内上限 = 5700 kcal

HomeRestRateBonus 与 BodyPhys 的回复速率使用相同的内部单位。

例如原先显示约 +4.8，增加 5 后约为 +9.8。

负数可以降低回复速度，但最终回复速率最低为 0。

领地效果管理

效果会在玩家进入和离开领地时按照差值应用，不会因为持续停留而重复增加一次性加成。

返回领地时会恢复离境减量。

修改配置中的加成时，只应用新旧配置之间的差值。

默认：

不改变生命值。
不改变劳损增长速率。

如果 BodyPhys 或 VS Roping 未安装，会跳过对应效果。

卸载模组前，应先将：

HomeRestBonus
AwayRestPenalty

设置为 0，然后热重载配置，并让拥有持久化休息修正的玩家上线，以清理其保存的休息修正。

管理员领地调试

以下命令必须由游戏内玩家执行，并拥有 controlserver 权限。

命令格式：

/vscncs territory debug <动作> [参数]

建议使用测试世界。

查看领地状态

/vscncs territory debug reset
/vscncs territory debug info

info 会显示：

当前模式
是否为部落成员
是否在领地内
部落名称
最终移动速度
领地速度增量
最大生命
休息 kcal / 上限
回复速率
劳损
攻击倍率
套索接入状态
附庸地名额

默认配置且安装 BodyPhys 时：

领地内休息上限应为 5700 kcal
领地回复加成为 5
没有测试覆盖时模式应为 auto

模拟领地状态

不创建部落，也不会修改部落存档：

/vscncs territory debug home
/vscncs territory debug info

模拟部落成员位于自己领地内。

默认情况下最终移动速度为 105.0%，攻击倍率为 0.95。

模拟离开领地：

/vscncs territory debug away
/vscncs territory debug info

恢复无部落状态：

/vscncs territory debug none
/vscncs territory debug info

恢复真实位置判定：

/vscncs territory debug auto

验证 BodyPhys

安装并启用 BodyPhys 后，可以测试真实窗口数值：

/vscncs territory debug home
/vscncs territory debug rest 2600
/vscncs territory debug strain 0.5
/vscncs territory debug info

然后坐下或躺床，再打开 BodyPhys 生理学窗口。

预期：

休息值约为 2600 kcal
领地内上限为 5700 kcal
回复速率比 auto/away 高 5
strain 0.5 显示为 50%

rest 超过当前上限或 strain 不在 0..1 范围内时，命令会拒绝。

临时修改配置

set 只修改服务器当前内存中的配置，不写入磁盘。

例如：

/vscncs territory debug set SpeedBonus 0.10
/vscncs territory debug set HomeRestRateBonus 9
/vscncs territory debug home
/vscncs territory debug info

可以测试：

HomeRestBonus
AwayRestPenalty
AttackDamageBonus
RopingChanceBonus
HealthBonus
ExertionRateBonus
Radius
附庸地人数门槛

测试完成后恢复磁盘配置：

/vscncs reload config
/vscncs territory debug reset

reset 不会回滚 set 修改的全服内存配置，因此必须执行 reload config 或重启服务器。

验证部落和附庸地

以下操作会写入世界存档，建议只在测试世界使用。

创建测试部落：

/vscncs territory debug create 测试部落
/vscncs territory debug info

执行者会成为首领，并生成领地旗帜。

默认：

领地半径：50 格
新中心或附庸地与任一已有领地中心至少相距 100 格

测试第一个附庸地：

/vscncs territory debug members 4
/vscncs territory debug info

此时附庸地应显示：

0/1

移动到距离中心超过 100 格的位置：

/vscncs territory debug outpost
/vscncs territory debug info

测试第二个附庸地：

/vscncs territory debug members 6
/vscncs territory debug info

名额应变为：

2

再次移动到距离现有领地中心均超过 100 格的位置后执行：

/vscncs territory debug outpost

最多创建两个附庸地。

验证领地迁移

查看并清除迁移冷却：

/vscncs territory debug cooldown

移动到新的位置后：

/vscncs territory debug move
/vscncs territory debug info

move 仍会检查与其他领地的距离，并将新位置写入世界存档。

Ctrl+Shift+S 的世界页面应同步新的领地旗帜位置。

测试结束