DS时钟

描述
⠀
DS Clock 是一个简单的时钟模组，可在屏幕上显示游戏内时间。
时间显示格式为 24小时制（HH:MM），其图标会根据当前时间在白天和夜晚之间变化。
⠀
在《龙剑》中， 游戏内1分钟约等于现实1秒因此，游戏内1小时约等于现实60秒，一整天约等于24分钟。
该 太阳图标从06:00开始使用，以及 月亮图标从18:00开始使用.
这些时间并非基于游戏官方的昼夜状态，只是我为时钟显示选择的时间。

你可以手动更改游戏内的时间。
打开 config.ini 在模组文件夹中并设置 启用=1 在……之下 [调试模式] 使用此功能。
此选项最初是为调试和测试而添加的。

时间控制键也可以在以下位置更改： config.ini。
默认按键为：

• 1小时前： 小键盘 1
• 向前1小时： 小键盘 2
• 恢复时间： 数字键盘 3
  

时间只能更改为整点。更改时间后，游戏时间将暂停。
要让时间恢复正常流动，请按恢复时间键。

手动更改时间导致的任何游戏问题，我概不负责。不过，我自己在模组测试期间使用此功能时并未发现任何问题。

⠀
功能
⠀

• 以24小时制显示游戏内时间
• 根据当前时间显示太阳/月亮图标
• 更改时间文本的位置、大小、颜色、阴影和不透明度
• 更改时钟位置和整体大小
• 更改背景图像和不透明度
• 更改太阳/月亮图像、位置和大小
• 更改日出/日落切换时间
• 设置快捷键以显示/隐藏时钟
• 设置一个重新加载配置的热键
• 设置一个切换时间的快捷键（当前为 Num1、Num2、Num3）
• 使用基于4K的UI坐标，并在QHD/FHD下自动缩放
  

⠀
笔记
⠀
v0.1.0是首个版本，主要专注于让所需功能在现有游戏UI结构下正常运行。
该模组允许你替换背景以及太阳/月亮图标，但 如果你使用自己的图片，可能需要根据图片的大小和形状手动调整位置、尺寸和偏移量。
除内置默认图像外，我不为自定义图像提供单独的预设或个别设置支持。
背景使用了九宫格切片设置，因此如果你使用不同种类的背景图片，可能需要编辑以下位置的图像定义： ui_images.lua.
⠀
⠀
需求
⠀

• 龙剑：觉醒
• 仅限UE4SS实验性构建
  

DS Clock v0.1.0 的开发与测试环境为 UE4SS 实验版-最新 (SHA: d7e7826d).
不支持 UE4SS 稳定版 v3.0.1。
部分 UI 元素在 Stable v3.0.1 上无法正确显示，请使用 Experimental 版本。
⠀
⠀
安装
⠀

• 安装 UE4SS 实验性最新版.
• 下载DS Clock并解压压缩包。
• 复制提取的 时钟 文件夹放入 模组 你当前UE4SS安装所使用的文件夹。
• 开始游戏。
  

实验版本的示例路径：

龙剑觉醒/
└─ DS/
   └─ 二进制文件/
      └─ Win64/
         └─ ue4ss/
            └─ 模组/
               └─ DSClock/

⠀
⠀
文件夹结构
⠀

DSClock/
├─ enabled.txt
├─ VERSION.txt
├─ config.ini
├─ 脚本/
│ ├─ main.lua
│ ├─ ui_box.lua
│ └─ ui_images.lua
└─ 图片/
   ├─ clock_button.png
   ├─ sun_wide.png
   └─ moon_wide.png

⠀

• config.ini ：时钟位置、大小、颜色、图标等设置。
• 脚本/主程序.lua DS Clock 主代码。
• 脚本/ui_box.lua ：处理九宫格背景界面。
• 脚本/ui_images.lua ：定义背景图像尺寸和切片值的图像数据文件。
• 图片/ 包含时钟使用的背景及太阳/月亮图像。
  

⠀
⠀
配置
⠀
config.ini 时钟
⠀

