Scriptirc

插件

· 作者 IonHex975

AI 为 Bukkit/Spigot/Paper 服务器编写插件。 只需将 .java 文件放入加载文件夹即可。

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

最新 1.4.7-SNAPSHOT · 1.20.6 · Folia

一键开服(送7天)

Scriptirc - 脚本编译器,将 Java 源代码直接编译为服务器插件并加载。

推荐在测试服务器或开发中的服务器上使用此插件,因为编译后的脚本无需依赖 Scriptirc 即可加载,您可以直接将编译好的插件脚本放入 plugins 目录。

? 简介

Scriptirc 是一款强大的 Bukkit/Spigot 插件,旨在简化插件管理和即时开发流程。如果您曾经希望能够在不重启服务器的情况下编译和修改脚本插件、加载、卸载或重新加载它们,或者想要快速开发和测试简单的功能,那么 Scriptirc 就是为您准备的。

✨ 主要特性

? 动态插件管理 - 在不重启服务器的情况下加载、卸载或重新加载插件

? 即时脚本编译 - 直接将 Java 脚本编译为功能完整的 Bukkit 插件

?️ 数据目录隔离 - 自动为插件脚本创建独立的数据目录

? 无缝集成 - 兼容现有的 Bukkit/Spigot/Paper 环境

? 资源释放 - 卸载插件脚本以完全释放插件资源,解锁 JAR 文件

? 安装说明

下载对应版本的 Scriptirc.jar

将 JAR 文件放置在服务器的 plugins 目录中

重启服务器或使用插件管理器加载插件

插件将自动创建必要的目录结构和配置文件

? 使用方法

Scriptirc 提供直观的命令行系统,让您能够轻松管理插件和脚本:

基本命令(所有命令均可缩写为 /si)

命令 描述

/scriptirc help	
/scriptirc load <pulgin name>	
/scriptirc unload <pulgin name>
/scriptirc reload <pulgin name>
/scriptirc list	
/scriptirc compiler <pulgin name>	
/scriptirc sync
/scriptirc profile

插件管理示例

加载名为 TestPlugin 的插件。

/si load TestPlugin

卸载插件

/si unload TestPlugin

重新加载插件(例如更新后)

/si reload TestPlugin

查看已加载的插件列表

/si list

脚本编译示例

编译位于 script_src 目录中的 HelloWorld.java 脚本。

/si compiler HelloWorld

然后加载编译好的插件。

/si load HelloWorld

? 目录结构

安装后,Scriptirc 将创建以下目录结构:

plugins/
  └── Scriptirc/
      ├── config.yml # 插件配置文件
      ├── plugins/ # 外部插件存储目录
      │ └── Data/ # 插件数据目录
      ├─ script_src/ # 脚本源代码目录 │ ├── script_src/ # 脚本源代码目录
      │ ├── HelloWorld.java # 示例脚本
      │ └── MathUtil.java # 示例脚本
      └─ script_build/ # 临时脚本构建目录

?️ 开发教程 - 创建您的第一个脚本插件

Scriptirc 让插件开发变得极其简单。你只需创建一个 Java 源文件,编译它并加载即可立即使用。以下是开发步骤:

1. 创建脚本文件

在 plugins/Scriptirc/script_src 目录下新建一个 Java 文件,例如 MyFirstPlugin.java。

2. 编写插件代码

以下是一个简单的插件模板:

包名可自定义(尽量使其有意义)

package your.package.name;

```java
import org.bukkit.command.Command;
import org.bukkit.command.CommandSender;
import org.bukkit.entity.Player;
import org.bukkit.plugin.java.JavaPlugin;

/**

  • @pluginName <插件名称>
  • @author <作者>
  • @version <版本>
  • @description <描述在此行完成所有描述>
  • (命令和权限为可选添加)
  • [command]<命令1>|描述1[/command]
  • [command]<命令2>|描述2[/command]
  • [Permission]<限制1>|描述1[/Permission]
  • [Permission]<限制2>|描述2[/Permission] */
public class MyFirstPlugin extends JavaPlugin {
    
    @Override
    public void onEnable() {
        getLogger().info("插件已启用!");
        // 初始化代码
				//
    }
    
    @Override
    public void onDisable() {
        getLogger().info("插件已禁用!");
        // 卸载/监听器/命令的代码可以放在这里。
    }
    
    @Override
    public boolean onCommand(CommandSender sender, Command command, String label, String[] args) {
        if (command.getName().equalsIgnoreCase("myfirstcmd")) {
            if (sender instanceof Player) {
                Player player = (Player) sender;
                player.sendMessage("§a你好,这是我的第一个插件命令!");
            } else {
                sender.sendMessage("此命令只能由玩家执行!");
            }
            return true;
        }
        return false;
    }
}

强烈推荐使用官方 AI!官方网站

3. 编译并加载你的插件

使用以下命令来编译和加载你的插件:

/si compiler MyFirstPlugin
/si load MyFirstPlugin

就是这么简单!你的插件现在已经在服务器上运行了,无需重启服务器。

重要元数据字段 | 字段 | 必填 | 描述 | VERSION | 是 | 插件版本号 | DESCRIPTION | 是 | 插件描述 | AUTHOR | 是 | 插件作者 | COMMANDS | 否 | 以“命令名称”形式表示的插件命令定义。 | PERMISSIONS | 否 | 以“权限节点”形式表示的权限定义。

⚙️ 配置文件说明

Scriptirc 的配置文件 (config.yml) 允许你自定义插件的行为:

插件自动重载配置 auto-reload.

是否启用自动重载 enabled: true

检查间隔(秒) check-interval: 5

verbose-logging: false verbose-logging: false

插件管理设置 plugin-management.

外部插件目录,相对于插件数据文件夹 external-plugins-directory: “plugins”

是否在服务器启动时自动加载外部插件。 load-on-startup: true

是否将外部插件的数据文件夹重定向到 Scriptirc 目录。 redirect-data-folder: true

权限设置 permissions.

管理员权限节点 admin-permission: “scriptirc.admin”

是否仅允许 OP(管理员)使用 op-only: true

日志设置

logging. 日志输出级别:VERBOSE(输出所有日志)、NORMAL(标准输出)、MINIMAL(仅输出关键信息)

level: “MINIMAL” (如果遇到编译失败,请尝试将日志模式切换为 VERBOSE)

? 常见问题

加载插件后玩家看不到命令怎么办?(存在一个小概率的 bug,将在后续修复)

服务器管理员可以运行命令 /si sync 以将所有命令同步给所有在线玩家。 或者让玩家重新登录服务器。

如果编译脚本时出错该怎么办?

请确保:

Java 代码语法正确无误

包含所有必需的元数据字段(VERSION、DESCRIPTION、AUTHOR)。

服务器正在运行 JDK 而非 JRE(编译需要 JDK)

如何移除动态加载的插件文件?

在使用 /si unload 命令卸载插件时,Scriptirc 会尝试完全释放 JAR 文件,以便将其删除或替换。如果仍然无法删除,可能需要重启服务器。

致谢

有关插件卸载和加载的代码参考了 PlugManX 项目

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源