Lightning ⚡
Lightning 让你能够自定义服务器中的各类消息,包括那些从未设计为支持 MiniMessage 的插件所发送的消息。无需修改各个独立的插件,即可添加渐变、十六进制颜色、悬停事件、点击操作、可复用占位符以及自定义命令。
通过简单的 YAML 配置定义可复用的文本样式、创建交互式消息并构建命令工作流。
与 Lightning 一起烹饪。
功能特性
通用 MiniMessage 支持
在来自几乎所有插件的消息中使用渐变、十六进制颜色、悬停事件和点击操作,即使是那些仅支持旧版颜色代码的插件也适用。
全服务器消息自定义
自定义聊天、动作栏、标题、Boss 条、标签页列表、计分板、菜单、物品、全息图、对话框、服务器列表消息,甚至包括封禁和踢出屏幕。
智能标签检测
Lightning 会处理包含受支持的 Lightning 标签的消息,同时保持普通文本不受影响。例如 /home <name> 这样的命令将保持原样。
Sparks:可复用的文本组件
创建用于前缀、配色方案、格式化占位符、动态值、轮播提示和本地化消息的自定义标签。只需定义一次,即可在整个服务器中重复使用。
Bolts:消息操作
超越单纯的格式设置,使用触发操作的标签,包括动作栏消息、标题、音效以及消息屏蔽。
玩家头像集成
使用 <face> 标签直接在受支持的文本组件中显示玩家自己的头像。
Rewires:覆盖现有消息
重新设计那些难以通过插件配置直接编辑的消息,包括原版服务器界面和硬编码的插件消息(在支持的情况下)。
自定义命令
使用 YAML 创建你自己的命令。配置权限、Tab 补全、键入参数、子命令、冷却时间、执行限制以及可配置的操作。
内置配置工具
追踪消息来源,识别插件配置中断裂的标签,并通过单次操作将旧版 & 颜色代码转换为 MiniMessage。
轻量且安全
玩家提供的文本保持为纯文本,不会被解释为格式指令。普通消息避免不必要的处理,有助于保持低开销。
配置示例
1. 在任何插件的配置中使用 MiniMessage
安装 Lightning 后,其他插件配置中受支持的消息可以使用 MiniMessage 格式。
welcome: "<gradient:#FFE259:#FFA751>Welcome back, %player_name%!</gradient>"
home-set: "<actionbar><green>Home set.<sound:entity.player.levelup>"
balance: "<spark:prefix> You have <spark:balance>"
2. 创建你自己的命令
直接在 YAML 中定义命令、参数、冷却时间、权限和操作。
report:
description: Report a player to staff
sender: player
cooldown: 1m
arguments:
- name: target
type: player
- name: reason
type: text
actions:
- "<spark:prefix> Thanks, staff will look into it."
- broadcast: "<red>Report</red> {player} reported {target}: {reason}"
permission: server.staff
这些示例展示了 Lightning 如何将格式设置、可复用组件和命令逻辑整合到一个由配置驱动的系统之中。
要求
- Paper 或 Folia,版本 1.21 或更高
- Java 21
- PlaceholderAPI(可选)
安装
- 下载 Lightning 并将 JAR 文件放入服务器的 plugins 文件夹。
- 重启服务器。
- 配置 Lightning 并开始自定义你的消息。
支持
需要 Lightning 的帮助吗?你可以加入 DenizenMC Discord 服务器 或查看 文档。
匿名统计
Lightning 通过 Arrow Stats(一个面向 Minecraft 软件的开源统计服务)收集匿名的服务器统计数据。
你可以通过编辑 plugins/Arrow Stats/config.yml 选择退出。
Lightning ⚡
Lightning lets you customize messages across your server, including messages from plugins that were never designed to support MiniMessage. Add gradients, hex colors, hover events, click actions, reusable placeholders, and custom commands without modifying individual plugins.
Define reusable text styles, create interactive messages, and build command workflows with simple YAML configuration.
Cook with Lightning.
Features
Universal MiniMessage Support
Use gradients, hex colors, hover events, and click actions in messages from virtually any plugin, including those limited to legacy color codes.
Server Wide Message Customization
Customize chat, action bars, titles, boss bars, tab lists, scoreboards, menus, items, holograms, dialogs, server list messages, and even ban and kick screens.
Smart Tag Detection
Lightning processes messages containing supported Lightning tags while leaving ordinary text untouched. Commands such as /home <name> remain intact.
Sparks: Reusable Text Components
Create your own tags for prefixes, color schemes, formatted placeholders, dynamic values, rotating tips, and localized messages. Define them once and reuse them throughout your server.
Bolts: Message Actions
Go beyond formatting with tags that trigger actions, including action bar messages, titles, sounds, and message suppression.
Player Head Integration
Use the <face> tag to display a player's own head directly in supported text components.
Rewires: Override Existing Messages
Restyle messages you cannot easily edit through a plugin's configuration, including vanilla server screens and hardcoded plugin messages where supported.
Custom Commands
Create your own commands using YAML. Configure permissions, tab completion, typed arguments, subcommands, cooldowns, execution limits, and configurable actions.
Built-in Configuration Tools
Trace messages back to their source, identify broken tags across plugin configurations, and convert legacy & color codes to MiniMessage with a single action.
Lightweight and Safe
Player supplied text remains plain text rather than being interpreted as formatting instructions. Ordinary messages avoid unnecessary processing, helping keep overhead low.
Configuration Examples
1. MiniMessage in Any Plugin's Configuration
With Lightning installed, supported messages in other plugins' configurations can use MiniMessage formatting.
welcome: "<gradient:#FFE259:#FFA751>Welcome back, %player_name%!</gradient>"
home-set: "<actionbar><green>Home set.<sound:entity.player.levelup>"
balance: "<spark:prefix> You have <spark:balance>"
2. Create Your Own Commands
Define commands, arguments, cooldowns, permissions, and actions directly in YAML.
report:
description: Report a player to staff
sender: player
cooldown: 1m
arguments:
- name: target
type: player
- name: reason
type: text
actions:
- "<spark:prefix> Thanks, staff will look into it."
- broadcast: "<red>Report</red> {player} reported {target}: {reason}"
permission: server.staff
These examples illustrate how Lightning brings formatting, reusable components, and command logic into one configuration driven system.
Requirements
- Paper or Folia, 1.21 or newer
- Java 21
- PlaceholderAPI (optional)
Installation
- Download Lightning and place the JAR in your server's plugins folder.
- Restart your server.
- Configure Lightning and start customizing your messages.
Support
Looking for help with Lightning? You can join the DenizenMC Discord Server or check out the documentation.
Anonymous Statistics
Lightning collects anonymous server statistics through Arrow Stats, an open source statistics service for Minecraft software.
You can opt out by editing plugins/Arrow Stats/config.yml.
下载 Lightning
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lightning
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lightning
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lightning
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lightning
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Lightning
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
支持 Paper 和 Folia 1.21 至 26.3。如果已安装,建议使用 PacketEvents 2.14.0 或更高版本。
- 新增:placeholder-tags 选项,占位符值默认仅用于显示
- 新增:充电对话框输入标签、服务器链接和项目描述
- 新增:时钟模式,如
<clock:HH:mm:ss>(无需引号) - 新增:当安装的 PacketEvents 版本过旧时发出警告
- 修复: bolts 被发射两次的问题
- 修复:重载后遗漏最近的冷却时间
- 修复:atomic 和 pruned 的 uses.yml 保存问题
- 修复:创造模式玩家重新获得未受影响的物品
- 修复:UTF-8 文件中遗留 stray  字符
- 修复:像 Gold 或 Bold 这样的玩家名称被误读为颜色标签
- 修复:通过 ViaVersion 断开与旧客户端的连接问题
- 修复:重命名后的 PacketEvents jar 包被下载两次的问题
- 修复:在 26.3 版本中跳过项目,直到 PacketEvents 2.15.0
- 安全:转义反斜杠标签技巧
- 安全:保护取消聊天、铁砧名称和重写消息
- 安全:半输入的标签不再阻塞真实链接
- 安全:项目和实体阻止点击、悬停和插入
- 安全:对非管理员隐藏 /lightning 命令
- 性能:在处理之前跳过没有标签的数据包
0.2.2-alpha.2
新增
- 在线玩家的踢出原因在
PlayerKickEvent中处理。控制台和服务端日志现在显示处理后的消息,而非原始标签。
修复
- 跨文本片段且样式相同的标签现可被正确解析。组件在序列化前会进行紧凑化处理。受影响的 EssentialsX 行(如余额排行榜总计)已修复。
安全
- Rewire 占位符会在插入捕获值之前,于配置的模板上完成解析。捕获的文本绝不会传递给 PlaceholderAPI。
- Rewire 值通过单次遍历填充。包含
{1}或{text}的已插入值不再展开。 - 正则表达式重写规则具有每条消息的工作量限制。超出限制的规则将被跳过并在调试模式下报告。
- 公式长度限制为 256 个字符,嵌套层级限制为 32 层。
- 在处理数据包期间发生的栈溢出和类加载错误不再导致玩家断开连接。
性能
- 替换与模式规则在重建组件前会先检查纯文本。
- 不含翻译内容的组件将跳过翻译器渲染。
0.2.2
修复
- fix(protocol):玩家现在可以在 Minecraft 26.1.2 上连接,而不会遇到过时的 PacketEvents 协议支持问题。
更改
- feat(dependencies):当可用时,使用已安装的 PacketEvents 插件。
- feat(dependencies):当未安装 PacketEvents 插件时,自动下载 PacketEvents 2.14.0。
文档:
0.2.1
新增功能
- feat(rewires):
replace和pattern规则会替换单词或整行,同时保留消息的其余部分及其颜色 - feat(rewires):通过针对
items使用lang规则来重命名原版物品,例如block.minecraft.sand - feat(inspect):
/lightning inspect <surface>命令现在适用于所有表面(标签页列表、物品、实体、对话框等……),每项文本仅报告一次 - feat(commands):
pick随机执行一个选项 - feat(commands):支持短参数形式,如
- target: player - feat(commands):添加
{world}和{uuid}占位符 - feat(config):添加
faces.shadow配置项以恢复面部阴影效果
修复内容
- fix(faces):修复了标签页列表中面部显示过暗且模糊的问题
- fix(rewires):
replace规则现在能够作用于作为翻译发送的原版文本 - fix(debug):日志现在记录因创造模式玩家而跳过的物品,以及每种对话框的类型
文档:
Lightning 0.2.0,全新重写。
Lightning 已从底层彻底重构。全新的代码、全新的配置以及一个更大的愿景:Lightning 不再仅仅添加命令,而是让服务器上的每一条消息都能按照你的意愿显示,即使是来自你无法修改的插件的消息也是如此。
这是一个测试版。如有任何异常,请在 support.denizenmc.com 报告。
新鲜出炉
- 为任何插件的文本充电。 在任何插件的配置中编写 MiniMessage,Lightning 会在玩家看到它之前将其生动呈现。无需前缀,无需钩子。
- 玩家阅读的所有地方。 聊天栏、动作栏、标题、Boss 条、标签页列表、计分板、菜单、物品、全息图、对话框、服务器列表以及踢出和封禁界面。
- 火花 (Sparks)。 你自己可复用的标签:颜色、前缀、公式、比例、旋转线条、随机选择以及每位玩家语言对应的行。
- 闪电 (Bolts)。 从文本内部将消息移动到动作栏或标题、播放声音或隐藏它。
- 玩家头像 支持
<face>,以及<center>、<clock>和小写字母(small caps)。 - 重布线 (Rewires)。 重新设计嵌入在插件或 Minecraft 本身的样式,包括封禁界面。
- 脉冲 (Pulse) 保持计分板和标签页列表中动画行的持续移动,即使它们本身不会刷新。
- 守卫 (Guard) 确保玩家输入的内容始终保持为纯文本,防止任何人将标签插入到你的消息中。
自定义命令,重塑归来
- 真实的 Brigadier 命令,支持自动补全和打字时的红色错误提示。
- 类型化参数、子命令、冷却时间、使用限制和每个命令专属的消息。
- 动作按从上到下的顺序读取:消息、控制台和玩家命令、广播、等待、检查和概率。
- 玩家输入始终是安全的。它不能变成标签、占位符或像
@a这样的选择器。
厨房工具
/lightning inspect显示任何消息的来源。/lightning check查找所有插件配置中损坏的标签。/lightning convert将旧的&代码转换为 MiniMessage,并生成备份。/lightning parse和/lightning debug用于测试和故障排除。
幕后机制
- 没有标签的文本在经过一次快速检查后会被跳过,任何对所有人读取相同的文本只准备一次。
- 全面支持 Folia。
- 更简洁的配置,使用简单的键名和平实的说明。
更新前须知
- Lightning 现在需要 Paper 或 Folia 1.21+ 以及 Java 21。不再支持 Spigot 和旧版本。
- 旧配置不会迁移。 命令使用了新的布局,因此请从新的
commands/examples.yml开始。 - 其他插件命令上的动作钩子暂时移除。 它们的大多数功能可以通过重布线 (rewires) 和闪电 (bolts) 更轻松实现。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。

评论 0
登录后参与评分
还没有评论,来抢沙发吧