⚡ LuaMine ⚡
适用于 Minecraft (1.21+) 的轻量级 Lua 脚本引擎
简介
LuaMine 是一款高性能的 Bukkit/Spigot 插件,它将轻量级 Lua 运行时(luaj)直接嵌入到你的 Minecraft 服务器中。
告别冗长的 Java 编译周期或复杂的配置文件。编写简洁、响应式的 Lua 脚本来处理事件、操作玩家、调度任务以及构建自定义机制——只需几秒钟,并支持热重载系统。
✨ 特性
- 热重载: 编辑你的脚本并通过
/minelua reload即时重新加载,无需重启服务器! - 模块化且清晰的 API: 内置结构化的模块,涵盖通用工具、聊天、玩家、视觉效果和任务调度。
- ⚡ 事件驱动: 轻松挂钩到原生的 Minecraft 事件,如玩家加入、聊天消息、方块破坏、交互和战斗。
- 零依赖: 自包含所有运行 Lua 所需的组件,确保在 JVM 上流畅运行。
- 开发者友好: 使用熟悉的语法编写自定义逻辑、自定义冲刺、小游戏或服务器实用工具。
⚡ LuaMine ⚡
Lightweight Lua Scripting Engine for Minecraft (1.21+)
About
LuaMine is a high-performance Bukkit/Spigot plugin that embeds a lightweight Lua runtime (luaj) directly into your Minecraft server.
Say goodbye to heavy Java compilation cycles or complex configuration files. Write clean, reactive Lua scripts to handle events, manipulate players, schedule tasks, and build custom mechanics in seconds — all with a hot-reload system.
✨ Features
- Hot Reload: Edit your scripts and reload them instantly on the fly using
/minelua reload. No server restart required! - Modular & Clean API: Built-in organized modules for general utilities, chat, players, visual effects, and scheduling.
- ⚡ Event-Driven: Easily hook into native Minecraft events like player joins, chat messages, block breaks, interactions, and combat.
- Zero Dependencies: Comes self-contained with everything needed to run Lua smoothly on the JVM.
- Developer Friendly: Write custom logic, custom dashes, mini-games, or server utilities using familiar syntax.
下载 LuaMine
下载 LuaMine
下载 LuaMine
下载 LuaMine
下载 LuaMine
下载 LuaMine
LuaMine 1.3
一次重大的稳定性与功能更新。LuaMine 经历了多个强化周期的测试(包括内存泄漏修复、线程安全改进、脚本看门狗机制),并新增了大量脚本功能——这是我们首次将其标记为稳定版(Stable)。
新增
- 流畅的命令构建器:
mc.command(name):execute():description():usage():tabComplete():permission():register()—— 支持 Tab 补全和权限限制命令。对于简单场景,mc.registerCommand(...)仍保持原有用法不变。 require("json")—— 支持将 Lua 表编码/解码为 JSON 格式,并提供json.save(name, table)/json.load(name)用于将数据持久化到plugins/LuaMine/config/目录。- 世界交互:
mc.setBlock(x, y, z, type)、mc.getBlock(x, y, z)、mc.spawnEntity(type, x, y, z)。 player:giveItem(item, amount)、player:hasItem(item, amount)。mc.hasPermission(sender, node)。- 12 个新事件:
onPlayerDeath、onPlayerRespawn、onPlayerQuit、onBlockPlace、onEntityDeath、onInventoryClick、onWeatherChange、onWorldChange、onSneakToggle、onItemMend、onPickup、onDrop。 - 脚本执行看门狗 —— 当脚本挂起或陷入无限循环时自动中止,避免导致整个服务器卡死。
修复
/minelua reload时的严重内存泄漏 —— 之前每次重载后,已调度的定时器(Minecraft.wait)和注册的命令仍会继续在已被丢弃的脚本状态上运行,随时间推移不断累积。现在重载会正确替换它们。- 通过
mc.registerCommand/mc.command注册的命令现在能在每次重载时可靠地反映最新的脚本内容。 - 修复了聊天处理中的竞态条件 ——
onChat现在在主线程上安全运行,不再与其他脚本事件产生竞争。 - 减少了高频事件(
onPlayerInteract、onBlockBreak)下的 GC 压力 —— 玩家对象的方法不再在每次调用时重新分配。 - 修复了在事件回调中使用玩家对象调用
Minecraft.getName/kick/sendMessage时静默失败(返回"Unknown"或不执行任何操作)的问题。 - 依赖 LuaMine 的插件(例如
require("re2"))现在能保证在脚本首次加载前就绪,而不再受插件启动顺序的竞争影响。
安全
- 移除了
LuaMineAPI.loadScript()—— 该函数允许任何已安装的插件向 LuaMine 环境注入任意 Lua 源代码,且未验证代码来源。请改用registerFunction/registerModule来暴露 Java 功能给脚本使用。
已知限制
- 一旦某个命令在本服务器会话中至少注册过一次,即使后续脚本不再定义它,该命令仍会保留其名称的 Tab 补全并在
/help中显示。不过,如果实际尝试运行该命令,它会正确报告为不可用。这是为了在 Paper 服务器上实现可靠的命令更新而做出的有意取舍。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