Repository navigation
Releases
Version 1.2.0.0
无 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.currentDownloadvia 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 (调试版)
调试版 — 与正式版 v1.2.0.0 功能完全一致,仅附带诊断日志开关文件。Diagnostic build — identical features to v1.2.0.0, ships with the diagnostic log switch enabled.
使用 / How to use
- 解压覆盖服务器
Unturned/Modules/WorkshopDownloadSpinnerModule(包内已附带开关文件WorkshopDownloadSpinner.diagnostic) - 重启服务器,控制台出现
[WDSP] Diagnostic logging enabled: ...即生效 - 复现问题后,把模块目录里的
WorkshopDownloadSpinner-diagnostic.log发出来
关闭日志 / Disable
删除模块目录里的 WorkshopDownloadSpinner.diagnostic 文件即可(或直接换用正式版 v1.2.0.0)。日志每次服务器启动重建,含:初始化信息、会话开始/结束原因、Steam 状态位跳变、渲染宽度遥测、异常堆栈、关服时序。