KotlinScriptLoader

插件

· 作者 babyaba

这是一个基于脚本的项目——你可以使用功能完整的 Kotlin 编写自己的脚本!你甚至能创建自己的 API 并构建插件!它拥有应有尽有的一切功能!

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

最新 1.2.0 · 1.21.11 · Paper / Purpur

一键开服(送7天)

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

预览/封面

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源