• 已启用 ：开启或关闭该模组。 1 = 已启用， 0 = 已禁用
• 更新间隔毫秒 ：时间显示更新频率，以毫秒（ms）为单位。默认 1000 每秒检查一次游戏时间。
• 调试日志 ：开启或关闭详细的 DS Clock 日志记录。你可以在检查问题时使用此功能。 0 = 已禁用， 1 = 已启用
  

⠀
config.ini - 布局
⠀

[布局]
引用宽度=3840
ReferenceHeight=2160
缩放模式=高度

DS Clock 使用 3840×2160 (4K) 作为其参考分辨率，并自动缩放到当前屏幕分辨率。
所以在QHD或FHD下，你通常不需要重新计算 宽度, 高度，或每种分辨率的位置值。
⠀

• 右 / 上 设置时钟位置。位置基于 钟面盒中心，所以改变 宽度 以同一中心向两侧扩展该框。
• 宽度／高度 设置时钟背景框的整体大小。
• 字体大小 ：设置时间文本的大小。
• 文本偏移X / 文本偏移Y 调整背景框内时间文本的位置。
  

⠀
config.ini - 背景
⠀

• 盒子 要使用的已注册背景图像名称。其数据定义于 脚本/界面图片.lua.
• 不透明度 设置背景不透明度。
  

⠀
config.ini - 风格
⠀

• 文本颜色 : 设置时间文本颜色。请使用颜色代码，格式为 #RRGGBB 格式。
• 文本不透明度 设置时间文本的不透明度。
  

⠀
config.ini - 图标
⠀

• 已启用 : 1 = 显示时间图标， 0 = 隐藏图标
• 日像/月像 要使用的白天/夜晚图像文件。图像文件必须位于 DSClock/图像/ 文件夹。
• DayStartHour / NightStartHour ：设置太阳/月亮图标变化的时间。这只是DS时钟使用的显示规则，并非游戏官方的昼夜状态。
• 偏移X / 偏移Y : 调整图标在背景框内的位置。
• 宽度 / 高度 设置图标显示大小。
• 文本移位 ：当显示图标时，调整时间文本的水平位置。
  

⠀
config.ini - 快捷键
⠀
热键修饰键已固定为 Ctrl你只需要设置按键。

切换键=F8
重新装填键=F9

⠀
使用这些设置：

Ctrl + F8 → 显示/隐藏DS时钟
Ctrl + F9 → 重新加载 config.ini

⠀
如果你不想使用热键，请将其设置为：

NONE

两个热键在默认发布配置中均被禁用。
⠀
⠀
卸载
⠀

• 关闭游戏。
• 删除 时钟 来自UE4SS的文件夹 模组 文件夹。
  

⠀
⠀
故障排除
⠀
时钟未显示
⠀
首先，请确保你正在使用 UE4SS 实验性版本.
DS Clock v0.1.0 不支持 UE4SS 稳定版 v3.0.1。

同时检查安装路径：

DS/Binaries/Win64/ue4ss/Mods/DSClock/

该文件夹应包含 config.ini, 已启用.txt, 脚本，以及 图片.
⠀
⠀
背景或图标未显示
⠀
请检查以下路径中的图像文件： 图片 文件夹未被删除或重命名。

默认配置使用以下文件：

时钟按钮.png
sun_wide.png
moon_wide.png

⠀
⠀
我改了配置，但什么都没变
⠀
如果 重新装填键 已设置后，你可以使用该快捷键重新加载配置。

默认值为：

ReloadKey=NONE

因此，使用默认发布配置时，请重启游戏以应用更改。
部分启动时注册的设置可能仍需重启生效。
⠀
⠀
问题仍然存在
⠀
在 config.ini，设置：

调试日志=1

然后复现该问题并检查 [DS时钟] UE4SS 日志中的条目。
⠀
⠀
特别鸣谢
⠀

• UE4SS-RE
  

