Skip to content

Commit 4264520

Browse files
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

‎Plugin.slnx‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,7 @@
144144
<Project Path="src/SurvivalCrisis/SurvivalCrisis.csproj" />
145145
<Project Path="src/SwitchCommands/SwitchCommands.csproj" />
146146
<Project Path="src/TeleportRequest/TeleportRequest.csproj" />
147+
<Project Path="src/TerraNews/TerraNews.csproj" />
147148
<Project Path="src/TimeRate/TimeRate.csproj" />
148149
<Project Path="src/TimerKeeper/TimerKeeper.csproj" />
149150
<Project Path="src/TownNPCHomes/TownNPCHomes.csproj" />

‎README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -192,6 +192,7 @@
192192
| [SurvivalCrisis](./src/SurvivalCrisis/README.md) | 类among us小游戏 | |
193193
| [SwitchCommands](./src/SwitchCommands/README.md) | 区域执行指令 | |
194194
| [TeleportRequest](./src/TeleportRequest/README.md) | 传送请求 | |
195+
| [TerraNews](./src/TerraNews/README.md) | 每日渔夫任务、月相、沙尘暴与旅商播报 | |
195196
| [TimeRate](./src/TimeRate/README.md) | 时间加速插件 | |
196197
| [TimerKeeper](./src/TimerKeeper/README.md) | 保存计时器状态 | |
197198
| [TownNPCHomes](./src/TownNPCHomes/README.md) | NPC 快速回家 | |

‎src/TerraNews/Configuration.cs‎

