NodeRunner

插件

· 作者 spider2742

在 Minecraft 服务器旁直接运行你的 Node.js Discord 机器人!具备自动配置、实时网页仪表板和游戏内控制功能

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

最新 1.4.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

NodeRunner ?

在你的 Minecraft 服务器内直接运行你的 Node.js Discord 机器人——无需 VPS、无需额外托管、无需 SSH。

NodeRunner 是一个 Paper 插件,它将 Node.js 进程作为 Minecraft 服务器的子进程进行管理。它自动处理一切:下载 Node.js、安装依赖项、崩溃后重启、通过 Web 仪表板实时流式传输日志以及发送 Discord 通知——所有操作都只需一个 config.yml。


? 1.4.0 更新内容

Java 25 & 构建现代化

  • 升级至 Java 25 — 使用 Java 25 字节码编译,以获得最新的 JVM 性能和语言特性。
  • Gradle 9.5.1 — 构建系统从 Gradle 8.x 升级至 9.5.1,以原生支持 Java 25。
  • 虚拟线程执行器 — 仪表板的 HTTP 服务器现在使用 newVirtualThreadPerTaskExecutor(),在 Java 25 上实现非阻塞 I/O 扩展。
  • plugin.yml api-version 已更新为 1.21,以匹配目标平台。

兼容性

  • Minecraft 1.21.x – 26.2.x — 基于 Paper 1.21.1 API 编译,向前兼容所有直至 26.2.x 版本的 Paper。

现有配置完全兼容——无需更改配置。


✨ 功能

⚡ 零接触 Node.js 设置

服务器上没装 Node.js?没问题。NodeRunner 会自动检测你的操作系统和 CPU 架构,并在首次启动时下载正确的 Node.js LTS 二进制文件。适用于 Linux (x64 & ARM64)、macOS 和 Windows。仅下载一次(约 30MB),永久缓存。

? 自动依赖安装

有 package.json?当检测到缺少 node_modules 时,NodeRunner 会在启动前自动运行 npm install。无需手动干预。

? 崩溃恢复与循环保护

你的机器人受到持续监控。发生崩溃时,NodeRunner 会等待一段可配置的时间并重启它。如果在短时间内崩溃次数过多,崩溃循环保护将停止重试并发出警报——避免无限的重启刷屏。

?️ 实时 Web 仪表板

内置的、受密码保护的控制面板,可从任何浏览器访问:

  • 实时日志流式传输 通过 Server-Sent Events(无需刷新页面)
  • 开始 / 停止 / 重启 / npm install 按钮
  • 实时状态、运行时间、PID、重启计数和内存使用情况
  • stdin 输入栏 — 直接向机器人进程发送命令
  • 多机器人选择器 — 从仪表板切换机器人(自动检测)
  • 带自动滚动切换功能的彩色编码日志输出
  • 所有修改端点的 CSRF 保护
  • 暴力登录保护 — 5 次失败尝试后锁定

? Discord Webhook 通知

当你的机器人启动、停止、崩溃或运行 npm install 时,通过标准 Webhook URL 在 Discord 中收到提醒。无需机器人令牌。每种事件类型均可单独开关。

? 游戏内命令

通过 Minecraft 控制台或游戏内的 /nodebot 进行完全控制。无需 SSH 会话即可重启机器人。

? 多机器人支持

同时运行多个 Node.js 机器人——每个机器人拥有自己的进程、日志文件和独立的崩溃恢复机制。使用 /nodebot start <name>、/nodebot stop <name> 等命令单独控制每个机器人。

? Node.js 版本固定

固定特定的 Node.js 主版本(例如 "22"),而不是始终下载最新的 LTS 版本。如果你的机器人需要特定的运行时版本,这非常有用。

? stdin 透传

直接从 Web 仪表板向机器人进程发送输入,而无需重启它——这对于接受通过 stdin 的控制台命令的机器人很有用。

? 内存监控

Web 仪表板显示机器人进程的实时内存使用情况(RSS),直接从 Linux 上的 /proc/<pid>/status 读取。

? TunnelMC 集成

