
试玩笔记
用/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
如果你将输出文件夹设置为服务器无法写入的文件夹,该更改会被拒绝,笔记会继续写入旧文件夹。服务器日志会说明原因。
安装
- 将
PlaytestNotes-1.0.0.jar放入服务器的mods文件夹(单人游戏:%APPDATA%\Hytale\UserData\Mods\)。 - 启动服务器或打开世界。
- 输入
/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。
正在加载版本记录…


正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。