HimDSL

插件

· 作者 HimxhMC

轻量高效脚本插件

0 本站下载 0 关注 更新于 3 周前

最新 6.5 · 26.3 · Bukkit / Paper

一键开服(送7天)

HimDSL

HimDSL 是适用于 Minecraft Java 服务器的脚本语言插件。它允许服务器管理员和地图制作者使用简洁、类 Java 的语法编写事件监听器、定时任务、GUI 菜单、数值逻辑和状态机,而 无需编写或编译 Java 插件。

脚本使用 .himdsl 扩展名,存放在 plugins/HimDSL/ 目录下,可通过单个命令执行,或在服务器启动和关闭时自动运行。


为什么选择 HimDSL?

大多数 Minecraft 服务器经常需要一些小型逻辑功能:欢迎新玩家、自动保存数据、构建商店菜单、运行倒计时、检查生命值等。为每一项功能都编写一个 Java 插件显然大材小用。现有的脚本选项要么限制过多,要么过于依赖特定功能,或者与你熟悉的语言相去甚远。

HimDSL 恰好处于中间地带。它提供了 真正的变量、类型化的函数、结构体(structs)、枚举(enums)、Lambda 表达式以及函数重载 —— 这些正是 Java 程序员所熟知的特性 —— 同时内置了 Minecraft 感知工具:

  • 选择器(@p、@a、@r、@s、@e)作为一等表达式。

  • 事件注解,用于挂钩 Bukkit 事件。

  • 调度注解,用于处理重复或延迟任务。

  • GUI 原语,支持点击和关闭回调。

  • PlaceholderAPI 集成,无需任何 Java 代码。

  • 直接 Java 互操作:使用 new <完全限定名>(...) 从其他插件创建对象,调用静态方法,读取静态字段 —— 无需包装器,无需注册。


特性

语言

  • int / double / bool / string / var,支持运行时类型检查
  • 完整的控制流:if / else、for、while、do-while、break、continue、return
  • 支持重载、Lambda 表达式和闭包的强类型函数
  • 结构体(Structs),包含字段和成员方法(实例方法与静态方法)
  • 用户自定义枚举,可直接与字符串进行比较
  • 数组、vector(列表)、set、map、stack、queue
  • 通过 toJson / fromJson 进行 JSON 序列化

Minecraft 集成

  • 带有过滤器的实体选择器(limit、distance、level、name、world、gamemode、type)
  • EntityRef,支持实时字段(p.name、p.health、p.x)和反射方法
  • 占位符($player$、$world$、$server$、$boss$),用于软依赖功能
  • @EventHandler 用于 Bukkit 事件,@BukkitRunnable 用于定时任务
  • runcmd(executor, command) 用于发送命令(玩家或控制台)
  • GUI 系统:创建菜单、分配图标、注册点击和关闭回调

内置函数

  • 数学运算:abs、max、min、sqrt、pow、sin、rand 等
  • BigDecimal:bigAdd、bigSub、bigMul、bigDiv、bigDivExact,用于高精度货币计算
  • 文件 I/O:fopen、fread、fwrite、fclose、freadlines、fwritelines、fexists、fdelete
  • PlaceholderAPI 桥接:papi、papiSet、papiRegister、papiUnregister、papiHas

可靠性

  • 解析错误会指出具体的行号和列号。
  • 运行时错误会记录包含堆栈跟踪的日志,而不会导致服务器崩溃。
  • 可选依赖项(PlaceholderAPI、HimDungeons、WorldEdit)具备优雅降级机制——即使缺少这些插件,脚本仍能正常加载。

示例:欢迎新玩家加入

plugins/HimDSL/onServerLoad.himdsl:

@EventHandler
void onJoin(event(PlayerJoinEvent)) {
    player p = @s;
    runcmd("CONSOLE", "say Welcome " + p.name + " to the server!");
    runcmd(p.name, "title @s title {\"text\":\"Welcome\"}");
}

int main() {
    start("onJoin");
}

示例:定时自动保存

@BukkitRunnable
void autosave() sche = 300s {
    var lines = vector();
    lines.add("saved at tps=" + $server(tps)$);
    fwritelines("last_save.txt", lines);
}

int main() {
    start("autosave");
}

示例:简易商店 GUI

int main() {
    var gui = new GUI(3, "§6Shop");

    var diamond = new GUISlot(Material.DIAMOND);
    diamond.name = "§bDiamond";
    diamond.lore = {"§7Price: §e100", "§aLeft-click to buy"};
    diamond.onLeftClick = () -> {
        player p = @s;
        runcmd("CONSOLE", "eco take " + p.name + " 100");
        runcmd("CONSOLE", "give " + p.name + " diamond 1");
        runcmd(p.name, "msg §aPurchased");
        gui.close(p);
    };
    gui[1][4] = diamond;

    gui.updateAll();
    gui.open(@p);
}

命令与权限

命令 描述 权限
/himdsl compile <path> 仅进行语法检查 himdsl.use
/himdsl run <path> [args] 执行脚本 himdsl.run
/himdsl debug on\|off 切换详细日志输出 himdsl.debug
/himdsl debug codeon\|codeoff 在每次运行前打印脚本内容 himdsl.debug

所有路径均相对于 plugins/HimDSL/ 目录。上述三个权限默认授予 OP(管理员)。


要求

  • 服务器: Bukkit / Spigot / Paper 1.21+(推荐使用 Paper 1.21+)
  • Java: 25 或更高版本(最新版本支持 Java 17+)
  • 可选依赖:
    • PlaceholderAPI — 启用 papi(...) 系列函数
    • HimDungeons — 启用 $boss(...)$ 及地牢相关占位符
    • WorldEdit — 启用部分世界相关占位符

自动运行脚本

将以下文件放入 plugins/HimDSL/ 目录中即可自动运行:

  • onServerLoad.himdsl — 在服务器完成加载后执行
  • onServerShutdown.himdsl — 在插件卸载或服务器关闭时执行

文档

完整文档请参阅 项目 Wiki:

  • 快速入门、语言基础、控制流
  • 函数、Lambda 表达式、函数式接口
  • 数据结构、自定义类型、Java 互操作
  • Minecraft 集成、事件与调度、GUI 系统
  • 内置函数参考、高级主题、常见陷阱
  • 示例脚本(递归、循环、商店 GUI、状态机、小游戏)

面向 Java 开发者

HimDSL 通过 Bukkit 的 ServicesManager 暴露了 HimDSLAPI,以便其他插件能够编译、运行和生成脚本:

HimDSLAPI api = Bukkit.getServicesManager().load(HimDSLAPI.class);
if (api != null) {
    api.run(new File(himdslFolder, "script.himdsl"));
}

在 plugin.yml 中添加 softdepend: [HimDSL]。

你可以在以下地址查看完整文档:


许可证

请参阅 LICENSE 文件。

问题与反馈

欢迎在 Issue Tracker 上提交 Bug 报告和功能请求。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源