Status Effect Timers

# 夜视效果还要持续多久？

你正在深海中挖矿，靠夜视效果照明。原版只会在角落显示一个小图标——没有计时器，也没有提示——直到周围突然一片漆黑。下界的抗火效果也是如此，尤其是你正站在熔岩湖上方时。

**状态效果计时器**会用清晰的列表取代原版的小图标：每种效果都会显示图标、名称、等级和倒计时。

## 功能

– **清晰的效果列表**——显示图标、名称和等级（“速度 2”“生命恢复 3”），以及剩余时间（“2:45”）。
– **结束前发出警告**——最后 10 秒时计时器变黄，最后 5 秒时变红，同时图标开始闪烁。
– **负面效果优先显示**——有害效果（中毒、凋零、缓慢等）以红色显示在顶部，其余效果按剩余时间排序。
– **整洁的布局**——所有计时器都整齐排列在右侧，并带有低调的深色背景。
– **长时间和无限时长效果**——超长效果会显示小时数（“1:02:30”），无限时长效果则显示“∞”。
– **信标效果**——正常显示，也可以通过设置隐藏。
– **任意角落、任意尺寸**——可选择屏幕角落、与边缘的距离和缩放比例。
– **普通数字**——默认将等级显示为“速度 2”；也可选择罗马数字（“速度 II”）。
– **不重复显示**——显示列表时会隐藏原版的小型效果图标（可关闭此功能）。
– **按 F1 和 F3 时隐藏**——与其他 HUD 元素的行为一致。

无需按键绑定，无需额外设置，也不会与其他模组冲突。

## 设置

首次启动时会创建 `config/statuseffecttimers.properties` 文件。请在游戏关闭时使用文本编辑器修改：

– `enabled` – 开启或关闭列表（默认：true）
– `replaceVanillaIcons` – 隐藏原版的小型效果图标（默认：true）
– `corner` – top_left、top_right、bottom_left 或 bottom_right（默认：top_right）
– `offsetX` / `offsetY` – 与屏幕边缘的距离（默认：4 / 4）
– `scale` – 列表大小，范围为 0.5 – 2.0（默认：1.0）
– `background` – 在列表后显示深色背景框（默认：true）
– `showLevelOne` – 显示“速度 1”而不是“速度”（默认：false）
– `romanLevels` – 显示“速度 II”而不是“速度 2”（默认：false）
– `warnSeconds` – 计时器变黄并且图标闪烁的剩余秒数（默认：10）
– `hideAmbient` – 隐藏信标/潮涌核心效果（默认：false）

## 支持服务器

这是一款**纯客户端模组**。服务器已经会将当前生效的效果及其持续时间发送给你（原版会在物品栏中显示相同的计时信息），所以此模组只是让这些信息更清晰易读。它适用于单人游戏、Realms 和任何多人服务器，无需在服务器端安装任何内容。

## 前置要求

– Minecraft 1.21 / 1.21.1
– Fabric Loader 0.16 或更高版本
– Fabric API
– Java 21

## 安装

1. 为 Minecraft 1.21.1 安装 Fabric Loader。
2. 将 **Fabric API** 和 **Status Effect Timers** 放入 `mods` 文件夹。
3. 启动游戏并喝下一瓶药水。

## 整合包

欢迎将此模组加入任何整合包，无需事先征求许可。

## 同一作者的其他作品

– **死亡地点助手** – 用屏幕上的箭头指引你返回死亡地点
– **物品拾取提醒** – 在屏幕侧边查看拾取的所有物品
– **平滑缩放** – 按住按键进行缩放，滚动鼠标滚轮调整缩放级别
– **物品容器预览** – 在提示框中查看潜影盒内容
– **简洁附魔提示** – 为附魔效果标注颜色，并添加（MAX）标签
– **智能火把放置器** – 按一个键放置火把，还可选择在挖矿时自动照明
– **智能作物收获** – 右键成熟作物即可收获并重新种植
– **浮动伤害指示器** – 在生物上方显示伤害、治疗和暴击数值
– **智能工具保护** – 耐久度警告与工具损坏保护
– **智能箱子整理器** – 为箱子提供排序按钮和快速存入功能
– **动态盔甲 HUD** – 在屏幕上显示盔甲、手持物品和箭矢的耐久度
– **智能自动丢弃** – 快速丢弃或自动扔掉垃圾物品
– **动态物品发光效果** – 为物品添加稀有度颜色和发光效果

## 已知限制

– 游戏标记为隐藏的效果（没有图标）不会显示，与原版行为一致。
– 如果右上角有其他也使用该区域的 HUD 模组，列表可能会与它们并排显示；若发生重叠，可通过 `corner` / `offsetY` 调整位置。
– 某些服务器或插件会提供持续时间极长的“虚假”效果；这些效果只会显示很长的计时器。
– 设置位于配置文件中；目前还没有游戏内设置界面。

## 关于图片

项目徽标是借助 AI 创作的插画，并非游戏截图。图库中的截图均为真实的游戏画面，未经编辑。