Yeow

插件

· 作者 iYeXin

使用 TypeScript / JavaScript 编写 Minecraft Paper 插件。每个插件都在其独立的隔离 QuickJS 线程中运行——不会阻塞主线程,热重载只需数秒,且插件包跨平台兼容。

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

最新 0.1.0 · 26.2 · Bukkit / Paper

一键开服(送7天)

使用 TypeScript / JavaScript 编写 Minecraft Paper 插件。

Yeow 是一个用于 Paper 服务器的插件运行时,让你能够使用现代前端工具链(TypeScript、npm、esbuild)来构建插件,而非 Java。每个插件都在其独立的 隔离 QuickJS 线程 中运行——它永远不会阻塞服务器主线程,且崩溃的插件不会影响其他插件。

特性

  • TypeScript 优先 — 为命令参数、事件负载和 API 结果提供完整的类型推断
  • 隔离线程 — 每个插件一个 QuickJS 上下文;插件代码绝不会阻塞游戏线程
  • 三级优先级调度器(HIGH / NORMAL / LOW),带有时间片预算、自动降级和动态预算缩放
  • 秒级热重载 — 编辑 src/,在服务器上实时查看效果,无需重启
  • 声明式权限 — 敏感节点(fs:*、http:*、service:registerNative、assets:extract)默认被拒绝,直到明确声明
  • 平台无关的插件包 — .yeow.zip 就是一个普通的 ZIP 文件,可在任何兼容的运行时上运行,而不仅限于 JVM/Bukkit
  • 原生服务 — 将 Go / Rust / C++ 二进制文件嵌入你的插件中;运行时会根据平台提取并启动它们
  • 运行时健康诊断 — 心跳 ping、事件/Tab 补全超时、队列积压和调度器饱和度警告

快速开始 —— 插件开发者

npm create yeow@latest -- -y --ts   # 生成 TypeScript 插件脚手架
cd my-plugin
npm install
npm run dev                          # 启动 Paper + 热重载
npm run build                        # 生成 dist/<name>-<version>.jar + .yeow.zip
import { onLoad, registerCommand, Player, pdcGet, pdcSet, log } from 'yeow-api';

onLoad(() => {
  registerCommand('back', {
    description: '传送至你的死亡位置',
    executor: async (p) => {
      const player = await Player.get(p.sender.uuid);
      if (player) await player.teleport(new Location(0, 64, 0, 0, 0, 'world'));
    },
  });
  log.info('MyPlugin loaded');
});

快速开始 —— 服务器管理员

  1. 将此插件安装到 plugins/ 目录并重启服务器
  2. 将任何 Yeow 插件包(.yeow.zip)放入 plugins/Yeow/ —— 启动时自动加载
  3. 或者在线安装:
    • /yeow install <url> — 下载并安装 .yeow.zip
    • /yeow update <url> — 替换旧版本(旧副本移至 plugins/Yeow/.backup/)
    • /yeow unload <plugin> / /yeow reload <plugin> — 管理正在运行的插件
  4. /yeow profile / /yeow track <plugin> <seconds> — 性能诊断

要求

  • Paper 1.21.4
  • Java 21+

文档

  • 中文文档:
  • 包含入门指南、API 参考(24 个模块)、平台规范以及运行时警告指南。

许可证

MIT(运行时、API、工具链)。QuickJS 引擎(MIT)通过 quickjs-wrapper(Apache-2.0)进行捆绑。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源