介绍 Introduction
输入“/”快速插入内容
介绍 Introduction
用户6305
用户6305
2025年10月31日修改
💡
本文为 Vulpecula 3 官方文档,若您正在寻找 v2 版本的文档,可前往:
https://www.yuque.com/lanscarlos/vulpecula-wiki-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