mEvents
为 Paper、Purpur 和 Folia 提供可靠的定时空投与基于贡献度的 Boss 事件。
功能介绍
- 运行受保护的补给箱,支持可配置的倒计时、认领宽限期、加权奖励以及确定性的清理机制。
- 运行原版 Boss 遭遇战,具备真实伤害贡献度追踪、最低伤害资格判定以及可选的最高获奖者数量限制。
- 支持手动或通过独立间隔启动模板,具备有界随机抖动和每个模板独立的冷却时间。
- 在分发指令前记录所有奖励;未解决的投递将保持挂起状态,以便重启后重试。
- 通过异步嵌入式 H2 存储持久化生命周期和审计历史记录。
- 重启后协调中断的运行并移除孤立的事件补给箱。
- 在 Paper 和 Folia 上正确使用全局、区域和实体调度器。
- 通过 Bukkit 的 Services Manager 公开
MEventsApi。
要求
- Java 25
- Paper、Purpur 或 Folia 26.3
安装
- 将
mEvents-1.1.1.jar 放入服务器的 plugins 目录。
- 启动服务器一次。
- 编辑
plugins/mEvents/events.yml。
- 运行
/event reload。
默认使用英语。在 config.yml 中设置 language: ru_RU 可将所有指令、公告和通知切换为俄语。现有的语言文件会自动接收新添加的默认值。
事件配置
events:
supply:
name: "Supply Crate"
type: AIRDROP
location: { world: world, x: 0, y: 100, z: 0 }
preparation-ticks: 100
duration-ticks: 1200
cooldown-ticks: 1200
airdrop:
grace-ticks: 60
schedule:
enabled: false
initial-delay-ticks: 1200
interval-ticks: 72000
jitter-ticks: 6000
rewards:
- id: supply_iron
weight: 70
commands: ["give {player} iron_ingot 16"]
奖励指令支持 {player}、{uuid}、{event} 和 {run}。请勿包含前导斜杠。ID 仅接受小写字母、数字、_ 和 -,最大长度为 64 个字符。无效的模板会被报告并跳过,而不会丢弃有效的模板。
自动间隔必须长于事件准备时间与持续时间之和。limits.max-concurrent-events 用于防止来自指令、API 或重叠调度的洪水攻击。
指令
| 指令 |
权限 |
描述 |
/event list |
mevents.use |
列出模板和正在运行的事件 |
/event status |
mevents.use |
显示正在运行的事件 |
/event history |
mevents.use |
显示最近十条持久化的运行记录 |
/event info <template> |
mevents.use |
检查某个模板 |
/event start <template> |
mevents.admin |
启动一个事件 |
/event stop <run-id> |
mevents.admin |
取消某次运行 |
/event reload |
mevents.reload |
验证并重新加载配置 |
安全模型
- 在有效认领之前,空投方块无法被打开、破坏、爆炸、被活塞移动或被漏斗访问。
- 已被占用的位置永远不会被覆盖。
- 同一模板的并发启动会被串行化处理。
- 玩家控制的占位符仅插入到管理员编写的指令中。
- H2 不再打开
AUTO_SERVER 监听器,其执行器会收到有界的关闭信号。
API
从 Bukkit 的 Services Manager 获取 MEventsApi。消费者可以列出模板、启动运行、查询活动运行或通过稳定的运行 UUID 进行取消。新的 start 方法是默认接口方法,以保持与替代提供者的兼容性。
遥测
mEvents 使用匿名的 bStats 指标。不收集任何玩家名称、UUID、位置、贡献度或奖励信息。通过 metrics.enabled: false 禁用指标。
构建
./gradlew clean build
根据 MIT 许可证授权。
mEvents
Reliable scheduled airdrops and contribution-based boss events for Paper, Purpur, and Folia.
What it does
- Runs protected supply crates with a configurable countdown, claim grace period, weighted rewards, and deterministic cleanup.
- Runs vanilla boss encounters with real-damage contribution tracking, minimum-damage eligibility, and optional top-winner limits.
- Starts templates manually or on independent intervals with bounded random jitter and per-template cooldowns.
- Journals every reward before dispatching commands; unresolved deliveries remain pending for startup retry.
- Persists lifecycle and audit history in asynchronous embedded H2 storage.
- Reconciles interrupted runs and removes orphaned event crates after restart.
- Uses global, region, and entity schedulers correctly on both Paper and Folia.
- Exposes a public
MEventsApi through Bukkit's Services Manager.
Requirements
- Java 25
- Paper, Purpur, or Folia 26.3
Installation
- Put
mEvents-1.1.1.jar in the server's plugins directory.
- Start the server once.
- Edit
plugins/mEvents/events.yml.
- Run
/event reload.
English is used by default. Set language: ru_RU in config.yml to switch every command, announcement, and notification to Russian. Existing language files automatically receive newly added defaults.
Event configuration
events:
supply:
name: "Supply Crate"
type: AIRDROP
location: { world: world, x: 0, y: 100, z: 0 }
preparation-ticks: 100
duration-ticks: 1200
cooldown-ticks: 1200
airdrop:
grace-ticks: 60
schedule:
enabled: false
initial-delay-ticks: 1200
interval-ticks: 72000
jitter-ticks: 6000
rewards:
- id: supply_iron
weight: 70
commands: ["give {player} iron_ingot 16"]
Reward commands support {player}, {uuid}, {event}, and {run}. Do not include a leading slash. IDs accept lowercase letters, digits, _, and -, with a maximum length of 64 characters. Invalid templates are reported and skipped without discarding valid templates.
Automatic intervals must be longer than the event preparation plus duration. limits.max-concurrent-events protects against floods from commands, the API, or overlapping schedules.
Commands
| Command |
Permission |
Description |
/event list |
mevents.use |
List templates and active runs |
/event status |
mevents.use |
Show active runs |
/event history |
mevents.use |
Show ten recent persisted runs |
/event info <template> |
mevents.use |
Inspect a template |
/event start <template> |
mevents.admin |
Start an event |
/event stop <run-id> |
mevents.admin |
Cancel a run |
/event reload |
mevents.reload |
Validate and reload configuration |
Safety model
- Airdrop blocks cannot be opened, broken, exploded, moved by pistons, or accessed by hoppers before a valid claim.
- Occupied locations are never overwritten.
- Concurrent starts of the same template are serialized.
- Player-controlled placeholders are inserted only into administrator-authored commands.
- H2 no longer opens an
AUTO_SERVER listener, and its executor receives a bounded shutdown.
API
Obtain MEventsApi from Bukkit's Services Manager. Consumers can list templates, start a run, query an active run, or cancel by stable run UUID. The new start method is a default interface method to preserve compatibility with alternative providers.
Telemetry
mEvents uses anonymous bStats metrics. No player names, UUIDs, locations, contributions, or rewards are collected. Disable metrics with metrics.enabled: false.
Build
./gradlew clean build
Licensed under the MIT License.
评论 0
登录后参与评分
还没有评论,来抢沙发吧