?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 战、自定义机制
- 监狱/空岛服务器 - 玩家经营的商店、自动化系统
? 工作原理
对于管理员:
- 安装 Quill(拖入 JAR 文件,重启服务器)
- 为玩家创建作用域:
/quill scope create arena PlayerName -50 60 -50 50 100 50 whitelist
- 设置权限:
/quill permission grant arena teleport
- 完成。剩下的交给玩家处理。
对于玩家:
- 运行
/quill edit 获取编辑器链接
- 在网页编辑器中编写脚本
- 保存,即在线上服务器生效
- 测试、迭代,发布你的活动
?️ 安全模型
Quill 基于零信任原则构建:
- ✅ 脚本只能影响其定义的物理边界
- ✅ 函数权限采用选择加入(白名单)或选择退出(黑名单)模式
- ✅ 无文件系统访问,无系统命令,无插件冲突
- ✅ 无限循环检测可防止服务器崩溃
- ✅ 脚本在隔离环境中运行——无变量冲突
让你的玩家发挥创造力,同时你保持绝对控制权。
? 要求
- Minecraft 服务器: Paper(Bukkit 和 Spigot 兼容性即将推出)
- Java 版本: 21 或更高
- 推荐: Paper 1.20+ 以获得最佳性能
? 安装
- 下载
Quill-x.x.x.jar
- 放入
plugins/ 文件夹
- 重启服务器
- 在
plugins/Quill/config.yml 中配置编辑器 URL(可选)
- 创建你的第一个作用域!
首次设置耗时不到 5 分钟。
? 资源
? 为什么选择 Quill 而不是 Skript?
(是的,我经常听到这个问题)
Skript 很棒——如果你是一位正在编写全局服务器逻辑的管理员。Quill 不同——它专为玩家编写本地化、沙盒化的活动而设计。
| 功能 |
Skript |
Quill |
| 沙盒执行 |
❌ 全局作用域 |
✅ 物理边界 |
| 玩家运营活动 |
❌ 仅限管理员 |
✅ 安全委托 |
| 权限控制 |
❌ 全有或全无 |
✅ 每作用域细粒度 |
| Web 编辑器 |
❌ 基于文件 |
✅ 零设置 |
| 持久化 |
⚠️ 手动 |
✅ 自动 |
不同的工具服务于不同的服务器模式。 如果你需要赋予玩家权力,Quill 正是为此而生。
? 许可证
MIT 许可证——永远免费且开源。
❤️ 致谢
由 Kohan Mathers 怀着对 Minecraft 社区的爱所创建。
灵感来源于 Skript,但旨在实现根本不同的信任模型。
? 如果 Quill 帮助了你的服务器,请留下评论并为 GitHub 仓库点赞!
有问题?加入 Discord 或提交 GitHub Issue。
?Quill - Player-Powered Events Without Admin Babysitting
Tired of players bugging admins for every custom event? Quill lets your community run their own mini-games, arenas, and automated events - safely sandboxed, fully controlled, zero admin intervention needed.
? The Problem Quill Solves
Your players want to run a PvP tournament. A parkour race. A custom boss fight. Maybe a city-wide scavenger hunt.
Traditional approach:
- Player asks admin for command blocks ❌
- Admin sets everything up manually ❌
- Admin has to supervise so nothing breaks ❌
- Event ends, cleanup is a nightmare ❌
With Quill:
- Admin creates a scope, hands it to the player ✅
- Player writes their event script in minutes ✅
- Script runs safely in its boundaries ✅
- Auto-cleanup, state persists, nothing breaks ✅
✨ Key Features
? Sandboxed Execution
Scripts run in physical boundaries. A player's arena script can't accidentally fill your spawn with TNT or teleport everyone to the void. What happens in the scope, stays in the scope.
? Event-Driven Programming
React to player actions, block interactions, mob deaths, chat messages, and more. No command blocks, no redstone contraptions - just clean, readable code.
?️ Granular Permissions
Whitelist or blacklist functions per scope. Arena scripts get teleport and give but not set_block. Build zones get set_block but not kill. You control exactly what each scope can do.
✍️ Web-Based Editor
No port forwarding. No server file access. Players get a session ID, open the web editor, write their script, and it's instantly on the server. Works behind proxies, NAT, everything.
? Persistent State
Script variables survive server restarts. Player scores, game states, team assignments - all automatically saved and restored.
? Player-Friendly Syntax
Designed for non-programmers. If your players can write command block logic, they can write Quill scripts.
? Quick Example
// A simple PvP arena that starts on command
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("Arena starting in 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} was eliminated!");
set_gamemode(player, "spectator");
}
}
That's it. No command blocks, no plugins for every feature, no admin intervention.
? Perfect For
- Community Servers - Let trusted players run events
- Creative/Build Servers - Automated build competitions
- Minigame Networks - Rapid prototyping without touching code
- RPG Servers - Quest systems, boss fights, custom mechanics
- Prison/Skyblock - Player-run shops, automated systems
? How It Works
For Admins:
- Install Quill (drag-drop JAR, restart server)
- Create scopes for players:
/quill scope create arena PlayerName -50 60 -50 50 100 50 whitelist
- Set permissions:
/quill permission grant arena teleport
- Done. Player handles the rest.
For Players:
- Run
/quill edit to get editor link
- Write your script in the web editor
- Save, and it's live on the server
- Test, iterate, publish your event
?️ Security Model
Quill is built on zero-trust principles:
- ✅ Scripts can ONLY affect their defined physical boundaries
- ✅ Function permissions are opt-in (whitelist) or opt-out (blacklist)
- ✅ No filesystem access, no system commands, no plugin conflicts
- ✅ Infinite loop detection prevents server crashes
- ✅ Scripts run in isolated contexts - no variable collisions
Your players get creative freedom. You keep total control.
? Requirements
- Minecraft Server: Paper (Bukkit and Spigot compatibility coming soon)
- Java Version: 21 or higher
- Recommended: Paper 1.20+ for best performance
? Installation
- Download
Quill-x.x.x.jar
- Drop it in your
plugins/ folder
- Restart your server
- Configure editor URL in
plugins/Quill/config.yml (optional)
- Create your first scope!
First-time setup takes under 5 minutes.
? Resources
? Why Quill Instead of Skript?
(Yes, I hear this a lot)
Skript is great - if you're an admin writing global server logic. Quill is different - it's designed for players writing localized, sandboxed events.
| Feature |
Skript |
Quill |
| Sandboxed execution |
❌ Global scope |
✅ Physical boundaries |
| Player-run events |
❌ Admin only |
✅ Delegated safely |
| Permission control |
❌ All or nothing |
✅ Per-scope granular |
| Web editor |
❌ File-based |
✅ Zero setup |
| Persistence |
⚠️ Manual |
✅ Automatic |
Different tools for different server models. If you need player empowerment, Quill is built for that.
? License
MIT License - Free and open source forever.
❤️ Credits
Created by Kohan Mathers with love for the Minecraft community.
Inspired by Skript, but designed for a fundamentally different trust model.
? If Quill helps your server, leave a review and star the GitHub repo!
Questions? Join the Discord or open a GitHub Issue.
评论 0
登录后参与评分
还没有评论,来抢沙发吧