Skip to content

Commit fffa109

Browse files
authored
DailyMerchant v1.1:合并骷髅商人,白天出生点附近有人时来一只 (#1206)
* 添加插件:DailySkeletonMerchant 骷髅商人每日到访 v1.0 - 每天上午 4:30 起在出生点附近固定位置出现一次,锚点由出生点确定性搜索得出 - 50 格内无在线玩家即离场(与原版 UnspawnTravelNPC 一致),当天不再出现,死亡不补位 - 场上已有骷髅商人(洞穴自然生成 / 管理员召唤)时不干预 - 无配置文件;货品沿用原版,随 Main.moonPhase 在每天清晨 4:30 自动换货 - 指令 /skeleton summon|despawn|check|status(别名 /skeletonmerchant、/骷髅商人、/骷髅),权限 tshock.admin * docs(DailySkeletonMerchant): 补充管理员测试注意事项(/time 跳时间不算跨天、despawn 会用掉当天名额) * fix(DailySkeletonMerchant): 世界初始化不再清掉命令刚记下的状态,并在 status 里显示附近玩家数 - EnsureWorldReady 改成只在"就绪状态发生变化"时重置当天状态;之前它无条件清空 _handledThisDay / _spawnedIndex,空服时第一个判定来自 /skeleton 命令,会把 summon 刚记录的 NPC 槽位与当天额度一起清掉,导致召唤出来的骷髅商人再也无人离场 - OnCommand 入口也先确认一次世界已载入 - /skeleton status 增加"附近玩家",排查"为什么不离场"时能直接看出离场半径内有几人 * feat(DailySkeletonMerchant): 去掉全部指令与状态输出,出生点改为多候选随机挑选 - 删除 /skeleton 命令及其 summon|despawn|check|status 子命令、status 输出、 相关文案(i18n 模板现在只剩 Description 一条);全程无指令、无广播 - 出生点不再写死 Main.spawnTileX/Y: - 种子按队伍分配出生点时(Main.teamBasedSpawnsSeed),ExtraSpawnPointManager .extraSpawnPoints 里每个队伍一个出生点,随机挑一个再用; - 普通种子仍然用世界出生点 - 出生点站不住人时的处理:逐个出生点由近及远找锚点(常规 40 格), 全都不行再用 120 格兜底找一遍;另排除地牢砖与 226 号砖(原版挑出生点同样排除) - 同一出生点的锚点依旧固定:搜索顺序只取决于出生点坐标 * fix(DailySkeletonMerchant): CanStand 一并检查地面方块的液体(Sourcery 审核 #1206) - 原实现只检查身体两格与两侧方块的液体,漏掉了被选作地面的 (x, y+1); 该方块带液体时(例如被水淹没的实心方块、被其他插件改过的方块)仍会被接受, 与"不泡水"的约定不符 - 现在脚下、身体、两侧一起判断 liquid;地面方块的液体判断直接复用已有的 floor 引用, 不增加额外数组访问 * feat(DailyMerchant)!: 合并骷髅商人到同一插件(v2.0),加配置文件开关 原 DailySkeletonMerchant 并入 DailyMerchant,一个插件管两个商人,配置文件 DailyMerchant.json 里各一个开关,默认都开(用 /tconfig reload 热重载)。 行为变化: - 骷髅商人改为与旅商一致的离场条件——看游戏时间:天黑就走,不看玩家距离; 清场走原版 UnspawnTravelNPC 的做法(清 active/life + 广播 23 号包), 场上不管是谁生成的一起走,保证"每天上午来一个" - 离场后当天名额仍然保留,第二天上午再来;被打死不补位 - 场上已有骷髅商人时当天不生成第二只、也不干预(保留原规则) 顺带修掉 v1.0 的两个问题: - 自动判定改成按真实时间间隔(1 秒)而不是每 20 帧,60 FPS 下原本只有 0.33 秒 - 带占位符的文案改走 GetString("…{0}…") + 自己 Format:GetText.NET 8 的 FormattableStringAdapter 会先把插值算好再查表,GetString($"…{0}…", args) 里的 {0} 会被当成"没有这个实参"填成 0,status 里表现为"已过上午4:30 + 0 分钟" - 旅商诊断补上入侵进行中的原因 /merchant 的 summon/despawn 仍只作用于旅商,check 与 status 扩展到两个商人。 DailySkeletonMerchant 目录删除,Plugins.json 与 Plugin.slnx 同步移除注册, DailyMerchant 升到 2.0 并更新 12 种语言的描述。 * chore(DailyMerchant): 版本号定为 1.1(合并骷髅商人这一版不升大版本) DailyMerchant 已在 v1.0 合并上线,本次只是加入骷髅商人并加配置开关,按小版本发布。 代码、README 更新日志与 Plugins.json 统一改成 1.1。 * feat(DailyMerchant): 骷髅商人离场改为"时间到 + 附近无人"才走 之前是"天黑就走",玩家站在旁边也会突然消失。现在两条同时满足才离场: - 时间到了(天黑)但 800 像素(50 格)内还有玩家 → 他照常站着,不会突然消失; - 天黑且附近没人 → 清场方式和原版 UnspawnTravelNPC 一致(清 active/life + 广播 23 号包); - 走掉之后当天不再出现,第二天上午再来; - 玩家一直在旁边的话,他第二天清晨也还在(场上已有就不生成第二个)。 同时收窄了作用范围:只清插件自己生成的那一只(记录 NPC 槽位 _skeletonIndex, 槽位失效或 NPC 已死就自动放弃跟踪),洞穴里刷到的、别的插件召唤的一概不动。 上一版是"天黑清掉场上所有骷髅商人",会误伤玩家在洞穴里摆的商人。 /merchant status 的离场条件显示改为"天黑且 800 像素内无人",README 同步更新。 * fix(DailyMerchant): 别让原版把骷髅商人按距离卸载掉 现象:白天玩家离开出生点一段距离(贝壳电话传送、跑远),骷髅商人就被原版清掉了, 等他回来时人已经没了,当天的"每天上午来一个"就废了。 原因:原版会把离所有玩家 2000 像素(125 格)之外的 NPC 慢慢卸载(NPC.timeLeft 倒计时走完即清), 骷髅商人不是城镇 NPC,照样适用——洞穴里原版的骷髅商人也是这么没的。 修法两层: - 每秒把他 timeLeft 按回 0,他一直留在出生点(顺带把空槽位判为"被原版卸载"的检测也放在这里) - 兜底补位:万一还是被清掉(别的插件动过、换了游戏版本),只要 6000 像素内有玩家 就在同一个锚点补回,最多每 5 秒补一次,不会来回抖动;被打死的(血量归零)不补位 离场条件不变:仍然要"天黑 + 800 像素内没人"才走。 * chore(DailyMerchant): 补上新增文案的英文翻译 * refactor(DailyMerchant): 骷髅商人只按"白天 + 出生点附近有人"生成,其余交给原版 反复调试后把判定简化成四条必须同时满足的条件:开关开、白天、场上没有骷髅商人、 锚点 2000 像素内有玩家。满足就在固定锚点生成一只,不满足就不生成。 删掉离场判定、原位补位、timeLeft 按回 0、死因区分、当天名额等全部逻辑 (SkeletonUpdate / RespawnSkeletonIfNeeded / MarkSkeletonHandled / UpdateSkeletonDay / DespawnNpc),连带 6 个状态字段一并移除,1031 行降到 851 行。 玩家走远后骷髅商人会不会消失、被谁清掉,全部是原版按距离卸载的行为,插件不干预也不补位。 "有人"的半径取 2000 像素,与原版卸载半径一致,保证不会出现"刚出现就自己没了"。 README 中英文补上完整的生成规则、判定顺序与白天/晚上行为矩阵。 * chore(DailyMerchant): 运行期不再输出日志,README 清掉不存在的指令 - 事件日志从 ConsoleInfo 改回 ConsoleDebug:原版卸载倒计时那几轮排查需要它落盘, 现在规则定下来了,服务器上保持安静(除加载时那行横幅)。 - README 去掉 /tconfig reload:它属于 TSConfig 插件,服务器上不一定装了, 改成"改完重启生效",并说明装了 TSConfig 时仍可热重载。 * docs(DailyMerchant): README 去掉指令与权限表 中英 README 里删掉整段"指令 / Commands"表格(语法、权限、别名), 排查段落改为描述诊断输出本身,不再列出指令语法与权限。 * refactor(DailyMerchant): 去掉 /merchant 指令,README 删掉排查章节 插件不再注册任何指令:RegisterCommand / RemoveCommand / OnCommand / SendHelp / SendStatus 全部删除,连带只服务于指令输出的诊断辅助方法 (Clock、Where、Town、InWindow、BlockReason、ExplainVanillaBlock、LastVanillaBlock、 SkeletonBlockReason)与 _scanCount 字段一并移除,851 行降到 559 行。 启动横幅与 Plugins.json 之外不再有玩家可见的输出,排查章节里的控制台日志样例 也一并从 README 删除。现在插件完全靠配置开关工作,没有指令也没有权限。 * fix(DailyMerchant): 回应 Sourcery 审核意见 - Config.Read 只捕获 JsonException:配置文件存在但读不了(被锁、无权限、I/O 错误)时 File.ReadAllText 会抛异常并中断插件初始化。现在补上 IOException / UnauthorizedAccessException, 兜底重写默认配置时同样容错——目录只读写不回去也不影响服务器起来,只是没有配置文件。 实测把 DailyMerchant.json 写成坏 JSON 后重启:插件正常加载并重建出默认配置。 - 删除过时的 /merchant check 文档注释(指令已整体移除):EnsureWorldReady 与 RunScan 的 注释改为只描述自动判定与空服行为;Config.cs 里 /tconfig reload 也改成"重启生效"。 - CanStand 检查脚下地面液体那条(a4b63698 已修,评论指向的是已删除的 DailySkeletonMerchant) 在合并后的 DailyMerchant.CanStand 里同样保留 floor.liquid > 0 的判断。 * refactor(DailyMerchant): 按维护者意见简化,并交还 Plugins.json - Plugins.json 与 Plugin.slnx 还原成合并基点的版本:前者由 CI 自动生成,PR 不应手动修改。 - Config.Read 去掉防御式 try/catch,改成仓库通用的写法(参照 DamageRuleLoot)。 - PresenceRadiusPx 写成 125 * 16,用格子数表达含义。 - 去掉 SpawnSkeleton 里的 netMode == 2 判断:插件只在服务端运行,恒为多人模式。 - 删除 EnsureWorldReady 状态机:GameUpdate 只在有人在线时触发,空服本来就不会跑判定。 换成 ResetOnWorldChange(),只按世界名变化清当天状态。 - i18n:en-US.po 补上 Language 头、结尾补空行,与仓库其他插件的 .po 结构一致。 DailyMerchant.cs 559 → 543 行。
1 parent c37098a commit fffa109

8 files changed

Lines changed: 574 additions & 705 deletions

File tree

‎src/DailyMerchant/Config.cs‎

Lines changed: 40 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
using Newtonsoft.Json;
2+
using TShockAPI;
3+
4+
namespace DM;
5+
6+
/// <summary>
7+
/// 插件配置:两个商人各一个开关,默认都开。
8+
///
9+
/// 用仓库里通用的做法(参照 DamageRuleLoot):配置文件放在 TShock 配置目录下,
10+
/// 叫 DailyMerchant.json,不存在就按默认值写一份;改完重启服务器生效
11+
/// (服务器上装了 TSConfig 的话也能走 TShock 的配置重载事件)。
12+
/// </summary>
13+
public class DailyMerchantConfig
14+
{
15+
[JsonProperty("启用旅商每日到访", Order = 0)]
16+
public bool TravellingMerchantEnabled { get; set; } = true;
17+
18+
[JsonProperty("启用骷髅商人每日到访", Order = 1)]
19+
public bool SkeletonMerchantEnabled { get; set; } = true;
20+
21+
// ------------------------------------------------------------------ 读取与写入
22+
23+
public static readonly string FilePath = Path.Combine(TShock.SavePath, "DailyMerchant.json");
24+
25+
public void Write() =>
26+
File.WriteAllText(FilePath, JsonConvert.SerializeObject(this, Formatting.Indented));
27+
28+
/// <summary>读配置;文件不存在就按默认值写一份。</summary>
29+
public static DailyMerchantConfig Read()
30+
{
31+
if (!File.Exists(FilePath))
32+
{
33+
var config = new DailyMerchantConfig();
34+
config.Write();
35+
return config;
36+
}
37+
38+
return JsonConvert.DeserializeObject<DailyMerchantConfig>(File.ReadAllText(FilePath)) ?? new DailyMerchantConfig();
39+
}
40+
}

0 commit comments

Comments
 (0)