Skip to content

Releases

Version 1.2.0.0

Choose a tag to compare

@CatzTimes CatzTimes released this 02 Oct 15:12

无 Harmony 重写整合正式版(经服务器实测验证)| Consolidated Harmony-free rework, verified on a live server.

中文

原模块:Gamingtoday093/WorkshopDownloadSpinner。本版本为 Catz 的无 Harmony 重写版,经 120 列控制台 + -Lang=Schinese 实机下载 11 个创意工坊物品验证。

特性

  • 不依赖 0Harmony:专用后台线程以只读反射轮询 DedicatedUGC.currentDownload,主线程零占用(慢终端不再拖慢 TPS)
  • 进度条 + 速度 + 预计剩余时间:正在下载 "名称" (ID) / [###### ] 49.7% (字/节) 29.2 MB/s 剩余时间 18s
  • 中文支持:-Lang=Schinese,模块名/描述/进度文案本地化(English.dat / Schinese.dat,描述双语)
  • 日志独立成行:包装 Console.Out,任何游戏日志写入前先收尾进度条行,不再出现 "Saving server" 叠在进度条后面
  • 恒定行宽:渲染行按显示宽度(中文 2 列)填充到缓冲区宽度,杜绝宽标题导致的折行刷屏与 ETA 残留
  • 防卡死:Steam 状态位逐项停止(等价原版 installDownloadedItem 强制停止)+ 10 秒全零停滞保险,修复 Steam 对已完成物品重打更新标志导致的永久卡住
  • 稳健加固:控制台操作全部异常保护(服务/docker/SSH 重定向不报错);修复原版速度估算运算符优先级 bug;Steamworks 缺失导出自动探测禁用;关服时序安全(先停线程再回收)
  • 可选诊断日志:模块目录放 WorkshopDownloadSpinner.diagnostic 空文件即开启详细日志(正式包默认关闭)

安装

解压到服务器 Unturned/Modules/,重启即可。支持 Unturned 3.26.x。

English

Harmony-free rework of Gamingtoday093's module by Catz, verified live (11 workshop items, 120-col console).

  • No 0Harmony dependency — a background thread polls DedicatedUGC.currentDownload via read-only reflection; zero main-thread impact
  • Progress bar + speed + estimated time remaining (localized: ETA 18s / 剩余时间 18s)
  • Chinese output via -Lang=Schinese
  • Console.Out proxy: log lines always start on their own row, never appended behind the bar
  • Constant display-width rows (CJK = 2 cells) — no wrap-flooding, no stale ETA remnants
  • Anti-stuck: per-item stop via Steam state flags + 10s all-zero stall guard
  • Hardening: exception-guarded console ops, monotonic speed estimate (fixes an original operator-precedence bug), graceful degradation on Steamworks API differences, safe shutdown ordering
  • Opt-in diagnostic logging (marker file, off by default)

Installation

Extract into the server's Unturned/Modules/ folder and restart. Requires Unturned 3.26.x.

Credits: original module by Gamingtoday093, rework by CatzTimes.

v1.2.0.1 Diagnostic Build (调试版)

Pre-release

Choose a tag to compare

@CatzTimes CatzTimes released this 02 Oct 15:13

调试版 — 与正式版 v1.2.0.0 功能完全一致,仅附带诊断日志开关文件。Diagnostic build — identical features to v1.2.0.0, ships with the diagnostic log switch enabled.

使用 / How to use

  1. 解压覆盖服务器 Unturned/Modules/WorkshopDownloadSpinnerModule(包内已附带开关文件 WorkshopDownloadSpinner.diagnostic)
  2. 重启服务器,控制台出现 [WDSP] Diagnostic logging enabled: ... 即生效
  3. 复现问题后,把模块目录里的 WorkshopDownloadSpinner-diagnostic.log 发出来

关闭日志 / Disable

删除模块目录里的 WorkshopDownloadSpinner.diagnostic 文件即可(或直接换用正式版 v1.2.0.0)。日志每次服务器启动重建,含:初始化信息、会话开始/结束原因、Steam 状态位跳变、渲染宽度遥测、异常堆栈、关服时序。