介绍 Introduction
输入“/”快速插入内容
介绍 Introduction
介绍 Introduction
用户6305用户63052025年10月31日修改
💡
本文为 Vulpecula 3 官方文档，若您正在寻找 v2 版本的文档，可前往：
🥵
欢迎使用 Vulpecula 3！您的支持是我们不断更新的最大动力！
本文档将介绍此插件的主要功能与特性。若您是初次接触 Vulpecula，我们推荐您阅读本篇概述，这将助您快速了解其核心概念。让我们开始吧！
Vulpecula 是一款基于 TabooLib 6 开发的 Kether 功能增强插件，致力于拓展和丰富 Kether 脚本系统的使用场景，为服务器定制化功能提供更多可能。通过 Vulpecula，你可以轻松实现高度自定义的游戏机制，从事件响应、自定义命令到定时任务，皆可通过 Kether 脚本灵活配置。
主要功能
事件驱动脚本 · 让服务器有“自主意识”
核心能力：将 Kether 脚本与游戏事件绑定，用脚本响应游戏中的任何事件，从玩家登录到方块被破坏，让你的服务器“活”起来，让服务器有“自主意识”。
场景示例：玩家首次登录时自动发送专属欢迎邮件并发放新手礼包；钻石块被破坏时实时记录破坏者信息并发送给管理员；玩家完成击杀末影龙成就后自动广播全服祝贺并解锁特殊称号，让服务器互动性更自然。
自定义命令 · 告别“命令不够用”困境
核心能力：完全通过 Kether 脚本定义命令的触发逻辑、权限等级、参数规则和执行效果，支持多参数判断、条件分支等复杂逻辑，无需编写插件代码即可打造专属命令。
场景示例：创建“/mycoin”命令让玩家查询个人金币余额，不同权限组玩家可执行不同子命令（普通玩家查余额、VIP玩家领福利、管理员重置余额）；设计“/warp”传送命令，根据玩家在线时长限制可传送的地点，兼顾趣味性与管理需求。
精准定时任务 · 服务器管理“省人力”
核心能力：支持两种定时模式（Cron 表达式精准定时、固定周期循环），可灵活设置任务启停条件，脚本执行结果可记录日志，方便问题排查。
场景示例：通过 Cron 表达式设置每天 19:00 自动开启双倍经验活动，21:00 自动结束并统计活动期间等级提升TOP3玩家发放奖励；设置每 30 分钟自动清理服务器内的过期掉落物，减少内存占用；凌晨 2 点自动备份世界数据并发送备份成功通知。
原生语法扩展 · 脚本编写“更顺手”
核心能力：针对原版 Kether 脚本的高频使用痛点，补充了大量集成功能、实用语法和属性，覆盖物品操作、权限管理、数据存储等核心场景，降低脚本编写门槛。
场景示例：通过扩展语法可直接获取玩家背包内指定物品的数量，无需编写复杂循环判断；使用权限判断语法快速验证玩家是否拥有特定权限组，简化命令权限控制逻辑；新增的时间格式化语法可让定时公告显示更清晰的时间戳，提升玩家体验。
兼容性
推荐使用 Paper 或其分支的服务端核心，插件开发环节主要使用 Paper 服务端核心进行测试。若你在其他服务端下进行过插件的使用，可联系我们并告知其兼容性，我们会持续记录汇总插件在各类服务端核心下的兼容情况。
关于脚本语言
本插件的核心是对脚本语言的多元拓展，并且主要是对 Kether 进行优化和扩展，很多功能都需要读者掌握 Kether 基础，并且未来会逐步接入性能更强的 Fluxon 语言。如果你对 Kether 不了解也没有关系。下方有关于 Kether 的初学者指南供辅助阅读，适合刚入门 Kether 的小伙伴。
Kether 语言
https://www.yuque.com/sacredcraft/kether
JavaScript 语言
得益于 Kether 中的 JS 语句，可以无缝兼容并运行 JavaScript 语言，使得 Kether 能够实现更多丰富的功能逻辑。目前互联网上 JavaScript 教程已较为完善，读者可自行搜索或借助 AI 快速学习上手。
Fluxon 语言
https://github.com/TabooLib/fluxon