概览
NeoHouse 是 Housing Editor 和 HTSL 的独立替代品。
现有的工具(如 Housing Editor)依赖 ChatTriggers 等外部依赖项以及基于网页的工作流。NeoHouse 以代码为核心,完全在游戏内运行——无需访问外部网站。
NeoHouse 的语言比 HTSL 具有更高的抽象程度,但在正确使用的前提下,仍可实现 1:1 的精确表示。
NeoHouse 提供:
- 完全在游戏内的脚本环境
- 自定义设计的编程语言
- 集成式 IDE,支持语法高亮、自动补全和参数提示
- 自包含的工作流
快速开始
要求
- 若使用 Fabric 版本,需要安装 Fabric API
支持版本
- Minecraft 1.21.2 → 1.21.11
- Fabric 和 NeoForge
文档
有关该语言的大部分文档可在游戏内的帮助页面中找到。
注意事项
本项目仍处于积极开发阶段。功能、语法和兼容性可能会在不同版本之间发生变化。
Overview
NeoHouse is a standalone replacement for Housing Editor and HTSL.
Existing tools like Housing Editor rely on external dependencies such as ChatTriggers and web-based workflows. NeoHouse is code-oriented and fully in-game — no external websites required.
NeoHouse's language has a bit more abstraction than HTSL, but still allows for 1:1 representations if used properly.
NeoHouse provides:
- A fully in-game scripting environment
- A custom-designed coding language
- An integrated IDE with syntax highlighting, autocomplete, and argument hints
- A self-contained workflow
Getting Started
Requirements
- Fabric requires if using the fabric version Fabric API
Supported Versions
- Minecraft 1.21.2 → 1.21.11
- Fabric and NeoForge
Documentation
Most of the documentation on the language can be found in the in-game help page.
Notes
This project is still in active development. Features, syntax, and compatibility may change between versions.
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
下载 NeoHouse
可能影响现有脚本的更改
- 变量始终需要一个持有者:声明(
long test;)、赋值(test = 5;)或直接读取裸名test都会报错;应写作p.test、g.test或t[team].test。之前,裸名会被静默地视为p.test。只有函数自身的参数可以不带持有者书写。 - 参数不能与常量或枚举成员同名(例如在
const long x = 1;旁边使用function f(long x))。此前,所有的x都会被静默地解释为常量,而参数则被忽略。 - 两个同名函数、命令或菜单会报错(在 Housing 中,第二个以前会替换第一个)。循环也不能与函数同名,因为在 Housing 中循环被视为函数。
- 针对同一事件的多个区块(例如两个
event onJoin)会报错。此前,第二个会清除第一个(Always Override 模式),或者被跳过(保留内容的模式)。 - 两个同名参数会报错。
- 除以常量零(
/ 0、% 0、/= 0、%= 0)会报错。 - 动作文本超过 256 个字符(
message(...)、标题等)会在编译时报错,而不是在运行时失败。 - 在字符串中,
\"现在表示",\\表示\;此前,反斜杠也会被发送给 Housing。其他反斜杠(如\n)按原样保留,({...})中的物品数据保持不变。
语言特性
- 菜单可以使用带引号的标题,包含空格和符号:
menu "Item Shop"(3) { ... }。 - 当房屋已拥有该定义时,允许调用脚本未定义的函数,或通过
displayMenu打开未定义的菜单。新增设置项用于控制对未知调用的处理(默认 Warn,也可设为 Error 或 Off)。无论设置如何,运行前都会检查这些函数和菜单是否存在。对这类函数的调用不能传递参数。 - 常量和枚举可以在文件的任何位置使用,包括在其声明之前,且常量可以使用后续声明的常量。
- 对字符串使用
+=表示追加:p.s += "x"会将x添加到末尾。此前,它会发送一个 Increment 操作,但这在文本上无效。 ++和--适用于 double 类型(步长为 1.0)。p.d += 1仍然需要写成1.0。- 仅由常量组成的条件(
if (1 == 1)、if (DEBUG))将在编译时决定,并附带警告:运行的分支将取代 if 语句,从而节省一个条件判断及其临时变量。 repeat(0)会发出警告,提示其主体永远不会运行。- 递归行为遵循 Recursion 设置。在默认的 Multi-call 模式下,每次递归调用以前都会因“运行次数超过一次”而失败,因此 Recursion 设置从未生效。
更清晰的错误和警告信息
else if以及嵌套在 if 内部的 if 会说明 Housing 不支持嵌套条件判断,并提供替代方案。- 比较运算符周围的
!(...)以及条件表达式周围的括号会说明 Housing 支持的内容,而不是显示 “Expected ')' after expression”。 - 未设置变量的警告会建议提供正确类型的回退值(
?""、?0.0、?false),而不是始终使用?0。
运行脚本
- 运行时会通过聊天栏显示导入内容,例如 “Importing 3 functions (5 once compiled), 1 loop, 2 menus”。
- 带有小数的数字会完整写出(
0.0001,而非1.0E-4),适用于 Housing 的数字字段和聊天文本。 - 将变量设置为空文本(
p.s = "";)会在 Housing 中输入"",而不是留空字段。 - 在文本中,如果团队名称或回退值包含空格,则会在占位符内加引号(
%var.team/x "red team"%、%var.player/s "a b"%),以便 Housing 保持其完整性。 - 减少临时变量使用:
p.a = p.a << 2(以及其他从变量自身值开始的步骤)将直接在p.a上运行,而不是通过临时变量;文本内的常量数学运算将直接写为其计算后的值。
修复
- 在函数内部文本中使用参数(
message("hi " + who))会读取错误的变量;在函数内部文本中使用的临时变量也存在相同问题。 - 仅为在文本中显示而计算的值(
p.s = p.c + 1 + "!")会被优化掉,导致文本显示未设置的变量。 - 在一个表达式或参数列表中包含两次调用(
add(sq(2), neg(3)))时,第一次调用的结果在被使用前就被第二次调用的结果替换了。 isFishingEnvironment无法使用;它会失败并显示 “Cannot add condition 'Block Type' here”(并且原本会在 Housing 中选择 Block Type)。- 长度达到或超过 47 个字符且需要拆分的函数会失败,并显示 “The function named '..._s$0' is too long”。
编辑器
- 字符串中的
&l、&m、&n和&o分别显示为粗体、删除线、下划线和斜体,效果会叠加,直到遇到颜色代码或&r,行为与 Minecraft 一致。由于 Housing 不格式化菜单标题,其中的&代码会作为纯文本显示。 - 脚本内容(函数、它们编译成的函数数量、循环、命令、菜单、事件)会显示在文件名下方。
- 自动补全不区分大小写:输入
i会建议INVOKER。 - 在字符串内粘贴时,会自动转义粘贴进来的
"和\,因此"some |"加上"text"会变成"some \"text\"". 如果文本本身已包含转义符,则会增加一层转义。 - 修复:在右边缘之外打字、删除或按下 Enter 键时,编辑器未能滚动到光标位置。
设置
- Mod Menu 支持:NeoHouse 的 Mod Menu 配置按钮会打开 NeoHouse 设置界面,按 Escape 或 Back 返回 Mod Menu。Mod Menu 仍为可选功能。
- 选项根据其严格程度着色,在下拉菜单和工具提示中均适用:Off 和 Allow 为绿色,Warn 为黄色,Error 为红色,Fix 为青色。Override 模式从 Never Override(绿色)经过 Override If Empty(黄色)和 Append(青色)到 Always Override(红色)。
音乐
- 音乐编辑器中新增
stop变量字段(例如p.stop)。当设置该变量后,导出歌曲中的每个音符块都会被包裹在if (p.stop?0 != 1) { ... } else { return; }中,因此将变量设为 1 即可切断歌曲播放。「1 = 停止」/「1 = 播放」按钮会翻转判断逻辑,使歌曲仅在变量为 1 时播放。若留空该字段,则按原有方式导出。 - 启用 stop 变量后,导出过程会自动构建受保护的代码块,每个块的完整程度取决于 Housing 的限制;若歌曲长度超过一个函数,编译器会通过辅助函数进行延续,且每个代码块仍受保护。歌曲函数名称会被截断至 Housing 允许的 50 个字符以内。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