Lines changed: 227 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,227 @@
1+
using Newtonsoft.Json;
2+
using Newtonsoft.Json.Linq;
3+
4+
namespace TerraNews;
5+
6+
// 1.0/1.1 的平铺布尔键,映射到后来的 Features 块,只在新文件没有该键时生效。
7+
public static class LegacyFeatureKeys
8+
{
9+
public static readonly IReadOnlyDictionary<string, Feature> Map = new Dictionary<string, Feature>(StringComparer.OrdinalIgnoreCase)
10+
{
11+
["ShowItemIcon"] = Feature.QuestFishIcon,
12+
["ShowMoonPhase"] = Feature.MoonPhase,
13+
["ShowAnglerStatus"] = Feature.AnglerStatus,
14+
["AnnounceSandstorm"] = Feature.Sandstorm,
15+
["AnnounceMerchant"] = Feature.TravelingMerchant,
16+
["LogToConsole"] = Feature.ServerLog
17+
};
18+
}
19+
20+
// 纯 JSON POCO,配置放在服务端目录下,改动后需重启服务器。
21+
public class TerraNewsConfig
22+
{
23+
// 总开关:关闭时插件完全静默,得改配置再重启才会生效。
24+
[JsonProperty("Enabled")]
25+
public bool Enabled { get; set; } = true;
26+
27+
// 每项功能单独开关,默认全开,所以新配置直接就是完整播报。
28+
[JsonProperty("Features", ObjectCreationHandling = ObjectCreationHandling.Replace)]
29+
public FeatureSwitches Features { get; set; } = new();
30+
31+
// 每日播报的游戏内小时(0-23);04:30 正是渔夫换新任务的时刻。
32+
[JsonProperty("BroadcastHour")]
33+
public int BroadcastHour { get; set; } = 4;
34+
35+
// 每日播报的游戏内分钟(0-59)。
36+
[JsonProperty("BroadcastMinute")]
37+
public int BroadcastMinute { get; set; } = 30;
38+
39+
// 触发窗口,单位是游戏分钟;默认 30 即覆盖 04:30-05:00。
40+
[JsonProperty("TriggerWindowSeconds")]
41+
public int TriggerWindowSeconds { get; set; } = 30;
42+
43+
// 插件加载后保持静默多久(真实秒)。
44+
[JsonProperty("StartupDelaySeconds")]
45+
public int StartupDelaySeconds { get; set; } = 5;
46+
47+
// 沙尘暴与暴风雪怎么区分:auto(按地形扫描)/ sandstorm(一律沙尘暴)/ blizzard(一律暴风雪)。
48+
[JsonProperty("StormType")]
49+
public string StormType { get; set; } = "auto";
50+
51+
// 货架每行放几个图标;0 = 不换行。
52+
[JsonProperty("MerchantItemsPerLine")]
53+
public int MerchantItemsPerLine { get; set; } = 5;
54+
55+
// 每秒输出一行触发器正在观察的状态。
56+
[JsonProperty("Diagnostics")]
57+
public bool Diagnostics { get; set; }
58+
59+
// 每日看板,刻意做得很短,因为 {icon} 的悬停提示已经包含了其余信息。
60+
// 占位符:{icon} {angler} {id} {moon} {moon_bonus} {time}
61+
// 含 {icon} 的行必须用「一个颜色标签包住整行」的写法,否则图标会变成一串字符。
62+
[JsonProperty("DailyLines", ObjectCreationHandling = ObjectCreationHandling.Replace)]
63+
public List<string> DailyLines { get; set; } = new()
64+
{
65+
"[c/4FC3F7:========== 泰拉新闻 · 今日渔夫任务 ==========]",
66+
"[c/FFD966:任务鱼 {icon}]",
67+
"[c/FFFFFF:今日月相 {moon}]"
68+
};
69+
70+
// 早期开发版那套七行看板,只为让老配置能被认出来并换成新默认而保留。
71+
// 它依赖已经删掉的 {name} {biome} {depth} {yrange} {tip} 占位符。
72+
internal static readonly string[] LegacyDailyLines =
73+
{
74+
"[c/4FC3F7:========== 泰拉新闻 · 今日渔夫任务 ==========]",
75+
"[c/FFD966:任务鱼] [c/FFFFFF:{icon} {name}]",
76+
"[c/FFD966:钓鱼地点] [c/FFFFFF:{biome} · {depth}{yrange}]",
77+
"[c/FFD966:提示] [c/FFFFFF:{tip}]",
78+
"[c/B39DDB:今日月相] [c/FFFFFF:{moon} · {moon_bonus}]",
79+
"[c/7FD4FF:{angler}]",
80+
"[c/888888:(游戏时间 {time})输入 /terranews 可随时重新查看今日任务]"
81+
};
82+
83+
// 沙尘暴。只在风暴出现的那一刻播一次,不跟进强度。
84+
// 占位符:{storm} {remaining} {time} {moon}。
85+
[JsonProperty("SandstormLines", ObjectCreationHandling = ObjectCreationHandling.Replace)]
86+
public List<string> SandstormLines { get; set; } = new()
87+
{
88+
"[c/E0A458:========== 泰拉新闻 · 天气预警 ==========]",
89+
"[c/FFD966:{storm}已登陆]"
90+
};
91+
92+
// 暴风雪。占位符与沙尘暴相同;原版只有一个 Sandstorm 事件,雪与沙按地形区分,
93+
// 所以这里也拆成两套模板,播报时才说对名字。
94+
[JsonProperty("BlizzardLines", ObjectCreationHandling = ObjectCreationHandling.Replace)]
95+
public List<string> BlizzardLines { get; set; } = new()
96+
{
97+
"[c/E0A458:========== 泰拉新闻 · 天气预警 ==========]",
98+
"[c/FFD966:{storm}已登陆]"
99+
};
100+
101+
// 旅商到访。占位符:{items} {count} {time} {moon}。
102+
[JsonProperty("MerchantLines", ObjectCreationHandling = ObjectCreationHandling.Replace)]
103+
public List<string> MerchantLines { get; set; } = new()
104+
{
105+
"[c/4FC3F7:========== 泰拉新闻 · 旅商到访 ==========]",
106+
"[c/FFD966:今日货架(悬停查看详情)]",
107+
"[c/FFFFFF:{items}]"
108+
};
109+
110+
public void Sanitize()
111+
{
112+
BroadcastHour = Math.Clamp(BroadcastHour, 0, 23);
113+
BroadcastMinute = Math.Clamp(BroadcastMinute, 0, 59);
114+
TriggerWindowSeconds = Math.Clamp(TriggerWindowSeconds, 1, 120);
115+
StartupDelaySeconds = Math.Clamp(StartupDelaySeconds, 0, 60);
116+
MerchantItemsPerLine = Math.Clamp(MerchantItemsPerLine, 0, 12);
117+
118+
Features ??= new FeatureSwitches();
119+
120+
if (DailyLines is null || DailyLines.Count == 0)
121+
DailyLines = new List<string> { "[c/FFD966:任务鱼 {icon}]" };
122+
if (SandstormLines is null || SandstormLines.Count == 0)
123+
SandstormLines = new List<string> { "[c/FFD966:{storm}已登陆]" };
124+
if (BlizzardLines is null || BlizzardLines.Count == 0)
125+
BlizzardLines = new List<string>(SandstormLines);
126+
if (MerchantLines is null || MerchantLines.Count == 0)
127+
MerchantLines = new List<string> { "[c/4FC3F7:旅商到访] [c/FFFFFF:{items}]" };
128+
}
129+
130+
// error 是"配置读不出来",warn 是"读出来了但没能写回去"。两者分开报,
131+
// 因为后者的处理方式不同:读失败会退回默认值,写失败只是迁移结果留在了内存里。
132+
public static TerraNewsConfig Load(string path, out string? error, Action<string>? warn = null)
133+
{
134+
error = null;
135+
try
136+
{
137+
if (!File.Exists(path))
138+
{
139+
var fresh = new TerraNewsConfig();
140+
fresh.Sanitize();
141+
Save(path, fresh);
142+
return fresh;
143+
}
144+
145+
string text = File.ReadAllText(path);
146+
var cfg = JsonConvert.DeserializeObject<TerraNewsConfig>(text);
147+
if (cfg is null)
148+
{
149+
error = "配置文件内容为空";
150+
return new TerraNewsConfig();
151+
}
152+
153+
MigrateLegacySwitches(cfg, text);
154+
MigrateDailyTemplates(cfg);
155+
cfg.Sanitize();
156+
157+
// 把升级后的结构写回去,这样管理员看到的是新字段,而不是一份我们
158+
// 已经悄悄不再读取的旧键。回写失败不该让插件跑不起来,但必须让管理员
159+
// 知道迁移没落盘,否则重启一次就白迁移一次。
160+
try
161+
{
162+
Save(path, cfg);
163+
}
164+
catch (Exception ex)
165+
{
166+
warn?.Invoke($"配置升级后的回写失败({ex.Message})。本次运行仍使用升级后的配置,但重启后会丢失。");
167+
}
168+
169+
return cfg;
170+
}
171+
catch (Exception ex)
172+
{
173+
error = ex.Message;
174+
return new TerraNewsConfig();
175+
}
176+
}
177+
178+
// 1.0 的平铺布尔键,只在新的 Features 块里缺该键时才搬进去。
179+
private static void MigrateLegacySwitches(TerraNewsConfig cfg, string json)
180+
{
181+
JObject root;
182+
try
183+
{
184+
root = JObject.Parse(json);
185+
}
186+
catch
187+
{
188+
return;
189+
}
190+
191+
JToken? features = root["Features"];
192+
foreach (KeyValuePair<string, Feature> entry in LegacyFeatureKeys.Map)
193+
{
194+
JToken? legacy = root[entry.Key];
195+
if (legacy is null || legacy.Type != JTokenType.Boolean)
196+
continue;
197+
198+
if (features is JObject obj && obj[entry.Value.ToString()] is not null)
199+
continue;
200+
201+
cfg.Features.Set(entry.Value, legacy.Value<bool>());
202+
}
203+
}
204+
205+
// 把 DailyLines 逐字比对,凡是还等于早期那套七行看板的就换成新默认,
206+
// 让升级真的改变玩家看到的东西。改过一个字的都原样保留——那是管理员自己的措辞。
207+
private static void MigrateDailyTemplates(TerraNewsConfig cfg)
208+
{
209+
if (cfg.DailyLines is null || cfg.DailyLines.Count != LegacyDailyLines.Length)
210+
return;
211+
212+
for (int i = 0; i < LegacyDailyLines.Length; i++)
213+
if (!string.Equals(cfg.DailyLines[i], LegacyDailyLines[i], StringComparison.Ordinal))
214+
return;
215+
216+
cfg.DailyLines = new TerraNewsConfig().DailyLines;
217+
}
218+
219+
public static void Save(string path, TerraNewsConfig cfg)
220+
{
221+
string? dir = Path.GetDirectoryName(path);
222+
if (!string.IsNullOrEmpty(dir))
223+
Directory.CreateDirectory(dir);
224+
225+
File.WriteAllText(path, JsonConvert.SerializeObject(cfg, Formatting.Indented));
226+
}
227+
}

