SimpleScripting | 使用 JavaScript 轻松制作模组 — 无需 Java，无需编译

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

SimpleScripting — Hytale 服务器的 JavaScript 模组

用 JavaScript 编写服务器模组，无需 Java。

SimpleScripting 让你能用简单的 JavaScript（数百万网站使用的同一种语言）创建强大的服务器端模组。每个模组都在其安全沙箱中运行，因此你可以安装、更新和删除模组，无需担心冲突。

完整文档、指南与教程： wiki.hosttale.com

遇到问题或需要帮助，请加入我们的 Discord： Discord

源代码： HostTale-Project/SimpleScripting

为什么选择 SimpleScripting？


易于学习	用 JavaScript 编写模组 — 无需 Java，无需编译，无需复杂设置。
安全设计	每个模组在独立的隔离环境中运行。一个模组崩溃不会影响其他模组或你的服务器。
热重载	编辑你的模组，在游戏内重载 — 无需重启服务器即可立即看到更改。
开箱即用	即用型 API，涵盖玩家、世界、指令、事件、聊天、界面、经济等。
入门示例	附带 4 个完整可用的示例模组，供你学习和定制。

工作原理

将插件放入服务器的 plugins 文件夹并启动服务器。
模组位于 mods/SimpleScripting/mods-js/ — 每个模组是一个包含 mod.json 配置文件和 main.js 脚本的文件夹。
插件自动加载、验证并在各自沙箱中运行每个模组。
编辑文件并在游戏内重载 — 无需重启服务器。

详细设置说明和模组创建指南，请访问 官方 wiki。

你可以构建什么？

几乎所有在服务器端运行的内容：

自定义指令（/home、/warp、/stats、/shop 等）
玩家加入/离开消息和欢迎礼包
挂机检测和空闲玩家管理
包含商店和交易的经济系统
数据统计追踪与排行榜
传送与家系统
定时事件与计划任务
跨模组 API，让你的模组协同工作
……还有更多！

指令

插件指令

指令	描述
`/createmod <mod-id>`	创建一个新的模组文件夹，包含所有入门文件
`/updatetypes <mod-id>`	更新类型定义以支持编辑器自动补全

示例模组指令

附带的示例模组（启用后）会添加以下指令：

指令	所属模组	描述
`/playtime`	欢迎奖励	查看你的总游戏时长
`/online`	欢迎奖励	查看当前在线玩家
`/sethome`	家与传送点	将当前位置保存为家
`/home`	家与传送点	传送回已保存的家
`/warp`	家与传送点	传送到服务器传送点
`/afk`	挂机管理器	切换你的挂机状态
`/afklist`	挂机管理器	查看当前空闲的玩家
`/stats`	简单统计	查看你的玩家统计数据
`/top`	简单统计	查看服务器范围的排行榜

附带的示例模组

SimpleScripting 首次运行时附带 4 个完整的示例模组 — 默认处于禁用状态，让你自行选择激活哪些模组。要启用某个模组，请打开其 mod.json 并将 "enabled": true 设置为 true。

欢迎奖励

一个完整的欢迎系统：为新玩家提供入门礼包、加入/离开广播消息以及游戏时长追踪。

家与传送点

完整的传送系统，包含个人玩家家和服务器范围的传送点。

挂机管理器

自动检测空闲玩家，具有可配置的超时时间。玩家也可以手动切换挂机状态。

简单统计

追踪玩家统计数据，并通过排行榜和排名进行展示。

模组作者可以做什么

SimpleScripting 为模组作者提供了丰富的功能集 — 无需导入 Java 包：

功能	作用
指令	注册带有描述和权限的自定义指令
事件	响应玩家动作、聊天消息、方块破坏、服务器启动等
玩家	查找玩家、发送消息、踢出、检查在线状态
世界	列出世界、查找世界中的玩家、广播消息
计划任务	运行延时或循环任务
界面	构建带颜色和样式的聊天消息
经济	管理玩家余额、存款和取款（需要经济插件）
日志	向服务器控制台输出信息、警告和错误
模块	将你的模组分隔成多个文件，便于组织
共享服务	公开 API 供其他模组使用，实现跨模组协作

扩展支持

其他 Hytale 插件可以通过添加自定义 API、类型定义和示例模组来扩展 SimpleScripting，实现无缝集成。例如，EconomySS 扩展提供了一整套经济 API，并附带一个玩家商店示例。

核心功能一览

每个模组独立沙箱 — 模组之间互不干扰
自动清理 — 禁用模组会注销其所有指令、事件和任务
依赖顺序 — 声明哪些模组必须先加载
实时重载 — 无需重启服务器即可更新模组
编辑器支持 — TypeScript 定义提供自动补全和内联文档
可操作错误信息 — 清晰的提示告诉你问题所在及如何修复

系统要求

Hytale 专用服务器
无需额外依赖（经济功能需要经济插件，如 VaultUnlocked 或 EliteEssentials）

文档与指南 · 为 Hytale 模组社区精心打造。