自动消息 [1.21]

不只是另一个聊天轮播器。这是一个完整的公告引擎。
为现代 Minecraft 服务器和网络提供定向、本地化且感知事件的通知广播。

_{6 个运行时  ·  8 种通知展示面  ·  8 类受众规则  ·  3 种事件触发器  ·  3 种内置语言  ·  每种语言一次渲染  ·  无数据库}

📣 广播应当赢得关注

当每条消息都发送给所有人时，玩家很快就会学会忽略公告。AutoMessage 让服务器沟通变得深思熟虑：每个流都有自己的时间表，每条消息都能选择自己的受众，文本会以每位玩家实际使用的语言呈现——这一切都源自一个运行在 Bukkit、Folia、Sponge、Velocity、Fabric 和 Minestom 上的共享核心。

_{同一套公告，在同一台服务器的游戏中展示：Boss 栏倒计时、全屏标题和一行聊天消息。}

一条完整的公告，从始到终

在老玩家加入三秒后向他们致以问候——绝不依赖定时器，绝不打扰新人，并使用他们自己的语言。只需两个文件即可实现：

# scheduledMessages.yml - 谁接收，何时接收
messages:
  - name: welcome-back
    trigger:
      type: JOIN
      delay: 3s
    rules:
      - type: PLAYTIME
        min: 10h

# lang/en.yml - 说什么
announcements:
  welcome-back:
    - chat: "<gray>欢迎回来，<aqua>{PLAYER}<gray>。"
      sound: "entity.player.levelup MASTER 1.0 1.2"

服务器将如此处理它们：

这就是功能集的缩影：基于事件而非时钟，针对特定受众而非所有人，文本与其他所有翻译并存。

⚖️ 不仅仅是轮播列表

这句标语并非营销噱头。普通的轮播器只回答一个问题——接下来该说什么？——然后用一种语言、按一个时钟把答案发给所有人。

底层细节

🎯 精准触达应接收者

规则可组合。每个顶层规则都必须通过，而当受众需要比简单的“与”逻辑更复杂的条件时，可在其中嵌套 ANY_OF、NONE_OF 和 NOT。

同样的规则也适用于由事件发送的消息，因此限制特定权限的加入问候绝不会发送给缺乏该权限的人，哪怕他们刚刚走进大门。

⚡ 由事件触发，而非时钟

带有触发器的消息会完全脱离其频道的轮播，静待某事发生。

PLAYER_COUNT 值得细读两遍：它在上升过程中仅触发一次，且仅在服务器人数回落至阈值以下后才重新武装，因此当人口在边界徘徊时，不会因每次有人登录就重复宣布同一里程碑。

🪶 几乎不消耗服务器资源

格式化是公告中最耗时的部分。颜色、渐变、悬停文本和占位符都必须在任何字符送达任何人之前进行解析——而直观的做法是为每位接收者解析一次。五百名玩家在线意味着同一句话要在主线程上构建五百次才能说出一件事，而其余的刻只能等待轮转。

AutoMessage 每种语言仅构建一次，并将完成的结果交给所有阅读该语言的玩家。

这意味着每条公告的主线程耗时减少 15 倍，这是在真实发送路径上、500 名观众在线时测得的——而非针对单一函数的微基准测试。剩下的工作只是将完成的文本传递给每个连接，这是任何插件都无法避免的。

随着玩家数量增加，节省效果愈发显著，且无需任何配置成本：无需调整缓存大小，无需调优设置，也无需牺牲任何行为。

它从不以正确性换取速度。 对于每位玩家阅读内容不同的消息——例如包含 {PLAYER} 或任何 PlaceholderAPI 令牌的消息——仍会为每位玩家单独构建，因为只有该令牌背后的扩展才知道两位玩家是否会看到相同的内容。分组仅在文本真正完全相同时应用，除此之外绝不应用。

分发路径在另外三个地方拒绝执行不必要的工作：

• 占位符每条消息仅扫描一次，而非每条公告扫描一次。 消息包含哪些令牌由文本决定，因此在读取文件时确定并记忆直到重载——而不是每次频道触发时重新推导。
• 空服务器会短路处理。 无人在线意味着无需选择、无需格式化、无需工作。
• 公告期间不触碰磁盘。 无数据库、无玩家记录、热路径上无 I/O。

🌐 一个引擎。六种运行时

AutoMessage 使用一个共享的平台无关核心，并为每种服务器类型配备小型运行时适配器。这意味着行为保持一致，而调度、观众、权限和生命周期钩子则在底层保持对各平台的原生支持。

[!NOTE] Java 21 是插件构建物的字节码底线，并非承诺每个 Minecraft 服务器版本都能在 Java 21 上运行。请使用你的服务器所需的 JVM；Minestom 本身需要 Java 25。

每个构建物都会生成感知平台的配置。运行时无法支持的选项会被省略，而非生成后被静默忽略。

🗂 配置模型

AutoMessage 将 何时、谁 和 什么 分离。添加语言从不需要复制调度规则，更改频道间隔也从不触及消息文本。