如果安装了 TunnelMC 并且仪表板端口上有活动的隧道,NodeRunner 将在机器人启动时将公共 URL 打印到控制台——仅提供信息用途,绝不会自动启动 TunnelMC。

? Pterodactyl 兼容

已在 Pterodactyl 面板上全面测试。使用 .tar.gz 提取 Node.js(无 xz 依赖),并将 node 二进制文件正确注入进程 PATH,以确保容器内的 npm 兼容性。


? 安装

  1. 将 NodeRunner.jar 放入你的 plugins/ 文件夹
  2. 启动服务器一次以生成配置文件
  3. 将你的机器人代码放在 plugins/NodeRunner/bot/ 中(需要 index.js + package.json)
  4. 在 config.yml 的 env: 下设置你的机器人令牌和其他任何密钥
  5. 重启,或运行 /nodebot start

NodeRunner 处理其余部分——Node.js 下载、npm install 和机器人启动全部自动完成。


? 文件结构

plugins/
  NodeRunner/
    config.yml          ← 所有插件设置
    bot/                ← 你的机器人代码放在这里
      index.js
      package.json
    logs/
      bot.log           ← 实时输出(5MB 轮换,保留 3 个备份)
      bot-<name>.log    ← 使用多个机器人时的单个机器人日志文件
    nodejs/             ← 自动下载的 Node.js 二进制文件(不要触碰)

? 命令与权限

权限: noderunner.admin (默认:OP)

命令 描述
/nodebot start [name] 启动机器人(或通过名称启动特定机器人)
/nodebot stop [name] 停止机器人(或通过名称停止特定机器人)
/nodebot restart [name] 重启机器人(或通过名称重启特定机器人)
/nodebot status [name] 显示所有机器人或特定机器人的状态
/nodebot install [name] 强制重新运行 npm install
/nodebot reload 重新加载 config.yml

? Web 仪表板

访问地址为 http://<your-server-ip>:8080(端口可配置)。

默认启用密码保护——在向公众开放之前,请在 config.yml 中更改默认密码。

Pterodactyl 用户: 仪表板需要第二个分配的端口。让你的主机添加一个,或使用 TunnelMC 或 Cloudflare Tunnel 在不添加端口的情况下暴露它。


? Discord Webhook 设置

  1. 进入你的 Discord 频道 → 编辑频道 → 集成 → Webhooks → 新建 Webhook
  2. 复制 Webhook URL
  3. 将其粘贴到 config.yml 中的 discord.webhook.url 下
  4. 设置 discord.webhook.enabled: true
  5. 重启服务器或运行 /nodebot reload

? Pterodactyl 注意事项

NodeRunner 已在 Pterodactyl 上经过全面测试。请注意:

  • 该插件使用 .tar.gz 格式的 Node.js,以避免大多数容器镜像中缺少 xz 依赖的问题
  • 如果之前的安装失败,请删除 plugins/NodeRunner/nodejs/ 目录并重启以重新下载
  • 通过 config.yml 中的 env: 设置你的机器人令牌和其他密钥——切勿在机器人文件中硬编码这些内容
  • 面板需要单独分配的端口——请联系你的主机提供商添加一个端口

? 兼容性

Minecraft Paper 1.21.x – 26.2.x
Java 25+(使用 Java 25 编译)
操作系统 Linux, macOS, Windows
架构 x64, ARM64
托管方式 自建、Pterodactyl、任意 VPS

⚠️ 需要 Java 25: JAR 文件使用 Java 25 编译,并使用虚拟线程。你的服务器必须运行 Java 25 或更高版本。Paper 1.21.x+ 搭配 Java 25 是推荐且经过全面测试的配置。


? 相关资源

TunnelMC — 通过 ngrok 隧道将任意服务器端口暴露到互联网。与 NodeRunner 完美配合,无需额外分配端口即可让 Web 面板对公众可访问。

PyRunner — 本插件的 Python 等效版本。在你的 Minecraft 服务器旁运行一个 Python Discord 机器人。


? 许可证

保留所有权利 — 本插件及其源代码均为专有软件。未经作者明确书面许可,你不得复制、重新分发、修改或反编译此软件。


由 Spider 开发

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源