mEvents

插件

· 作者 miklires

适用于 Paper、Purpur 和 Folia 的可靠定时空投与基于贡献度的 Boss 事件。

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

最新 1.2.0 · 26.3 · Folia / Paper

一键开服(送7天)

mEvents

为 Paper、Purpur 和 Folia 提供可靠的定时空投与基于贡献度的 Boss 事件。

GitHub Modrinth

功能介绍

  • 运行受保护的补给箱,支持可配置的倒计时、认领宽限期、加权奖励以及确定性的清理机制。
  • 运行原版 Boss 遭遇战,具备真实伤害贡献度追踪、最低伤害资格判定以及可选的最高获奖者数量限制。
  • 支持手动或通过独立间隔启动模板,具备有界随机抖动和每个模板独立的冷却时间。
  • 在分发指令前记录所有奖励;未解决的投递将保持挂起状态,以便重启后重试。
  • 通过异步嵌入式 H2 存储持久化生命周期和审计历史记录。
  • 重启后协调中断的运行并移除孤立的事件补给箱。
  • 在 Paper 和 Folia 上正确使用全局、区域和实体调度器。
  • 通过 Bukkit 的 Services Manager 公开 MEventsApi。

要求

  • Java 25
  • Paper、Purpur 或 Folia 26.3

安装

  1. 将 mEvents-1.1.1.jar 放入服务器的 plugins 目录。
  2. 启动服务器一次。
  3. 编辑 plugins/mEvents/events.yml。
  4. 运行 /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 许可证授权。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源