
SScript
为Minecraft服务器添加类似Python/Lua脚本语言的Fabric模组。使用事件、内置函数、HTTP请求和文件I/O编写游戏逻辑——无需Java。
查看大图SScript — Minecraft 服务器脚本语言
SScript 是一种用于 Minecraft 服务器自动化的轻量级编程语言。使用类似 Python/Lua 的语法编写脚本,以执行命令、自动化任务并控制服务器行为,无需接触 Java 代码。
功能概述
核心用途: 在 Minecraft 服务器上执行自动化命令和逻辑。
- 🎯 命令执行 — 以编程方式运行命令(
/say、/give、/setblock等) - ⚙️ 任务自动化 — 运行初始化脚本、定时任务、批量操作
- 🔧 服务器逻辑 — 响应玩家行为(加入/离开、聊天、破坏方块、死亡、睡眠)
- 📝 简单语法 — 任何人都能学会的类 Python 语言
- ⚡ 非阻塞 — 任务运行不会冻结服务器
快速开始
1. 创建脚本 于 sscripts/boom.ss:
log "BOOM SPAWN!"
func boom():
run "fill 10 50 10 -10 90 -10 air destroy"
# boom! >:3
end
boom()
2. 创建事件处理器 于 sscripts/handlers.event.ss:
on player_join(player):
run "say " + player.name + " joined"
run "execute at " + player.name + " run fill ~10 50 ~10 ~-10 90 ~-10 air"
end
on player_chat(player, message):
log player.name + ": " + message
end
3. 加载并运行:
/sscript run boom.ss
/sscript debug on
/sscript debug off - no spam [Server]: ...
完成!脚本无需重启即可执行。
语言特性
- 变量与类型: 字符串、数字、布尔值、列表、对象
- 控制流:
if/elif/else、for、while、try/catch - 函数: 使用
func或def定义,同步或异步调用 - 事件: 响应玩家行为、服务器事件
- 内置函数: 60+ 个用于玩家、方块、数学、字符串、文件的函数
- 异步支持: 使用
wait关键字的后台任务
命令
执行脚本并控制执行:
/sscript run <file> # 执行脚本
/sscript run <file> function <name> # 调用特定函数
/sscript monitor [all|<id>| ] # 查看运行中的任务
/sscript stop [all|<id>|<file>] # 停止运行中的任务
/sscript reload [all|<id>|<file>] # 重启任务
/sscript debug [on|off] # 切换调试输出服务器
文档
📖 包含示例和 API 参考的完整文档:
其他功能
除了命令执行,SScript 还可以:
- 📊 存储数据 — 全局变量在重启后持久化(
globals.json) - 📡 HTTP 请求 — 从 API 获取数据或发送 webhook
- 💾 文件 I/O — 读写文件和 JSON
- 🎮 玩家数据 — 访问生命值、游戏模式、坐标、NBT 数据
- 🏷️ 标签系统 — 使用自定义标签组织玩家
- 🔍 选择器 — 动态查询玩家(
@a[tag=admin]、@a[distance=..100])
性能
- ⚡ Tick 安全 — 任务自动分散到服务器 tick 中以防止卡顿
- 🔄 非阻塞 — 事件处理器异步运行(不会冻结游戏)
- 💪 限制 — 最多 500 个进程,每 tick 生成 20 个,每 tick 执行 50 条语句
要求
- Java 21+
- Fabric Loader 0.14+
- Minecraft 1.21.11
安装
- 下载模组 JAR
- 放入
mods/文件夹 - 启动服务器
- 将脚本放入
sscripts/
示例:聊天记录器
# sscripts/chat_logger.event.ss
func log_chat(player_name, message):
file_mkdirs("sscripts/logs")
line = "[" + player_name + "] " + message
file_append("sscripts/logs/chat.log", line + "\n")
end
on player_chat(player, message):
log_chat(player.name, message)
end
链接
AI 生成描述 D:
正在加载版本记录…

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