LuScript

插件

· 作者 Kyouki

Paper 的 Lua 基础脚本引擎

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

最新 0.03 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

LuScript

LuScript 是一个高性能脚本引擎,旨在将 Lua 的轻量级灵活性引入 Spigot 和 Paper 服务器。作为 Skript 等传统脚本引擎的强大替代方案,它摒弃了复杂的语言解析,转而采用标准的编程范式。

LuScript 允许开发者使用简洁高效的 Lua 语法编写服务器逻辑,同时保持对强大服务端功能的直接访问权限,如原生权限管理、动态命令注册以及跨脚本通信。


工作原理

LuScript 将安全的 Lua VM(虚拟机)直接嵌入到您的 Minecraft 服务器中。它将 Bukkit 的内部系统——命令、事件和任务——映射为简单的 Lua 函数。当您保存脚本并运行 /luscript reload [script.lua] 时,引擎会立即卸载旧逻辑,清除已注册的监听器,移除动态创建的命令,并注入新代码,整个过程无需重启服务器、玩家重新登录或重置其他正在运行的脚本。


功能特性

1. 细粒度的单脚本重载

支持即时卸载和重载特定脚本。运行 /luscript reload <filename.lua> 可以有针对性地销毁并重建仅属于该特定脚本的事件监听器、自定义命令和全局信号,而不会影响所有其他活跃的服务器脚本。

2. 智能且美观的开发者诊断

当脚本出错时,不再需要解析杂乱无章、如同“文字墙”般的 Java 堆栈跟踪转储信息。LuScript 动态捕获加载时的语法错误和运行时执行异常:

  • 高亮代码片段:在聊天或控制台中打印彩色的 3 行内联代码块,直接显示问题发生的确切行号。
  • 可读的错误日志:自动剥离原始的内部 VM 跟踪信息,为开发者提供易于理解、以开发者为中心的反馈。
  • 运行时错误捕获:捕获动态命令执行或事件监听器失败的情况,并将详细信息直接路由到游戏内授权开发者的聊天频道。

3. 面向对象的坐标包装器

LuScript 自动将 Bukkit 的坐标封装为智能的 Lua 表。这些表完全支持在 Lua 中直接使用流畅、可链式调用的方法语法:

  • loc.getDirection():返回一个包含 .getX()、.getY() 和 .getZ() 辅助获取器的方向向量表。
  • loc.clone():返回位置表的独立精确副本。
  • loc.add(dx, dy, dz):动态偏移坐标参数并返回修改后的位置表。
  • 智能调用约定:完全支持点号 (loc.add(x, y, z)) 和冒号 (loc:add(x, y, z)) 两种调用约定。

4. 世界检查与方块碰撞 API

使用 GetBlock(location) 在世界中的任何位置读取方块状态。轻松检查方块属性,例如判断方块是否为实体、是否为空气,或获取其材质类型。非常适合编写防碰撞传送机制、自定义破坏事件或交互限制。


代码示例

高级命令与 Tab 补全

注册具有动态 Tab 补全和原生权限的复杂命令,无需编辑任何 plugin.yml 文件。

RegisterCommand("heal", {
    permission = "luscript.command.heal",
    usage = "/heal [player]",
    tabComplete = function(sender, args)
        if #args == 1 then
            return {"@a", "@p", sender.getName()}
        end
    end,
    execute = function(sender, args)
        local target = sender
        if #args > 0 then
            target = GetPlayer(args[1])
        end

        if target then
            target.setHealth(20)
            sender.sendMessage("&aHealed " .. target.getName())
        else
            sender.sendMessage("&cPlayer not found.")
        end
    end
})

模块化跨脚本信号

允许多个脚本通过全局信号总线进行通信。非常适合解耦的多文件系统。

-- Script A
RegisterCommand("alert", {
    execute = function(sender, args)
        EmitSignal("AdminAlert", { user = sender.getName(), msg = args[1] })
    end
})

-- Script B
OnSignal("AdminAlert", function(data)
    print("ALERT: " .. data.user .. " sent: " .. (data.msg or "nothing"))
end)

自定义物品与安全传送

结合自定义物品引擎和方块检查 API,创建一把剑,只有当玩家不会落入实心方块内部时,才能将其向前传送。

RegisterCommand("godsword", {
    execute = function(sender, args)
        local item = CreateItem("diamond_sword", 1)
        item.setName("&6&lGod Sword")
        item.setLore({
            "&7A sword with ancient powers.",
            "&eRight-click to teleport forward!"
        })
        item.addEnchant("sharpness", 10)
        item.addEnchant("fire_aspect", 2)
        
        sender.giveItem(item)
        sender.sendMessage("&eYou received the &6&lGod Sword&e!")
    end
})

RegisterEvent("player_interact", function(event)
    local player = event.player
    local item = event.item
    local action = event.action

    if item and item.getType() == "diamond_sword" then
        if action == "right_click_air" or action == "right_click_block" then
            player.sendMessage("&bSwoosh! Teleporting...")
            
            local loc = player.getLocation()
            local dir = loc.getDirection()
            
            -- Calculate landing coordinates
            local targetLocation = loc.clone().add(dir.getX() * 10, dir.getY() * 10, dir.getZ() * 10)
            
            -- Check if path is clear (feet & head space)
            local blockFeet = GetBlock(targetLocation)
            local blockHead = GetBlock(targetLocation.clone().add(0, 1, 0))
            
            if blockFeet.isSolid or blockHead.isSolid then
                player.sendMessage("&cTeleport path is blocked by solid blocks!")
            else
                player.teleport(targetLocation)
            end
        end
    end
end)

为什么选择 LuScript?

  • 零重新加载延迟:通过 /luscript reload <filename.lua> 即时更新脚本,无需中断玩家或重置其他活动脚本。
  • 易读的脚本诊断信息:在聊天窗口或控制台中直接显示带颜色编码的 3 行内联代码错误预览,隐藏丑陋的 Java 堆栈跟踪细节。
  • 纯 Lua 语法:利用标准、简洁的编程范式——无需臃肿的自定义语言语法或类似英语的解析逻辑。
  • 原生性能:运行于轻量级沙盒化 Lua VM 之上,提供直接的 Bukkit 映射,开销几乎为零。
  • 安全沙箱:配置为限制危险的文件/系统调用(io、os、luajava),确保生产环境的绝对安全性。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源