flowchart LR
    schedule["config.yml<br/>何时<br/>频道 · 周期 · 选择器"]
    audience["scheduledMessages.yml<br/>谁<br/>规则 · 权重 · 触发器"]
    content["lang/*.yml<br/>什么<br/>本地化 MiniMessage 通知"]
    minecraft["Minecraft<br/>玩家输出"]
    discord["discordWebhook.yml<br/>可选镜像"]

    schedule --> audience --> content --> minecraft
    content -. "聊天文本" .-> discord

    classDef config fill:#11182d,stroke:#8b7cf6,color:#eef0ff,stroke-width:1px;
    classDef output fill:#0d2028,stroke:#45d7e8,color:#ecfeff,stroke-width:1px;
    class schedule,audience,content config;
    class minecraft,discord output;

📥 获取 AutoMessage

[!IMPORTANT] 发布状态： 此 README 记录的是本地多平台分支。当前的公开列表仍代表较早的专注于 Bukkit 的发布线。在新的 GitHub 发布版公布全部六个构建物之前，请使用 ./gradlew dist 构建多平台 jar。

🚀 快速开始

1. 获取为你的运行时构建的构建物。平台 jar 有意分开。
2. 将其放入你平台的 plugins/ 或 mods/ 目录。对于 Minestom，将 jar 添加到应用程序类路径，并使用下方所示的构建器。
3. 启动服务器一次。AutoMessage 会生成带注释的配置以及可用的示例公告。
4. 编辑 config.yml、scheduledMessages.yml 和 lang/ 内的文件。
5. 运行 /automessage reload，然后使用 /automessage view <name> 测试一条消息。

[!TIP] 从生成的文件开始。它们不是空模板：每个可用字段都在可用示例旁进行了解释，且内容会适应创建它们的平台。

🛠 创建你的第一条公告

以下示例创建一个独立的事件流，向其中添加一条公告，并从单个本地化负载渲染多种通知类型。

1. 调度流

# config.yml
enabled: true
fallbackLanguage: en

channels:
  - name: default
    enabled: true
    initialDelay: 1m
    period: 5m
    selector: SHUFFLE

  - name: events
    enabled: true
    initialDelay: 30s
    period: 15m
    selector: SEQUENTIAL

2. 注册公告

# scheduledMessages.yml
messages:
  - name: event-night
    channel: events

3. 设计玩家接收的内容

# lang/en.yml
announcements:
  event-night:
    - chat:
        - "<dark_gray>[<gold>活动<dark_gray>] <gray>竞技场将在 <gold>5 分钟<gray>后开放。"
        - "<gray>点击 <click:run_command:'/warp arena'><hover:show_text:'<yellow>传送'><aqua><u>此处</u></aqua></hover></click> 加入。"
      actionbar: "<yellow>准备好你的装备——活动即将开始"
      title: "<gradient:#ffd166:#ff6b6b><bold>活动之夜</bold></gradient>"
      subtitle: "<gray>竞技场将在 05:00 开放"
      times: "500ms 3s 500ms"
      bossbar:
        message: "<light_purple>活动倒计时"
        duration: 10s
        color: PURPLE
        overlay: PROGRESS
        progress: 0.75
      sound: "block.note_block.pling MASTER 1.0 1.0"

仅使用适合消息的部分。简单的聊天公告可以是一个字符串；展示型公告可以组合上述所有表面。

📖 参考文档

channels:
  - name: tips
    enabled: true
    initialDelay: 1m
    period: 5m
    selector: SHUFFLE

  - name: promotions
    enabled: true
    initialDelay: 2m
    period: 20m
    selector: WEIGHTED

messages:
  - name: vip-event
    channel: events
    rules:
      - type: ANY_OF
        rules:
          - type: PERMISSION
            permission: rank.vip
          - type: PERMISSION
            permission: rank.staff
      - type: PLAYER_COUNT
        min: 10
        max: 100

messages:
  - name: welcome-back
    trigger:
      type: JOIN
      delay: 3s

  - name: first-join-welcome
    trigger:
      type: FIRST_JOIN
      delay: 3s

  - name: one-hundred-online
    trigger:
      type: PLAYER_COUNT
      threshold: 100

命令与权限

MinecraftServer.init();

AutoMessageMinestom autoMessage = AutoMessageMinestom.builder()
        .dataDirectory(Path.of("automessage"))
        .permissions((sender, node) -> myPermissions.check(sender, node)) // 可选
        .enable();

// 在你的服务器关闭期间：
autoMessage.shutdown();

🔨 从源码构建

构建所有运行时需要 JDK 25。从仓库根目录运行：

./gradlew dist

该任务运行所有检查，构建每个平台特定的 jar，并将六个可安装构建物同步到 build/dist：

• Bukkit
• Folia
• Sponge
• Velocity
• Fabric
• Minestom

若任何验证失败，则不会生成分发包。普通的 ./gradlew build 执行相同的项目检查，但将构建物保留在各自的模块内。

💛 支持本项目

AutoMessage 是免费、开源且独立维护的。

请在所有社区空间中遵循项目的 行为准则。 AutoMessage 根据 GNU 通用公共许可证 v3.0 分发。

如果 AutoMessage 让你的服务器沟通更好，请给仓库点个星。
这有助于其他服务器所有者发现本项目。