⚡ PulseMsg
定时广播与广告插件 —— 支持可点击链接、十六进制颜色、优先级覆盖以及智能防刷屏机制。
? PulseMsg 是什么?
PulseMsg 是一款轻量但功能强大的广播插件,允许服务器管理员设置定时的广告消息,具备完整的颜色控制、可点击链接、悬停提示以及智能防刷屏机制,确保玩家不会受到垃圾信息的轰炸。
每条消息都有自己独立的计时器——不再有消息碰撞或同时溢出聊天栏的情况。
✨ 特性
| 特性 |
描述 |
| ⏱ 独立消息计时器 |
每条消息拥有自己的 interval-seconds(间隔秒数)——完全独立运行 |
| ? 可点击链接 |
打开网址、建议命令、执行命令或将文本复制到剪贴板 |
| ? 完整颜色支持 |
支持旧版 &x 代码 和 十六进制 &#RRGGBB 格式,适用于每一行 |
| ? 优先消息 |
将消息标记为 priority: true,使其即使与其他消息同时到达也能强制发送 |
| ? 防刷屏机制 |
每个调度刻(tick)最多只发送一条非优先消息——杜绝聊天刷屏 |
| ? 权限门控 |
仅向拥有特定权限节点的玩家发送指定消息 |
| ? 随机或顺序播放 |
按顺序发送消息,或通过 random-order: true 进行随机打乱 |
| ? 最小在线人数 |
当在线玩家少于 N 人时跳过广播 |
| ♻ 热重载 |
/pm reload 可在零服务器重启的情况下应用所有配置更改 |
? 命令
所有命令均需 pulsemsg.admin 权限(默认:OP)。
别名:/pulsemsg、/pm、/pulse
| 命令 |
描述 |
/pm reload |
重新加载配置并重启调度器 |
/pm list |
列出所有消息及其启用/禁用状态 |
/pm send <id> |
立即手动触发某条消息 |
/pm info <id> |
显示某条消息的详细信息及下次触发的倒计时 |
/pm toggle |
暂停或恢复所有广播 |
/pm help |
显示帮助菜单 |
? 权限
| 节点 |
默认值 |
描述 |
pulsemsg.admin |
OP |
完全访问所有 PulseMsg 命令 |
pulsemsg.bypass |
false |
该玩家将永远不会收到任何广播 |
⚙ 配置
PulseMsg 在首次运行时会自动生成一份带有完整文档的 config.yml。以下是一个示例片段:
global-interval-seconds: 60
global-prefix: 'ᛩf2&l[PulseMsg]&r '
random-order: false
minimum-players: 0
messages:
discord-ad:
enabled: true
title: 'ᱹda&l⚡ Join Our Discord ⚡'
body:
- '&7Stay connected with the community!'
- '&7Get support, updates, and giveaways.'
- ' '
- 'ᱹda&l&nJoin Now&r &7— discord.gg/example'
interval-seconds: 300
priority: true # 即使与其他消息同时到达也始终触发
prefix: 'ᱹda[Discord]&r ' # 覆盖全局前缀
click:
action: OPEN_URL
value: 'https://discord.gg/example'
hover: '&9Click to join our Discord!'
store-ad:
enabled: true
title: '&#f1c40f&l★ Support The Server ★'
body:
- '&7Ranks, cosmetics and more at our store!'
interval-seconds: 1200
priority: false
click:
action: OPEN_URL
value: 'https://store.example.com'
hover: '&eClick to open the store!'
点击动作
| 动作 |
效果 |
OPEN_URL |
在玩家的浏览器中打开一个网址 |
SUGGEST_CMD |
将文本放入玩家的聊天输入框中 |
RUN_CMD |
以玩家身份执行一条命令 |
COPY_TEXT |
将文本复制到玩家的剪贴板 |
调度工作原理
PulseMsg 每 global-interval-seconds 刻进行一次调度。每次调度时,它会独立倒数每条消息各自的计时器。当某条消息到期时:
- 优先消息 始终会触发——即使同一刻有其他消息也到期。
- 非优先消息 受防刷屏机制保护——每个调度刻仅允许 一条 触发。如果多条同时到期,其余消息将等待其下一个自然间隔。
? 要求
- Minecraft: 1.20+
- 服务端: Spigot 或 Paper
- Java: 17 或更高版本
由 rradajbi 精心制作 —— 如有 Bug 或功能建议,请在 GitHub 上提交 Issue。
⚡ PulseMsg
Timed broadcast & advertisement plugin — clickable links, hex colors, priority overrides, and a smart flood guard.
? What is PulseMsg?
PulseMsg is a lightweight but powerful broadcast plugin that lets server owners schedule timed advertisement messages with full color control, clickable links, hover tooltips, and a smart flood guard so players never get spammed.
Each message runs on its own independent timer — no more messages colliding or overflowing chat at the same time.
✨ Features
| Feature |
Description |
| ⏱ Per-message timers |
Each message has its own interval-seconds — completely independent |
| ? Clickable links |
Open URLs, suggest commands, run commands, or copy text to clipboard |
| ? Full color support |
Legacy &x codes and hex &#RRGGBB both supported on every line |
| ? Priority messages |
Mark a message as priority: true to always fire, even alongside others |
| ? Flood guard |
At most one non-priority message per scheduler tick — no chat spam |
| ? Permission gating |
Send specific messages only to players with a given permission node |
| ? Random or sequential |
Send messages in order or shuffle them with random-order: true |
| ? Minimum players |
Skip broadcasts when fewer than N players are online |
| ♻ Hot reload |
/pm reload applies all config changes with zero server restart |
? Commands
All commands require the pulsemsg.admin permission (default: OP).
Aliases: /pulsemsg, /pm, /pulse
| Command |
Description |
/pm reload |
Reload config and restart the scheduler |
/pm list |
List all messages with enabled/disabled status |
/pm send <id> |
Manually fire a message immediately |
/pm info <id> |
Show details and next-fire countdown for a message |
/pm toggle |
Pause or resume all broadcasts |
/pm help |
Show the help menu |
? Permissions
| Node |
Default |
Description |
pulsemsg.admin |
OP |
Full access to all PulseMsg commands |
pulsemsg.bypass |
false |
Player will never receive any broadcasts |
⚙ Configuration
PulseMsg generates a fully documented config.yml on first run. Here's a taste:
global-interval-seconds: 60
global-prefix: 'ᛩf2&l[PulseMsg]&r '
random-order: false
minimum-players: 0
messages:
discord-ad:
enabled: true
title: 'ᱹda&l⚡ Join Our Discord ⚡'
body:
- '&7Stay connected with the community!'
- '&7Get support, updates, and giveaways.'
- ' '
- 'ᱹda&l&nJoin Now&r &7— discord.gg/example'
interval-seconds: 300
priority: true # always fires even alongside other messages
prefix: 'ᱹda[Discord]&r ' # overrides the global prefix
click:
action: OPEN_URL
value: 'https://discord.gg/example'
hover: '&9Click to join our Discord!'
store-ad:
enabled: true
title: '&#f1c40f&l★ Support The Server ★'
body:
- '&7Ranks, cosmetics and more at our store!'
interval-seconds: 1200
priority: false
click:
action: OPEN_URL
value: 'https://store.example.com'
hover: '&eClick to open the store!'
Click actions
| Action |
Effect |
OPEN_URL |
Opens a URL in the player's browser |
SUGGEST_CMD |
Puts text into the player's chat box |
RUN_CMD |
Runs a command as the player |
COPY_TEXT |
Copies text to the player's clipboard |
How scheduling works
PulseMsg ticks every global-interval-seconds. Each tick it counts down every message's own timer independently. When a message is due:
- Priority messages always fire — even if another message is also due that tick.
- Non-priority messages are flood-guarded — only one fires per tick. If multiple are due simultaneously, the others simply wait for their next natural interval.
? Requirements
- Minecraft: 1.20+
- Server: Spigot or Paper
- Java: 17 or newer
Made with care by rradajbi — open an issue on GitHub for bugs or feature requests.
评论 0
登录后参与评分
还没有评论,来抢沙发吧