SScript

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

安装

  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

链接

AI 生成描述 D: