试玩笔记

试玩笔记

用/note在游戏内现场记录发现。每行都会在一个Markdown文件中记录时间、玩家、世界、位置和#标签,该文件列出所有已加载的插件及其版本。可直接交给编写测试报告的人。MIT。

实用

测试记录笔记

在游戏里随手记下你发现的问题,无需退出游戏。 输入 /note the bridge texture flickers at dusk #art,一行带时间戳的记录就会写入服务器上的一个 Markdown 文件。该行会记录是谁写的、所在世界、坐标以及所有 #标签。

每个文件开头都有一张已加载插件及其版本的表格。当有人撰写测试报告时,把文件交给他们即可。这张表能回答“我当时运行的是哪些 jar?”。

功能

  • /note <text> 向当天的笔记文件添加一行。系统会识别已知的 #标签(bug、idea、balance、art、perf、ui);你可以更改这个列表。
  • 每行都包含时间、玩家、世界和坐标,格式由你选择。
  • **每个文件顶部都有一张插件表:**服务器构建版本、启动时间,以及已加载插件及其版本。
  • /notes 在聊天中显示最后几行。/notes mark <label> 写入一个 ## 标题,用于将会话分成多个部分。/notes file 打印文件路径。
  • **默认每天每个世界一个文件。**文件为仅追加的 UTF-8,每行立即刷新,因此即使服务器停止也不会丢失内容。支持任意语言的文字。
  • **也可从服务器控制台使用。**控制台笔记没有坐标。
  • **防护措施:**过长的笔记会被拒绝,而不是被截断。在冷却时间内提交的第二条笔记会被拒绝,以防你按了两次回车。
  • **一切皆可配置:**输出文件夹、文件名、行格式、时间格式、UTC、坐标小数位、长度限制、冷却时间、聊天回显、谁可以写笔记、命令名称和标签列表。

笔记文件

每天每个世界生成一个 Markdown 文件。文件以日期、服务器版本和已加载模组表格开头,之后每条笔记一行:时间、玩家、世界、坐标、文本和标签。/notes mark Boss fight 会添加一个标题,通过 Mod Settings Manager 所做的设置更改也会被记录。参见图库中的笔记文件图片。

命令与权限

命令 谁 作用
/note <text> 见 WhoCanNote 向当天的笔记文件添加一行
/notes 任何人 在聊天中显示最后 5 行
/notes <n> 任何人 显示最后 n 行(1 到 20)
/notes mark <label> 见 WhoCanNote 写入一个 ## <label> 标题
/notes file 管理员 打印当前文件的完整路径

**权限:**当 WhoCanNote 为 permission 时,playtestnotes.write 允许玩家写笔记。管理员始终通过。服务器控制台始终可以写入。

设置

设置位于模组数据文件夹中的 notes/settings.json。首次启动会写入最常用的键;你添加的任何其他键也会生效。错误的值会被替换为默认值,并在服务器日志中记录一行。模组在首次创建文件后不会再重写该文件。

键 默认值 作用
Enabled true 开启或关闭 /note
OutputFolder "notes" 文件存放位置:绝对路径,或相对于数据文件夹
FileNameTemplate "{date}_{world}.md" 令牌 {date} {world} {server} {player};必须以 .md 或 .txt 结尾
LineTemplate (较长,见下文) 每行的外观
TimeFormat "HH:mm:ss" HH:mm、HH:mm:ss、h:mm a、h:mm:ss a、ISO-8601 或 epoch-ms
UseUtc false 使用 UTC 而非服务器时区
CoordinatePrecision 0 坐标的小数位数,0 到 3
MaxNoteLength 280 笔记最长长度,20 到 2000 个字符
CooldownSeconds 0.5 同一玩家两条笔记之间的最短时间,0 到 10
IncludeModList true 每个文件以插件表开头
ModListIncludeBuiltIn false 在表格中列出所有内置 Hytale 插件;关闭时只给出一行计数
EchoToChat "self" 谁看到“Noted.”:none、self、operators、everyone
WhoCanNote "everyone" everyone、permission 或 operators
CommandName "note" 命令名称;重启后生效
Tags bug, idea, balance, art, perf, ui # 之后被视为标签的词

默认 LineTemplate:"- {time} **{player}** @ {world} ({x}, {y}, {z}): {text} {tags}"

与 Mod Settings Manager 配合使用

Playtest Notes 不需要 Mod Settings Manager,但如果已安装,每个设置都会出现在其 /modsettings 窗口中,带有标签、分区、范围和下拉菜单。更改会实时生效。只有命令名称需要重启。以这种方式所做的更改也会写入当前的笔记文件。

Mod Settings Manager 页面:CurseForge · Nexus Mods

如果你将输出文件夹设置为服务器无法写入的文件夹,该更改会被拒绝,笔记会继续写入旧文件夹。服务器日志会说明原因。

安装

  1. 将 PlaytestNotes-1.0.0.jar 放入服务器的 mods 文件夹(单人游戏:%APPDATA%\Hytale\UserData\Mods\)。
  2. 启动服务器或打开世界。
  3. 输入 /note it works #idea。

笔记位于 mods\Hledjolf_PlaytestNotes\notes\。在单人游戏中,该路径位于世界的存档文件夹内:%APPDATA%\Hytale\UserData\Saves\<world>\mods\Hledjolf_PlaytestNotes\notes\。

兼容性

  • Hytale 服务器 0.7.3。
  • 适用于专用服务器和单人游戏。
  • 无依赖。Mod Settings Manager 为可选。
  • 此版本不包含:笔记附截图、笔记窗口、上传或同步笔记,以及按玩家分文件。

许可证

MIT,版权所有 (c) 2026 Hledjolf。

源代码和问题追踪器:https://github.com/Hledjolf/PlaytestNotes