🌌 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. 安装步骤
- 下载匹配的 JAR(
SpectraEvents-<version>-paper.jar 或 SpectraEvents-<version>-spigot.jar)。
- 将 JAR 放入服务器的
plugins/ 文件夹中。
- 启动服务器。SpectraEvents 将生成所有默认目录和配置文件。
- 安装官方模板(例如 Metin Stone):
/spectraevents template install metin
- 运行诊断医生以验证系统健康状况:
/spectraevents doctor
- 开始你的第一个事件:
/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 自定义物品。
🔗 有用链接
🌌 SpectraEvents
SpectraEvents is a next-generation, high-performance 3D event engine for modern Minecraft servers. Rather than hardcoding static mini-games, SpectraEvents empowers server operators and creators to author dynamic, cinematic, multiplayer world encounters entirely through declarative YAML definitions, smooth Blockbench 3D display entities, and deterministic phase state machines.
Zero client-side mods required! All 3D models and animations run using native vanilla Display and Interaction entities (item_display, block_display, interaction).
✨ Key Features
- 🪐 100% Data-Driven Architecture: Define full multi-phase events, raids, boss fights, loot drops, and piñatas entirely in YAML—phases, triggers, conditions, actions, and limits—without writing a single line of Java.
- 🧊 Real-Time 3D Blockbench Engine: Render, translate, and animate complex multi-bone Blockbench models directly in-game. Powered by smooth keyframed bone animations, quaternion rotations (slerp), and vanilla display entities.
- ⚡ Multi-Platform & Regional Threading: Dedicated distribution JARs for Paper, Purpur, Spigot, CraftBukkit, and native regional multithreading on Folia (
RegionTaskScheduler). Zero global singletons, service locators, NMS, or reflection hacks.
- 📬 Crash-Proof Transactional Mailbox: State persistence backed by SQLite WAL mode. Offline player rewards are stored in durable, three-state mailboxes (
PENDING -> DELIVERING -> DELIVERED) that seamlessly reconcile and survive unexpected server restarts.
- ⏰ Timezone-Calibrated Schedules: Schedule recurring world events with timezone precision, Cron expressions, and parameter overrides (
schedules.yml).
- 📦 Automated Modrinth Asset CDN: Official resource-pack bundles are version-matched and delivered securely via the Modrinth CDN (
spectraevents-assets), or hosted independently on private server URLs.
- 🛠️ In-Game Administration & Live Diagnostics: Built-in operator tools (
/spectraevents doctor, /spectraevents status, definition validator, and live template installer).
🎮 Shipped Reference Presets
SpectraEvents comes pre-packaged with production-ready reference presets that you can install in seconds:
| Preset |
Description |
Key Mechanics Demonstrated |
| Meteor |
A blazing celestial rock crashes from the sky into the world. |
Falling animation, impact shockwave, multi-stage damage thresholds, radial loot drops. |
| Airdrop |
A supply crate parachutes slowly from cloud level down to the terrain. |
Slow-fall display entity physics, smoke beacon flare, interactive loot chest with auto-despawn timer. |
| Metin Stone |
A cursed stone spawns hostile waves of aggressive mobs as health depletes. |
Health-gated phase transitions, mob spawning actions, bossbar countdown, top-damager rewards. |
| Piñata |
A suspended festive piñata bursts into celebratory fireworks and bouncing loot. |
Hit-count triggers, sound action chains, physical item drops scattered within a radial zone. |
| Boss Portal |
An ominous rift opens, summoning an elite encounter with custom phase shifts. |
Boss summon actions, dynamic area restriction boundaries, phase transition conditions, podium awards. |
📦 Which JAR Should I Download?
SpectraEvents strictly follows the Golden Packaging Invariant—every release produces EXACTLY TWO production JARs:
| Distribution JAR |
Target Server Platforms |
Minecraft Versions |
Features & Architecture |
SpectraEvents-<version>-paper.jar |
Paper, Purpur, Folia |
26.1 – 26.3 |
Full feature set, asynchronous chunk loading, native Adventure MiniMessage, Folia regional multithreading via RegionTaskScheduler, Admin GUI. |
SpectraEvents-<version>-spigot.jar |
Spigot, CraftBukkit |
26.1 – 26.3 |
Dedicated Spigot task scheduling, Spigot PDC persistence keys, Bukkit Admin GUI, and modular administration subcommands. |
⚠️ Important: Install only one matching JAR in your server's plugins/ directory. Do not place both JARs on the same server.
🚀 Quick Start Guide
1. Prerequisites
- Server running Paper 26.1–26.3, Purpur 26.1–26.3, Folia 26.1–26.3, or Spigot 26.1–26.3.
- Java 25 runtime (
java -version).
- (Optional) PlaceholderAPI for leaderboard and event status placeholders.
2. Installation
- Download the matching JAR (
SpectraEvents-<version>-paper.jar or SpectraEvents-<version>-spigot.jar).
- Place the JAR into your server's
plugins/ folder.
- Start the server. SpectraEvents will generate all default directories and configurations.
- Install an official template (e.g. Metin Stone):
/spectraevents template install metin
- Run the diagnostic doctor to verify system health:
/spectraevents doctor
- Start your first event:
/spectraevents event start metin
⌨️ Essential Commands & Permissions
Base command: /spectraevents (aliases: /se, /events). Permissions are nested under spectraevents.*:
| Command |
Permission |
Description |
/se status |
spectraevents.status |
Displays engine status, active instances, and runtime metrics. |
/se doctor |
spectraevents.admin |
Performs complete system diagnostics and environment checks. |
/se event list |
spectraevents.event.list |
Lists all active and running event instances across worlds. |
/se event start <id> |
spectraevents.event.start |
Spawns a new instance of the specified event definition. |
/se event stop <uuid> |
spectraevents.event.stop |
Immediately cancels and despawns an active event instance. |
/se event inspect <uuid> |
spectraevents.event.inspect |
Displays detailed runtime state, current phase, and participants. |
/se definition validate |
spectraevents.definition.validate |
Validates YAML definitions and reports compiler diagnostics. |
/se definition reload |
spectraevents.definition.reload |
Hot-reloads definition files from disk without restarting. |
/se template list |
spectraevents.template |
Lists bundled event templates available for instant installation. |
/se template install <id> |
spectraevents.template |
Installs and compiles a bundled event template. |
| `/se schedule list |
reload` |
spectraevents.schedule |
| `/se rewards list |
claim` |
spectraevents.rewards |
/se admin |
spectraevents.admin.gui |
Opens the interactive administrative GUI (Paper only). |
🎨 Asset Delivery & Resource Pack
SpectraEvents supports delivering custom 3D models and textures through client resource packs:
- Modrinth Asset CDN: Official resource packs are published to Modrinth project
spectraevents-assets (ID: Rg1nw8IW).
- Private Server Hosting: Operators hosting custom Blockbench models can configure direct HTTP URLs in
config.yml.
- Default Delivery: Automatic resource-pack prompt delivery is disabled by default until configured by an administrator.
🔌 Integrations
SpectraEvents automatically detects and seamlessly integrates with:
- PlaceholderAPI: Leaderboard and event status placeholders (
%spectraevents_...%).
- LuckPerms: Fine-grained permissions checking and hierarchy.
- MiniPlaceholders: Rich MiniMessage placeholder expansions.
- Vault: Economy and currency rewards.
- Custom Items: Oraxen, ItemsAdder, and Nexo custom items in event loot and rewards.
🔗 Useful Links
评论 0
登录后参与评分
还没有评论,来抢沙发吧