Quill

插件

· 作者 KohanMathers

用于 Minecraft 事件自动化的沙盒化脚本语言

0 本站下载 0 关注 更新于 1 年前

最新 1.0.0 · 1.21.10 · Paper

一键开服(送7天)

?Quill - 由玩家驱动的活动,无需管理员全程看护

厌倦了玩家为每个自定义活动都来烦扰管理员? Quill 让你的社区能够自主运行迷你游戏、竞技场和自动化活动——在安全沙盒中,完全可控,无需任何管理员干预。

? Quill 解决的问题

你的玩家想要举办一场 PvP 锦标赛。一场跑酷比赛。一个自定义 Boss 战。也许是一场全城范围的寻宝游戏。

传统方式:

  • 玩家向管理员申请命令方块 ❌
  • 管理员手动设置一切 ❌
  • 管理员必须监督以防出错 ❌
  • 活动结束后,清理工作令人头疼 ❌

使用 Quill:

  • 管理员创建范围,将其交给玩家 ✅
  • 玩家在几分钟内编写自己的活动脚本 ✅
  • 脚本在其边界内安全运行 ✅
  • 自动清理,状态持久化,不会出错 ✅

✨ 主要功能

? 沙盒执行 脚本在物理边界内运行。玩家的竞技场脚本不会意外地用 TNT 填满你的出生点或将所有人传送至虚空。作用域内发生的事,就留在作用域内。

? 事件驱动编程 响应玩家动作、方块交互、生物死亡、聊天消息等。无需命令方块,无需红石装置——只需清晰、可读的代码。

?️ 细粒度权限控制 按作用域白名单或黑名单指定函数。竞技场脚本获得 teleport(传送)和 give(给予)权限,但没有 set_block(设置方块)权限。建造区域获得 set_block 权限,但没有 kill(杀死)权限。你可以精确控制每个作用域能做什么。

✍️ 基于 Web 的编辑器 无需端口转发。无需服务器文件访问。玩家获取会话 ID,打开网页编辑器,编写脚本,然后立即生效到服务器上。适用于代理、NAT 等各种网络环境。

? 持久化状态 脚本变量在服务器重启后依然存在。玩家分数、游戏状态、队伍分配——全部自动保存并恢复。

? 对玩家友好的语法 专为非程序员设计。如果你的玩家能编写命令方块逻辑,他们就能编写 Quill 脚本。


? 快速示例

// 一个简单的 PvP 竞技场,通过指令启动
let arena = new Scope(-50, 60, -50, 50, 100, 50);
arena.game_active = false;

OnEvent(PlayerChat) {
    if chat.message == "!start" && in_region(player, arena) {
        arena.game_active = true;
        broadcast("竞技场将在 3... 2... 1... 后开始!");
        
        for p in arena.players {
            set_gamemode(p, "survival");
            give(p, "diamond_sword", 1);
            heal(p);
        }
    }
}

OnEvent(PlayerDeath) {
    if arena.game_active && in_region(player, arena) {
        broadcast("{player.name} 被淘汰了!");
        set_gamemode(player, "spectator");
    }
}

就是这样。无需命令方块,无需为每个功能安装插件,无需管理员干预。


? 适用场景

  • 社区服务器 - 让受信任的玩家举办活动
  • 创造/建筑服务器 - 自动化的建筑竞赛
  • 小游戏网络 - 无需触碰代码即可快速原型开发
  • RPG 服务器 - 任务系统、Boss 战、自定义机制
  • 监狱/空岛服务器 - 玩家经营的商店、自动化系统

? 工作原理

对于管理员:

  1. 安装 Quill(拖入 JAR 文件,重启服务器)
  2. 为玩家创建作用域:/quill scope create arena PlayerName -50 60 -50 50 100 50 whitelist
  3. 设置权限:/quill permission grant arena teleport
  4. 完成。剩下的交给玩家处理。

对于玩家:

  1. 运行 /quill edit 获取编辑器链接
  2. 在网页编辑器中编写脚本
  3. 保存,即在线上服务器生效
  4. 测试、迭代,发布你的活动

?️ 安全模型

Quill 基于零信任原则构建:

  • ✅ 脚本只能影响其定义的物理边界
  • ✅ 函数权限采用选择加入(白名单)或选择退出(黑名单)模式
  • ✅ 无文件系统访问,无系统命令,无插件冲突
  • ✅ 无限循环检测可防止服务器崩溃
  • ✅ 脚本在隔离环境中运行——无变量冲突

让你的玩家发挥创造力,同时你保持绝对控制权。


? 要求

  • Minecraft 服务器: Paper(Bukkit 和 Spigot 兼容性即将推出)
  • Java 版本: 21 或更高
  • 推荐: Paper 1.20+ 以获得最佳性能

? 安装

  1. 下载 Quill-x.x.x.jar
  2. 放入 plugins/ 文件夹
  3. 重启服务器
  4. 在 plugins/Quill/config.yml 中配置编辑器 URL(可选)
  5. 创建你的第一个作用域!

首次设置耗时不到 5 分钟。


? 资源


? 为什么选择 Quill 而不是 Skript?

(是的,我经常听到这个问题)

Skript 很棒——如果你是一位正在编写全局服务器逻辑的管理员。Quill 不同——它专为玩家编写本地化、沙盒化的活动而设计。

功能 Skript Quill
沙盒执行 ❌ 全局作用域 ✅ 物理边界
玩家运营活动 ❌ 仅限管理员 ✅ 安全委托
权限控制 ❌ 全有或全无 ✅ 每作用域细粒度
Web 编辑器 ❌ 基于文件 ✅ 零设置
持久化 ⚠️ 手动 ✅ 自动

不同的工具服务于不同的服务器模式。 如果你需要赋予玩家权力,Quill 正是为此而生。


? 许可证

MIT 许可证——永远免费且开源。


❤️ 致谢

由 Kohan Mathers 怀着对 Minecraft 社区的爱所创建。

灵感来源于 Skript,但旨在实现根本不同的信任模型。


? 如果 Quill 帮助了你的服务器,请留下评论并为 GitHub 仓库点赞!


有问题?加入 Discord 或提交 GitHub Issue。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源