VitalStrike
VitalStrike 让 Paper 服务器上的战斗更易于阅读且更具回报感。命中时会显示浮动伤害数字,怪物和玩家头顶会出现生命条,连续命中会构建带有等级和伤害加成的连击系统。击杀可获得 RPG 风格的经验和等级。致命伤害会将玩家击倒而非直接杀死,队友可以将其复活。
所有功能均可在 config.yml 中关闭或重新设置样式。
功能
- 伤害数字: 每次命中显示浮动文字,根据伤害类型进行样式化,快速命中时合并显示,治疗为绿色。
- 生命条: 在你击中或治疗的任何目标上方显示当前和最大生命值。
- 连击系统: 连续命中可获得 D 到 SSS 的等级、伤害加成以及 streak 全息图。
- 击杀与等级: 击杀时显示“SLAIN”标记,经验值基于受害者的最大生命值计算,并保存等级进度。
- 击倒机制: 致命伤害会使玩家倒地,队友可以将其复活。
- 奖励: 在累计伤害里程碑处获得物品和经验值。
- 统计数据和排行榜: 记录伤害、命中次数、最佳连击、击杀数和等级。
- 世界控制: 可按世界或维度禁用,并按维度缩放伤害。
- 轻量级服务端: 仅显示实体,共用一个任务,崩溃后不留残留数据。
所有内容均可配置,并可在 config.yml 中关闭。按组的伤害样式通过权限设置。
要求
- Java 25 或更高版本
- Paper 26.1 或更高版本,或 Paper 分支。不支持 Spigot 和 Bukkit。
安装
- 从 Releases 页面 下载最新的 JAR 文件。
- 将其放入服务器的
plugins文件夹中。 - 启动服务器。这将创建
plugins/VitalStrike/config.yml。 - 编辑配置文件,然后运行
/vs reload。
命令
命令为 /vitalstrike,简写为 /vs。短名称包括:top、holo、give、pack。旧名称(leaderboard、hologram、vitalawakening、resourcepack、lb、va、rp)仍然有效。
| Command | Permission | What it does |
|---|---|---|
/vs help [section] |
vitalstrike.use |
显示帮助菜单。 |
/vs toggle [on/off] |
vitalstrike.toggle |
开启或关闭你自己的指示器。 |
/vs holo [on/off] |
vitalstrike.hologram |
开启或关闭你的连击全息图。 |
/vs stats [player] |
vitalstrike.stats |
显示等级、击杀数和战斗统计数据。 |
/vs top [type] |
vitalstrike.leaderboard |
显示 damage、combo 或 average 排行榜。 |
/vs pack |
vitalstrike.resourcepack |
加载可选的资源包。 |
/vs reload |
vitalstrike.reload |
重新加载配置并清除浮动文字。 |
/vs clear |
vitalstrike.clear |
移除所有浮动文字,包括散落的文字。 |
/vs revive <player> |
vitalstrike.revive |
复活倒地的玩家。 |
/vs give [n] [p] |
vitalstrike.give |
给予 Vital Awakening 物品。 |
/vs perm <action> <player> |
vitalstrike.admin.permissions |
管理存储的组权限。 |
/vs config [apply <code>] |
vitalstrike.admin.config |
在你的浏览器中编辑配置(Web 编辑器)。 |
管理员权限(reload、clear、give、revive、admin.permissions)默认赋予操作员。vitalstrike.admin 授予所有这些权限。
要给予玩家来自 group-damage-formats 的伤害样式,请授予 vitalstrike.group.<name>。
配置
所有内容都位于 plugins/VitalStrike/config.yml 中,该文件包含注释。主要部分如下:
| Section | Controls |
|---|---|
display |
伤害数字持续时间、位置、动画和合并方式。 |
simple-damage-formats |
每种伤害类型的文本。 |
group-damage-formats |
不同权限组的样式。 |
damage-type-sounds |
每种伤害类型播放的声音。 |
health-bar |
生命条长度、高度、持续时间和文本。 |
combo |
重置时间、衰减、伤害乘数、等级、全息图。 |
kill-indicator and levels |
击杀标记文本、经验速率、等级曲线和升级效果。 |
knockdown-system |
倒地时间、倒地生命值、复活时间和消息。 |
rewards |
伤害里程碑及其奖励内容。 |
world-settings |
禁用的世界和按维度缩放的伤害。 |
文本使用 MiniMessage,同时也支持 & 颜色代码。
从源代码构建
你不需要安装 JDK。Gradle Wrapper 会自动为你下载 Java 25。
git clone https://github.com/Stawa/VitalStrike.git
cd VitalStrike
./gradlew build
生成的 JAR 文件位于 build/libs/ 目录下。scripts/ 目录中的脚本执行相同的构建操作并输出 JAR 文件名:Linux 和 macOS 上使用 scripts/build.sh,Windows 上使用 scripts/build.bat。
支持
VitalStrike 由单人维护,因此回复可能较慢,但欢迎提交错误报告和建议。
- 错误与功能请求:GitHub Issues
- 问题与聊天:Discord
- 支持开发:Buy Me a Coffee
许可证
GNU General Public License v3.0。详见 LICENSE。
VitalStrike
VitalStrike makes combat on a Paper server easier to read and more rewarding. Hits show floating damage numbers, mobs and players get a health bar, and chaining hits builds a combo with ranks and a damage bonus. Kills earn RPG-style XP and levels. Lethal damage knocks a player down instead of killing them, and a teammate can revive them.
Every feature can be turned off or restyled in config.yml.
Features
- Damage numbers: floating text per hit, styled by damage type, merged on rapid hits, green for heals.
- Health bars: current and max health above anything you hit or heal.
- Combos: chain hits for ranks D to SSS, a damage bonus, and a streak hologram.
- Kills and levels: a "SLAIN" marker on kills, XP from the victim's max health, saved levels.
- Knockdown: lethal damage downs a player, and teammates can revive them.
- Rewards: items and XP at lifetime-damage milestones.
- Stats and leaderboards: damage, hits, best combo, kills and level.
- World control: disable per world or dimension, and scale damage per dimension.
- Light on the server: display entities, one shared task, nothing left behind after a crash.
Everything is configurable and can be switched off in config.yml. Per-group damage styles are set with permissions.
Requirements
- Java 25 or newer
- Paper 26.1 or newer, or a Paper fork. Spigot and Bukkit are not supported.
Installation
- Download the latest JAR from the Releases page.
- Put it in your server's
pluginsfolder. - Start the server. This creates
plugins/VitalStrike/config.yml. - Edit the config, then run
/vs reload.
Commands
The command is /vitalstrike, or /vs for short. Short names: top, holo, give, pack. The older names (leaderboard, hologram, vitalawakening, resourcepack, lb, va, rp) still work.
| Command | Permission | What it does |
|---|---|---|
/vs help [section] |
vitalstrike.use |
Shows the help menu. |
/vs toggle [on/off] |
vitalstrike.toggle |
Turns your own indicators on or off. |
/vs holo [on/off] |
vitalstrike.hologram |
Turns your combo hologram on or off. |
/vs stats [player] |
vitalstrike.stats |
Shows level, kills and combat stats. |
/vs top [type] |
vitalstrike.leaderboard |
Shows the damage, combo or average top. |
/vs pack |
vitalstrike.resourcepack |
Loads the optional resource pack. |
/vs reload |
vitalstrike.reload |
Reloads the config and clears floating text. |
/vs clear |
vitalstrike.clear |
Removes all floating text, including strays. |
/vs revive <player> |
vitalstrike.revive |
Revives a downed player. |
/vs give [n] [p] |
vitalstrike.give |
Gives Vital Awakening items. |
/vs perm <action> <player> |
vitalstrike.admin.permissions |
Manages stored group permissions. |
/vs config [apply <code>] |
vitalstrike.admin.config |
Edits the config in your browser (web editor). |
Admin permissions (reload, clear, give, revive, admin.permissions) default to operators. vitalstrike.admin grants all of them.
To give a player a damage style from group-damage-formats, grant vitalstrike.group.<name>.
Configuration
Everything lives in plugins/VitalStrike/config.yml, and the file is commented. The main sections are:
| Section | Controls |
|---|---|
display |
Damage number duration, position, animation and merging. |
simple-damage-formats |
Text for each damage type. |
group-damage-formats |
Different styles per permission group. |
damage-type-sounds |
Sound played for each damage type. |
health-bar |
Bar length, height, duration and text. |
combo |
Reset time, decay, damage multipliers, ranks, hologram. |
kill-indicator and levels |
Kill marker text, XP rate, level curve and level-up effects. |
knockdown-system |
Down time, downed health, revive time and messages. |
rewards |
Damage milestones and what they pay. |
world-settings |
Disabled worlds and per-dimension damage scaling. |
Text uses MiniMessage, and & color codes also work.
More guides: website and JavaDoc.
Building from source
You don't need a JDK installed. The Gradle wrapper downloads Java 25 for you.
git clone https://github.com/Stawa/VitalStrike.git
cd VitalStrike
./gradlew build
The JAR ends up in build/libs/. The scripts in scripts/ do the same build and print the JAR name: scripts/build.sh on Linux and macOS, scripts/build.bat on Windows.
Support
VitalStrike is maintained by one person, so replies can take a while, but bug reports and ideas are welcome.
- Bugs and feature requests: GitHub Issues
- Questions and chat: Discord
- Support development: Buy Me a Coffee
License
GNU General Public License v3.0. See LICENSE.
下载 VitalStrike
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VitalStrike
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VitalStrike
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VitalStrike
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VitalStrike
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VitalStrike
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VitalStrike
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[2.0.0] - 2026-11-02
平台更新,新增网页配置编辑器及广泛修复。需要 Paper 26.1+ 和 Java 25。
Breaking changes
- 需要 Paper 26.1+ 和 Java 25。运行在 1.21.x 的服务端应停留在 1.4.0。
- 移除了 WorldGuard 依赖项以及
respect-worldguard-pvp选项。 - 奖励变为一次性里程碑,不再可重复刷取(见 Changed)。
knockdown-system.vital-awakening.item-model被替换为custom-model-data。现有的 Vital Awakening 物品会自动迁移。- 以前会被静默忽略的配置路径现在生效(见 Fixed):自定义伤害格式、合并设置、连击全息图设置以及声音音量/音调。升级后请检查这些配置。
- 规范的命令名称现在是
give、pack、top和holo。旧名称和快捷方式仍然有效。
Changed
- 基于 Paper API 26.3 构建,使用 Java 25;Gradle 9.8;CI 动作已更新。
- 命中现在以
MONITOR优先级计数,因此被其他插件取消的伤害(WorldGuard PvP 标志、出生点保护)不再产生连击、统计、指示器或奖励。WorldGuard 依赖项和respect-worldguard-pvp选项已移除。 - 奖励变为一次性终身伤害里程碑(以前每次合并窗口都可重复刷取)。
- 连击衰减现在正常工作:启用衰减后,经过
reset-time时间后连击不会硬重置。 - 倒地玩家通过事件锁固定在原地,而不是使用
setInvulnerable,并且效果会以短暂持续时间刷新,因此在崩溃或重启后不会有残留效果。 /vs reload时重新读取所有设置(倒地系统和连击值以前需要重启才能生效)。- 命令整合到一个类中;
/vs perm现在仅管理存储的组授予,并支持离线玩家。 - 资源包在主线程之外进行哈希处理,其 URL 可配置(
resource-pack.url)。 - 资源包哈希每 10 分钟刷新一次,并在加载失败后刷新,因此重新发布的资源包不会再因过时的 SHA-1 而在下次重启前失败。
- VitalAwakening 资源包现在声明了 46-97 种格式(1.21.4 到 26.3),其 CI 构建可重现且经过验证的 zip 文件。
Added
/vs config网页编辑器:在浏览器中编辑配置,然后执行/vs config apply <code>。通过 VitalStrike 网站上的中继运行(web-editor配置部分)。- 循环奖励层级:
rewards.loop.enabled会在最后一个层级之后重复这些层级,每圈需要额外的rewards.loop.cycle-damage伤害(默认值:最后一个层级的伤害)。 - 按世界设置:
world-settings.worlds允许你为任何世界(按名称)提供独立的开关和伤害乘数。它们优先于维度设置。 - 网页编辑器直接编辑奖励层级(每个层级的伤害、XP 和物品)和自定义世界。
- 更短的命令:
/vs give、/vs pack、/vs top、/vs holo。旧名称仍然有效。 - 治疗指示器(
display.show-heals),使用现有的heal格式。 - 真实的暴击检测(
critical格式和声音以前是 20% 的概率判定)。 - 弓/三叉戟/其他投射物命中计入射手的连击、统计和按组格式。
/vs revive <player>、/vs stats [player]和/vs va [amount] [player]。- 倒地玩家爬行,无法攻击、放置、掉落、交互或行走,生物停止锁定他们。在被复活时,原本追击或攻击他们的生物会冷静下来(狼、蜜蜂和僵尸猪灵失去愤怒;其他生物失去目标)。
- 大型生物(末影龙、恶魂、劫掠兽、凋灵、大型史莱姆)身上的伤害数字出现在攻击者注视的一侧,并随生物大小缩放,而不是显示在其中心上方。
- 拥有
vitalstrike.update-notify权限的玩家会收到更新通知。 knockdown-system.vital-awakening.custom-model-data(替代item-model):物品标记了自定义模型数据,而不是自定义物品模型,因此没有资源包的玩家会看到正常的图腾,而不是缺失模型的方块。当持有者加入游戏、拾取或打开容器时,来自旧版本(旧模型或未标记)的图腾会自动迁移。
Fixed
- 从未匹配的配置路径:自定义伤害格式(
simple-damage-formats)、合并设置(display.merge)、连击全息图设置(combo.hologram)以及声音音量/音调被静默忽略。 - 指示器和乘数忽略了
disabled-worlds和维度enabled。 - 退出时会移除 32 格内的所有文本显示,包括其他插件的。现在指示器改为非持久化。
- 每个实体 500 毫秒的冷却时间导致本应合并的伤害被丢弃;其映射表也存在内存泄漏。
- 倒地状态在死亡(虚空、
/kill)后仍然存在,并在重生后保持“倒地”状态。 - 倒地的玩家仍可能陷入虚空的无限循环受伤;虚空/杀死/自杀现在始终生效。
- 复活时的退出处理在清除状态后查找状态;当开启
require-vital-awakening时,复活物品从未被消耗。 - 资源包:哈希是 Base64 而非十六进制,状态监听器从未注册,启动期间在主线程下载资源包,且退出时未重置加载状态。
- 更新检查器无法解析 GitHub 的 JSON,并将任何版本差异(包括 SNAPSHOT)视为更新。
- 统计信息仅在正常关闭时保存;现在每 5 分钟自动保存,并存储玩家姓名,这样排行榜不再跳过离线玩家。
- Vital Awakening 配方/实例被创建了三次;描述文本不再是斜体。
Removed
- 死代码:元素系统(无法设置)、按玩家样式、自定义异常层次结构、自定义日志记录器、WorldGuard 适配层、重复的配置缓存以及样板
package-info文件。
新增
- 支持多种伤害指示器格式:
- 简单伤害格式(默认)
- 基于权限系统的可自定义分组伤害格式
- 添加基于权限的伤害格式分组:
- 可在配置文件中定义自定义组格式
- 每个组可以拥有独特的伤害指示器
- 格式:
vitalstrike.group.<groupname>
更改
- 重构连击系统以提升性能
- 改进配置文件加载中的错误处理
- 增强伤害指示器格式的缓存机制
- 更新配置验证系统
修复
- 修复了插件禁用后连击系统仍处于活动状态的关键 bug
- 修复了插件禁用时连击计数器继续运行的问题
- 修复了伤害指示器的持久化问题
- 改进了对无效配置的异常处理
技术
- 优化代码结构与可维护性
- 增强错误处理系统
- 更新配置验证逻辑
- 优化伤害格式缓存系统
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