SpectraEvents

插件

· 作者 kizio

面向 Paper、Spigot 与 Folia 的下一代数据驱动 3D 事件引擎。原版展示实体模型,流畅动画且无需客户端模组。

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

最新 1.0.0+spigot · 26.3 · Bukkit / Spigot

一键开服(送7天)

🌌 SpectraEvents

SpectraEvents 是一款面向现代 Minecraft 服务器的下一代高性能 3D 事件引擎。SpectraEvents 摒弃了硬编码的静态小游戏,赋予服务器管理员和创作者通过声明式 YAML 定义、流畅的 Blockbench 3D 展示实体以及确定性的阶段状态机,来完全自主设计动态、电影化且支持多人互动的世界遭遇战的能力。

无需任何客户端模组! 所有 3D 模型和动画均使用原版的 Display(展示)和 Interaction(交互)实体(item_display、block_display、interaction)运行。


✨ 主要特性

  • 🪐 100% 数据驱动架构: 完全通过 YAML 定义包含多个阶段的事件、袭击、Boss 战、掉落物和彩罐(piñatas)——包括阶段、触发器、条件、动作和限制——无需编写一行 Java 代码。
  • 🧊 实时 3D Blockbench 引擎: 在游戏中直接渲染、平移和动画化复杂的多骨骼 Blockbench 模型。由流畅的关键帧骨骼动画、四元数旋转(slerp)和原版展示实体提供支持。
  • ⚡ 多平台与区域多线程: 为 Paper、Purpur、Spigot、CraftBukkit 提供专用的分发 JAR,并在 Folia 上原生支持区域多线程(RegionTaskScheduler)。零全局单例、服务定位器、NMS 或反射黑客。
  • 📬 防崩溃事务性邮箱: 基于 SQLite WAL 模式的状态持久化。离线玩家的奖励存储在耐用的三态邮箱中(PENDING -> DELIVERING -> DELIVERED),能够无缝对账并抵御意外的服务器重启。
  • ⏰ 时区校准调度: 使用时区精度、Cron 表达式和参数覆盖(schedules.yml)安排重复的世界事件。
  • 📦 自动化 Modrinth 资产 CDN: 官方资源包捆绑版本匹配并通过 Modrinth CDN(spectraevents-assets)安全交付,也可托管在私有服务器 URL 上。
  • 🛠️ 游戏内管理与实时诊断: 内置操作员工具(/spectraevents doctor、/spectraevents status、定义验证器和实时模板安装器)。

🎮 随附参考预设

SpectraEvents 预装了生产就绪的参考预设,您可以几秒钟内完成安装:

预设 描述 演示的关键机制
Meteor 一块炽热的天体岩石从天空坠入世界。 下落动画、冲击波、多阶段伤害阈值、径向掉落物。
Airdrop 一个补给箱从云层缓慢飘降至地面。 慢速下落展示实体物理效果、烟雾信标闪光、带有自动消失计时器的可互动宝箱。
Metin Stone 一块被诅咒的石块随着生命值耗尽而刷出敌对的激进生物群。 生命值锁定的阶段转换、生物生成动作、Boss 血条倒计时、最高伤害者奖励。
Piñata 一个悬挂的节日彩罐爆裂成庆祝烟花和弹跳的掉落物。 击打次数触发、声音动作链、在径向区域内散射的物理物品掉落。
Boss Portal 一道不祥的裂隙打开,召唤具有自定义阶段转换的精英遭遇战。 Boss 召唤动作、动态区域限制边界、阶段转换条件、领奖台奖励。

📦 我应该下载哪个 JAR?

SpectraEvents 严格遵循 黄金打包不变量 —— 每个发行版仅生成 恰好两个 生产用 JAR:

分发 JAR 目标服务器平台 Minecraft 版本 特性与架构
SpectraEvents-<version>-paper.jar Paper、Purpur、Folia 26.1 – 26.3 完整功能集、异步区块加载、原生 Adventure MiniMessage、通过 RegionTaskScheduler 实现 Folia 区域多线程、管理 GUI。
SpectraEvents-<version>-spigot.jar Spigot、CraftBukkit 26.1 – 26.3 专用 Spigot 任务调度、Spigot PDC 持久化键、Bukkit 管理 GUI 及模块化管理子命令。

⚠️ 重要提示: 请在服务器的 plugins/ 目录中仅安装一个匹配的 JAR。请勿在同一服务器上同时放置两个 JAR。


🚀 快速入门指南

1. 前置要求

  • 正在运行 Paper 26.1–26.3、Purpur 26.1–26.3、Folia 26.1–26.3 或 Spigot 26.1–26.3 的服务器。
  • Java 25 运行时(java -version)。
  • (可选) PlaceholderAPI 用于排行榜和事件状态占位符。

2. 安装步骤

  1. 下载匹配的 JAR(SpectraEvents-<version>-paper.jar 或 SpectraEvents-<version>-spigot.jar)。
  2. 将 JAR 放入服务器的 plugins/ 文件夹中。
  3. 启动服务器。SpectraEvents 将生成所有默认目录和配置文件。
  4. 安装官方模板(例如 Metin Stone):
    /spectraevents template install metin
    
  5. 运行诊断医生以验证系统健康状况:
    /spectraevents doctor
    
  6. 开始你的第一个事件:
    /spectraevents event start metin
    

⌨️ 基本命令与权限

基础命令:/spectraevents(别名:/se、/events)。权限嵌套在 spectraevents.* 之下:

命令 权限节点 描述
/se status spectraevents.status 显示引擎状态、活动实例和运行时指标。
/se doctor spectraevents.admin 执行完整的系统诊断和环境检查。
/se event list spectraevents.event.list 列出所有世界中处于活动和运行状态的事件实例。
/se event start <id> spectraevents.event.start 生成指定事件定义的新实例。
/se event stop <uuid> spectraevents.event.stop 立即取消并移除活跃的事件实例。
/se event inspect <uuid> spectraevents.event.inspect 显示详细的运行时状态、当前阶段和参与者。
/se definition validate spectraevents.definition.validate 验证 YAML 定义并报告编译器诊断信息。
/se definition reload spectraevents.definition.reload 从磁盘热重载定义文件,无需重启。
/se template list spectraevents.template 列出可用于即时安装的捆绑事件模板。
/se template install <id> spectraevents.template 安装并编译一个捆绑的事件模板。
`/se schedule list reload` spectraevents.schedule
`/se rewards list claim` spectraevents.rewards
/se admin spectraevents.admin.gui 打开交互式管理 GUI(仅限 Paper)。

🎨 资产分发与资源包

SpectraEvents 支持通过客户端资源包交付自定义 3D 模型和纹理:

  • Modrinth Asset CDN: 官方资源包已发布至 Modrinth 项目 spectraevents-assets(ID: Rg1nw8IW)。
  • 私有服务器托管: 托管自定义 Blockbench 模型的运营者可以在 config.yml 中配置直接 HTTP URL。
  • 默认分发: 自动资源包提示功能默认处于禁用状态,直到由管理员进行配置。

🔌 集成

SpectraEvents 会自动检测并与以下插件无缝集成:

  • PlaceholderAPI: 排行榜和事件状态占位符(%spectraevents_...%)。
  • LuckPerms: 细粒度的权限检查和层级结构。
  • MiniPlaceholders: 丰富的 MiniMessage 占位符扩展。
  • Vault: 经济和货币奖励。
  • Custom Items: 事件战利品和奖励中的 Oraxen、ItemsAdder 和 Nexo 自定义物品。

🔗 有用链接

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源