Repository navigation
Commit 4264520
authored
添加 TerraNews 泰拉新闻插件 (#1205)
* feat: 添加 TerraNews 泰拉新闻插件
每天游戏内 04:30 全服播报今日渔夫任务鱼(可交互图标)与今日月相,
沙尘暴/暴风雪与旅商到访时同步播报。
- 任务鱼与旅商货架使用原版 [i:netId] 物品标签,玩家悬停即可查看详情
- 任务鱼名称、产地、深度、钓法提示均在图标悬停提示中,不在聊天框重复输出
- 每日触发与 Main.mfwh_AnglerQuestSwap 同帧,保证播报的是新任务
- 总开关 + 每项功能单独开关,关闭某项时依赖它的整行一并消失
- 四组播报模板均可自定义,支持颜色标签与占位符替换
* refactor: 清理死代码并精简注释
删除仅被自身测试引用的成员,并压缩多行注释:
- HalfDayTrigger.LastTime:无任何引用
- AuthorityResolver 的实例状态:与 NewsHub 完整重复,生产代码一行未用,
改为只保留 ServerRenders / ClientRenders 两个静态方法
- FeatureSwitches.Enabled() / Disabled():只有测试在用,测试改用索引器遍历
- GameTime.HasPassed / DayLengthTicks、ChatLineParser.StripColorTag、
MoonPhases.IsNotable:仅测试引用
保留 QuestFishCatalog.QuestPool:41 条原版任务鱼 ID 的基准表,测试据此校验
目录一致性,属于规格数据而非死代码。
注释由 304 行压到 214 行,每段尽量收敛为一行。
* refactor: 按仓库约定重整 TerraNews 插件
对齐 UnrealMultiple/TShockPlugin 其余 140+ 插件的组织方式:
- Core/ 子目录摊平到插件目录,与其他插件一致;命名改用
Configuration.cs / QuestFish.cs / WorldEvent.cs / Rendering.cs
- 接入仓库统一的 GetString 国际化(template.targets 已注入 Shared/I18n.cs),
新增 i18n/template.pot 与 i18n/en-US.po
- 补 README.en-US.md,与 README.md / manifest.json 的三语描述对齐
- 合并 broadcast/weather/merchant/reload 四处重复的权限与开关检查为 Gate()
- broadcast 子命令原本重复构建两次播报上下文,合并为一次
随之删除仅为多端共享而存在、现已无人引用的抽象:NewsChannel、AuthorityResolver、
FeatureSwitches.Channels/Clone、FeatureMap.Owner、QuestPool、ShouldAnnounce、
QuestFishCatalog.NameText/BiomeText,以及两个未使用的 using。
GetString 一律使用内插值的 FormattableString 重载:位置参数重载
GetString(FormattableStringAdapter, params object[]) 在服务端不替换实参,
会把 {0:00} 原样打印成 00。
* refactor: 删除内置鱼种数据,注释统一为中文
发送任务鱼图标只需要 ID,名称、产地、深度、钓法本就来自原版物品标签的悬停提示,
因此删除 QuestFish.cs 里的 41 条鱼种介绍。
随之失效并一并移除:
- 占位符 {name} {name_zh} {name_en} {name_vanilla} {biome} {depth} {yrange} {tip}
- Features.FishingLocation 开关(它只控制上述占位符)
- NameSource 配置项(唯一消费者是已删除的 {name})
- NameText 与 SafeVanillaName(不再需要读原版本地化表)
所有 <summary> 换成普通 // 注释并译为中文;README.en-US.md 与 manifest 里的
en-US/es-ES 描述一并删除,manifest 只保留 README,与 BossLock 等插件一致。
插件体积 45.5 KB -> 36.5 KB。
* Modify author info and clean up links in README
Updated author name and removed outdated links.
* fix: 修复任务鱼图标不显示,沙尘暴与暴风雪分开播报
图标:原版客户端用一条正则单次扫过聊天文本,文字部分非贪婪:
\[(?<tag>[a-zA-Z]{1,10})(\\/(?<options>[^:]+))?:(?<text>.+?)(?<!\\\\)\\]
所以颜色标签只吞到它后面第一个 ],写成两段颜色标签时
[c/FFD966:任务鱼] [c/FFFFFF:[i:2451]] 里的 [i:2451 会被颜色标签当成正文,
图标永远不会被转换,只会显示成字符串。改为整行一个颜色标签——这种写法
ChatLineParser 本来就会剥掉标签换成真正的 RGB,客户端收到纯文本,图标正常。
顺带在解析器里加了告警:渲染结果里同时出现多个颜色标签和物品标签时,
往 TShock 日志写一次警告并给出正确写法。
沙尘暴与暴风雪拆成两套模板:原版只有同一个 Sandstorm 事件,客户端按
player.ZoneSnow && player.ZoneRain 决定是雪还是沙,插件用同样的判据区分在线
玩家,空服时退回抽样扫描世界地表。新增 BlizzardLines 与 BlizzardPeakLines。
同时删掉天气播报里的注意事项文案,版本号固定为 1.0.0。
* fix: 沙尘暴不再被误判成暴风雪
原版判定暴风雪用的是 player.ZoneSnow && player.ZoneRain,但这两个标志在专用服务器
上不可靠:
ZoneRain = Main.raining && Y <= worldSurface // 全局,准确
ZoneSnow = Main.SceneMetrics.EnoughTilesForSnow // 客户端算的,服务器上是过期值
在 rain(一直下雨)种子上 ZoneRain 恒为真,判据退化成只看 ZoneSnow,于是一个玩家
就能把沙尘暴误报成暴风雪。空服时因为没有 active 玩家反而走了兜底分支,所以只在
有人在线时复现。
改为不问玩家,抽样扫描地表明层数沙块(32)与雪块(51),结果缓存一次,reload 时清空。
默认世界和 rain 种子的沙漠地表都约为雪原的 4 倍,判定结果均为沙尘暴。
沙尘暴与暴风雪在同一个世界里本就无法两全(同一事件对沙漠是黄沙、对雪原是暴雪),
新增 StormType 配置(auto/sandstorm/blizzard)让服主可以直接固定名字。
* docs: 去掉从未发布过的旧版本号
插件固定在 1.0.0,而 1.2.0/1.3.0/1.4.0 三个版本号只存在于开发过程,
从未发布。配置迁移里那两处注释会让人以为存在这些历史版本,改成描述
LegacyDailyLines 的实际用途:它是早期七行看板的逐字快照,用来把老配置
认出来并换成新默认,以及说明它依赖哪些已删除的占位符。
* refactor: 去掉 /terranews 指令,播报不再带时间和提示语
按反馈精简播报内容与交互方式:
- 每条播报结尾那条深灰色的行全部去掉:每日看板的「(游戏时间)输入 /terranews
可随时重新查看」、旅商的「共 N 件 · 售完即止(游戏时间)」,以及天气里的
个性语和预计持续时间
- 整个 /terranews 指令移除,包括 broadcast/storm/merchant/reload 与
新闻/泰拉新闻/news 三个别名。随之删掉 CommandAliases、CommandPermission、
AdminPermission 三项配置、ResolvedCommandPermission/ResolvedAdminPermission、
Gate/GateResult 权限校验、MainCommand、RegisterCommand、Send(TSPlayer),
以及只服务于 reload 的 WorldEventWatcher.Reset
- 改配置现在需要重启服务器,日志与 README 已同步说明
- 作者改为 不是现在,版本号保持 1.0.0
插件体积 38.5 KB -> 34.5 KB。
* docs: 标注暴风雪分支尚未实机验证
暴风雪的判定链路(IsBlizzard + 地表扫描 + StormType 覆盖)代码完整,但控制台
复现不出该场景:/worldevent 没有 blizzard 类型,两个测试世界的地表都是沙多雪少,
且专用服务器无玩家在线时世界不推进、OnUpdate 不触发。所以沙尘暴一侧跑通了,
暴风雪一侧只做了逻辑论证。
README 里补一节写清这一点,并给出真机验证步骤:需要雪原为主地表的世界,先看日志
确认雪块多于沙块,客户端连上后再用 /worldevent sandstorm 制造风暴。说明区也加了
指向该节的提示,避免读者以为两侧都已验证。
* docs: 暴风雪已在真实客户端环境验证通过
把 README 里的「暴风雪尚未实机验证」改写为「实机验证记录」:说明区那条 ⚠ 提示
一并去掉。保留的是验证过程中真正有价值的注意事项——auto 依赖地形判定、必须先有
客户端连上否则世界不推进、/worldevent 没有 blizzard 类型只能靠 sandstorm 制造、
峰值补报要等强度自然越过阈值。
同时删掉上一版里只服务于「尚未验证」语境的复现步骤。
* Update README.md to reflect current plugin features
Removed outdated information about broadcasting tasks and weather events. Updated the description to clarify the plugin's functionality.
* fix: 修正夜间播报与半日计数,并去掉风暴强度相关
包含两组改动。
一、回应 Sourcery 代码审查的 6 条意见(4 条成立、2 条驳回)
成立并修复:
1. 夜间播报时刻永远不触发。原 TriggerOffsetTicks 把 19:30-23:59 也按白天
04:30 归零点算偏移,offset 会超出白天 Main.time 的上限(20:00 算出 55800
刻,白天上限 54000 刻),IsInWindow 恒为假。改为三段式:04:30-19:29 按
DawnMinutes、19:30-23:59 按 DuskMinutes、00:00-04:29 按夜长倒推;
IsInWindow 的昼夜判定同步改成 !IsNightMinutes(m) == dayTime。
2. /time 回拨会重播。原逻辑把任何 Main.time 倒退都当成半日归零,与它自己
注释里「跳变不会重复播报」的意图相反。改为数 Main.dayTime 翻转——04:30
和 19:30 必然翻转,而管理员在同一半日内调时间(10:00 退回 05:00)不翻转,
闩锁因此不再被误重置。
3. 配置回写失败被空 catch 吞掉。只读目录会导致迁移结果静默丢失且无人知晓。
Load 增加可选的 Action<string> warn 回调,插件侧接到 TShock.Log.Warn;
读失败与写失败分两个出口报,因为两者处理方式不同。
驳回:
4. 建议静默期内 MarkAnnounced 以吞掉每日窗口。驳回:服务器恰好在窗口内启动
时,玩家理应看到当天看板,吞掉才是真的丢信息。已改注释说清「事件监视器要
消耗边沿、每日窗口不消耗」的真实理由。
另修:启动日志把窗口终点写死成 04:30-05:00,且把游戏分钟当成秒除以 60,
配置成 20:00 后会显示「即到 04:30」。改为按实际配置计算。
二、去掉沙尘暴与暴风雪的强度相关,只在出现时播一次
- 删除 {severity} 占位符与 SeverityText 四档文案
- 删除 SandstormPeak 功能开关(8 项降为 7 项)、SandstormPeakSeverity 配置、
SandstormPeakLines/BlizzardPeakLines 两套模板(模板从四套降为两套)
- 删除 NewsKind 枚举,TickSandstorm 改为返回 bool,与 TickMerchant 同形
- 删除 _stormMaxAnnounced 状态与 AnnounceSandstormPeak 迁移键
- 诊断日志不再输出 severity
验证:离线测试台 47 项断言全通过,含夜间各时段偏移量、/time 回拨、半日翻转、
风暴只在上升沿播报、货架展开;沙尘暴与暴风雪两侧均已在真实客户端环境下确认。
插件体积 35 KB -> 33 KB。
* fix: 显式把触发窗口截到半日结束
窗口上界原本只取 offset + windowTicks,于是配置时刻贴近半日边界时(比如 19:20
配 30 分钟窗口),上界 55200 会越过白天长度 54000,那一段永远播不到。
这不是缺陷而是窗口的本意——窗口的作用是到点报一次,刻意做得很窄,专用服务器
只在有客户端时才推进世界,本来就不该在错过触发点后补一条过期的播报——但原写法
让它依赖 IsNightMinutes 那一行早退的副作用,属于碰巧如此。
改为显式取半日结束与配置窗口的较小者,并补上原先缺失的 DayLengthTicks 常量:
double limit = Math.Min(offset + windowTicks, dayTime ? DayLengthTicks : NightLengthTicks);
行为不变,但意图写在代码里,不贴边的配置(如正午 12:00)仍播满整窗。
测试台补 12 项边界断言,覆盖 19:20、19:00、04:25、23:50、01:00 五个贴近半日
边界的触发点,各验证首帧命中、边界前一刻命中、边界后不命中;全套 67 项通过。1 parent 376f0cb commit 4264520
14 files changed
Lines changed: 1252 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
144 | 144 | | |
145 | 145 | | |
146 | 146 | | |
| 147 | + | |
147 | 148 | | |
148 | 149 | | |
149 | 150 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
192 | 192 | | |
193 | 193 | | |
194 | 194 | | |
| 195 | + | |
195 | 196 | | |
196 | 197 | | |
197 | 198 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
| 105 | + | |
| 106 | + | |
| 107 | + | |
| 108 | + | |
| 109 | + | |
| 110 | + | |
| 111 | + | |
| 112 | + | |
| 113 | + | |
| 114 | + | |
| 115 | + | |
| 116 | + | |
| 117 | + | |
| 118 | + | |
| 119 | + | |
| 120 | + | |
| 121 | + | |
| 122 | + | |
| 123 | + | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
| 130 | + | |
| 131 | + | |
| 132 | + | |
| 133 | + | |
| 134 | + | |
| 135 | + | |
| 136 | + | |
| 137 | + | |
| 138 | + | |
| 139 | + | |
| 140 | + | |
| 141 | + | |
| 142 | + | |
| 143 | + | |
| 144 | + | |
| 145 | + | |
| 146 | + | |
| 147 | + | |
| 148 | + | |
| 149 | + | |
| 150 | + | |
| 151 | + | |
| 152 | + | |
| 153 | + | |
| 154 | + | |
| 155 | + | |
| 156 | + | |
| 157 | + | |
| 158 | + | |
| 159 | + | |
| 160 | + | |
| 161 | + | |
| 162 | + | |
| 163 | + | |
| 164 | + | |
| 165 | + | |
| 166 | + | |
| 167 | + | |
| 168 | + | |
| 169 | + | |
| 170 | + | |
| 171 | + | |
| 172 | + | |
| 173 | + | |
| 174 | + | |
| 175 | + | |
| 176 | + | |
| 177 | + | |
| 178 | + | |
| 179 | + | |
| 180 | + | |
| 181 | + | |
| 182 | + | |
| 183 | + | |
| 184 | + | |
| 185 | + | |
| 186 | + | |
| 187 | + | |
| 188 | + | |
| 189 | + | |
| 190 | + | |
| 191 | + | |
| 192 | + | |
| 193 | + | |
| 194 | + | |
| 195 | + | |
| 196 | + | |
| 197 | + | |
| 198 | + | |
| 199 | + | |
| 200 | + | |
| 201 | + | |
| 202 | + | |
| 203 | + | |
| 204 | + | |
| 205 | + | |
| 206 | + | |
| 207 | + | |
| 208 | + | |
| 209 | + | |
| 210 | + | |
| 211 | + | |
| 212 | + | |
| 213 | + | |
| 214 | + | |
| 215 | + | |
| 216 | + | |
| 217 | + | |
| 218 | + | |
| 219 | + | |
| 220 | + | |
| 221 | + | |
| 222 | + | |
| 223 | + | |
| 224 | + | |
| 225 | + | |
| 226 | + | |
| 227 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
| 1 | + | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
| 26 | + | |
| 27 | + | |
| 28 | + | |
| 29 | + | |
| 30 | + | |
| 31 | + | |
| 32 | + | |
| 33 | + | |
| 34 | + | |
| 35 | + | |
| 36 | + | |
| 37 | + | |
| 38 | + | |
| 39 | + | |
| 40 | + | |
| 41 | + | |
| 42 | + | |
| 43 | + | |
| 44 | + | |
| 45 | + | |
| 46 | + | |
| 47 | + | |
| 48 | + | |
| 49 | + | |
| 50 | + | |
| 51 | + | |
| 52 | + | |
| 53 | + | |
| 54 | + | |
| 55 | + | |
| 56 | + | |
| 57 | + | |
| 58 | + | |
| 59 | + | |
| 60 | + | |
| 61 | + | |
| 62 | + | |
| 63 | + | |
| 64 | + | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
| 93 | + | |
| 94 | + | |
| 95 | + | |
| 96 | + | |
| 97 | + | |
| 98 | + | |
| 99 | + | |
| 100 | + | |
| 101 | + | |
| 102 | + | |
| 103 | + | |
| 104 | + | |
0 commit comments