LuaCord
LuaCord 是一个现代化的插件框架,允许你使用 Lua 脚本并通过完整的 Spigot API 来创建 Minecraft 插件。现在支持 JAR 打包,便于分发!
功能特性
- 完整的 Spigot API - 可访问命令、事件、权限等
- JAR 支持 - 将插件打包为 .jar 文件以用于 CurseForge/Modrinth
- Web JAR 生成器 - 在 luacordmc.github.io/generator.html 将 .lkt 转换为 .jar
- 兼容 Paper - 在现代 Paper 服务器上完美运行
- 易于学习 - Lua 比 Java 简单得多
- 热重载 - 在开发模式下即时测试更改
- 向后兼容 - 所有 Lukkit 插件无需修改即可工作
安装方法
- 下载 LuaCord 并放入
/plugins/目录 - 将你的
.lkt或.jar插件放入/plugins/目录 - 重启服务器
创建插件
插件可以是:
.lkt文件(ZIP 归档)- 用于开发.jar文件(JAR 包装器)- 用于在 CurseForge/Modrinth 上分发- 文件夹 - 用于快速测试
每个插件包含:
main.lua- 你的插件代码plugin.yml- 插件元数据config.yml- 可选配置
示例插件:
plugin:onEnable(function()
logger:info("插件已启用!")
end)
plugin:addCommand({
name = "heal",
description = "治愈自身"
}, function(event)
local player = event:getSender()
player:setHealth(20)
player:sendMessage("已治愈!")
end)
plugin:registerEvent("PlayerJoinEvent", function(event)
local player = event:getPlayer()
player:sendMessage("欢迎!")
end)
plugin.yml:
name: MyPlugin
version: 1.0
main: main.lua
author: YourName
description: My awesome plugin
JAR 分发
想在 CurseForge 或 Modrinth 上分享你的插件吗?
- 创建你的
.lkt插件 - 前往
- 上传你的
.lkt并填写元数据 - 下载生成的
.jar文件 - 上传至 CurseForge/Modrinth!
JAR 生成器完全在浏览器中运行——你的文件永远不会离开你的计算机。
命令
/luacord plugins- 列出已加载的 LuaCord 插件/luacord dev reload <plugin>- 热重载开发模式插件/luacord dev pack <plugin>- 将文件夹打包为 .lkt/luacord dev unpack <plugin>- 将 .lkt 解压到文件夹/luacord dev errors- 查看错误日志
配置
debug-mode: false # 详细日志记录
bypass-plugin-registration: true # Paper 兼容模式(推荐)
lua-debug: false # 启用 Lua 调试全局变量
依赖项
- Spigot 或 Paper(任意版本)
- Java 8 或更高版本
链接
- 官网:
- JAR 生成器:
- GitHub:
- 问题反馈:
许可协议
GPL v3
更新日志
0.2.6-BETA(当前版本)
打包修复
错误修复:
- 修复了 Jar 打包时包含无关的 Maven 构建库(Plexus Utils 和 Maven 编译器插件的依赖项),这导致 0.2.5 被 CurseForge 审核团队拒绝
更改:
- 移除了未使用的依赖项(
reflections、ebean) - Jar 包大小从约 12 MB 减少至约 4 MB
- 对 Lua API 或插件行为无影响——现有的
.lkt和.jar插件照常工作
0.2.5-BETA
稳定性与品牌重塑更新
错误修复:
- 修复了插件加载逻辑,防止一个损坏的
.lkt插件无声地阻止其后列出的所有插件加载 - 修复了一个双重启用 bug,该 bug 可能导致以 JAR 形式分发的插件重复注册其事件监听器
- 修复了 JAR 生成器为某些插件描述生成损坏的
plugin.yml文件的问题
更改:
- 将
/lukkit命令重命名为/luacord(权限也随之重命名——如果您曾显式授予lukkit.command/lukkit.run,请重新授予luacord.command/luacord.run)
0.2.0-BETA
JAR 支持发布!
新功能:
- JAR 插件包装器支持——以 .jar 文件形式分发插件
- luacordmc.github.io/generator.html 上的基于 Web 的 JAR 生成器
- 面向 JAR 包装器的公共 LuaCordAPI
- 改进了带有有用下载链接的错误提示
兼容性:
- 兼容所有 Lukkit 插件
- 完全向后兼容 .lkt 文件
- 适用于任何 Spigot/Paper 版本
- 需要 Java 8+
已知问题(当时):
- 由于兼容模式,
.lkt插件在 Paper 上的/plugins命令中不显示——请改用/luacord plugins。以 JAR 形式分发的插件可以正常显示。 - 热重载仅适用于文件夹形式的插件
0.1.0-BETA
LuaCord 初始发布
源自 Lukkit 2.2.0(亦由我制作),进行了重大改进:
- 使用 Kotlin 重写
- 清理控制台日志(不再出现类路径垃圾信息)
- 包名重命名为
io.thegamingmahi.luacord - Paper 兼容性修复
- 绕过 Paper 限制的模式
- 改进的错误处理
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