⠀
⠀
⠀⠀
⠀
⠀
⠀
说明
⠀
这是一个在屏幕上显示游戏内时间的简单时钟模组。
时间 24小时制(HH:MM) 以表示，并根据当前时间段同时显示区分白天和夜晚的图标。
⠀
龙剑的游戏时间为 游戏内1分钟约为现实时间1秒以的速度进行。因此，游戏内1小时约为现实60秒，一天约为24分钟。
在默认设置中 06:00开始太阳图标, 从18:00开始月亮图标转换为。此时间划分并非采用游戏中官方定义的昼/夜判定，而是为显示时钟而任意设定的标准。

可以强制更改游戏时间。
模组文件夹内 config.ini打开 [调试模式]의 启用=1 更改为后方可使用。这是原本为调试用途开发的选项。

时间变更是 config.ini 可以在此处另行设置。
当前默认设置如下。

• 向后推进1小时： 小键盘 1
• 提前1小时进行： 小键盘 2
• 时间播放： 数字键盘 3
  

时间仅按整点变更，变更后便会停止。
要让时间再次流动，需要再次按下时间播放键。

因更改时间导致的游戏错误概不负责。不过在自行进行模组测试期间，并未发现其他错误。
⠀
⠀
功能
⠀

• 以24小时制显示游戏内时间
• 根据当前时间段显示 Sun / Moon 图标
• 可调整时间文本的位置、大小、颜色和不透明度
• 时钟位置和整体大小可调整
• 可更改背景图片并调整不透明度
• 太阳/月亮图像可更改及位置·大小可调整
• 可设置昼夜图标切换时间
• 可设置时钟显示/隐藏快捷键
• 可设置重新加载设置的快捷键
• 可设置时间变更快捷键（当前指定为 Num1、Num2、Num3）
• 使用4K基准UI坐标，在QHD/FHD下也会自动缩放
  

⠀
注意事项
⠀
v0.1.0 是首个针对当前游戏 UI 结构优先实现必要功能的版本。
背景图片或Sun/Moon图标已预留结构，可替换为其他图片，但 如果用户自行更换图片，可能需要根据图片尺寸和形状手动调整位置、大小、偏移等。
除默认提供的图片外，不提供针对自定义图片的单独预设或个性化设置支持。
特别是背景图像采用9-slice方式处理，因此使用其他形式的图像时 ui_images.lua可能需要直接修改的图像定义。
⠀
⠀
需求
⠀

• 龙剑：觉醒
• 仅限UE4SS实验性版本
  

DS Clock v0.1.0 是 UE4SS 实验版-最新版（SHA：d7e7826d） 已在环境中进行开发和测试。
不支持 UE4SS Stable v3.0.1。
在Stable v3.0.1版本中已确认部分UI元素无法正常显示的问题，请使用Experimental版本。
⠀
⠀
安装
⠀

• UE4SS 实验性-最新 正在安装版本。
• 解压DS Clock压缩文件。
• 解压后得到的 时钟 当前已安装的UE4SS的文件夹 模组 复制到文件夹。
• 正在启动游戏。
  

实验版本基准安装路径示例:

龙剑觉醒/
└─ DS/
   └─ 二进制文件/
      └─ Win64/
         └─ ue4ss/
            └─ 模组/
               └─ DSClock/

⠀
⠀
文件夹结构
⠀

DSClock/
├─ enabled.txt
├─ VERSION.txt
├─ 配置文件.ini
├─ 脚本/
│ ├─ main.lua
│ ├─ ui_box.lua
│ └─ ui_images.lua
└─ 图片/
   ├─ clock_button.png
   ├─ sun_wide.png
   └─ moon_wide.png

⠀

• config.ini ：这是用于设置模组位置、大小、颜色、图标等的配置文件。
• 脚本/main.lua 这是DS Clock的主执行代码。
• Scripts/ui_box.lua 处理背景 UI 的 9-slice 显示。
• 脚本/ui_images.lua ：这是定义背景图片尺寸和切片信息的图像数据文件。
• images/ 包含用于时钟的背景及太阳/月亮图像。
  

