KotlinScriptLoader (KSL)
KotlinScriptLoader 是一款 Bukkit/Paper 插件,允许你使用 Kotlin (.kts) 编写服务器脚本,替代 Java、Skript 或 Denizen。它提供功能强大且类型安全的 DSL,并支持热重载,让你无需编译完整插件即可完全访问 Bukkit/Spigot/Paper API。
? 为什么使用 KSL?
- ? 快速原型开发: 在几分钟内编写和测试游戏逻辑、自定义命令或事件。
- ? 热重载: 通过
/ksl reload即时应用更改——无需重启服务器。 - ? 完整的 Kotlin 特性: 使用协程、集合、扩展函数以及整个 JVM 生态系统。
- ? 现代文本格式: 原生支持 MiniMessage,可实现渐变、悬停事件和点击操作。
- ? 内置集成: 开箱即用支持 LuckPerms、EssentialsX、PlaceholderAPI 和 Discord Webhooks。
- ?️ 安全执行: 可选的沙盒模式,用于限制不受信任脚本中的危险操作。
⚡ 功能特性
- 事件监听器:
onEvent<PlayerJoinEvent> { ... } - 调度器 DSL:
delay、every、runAsync、runSync。 - 动态命令: 直接从脚本注册
/mycommand。 - 数据库访问: 通过 HikariCP 内置 SQLite 数据库支持。
- 配置与 YAML: 轻松实现每个脚本的配置管理。
- Addon API: 通过自定义 Java/Kotlin 插件扩展 KSL。
- IDE 支持: 自动生成
.autocomplete.kts文件以支持 IntelliJ IDEA 代码补全。
? 示例脚本 (scripts/hello.kts)
// 监听玩家加入事件
onEvent<PlayerJoinEvent> {
val p = player
p.sendRichMessage("<gradient:red:blue>Welcome, ${p.name}!</gradient>")
// 检查 LuckPerms 组
if (p.group == "vip") {
p.showRichTitle("<gold>VIP Player", "<gray>Enjoy your perks!")
}
}
// 注册自定义命令
registerCommand("balance", aliases = listOf("bal", "money")) { player, args ->
val bal = player.balance ?: 0.0
player.sendRichMessage("<green>Your balance: <yellow>$${bal}")
}
// 安排重复任务
every(20L * 60) { // 每分钟
broadcastMM("<gray>[KSL] <white>Server is running smoothly!")
}
? 命令
| 命令 | 权限 | 描述 |
|---|---|---|
/ksl reload |
ksl.admin |
重新加载所有脚本和配置。 |
/ksl addons |
ksl.admin |
列出所有已加载的 KSL 附加组件。 |
/ksl services |
ksl.admin |
列出所有已注册的服务。 |
/ksl discord |
ksl.admin |
显示已配置的 Discord Webhook。 |
/ksl sandbox |
ksl.admin |
显示沙盒状态。 |
? 依赖要求
- Paper / Purpur (1.20+)
- Java 21
- (可选) PlaceholderAPI、LuckPerms、EssentialsX

你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