‎src/TerraNews/Features.cs‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
using System.Text.RegularExpressions;
2+
3+
namespace TerraNews;
4+
5+
// 每一项可以单独开关的新闻。
6+
public enum Feature
7+
{
8+
DailyQuestBoard = 0,
9+
QuestFishIcon,
10+
AnglerStatus,
11+
MoonPhase,
12+
Sandstorm,
13+
TravelingMerchant,
14+
ServerLog
15+
}
16+
17+
// 开关组,默认为全开。
18+
public class FeatureSwitches
19+
{
20+
public bool DailyQuestBoard { get; set; } = true;
21+
public bool QuestFishIcon { get; set; } = true;
22+
public bool AnglerStatus { get; set; } = true;
23+
public bool MoonPhase { get; set; } = true;
24+
public bool Sandstorm { get; set; } = true;
25+
public bool TravelingMerchant { get; set; } = true;
26+
public bool ServerLog { get; set; } = true;
27+
28+
public static readonly Feature[] All = (Feature[])Enum.GetValues(typeof(Feature));
29+
30+
public bool this[Feature feature] => feature switch
31+
{
32+
Feature.DailyQuestBoard => DailyQuestBoard,
33+
Feature.QuestFishIcon => QuestFishIcon,
34+
Feature.AnglerStatus => AnglerStatus,
35+
Feature.MoonPhase => MoonPhase,
36+
Feature.Sandstorm => Sandstorm,
37+
Feature.TravelingMerchant => TravelingMerchant,
38+
Feature.ServerLog => ServerLog,
39+
_ => true
40+
};
41+
42+
public void Set(Feature feature, bool value)
43+
{
44+
switch (feature)
45+
{
46+
case Feature.DailyQuestBoard: DailyQuestBoard = value; break;
47+
case Feature.QuestFishIcon: QuestFishIcon = value; break;
48+
case Feature.AnglerStatus: AnglerStatus = value; break;
49+
case Feature.MoonPhase: MoonPhase = value; break;
50+
case Feature.Sandstorm: Sandstorm = value; break;
51+
case Feature.TravelingMerchant: TravelingMerchant = value; break;
52+
case Feature.ServerLog: ServerLog = value; break;
53+
}
54+
}
55+
56+
// 拼成 "任务鱼图标=开 月相=关, ...",用于启动日志。
57+
public string Summary() => string.Join(" ", All.Select(f => $"{Label(f)}={(this[f] ? "开" : "关")}"));
58+
59+
private static string Label(Feature feature) => feature switch
60+
{
61+
Feature.DailyQuestBoard => "每日任务播报",
62+
Feature.QuestFishIcon => "任务鱼图标",
63+
Feature.AnglerStatus => "渔夫状态",
64+
Feature.MoonPhase => "月相",
65+
Feature.Sandstorm => "风暴播报",
66+
Feature.TravelingMerchant => "旅商播报",
67+
Feature.ServerLog => "写入服务端日志",
68+
_ => feature.ToString()
69+
};
70+
}
71+
72+
// 占位符与它所属功能的对应关系。
73+
public static class FeatureMap
74+
{
75+
private static readonly Dictionary<string, Feature> Owners = new(StringComparer.OrdinalIgnoreCase)
76+
{
77+
["icon"] = Feature.QuestFishIcon,
78+
["angler"] = Feature.AnglerStatus,
79+
["moon"] = Feature.MoonPhase,
80+
["moon_bonus"] = Feature.MoonPhase
81+
};
82+
83+
private static readonly Regex Placeholder = new(@"\{(\w+)\}", RegexOptions.Compiled);
84+
85+
// 某个占位符所属的功能被关掉时整行不播,避免只剩一个空标签。纯静态行始终保留;
86+
// 混有关闭与开启占位符的行照播,关闭的那部分渲染成空字符串。
87+
public static bool ShouldRender(string? template, FeatureSwitches? features)
88+
{
89+
if (string.IsNullOrEmpty(template))
90+
return false;
91+
if (features is null)
92+
return true;
93+
94+
bool found = false;
95+
foreach (Match match in Placeholder.Matches(template))
96+
{
97+
found = true;
98+
if (!Owners.TryGetValue(match.Groups[1].Value, out Feature owner) || features[owner])
99+
return true;
100+
}
101+
102+
return !found;
103+
}
104+
}

0 commit comments

Comments
 (0)