⠀
⠀
配置
⠀
config.ini 时钟
⠀

• 已启用 ：是否为模组激活状态。 1 = 激活， 0 = 已禁用
• 更新间隔毫秒 时间显示更新周期。单位为毫秒(ms)。默认值 1000大约每1秒确认一次游戏时间。
• 调试日志 : 是否输出 DS Clock 的详细日志。出现问题时可用于确认原因。 0 = 停用， 1 = 激活
  

⠀
config.ini - 布局
⠀

[布局]
ReferenceWidth=3840
ReferenceHeight=2160
缩放模式=高度

DS时钟默认情况下 3840×2160（4K） 将其用作基准分辨率，并根据实际屏幕分辨率自动缩放。
因此在QHD或FHD下也通常 宽度, 高度，位置值无需按分辨率重新计算。
⠀

• 右 / 上 ：调整时钟的位置。将时钟盒的 以中心点为基准计算位置因此 宽度即使更改，盒子也会以中心为基准向左右扩展。
• 宽度 / 高度 ：时钟背景框的整体大小。
• 字号 ：时间文本的字号。
• 文本偏移X / 文本偏移Y : 在背景框内部微调时间文本的位置。
  

⠀
config.ini - 背景
⠀

• 盒子 ：要使用的背景图像定义名称。注册信息为 脚本/ui_images.lua定义于。
• 不透明度 调整背景的不透明度。
  

⠀
config.ini - 样式
⠀

• 文本颜色 : 这是时间文本的颜色。 #RRGGBB 可以使用形式的颜色代码。
• 文本不透明度 时间文本的不透明度。
  

⠀
config.ini - 图标
⠀

• 已启用 : 1 = 时间图标显示， 0 = 图标隐藏
• 日像 / 月像 ：要使用的白天/夜晚图像文件。图像文件是 DSClock/images/ 必须位于文件夹中。
• 白天开始时间 / 夜晚开始时间 ：这是太阳/月亮图标切换的时间。这不是游戏内正式的昼夜判定，而是DS Clock使用的显示标准。
• 偏移X / 偏移Y 调整背景框内图标的位置。
• 宽度 / 高度 设置图标的显示大小。
• 文本偏移 ：显示图标时用于校正时间文本横向位置的数值。
  

⠀
配置.ini - 快捷键
⠀
快捷键的修饰键是 Ctrl固定并且仅指定实际要使用的键。

切换键=F8
重新装填键=F9

⠀
按上述设置后：

Ctrl + F8 → 显示/隐藏DS时钟
Ctrl + F9 → 重新加载 config.ini

⠀
若不想使用快捷键：

无

设置为。
在默认部署设置中，两个快捷键均处于禁用状态。
⠀
⠀
卸载
⠀

• 正在退出游戏。
• UE4SS的 模组 从文件夹中 DSClock 删除文件夹。
  

⠀
⠀
故障排除
⠀
时钟未显示
⠀
UE4SS 实验版本请先确认是否正在使用。
DS Clock v0.1.0不支持UE4SS Stable v3.0.1。
请确认安装路径。

DS/Binaries/Win64/ue4ss/Mods/DSClock/

该文件夹内 config.ini, 启用, 脚本, 图像必须有。
⠀
⠀
背景或图标不显示
⠀
图像 请检查文件夹中的图像文件是否已被删除或重命名。
默认设置下将使用以下文件。

clock_button.png
sun_wide.png
moon_wide.png

⠀
⠀
我更改了设置，但没有生效。
⠀
重新装填键如果已设置，可以通过该快捷键重新加载设置。

默认值：

重载键=无

因此，在默认部署状态下，请重新启动游戏。
部分启动时注册的设置可能需要重新运行。
⠀
⠀
问题不断发生
⠀
config.ini来自：

调试日志=1

设置为该状态后重新复现问题，然后在UE4SS文件夹中生成的日志里 [DS时钟] 请确认项目。
⠀
⠀
特别鸣谢
⠀

• UE4SS-RE