EternalScript

插件

· 作者 VectorTransformation

一个用于 Minecraft Paper 服务器的脚本插件,支持在运行时动态加载和卸载 Kotlin 脚本。

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

最新 1.0.7 · 1.21.8 · Paper

一键开服(送7天)

EternalScript:用于 Minecraft Paper 服务器的 Kotlin 脚本插件

EternalScript 允许你在 Minecraft Paper 服务器上动态加载和管理代码,而无需重启服务器。它支持多种自定义功能,如脚本生命周期管理、事件处理和自定义命令。

命令

以下是 EternalScript 的可用命令:

  • /es compile:编译并加载配置脚本文件夹中的所有脚本。
  • /es clear:卸载所有当前已加载的脚本。
  • /es config:重新加载插件配置。
  • /es call [script] [function]:调用指定脚本中的函数。
  • /es load [script]:加载特定的脚本文件(例如 /es load "/hello.kt")。
  • /es unload [script]:卸载特定的脚本文件(例如 /es unload "/hello.kt")。
  • /es list:列出所有当前已加载的脚本。

脚本生命周期

控制脚本的行为,包括在加载时执行初始设置以及在卸载时清理资源。

enable {
    // 此代码在脚本加载/启用时运行。
    Bukkit.broadcastMessage("Eternal Script: Script loaded!")
}

disable {
    // 此代码在脚本卸载/禁用时运行。
    Bukkit.broadcastMessage("Eternal Script: Script unloaded!")
}

事件处理

直接在脚本中轻松注册和处理事件,以添加自定义逻辑。

import org.bukkit.Bukkit
import org.bukkit.event.player.PlayerJoinEvent
import org.bukkit.event.player.PlayerQuitEvent

event<PlayerJoinEvent> { event ->
    Bukkit.broadcastMessage("${event.player.name} joined the server!")
}

event<PlayerQuitEvent> { event ->
    Bukkit.broadcastMessage("${event.player.name} left the server.")
}

自定义命令

直接从脚本中定义和注册你自己的游戏内命令。

import org.bukkit.Bukkit

command("test-command") {
    // 玩家执行此命令需要此权限。
    permission = "eternals.command.test"
    executor = { sender, label, args ->
        // 此代码在命令执行时运行。
        Bukkit.broadcastMessage("Command executed by: ${sender.name}")
    }
}

脚本包含/排除规则

控制插件处理哪些脚本。

  • *.kt | *.kts:包含所有 Kotlin 文件(.kt)和 Kotlin 脚本文件(.kts)。
  • -*/ *.kt | -*.kt:忽略特定的文件夹或文件(例如,排除子文件夹中的脚本或特定文件)。
  • !*/* .kt | !*.kt:同步加载特定的文件夹或文件(例如,在服务器启动时优先于其他脚本处理它们)。

安装

在你的服务器上快速轻松地运行 EternalScript:

  1. 从 Modrinth 下载 EternalScript 的最新版本。
  2. 将下载的文件上传到 Minecraft 服务器的 plugins 文件夹。
  3. 启动或重启服务器以加载 EternalScript。

入门指南

通过编写和运行你的第一个 Kotlin 脚本来体验 EternalScript 的强大功能:

  1. 安装后,将创建一个 plugins/EternalScript/scripts/ 文件夹。
  2. 在此 scripts 文件夹内编写扩展名为 .kt 的 Kotlin 脚本文件。
  3. 从服务器控制台,你可以使用 /es load "/[script].kt" 命令加载特定脚本,或使用 /es compile 加载文件夹内的所有脚本。

简单的“Hello World”示例

在 plugins/EternalScript/scripts/ 文件夹中创建 hello.kt 文件,并输入以下内容:

// plugins/EternalScript/scripts/hello.kt

enable {
    Bukkit.broadcastMessage("Hello, world!")
}

然后,从服务器控制台执行 /es load "/hello.kt",你将看到消息出现在游戏聊天中。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源