SScript

模组

· 作者 UserLog

Fabric 模组,为你的 Minecraft 服务器添加类 Python/Lua 的脚本语言。使用事件、内置函数、HTTP 请求和文件 I/O 编写游戏逻辑——无需 Java。

0 本站下载 0 关注 更新于 6 个月前

最新 1.1.1 · 1.21.11 · Fabric

一键开服(送7天)

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

安装

  1. 下载模组 JAR 包
  2. 放入 mods/ 文件夹
  3. 启动服务器
  4. 将脚本放置在 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

链接

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源