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
链接
你是这个资源的作者?登录后可认领此资源。
相似资源
探险者指南针Explorer's Compass
Chaosyr
让你能够在世界中的任何位置定位结构。
冒险装备
95
Save and Load Inventories
Serilum
? 使用命令保存和加载玩家或他人的背包/套装。
管理实用
87
Hodgepodge
mitchej123
一堆修复
玩法机制优化
78
另一个配置库 (YACL)
isxander
一个基于构建器的 Minecraft 配置库!
前置管理
66
群峦传说TerraFirmaCraft
eerussianguy
TerraFirmaCraft (TFC) 是一个全面转换模组,对生存模式进行了彻底的改造与重新设计。
冒险玩法机制
61
神化Apotheosis
Shadows-of-Fire
所有本应存在的事物
冒险装备
58
评论 0
登录后参与评分
还没有评论,来抢沙发吧