** UltimateSouls - 完整文档包
? 插件说明
概述
UltimateSouls 是一款高品质的、功能丰富的 Minecraft Paper 插件,引入了革命性的基于灵魂(Soul)的武器成长系统。将普通武器转化为具有生命力的实体,随着每次击杀变得更强,解锁毁灭性的能力,并最终觉醒为拥有独特力量的传奇神器。
核心概念
在 UltimateSouls 中,每一次击杀都至关重要。当你使用兼容的武器消灭敌人时,他们的灵魂会被吸收进你的剑刃。每个灵魂都会增加武器的威力,但同时也伴随着可怕的代价——诅咒随之增强。你的武器会变得越来越不稳定,以惊人的速度消耗耐久度,阻止经验修补(Mending),并让你遭受腐化效果的影响。
这创造了一种引人入胜的 风险与回报 动态:
- 更多灵魂 = 更多力量(增加伤害、能力和传奇潜力)
- 更多灵魂 = 更多风险(更快破碎、腐化效果、不稳定性)
玩家必须在对力量的渴望与他们心爱武器可能在手中碎裂的真实可能性之间取得平衡。
目标受众
- PvP 服务器:非常适合阵营、KitPvP 和生存 PvP 服务器
- 生存服务器:为 PvE 体验增添深度
- RPG 服务器:无缝集成 RPG 风格的游戏玩法
- 竞技服务器:排行榜和赏金系统推动竞争
✨ 功能摘要
核心功能
| 功能 |
描述 |
可配置 |
| 灵魂收集 |
从击杀中将灵魂吸收到武器中 |
✅ |
| 伤害缩放 |
每个灵魂增加攻击伤害 |
✅ |
| 诅咒系统 |
灵魂增加耐久度消耗 |
✅ |
| 经验修补限制 |
高灵魂数量会阻止经验修补附魔 |
✅ |
| 武器支持 |
剑、斧、三叉戟、重锤 |
✅ |
| 单武器配置 |
不同武器类型设置不同的参数 |
✅ |
扩展功能(全部可切换)
| 功能 |
描述 |
默认值 |
| 灵魂层级 |
在灵魂里程碑处解锁能力 |
启用 |
| 灵魂衰减 |
没有击杀时武器会逐渐失去灵魂 |
启用 |
| 灵魂低语 |
武器向玩家“说话” |
启用 |
| 灵魂破碎 |
武器爆炸性破碎并散射灵魂 |
启用 |
| 腐化效果 |
高灵魂数量下的负面效果 |
启用 |
| 灵魂不稳定性 |
武器随机失控攻击 |
启用 |
| 赏金系统 |
高灵魂玩家成为被追杀的目标 |
启用 |
| 灵魂窃取 |
从被杀玩家身上窃取灵魂 |
启用 |
| 复仇印记 |
对杀死你的人造成额外伤害 |
启用 |
| 宿敌系统 |
对重复受害者造成额外伤害 |
启用 |
| 诅咒视觉效果 |
武器上的粒子效果和特效 |
启用 |
| 动态命名 |
武器名称随灵魂数量变化 |
启用 |
| 击杀公告 |
广播里程碑成就 |
启用 |
| 灵魂提取 |
将灵魂提取到物品中 |
启用 |
| 灵魂灌注 |
在武器间转移灵魂 |
启用 |
| 净化祭坛 |
移除诅咒,保留部分力量 |
启用 |
| 击杀连击 |
连续击杀以获得倍数加成 |
启用 |
| 灵魂类型 |
不同生物给予不同的加成 |
启用 |
| 传奇觉醒 |
转变为独特的传奇形态 |
启用 |
| 灵魂共鸣 |
附近的灵魂武器相互交互 |
启用 |
| 排行榜 |
竞技排名 |
启用 |
技术功能
| 功能 |
描述 |
| PDC 存储 |
数据存储在物品上(无需数据库) |
| SQLite/MySQL |
可选数据库用于统计数据和排行榜 |
| 完整 API |
带有自定义事件的开发者 API |
| PlaceholderAPI |
完整的占位符支持 |
| Vault 集成 |
经济支持功能 |
| WorldGuard |
区域保护兼容性 |
| 异步操作 |
数据库操作是异步的 |
| 性能优化 |
高效的事件处理 |
? 详细功能文档
- 灵魂收集系统
工作原理
当你手持有效的灵魂武器击杀实体时,你有几率吸收其灵魂。灵魂将永久绑定到该武器上,直到被提取或丢失。
配置选项
souls:
max-souls: 100 每把武器最大灵魂数
damage-per-soul: 0.5 每个灵魂增加的伤害
player-kills-only: false 仅计算玩家击杀
require-pvp: false 需要开启 PvP
blocked-gamemodes: 无法获取灵魂的生存模式
- CREATIVE
- SPECTATOR
灵魂获取公式
基础灵魂 = 1 (每次击杀)
连击倍率 = 可变 (1.0x - 3.0x)
赏金倍率 = 2.0x (如果目标是赏金状态)
赏金奖励 = +5 (击杀赏金目标的固定奖励)
窃取灵魂 = 受害者武器灵魂的 25%
总灵魂数 = (基础 × 连击 × 赏金) + 赏金奖励 + 窃取
- 诅咒系统(耐久度惩罚)
工作原理
你武器上的每个灵魂都会增加耐久度消耗。在高灵魂数量下,你的武器会以极快的速度破碎。
耐久度公式
损失耐久度 = 基础伤害 × (1 + (灵魂数 × 倍率))
例如,拥有 50 个灵魂且倍率为 0.15:
损失耐久度 = 1 × (1 + (50 × 0.15)) = 正常速度的 8.5 倍
配置选项
curse:
enabled: true
durability-multiplier-per-soul: 0.15
instant-break-at-max: true
替代方案:自定义阈值
custom-durability:
enabled: false
thresholds:
10: 2 10 个灵魂时 2 倍
25: 4 25 个灵魂时 4 倍
50: 8 50 个灵魂时 8 倍
100: 9999 立即破碎
- 经验修补限制
工作原理
在可配置的灵魂阈值下,经验修补附魔将停止工作。诅咒过于强大,经验修补无法修复。
选项
- BLOCK:经验修补停止工作但仍保留在物品上
- REMOVE:强制从物品上移除经验修补
配置
mending:
enabled: true
disable-threshold: 25 阻止修补所需的灵魂数量
action: "BLOCK" "BLOCK"(阻止)或 "REMOVE"(移除)
prevent-application: true 防止通过铁砧添加修补魔咒
- 灵魂层级与能力
层级进阶
| 层级 |
所需灵魂数 |
名称 |
能力 |
| 1 |
10 |
觉醒 (Awakened) |
生命窃取(回复 15% 伤害量) |
| 2 |
25 |
赋能 (Empowered) |
击杀后获得速度 II(持续 5 秒) |
| 3 |
50 |
飞升 (Ascended) |
击杀时造成范围伤害(4 点伤害,3.5 半径) |
| 4 |
100 |
传说 (LEGENDARY) |
20% 几率召唤闪电 |
能力详情
生命窃取(第 1 层)
- 根据造成伤害的百分比治疗玩家
- 每次命中均生效
- 可配置的百分比
击杀加速(第 2 层)
- 击杀后赋予速度药水效果
- 可配置等级和持续时间
- 刷新持续时间以叠加效果
范围伤害(第 3 层)
- 击杀时对附近敌人造成伤害
- 产生粒子爆炸效果
- 可配置范围和伤害值
闪电打击(第 4 层)
- 命中时有几率召唤闪电
- 可造成真实伤害或仅显示视觉效果
- 可配置触发几率
- 灵魂衰变
工作原理
武器会“渴望”灵魂。如果你不通过击杀来喂养它们,它们会随时间流失灵魂。
配置
soul-decay:
enabled: true
check-interval: 60 每 60 分钟检查一次
decay-amount: 1 每次检查流失 1 个灵魂
only-while-online: true 仅在持有该武器的玩家在线时衰变
decay-threshold: 5 灵魂数低于 5 时不再衰变
grace-period: 120 最后一次击杀后的 2 小时宽限期
防止衰变
- 定期击杀敌人以重置计时器
- 拥有
ultimatesouls.bypass.decay 权限的玩家永远不会衰变
- 灵魂数低于阈值的武器不会衰变
- 灵魂低语
工作原理
你的武器会发展出个性!它会根据当前拥有的灵魂数量向你发送消息。
消息示例
| 灵魂数量 |
示例消息 |
| 5+ |
“我渴望更多……”,“喂饱我……” |
| 10+ |
“我们正变得更强……” |
| 25+ |
“他们的尖叫声滋养着我……”,“我尝到了他们的恐惧……” |
| 50+ |
“我们即将合二为一……”,“你的手,我的刃……” |
| 75+ |
“鲜血。灵魂。力量。” |
| 100+ |
“我是永恒的”,“他们终将陨落” |
击杀低语
有 50% 的几率在击杀时收到如下消息:
- “对……没错!”
- “又一个祭品……”
- “他们的灵魂是我的!”
- 灵魂碎裂
工作原理
当高灵魂数的武器损坏时,它不会安静地消失,而是会爆炸!
碎裂效果
- 爆炸:在武器位置产生视觉爆炸
- 持握者受伤:玩家受到伤害(可配置)
- 灵魂散落:灵魂掉落为可收集的碎片
- 附近警报:附近的玩家会看到一条消息
灵魂碎片
- 以发光物品的形式掉落
- 任何人都可以拾取
- 用于灵魂融合系统
- 经过可配置的时间后会消失
- 腐化效果
效果进阶
| 效果 |
所需灵魂数 |
描述 |
| 饥饿流失 |
25 |
缓慢失去食物饱和度 |
| 失明闪烁 |
50 |
短暂的失明时刻 |
| 凋零光环 |
75 |
周围环绕烟雾粒子 |
| 灵魂之声 |
100 |
诡异的环境音效 |
| 缓慢 |
150 |
持续的缓慢效果 |
| 恶心 |
200 |
随机出现的恶心症状 |
豁免
拥有 ultimatesouls.bypass.corruption 权限的玩家免疫此效果。
- 灵魂不稳定
工作原理
当灵魂数达到 50+ 时,武器会变得不稳定。每次攻击都有几率对持握者“反击”。
反击效果
- 伤害:玩家受到 3 点伤害
- 闪电:产生闪电视觉效果
- 粒子:灵魂火焰爆发
- 声音:雷鸣般的爆裂声
几率计算
几率 = 基础值 (2%) + (灵魂数 × 0.1%)
50 个灵魂时:2% + 5% = 7%
100 个灵魂时:2% + 10% = 12%
- 赏金系统
工作原理
持有拥有 30+ 灵魂的武器的玩家会成为“赏金目标”。其他玩家会受到通知,并在猎杀他们时获得奖励。
功能
- 公告:当某人成为赏金目标时,全服广播
- 发光效果:赏金目标呈现红色发光
- 粒子轨迹:火焰粒子跟随赏金目标
- 奖励:击杀赏金目标可获得 2 倍灵魂 + 5 点额外奖励
指南针追踪
玩家可以使用指南针追踪最近的赏金目标(可选功能)。
- 灵魂窃取
工作原理
当你击杀一名装备了灵魂武器的玩家时,你会窃取他们的一部分灵魂!
配置
soul-stealing:
enabled: true
steal-percentage: 0.25 窃取其 25% 的灵魂
minimum-victim-souls: 5 受害者至少需要拥有 5 个灵魂
max-steal-per-kill: 10 每次击杀最多窃取 10 个灵魂
require-weapon-equipped: true 受害者必须手持武器
- 复仇印记系统
工作原理
被某人击杀后,你会获得一个“复仇印记”,从而对该目标造成额外伤害。
功能
- 伤害加成:对击杀者造成 +20% 的伤害
- 持续时间:30 分钟
- 叠加:最多叠加 3 层(叠加后总增伤达 +30%)
- 满足感:当你成功复仇时会收到特殊消息
- 宿敌系统
工作原理
你的武器会记住受害者。反复击杀同一名玩家可获得递增的伤害加成!
伤害缩放
加成 = 击杀数 × 5%(上限 50%)
击杀数 1:+5%
击杀数 5:+25%
击杀数 10+:+50%(最大值)
背景故事显示
武器会在背景故事中显示“血誓之敌”及其击杀计数。
- 诅咒视觉效果
效果进阶
| 灵魂数 |
效果 |
| 10 |
红色尘埃粒子 |
| 25 |
火焰粒子,发光效果 |
| 50 |
灵魂火焰,附魔光泽 |
| 75 |
灵魂粒子,烟雾,玩家光环 |
| 100 |
强烈的粒子效果,闪电噼啪声 |
- 动态武器命名
命名进阶
| 灵魂数 |
名称格式 |
| 0 |
原始名称 |
| 10 |
染血的 {name} |
| 25 |
深红的 {name} |
| 50 |
灵魂绑定 {name} |
| 75 |
杀戮者{name} |
| 100 |
噬魂者 |
| 150+ |
随机传奇名称 |
传奇名称池
- Eternal Reaper
- Voidbringer
- Bloodmoon's Edge
- Shadowfang
- Damnation
- Soulrender
- Oblivion
- 击杀公告
里程碑广播
| 灵魂数 |
公告内容 |
效果 |
| 10 |
"{player} 的武器已夺去第 10 名受害者!" |
广播 |
| 25 |
"{player} 的武器沐浴在 25 个灵魂之中!" |
广播 + 音效 |
| 50 |
"{player} 的武器因 50 个灵魂而升华!" |
广播 + 标题 |
| 100 |
"传奇武器铸就!{player} 达到 100 灵魂!" |
全部效果 + 烟花 |
- 灵魂提取
工作原理
从你的武器中提取灵魂到便携式的“灵魂碎片”中,这些碎片可以进行交易或保存。
流程
- 手持你的灵魂武器
- 使用
/us extract 命令
- 支付熵税(损失 30% 的灵魂)
- 获得灵魂碎片物品
碎片物品
- 材质:回声碎片 (Echo Shard)
- 发光效果
- 在物品描述中显示灵魂数量
- 可以灌注到其他武器上
- 灵魂灌注
工作原理
右键点击武器上的灵魂碎片以转移灵魂。
机制
- 效率:仅转移碎片中 75% 的灵魂
- 限制:每把武器最多灌注 50 个灵魂
- 叠加:可以在限制范围内多次灌注
- 净化祭坛
工作原理
建造一个多方块祭坛,在保留部分力量的同时去除武器上的诅咒。
结构
[S] [S]
\ | /
[C]--[E]--[C]
/ | \
[S] [S]
E = 附魔台 (中心,在此交互)
C = 哭泣的黑曜石 (4 块)
S = 灵魂营火 (4 个)
需求
- 16 颗钻石
- 1 颗下界之星
- 1 个不死图腾
- 30 秒仪式时间
结果
- 灵魂保留:保留 50% 的伤害加成
- 诅咒移除:不再受到耐久度惩罚
- 腐化清除:不再受负面效果影响
- 传奇状态丢失:移除传奇状态
- 击杀连击
连击倍率
| 连击数 |
倍率 |
消息 |
| 3 |
1.5x |
杀戮狂潮!(KILLING SPREE!) |
| 5 |
2.0x |
狂暴!(RAMPAGE!) |
| 7 |
2.5x |
势不可挡!(UNSTOPPABLE!) |
| 10 |
3.0x |
神明降临!(GODLIKE!) |
机制
- 超时:击杀间隔超过 60 秒将重置
- 重置:死亡会重置连击
- 动作栏:显示当前连击数和倍率
- 灵魂类型
生物灵魂效果
| 生物 |
掉落率 |
上限 |
效果 |
| 玩家 |
100% |
∞ |
每个灵魂 +0.5 伤害 |
| 僵尸 |
5% |
20 |
每个灵魂 +2% 生命窃取 |
| 骷髅 |
4% |
15 |
每个灵魂 +10% 投射物伤害 |
| 苦力怕 |
3% |
10 |
每个灵魂 +5% 爆炸抗性 |
| 末影人 |
6% |
12 |
每个灵魂 +1% 传送几率 |
| 烈焰人 |
5% |
15 |
每个灵魂增加 1s 火焰附加效果 |
| 凋灵骷髅 |
2% |
10 |
每个灵魂 +2% 凋零几率 |
| 监守者 |
80% |
3 |
每个灵魂 +5% 声波冲击几率 |
| 末影龙 |
100% |
1 |
龙息 AOE 能力 |
| 凋灵 |
100% |
1 |
凋灵光环能力 |
- 传奇觉醒
需求
- 武器上拥有 100+ 灵魂
- 信标祭坛结构
- 献祭材料
祭坛结构
[N] [N] [N]
[N] [B] [N]
[N] [N] [N]
|
[N] (下方)
B = 信标 (中心)
N = 下界合金块 (共 9 个)
所需献祭
可用传奇武器
暗影之牙 (Shadowfang)
- 能力:暗影步 (Shadow Step)
- 效果:击杀后获得 3 秒隐身
- 伤害倍率:1.5x
血月之刃 (Bloodmoon's Edge)
- 能力:嗜血狂暴 (Blood Frenzy)
- 效果:每次击杀增加 10% 伤害(可叠加 5 次,持续 10 秒)
- 伤害倍率:1.3x
虚空使者 (Voidbringer)
- 能力:虚空裂隙 (Void Rift)
- 效果:击杀时有 20% 几率造成 AOE 虚空伤害
- 伤害倍率:1.4x
- 灵魂共鸣
模式
增益模式 (BUFF Mode) (默认)
- 附近的灵魂武器互相强化
- 每把附近武器提供 +5% 伤害(最高 +25%)
冲突模式 (CONFLICT Mode)
- 附近的灵魂武器互相削弱
- 每把附近武器导致 -10% 伤害(最高 -40%)
动态模式 (DYNAMIC Mode)
- 高灵魂数的武器吸取低灵魂数的武器
- 主导武器:获得 +15% 增益
- 从属武器:承受 -10% 减益
- 排行榜
类型
- 武器灵魂数:单把武器上最多的灵魂数
- 总灵魂数:累计收集的灵魂总数
- 击杀连击:达成的最佳击杀连击数
每周奖励(可选)
rewards:
第 1 名: 64 钻石, 16 下界合金
第 2 名: 32 钻石, 8 下界合金
第 3 名: 16 钻石, 4 下界合金
? 安装指南
需求
| 需求 |
版本 |
| 服务器 |
Paper 1.21 - 1.21.11 |
| Java |
21 或更高 |
| RAM |
推荐 512MB+ |
可选依赖项
| 插件 |
用途 |
| Vault |
用于提取费用的经济系统支持 |
| PlaceholderAPI |
占位符支持 |
| WorldGuard |
区域保护 |
安装步骤
第 1 步:下载
从发布页面下载 UltimateSouls-1.0.0.jar。
第 2 步:安装
将 JAR 文件放入服务器的 plugins 文件夹中。
第 3 步:重启
重启服务器(不要使用重载命令)。
第 4 步:配置
根据您的偏好编辑 plugins/UltimateSouls/config.yml。
第 5 步:重载
使用 /us reload 应用配置更改。
? 快速入门指南
对于服务器管理员
最小化设置(使用默认值)
- 安装插件
- 重启服务器
- 完成!所有功能启用并使用平衡的默认值
推荐的自定义
- 根据服务器风格调整
max-souls
- 设置
damage-per-soul 以获得期望的力量等级
- 根据您的玩家数量配置
bounty-threshold
- 自定义公告消息
PvP 服务器设置
souls:
player-kills-only: true
max-souls: 150
soul-stealing:
enabled: true
steal-percentage: 0.30
soul-bounty:
enabled: true
bounty-threshold: 25
PvE 服务器设置
souls:
player-kills-only: false
max-souls: 100
soul-types:
enabled: true
soul-decay:
enabled: false 对休闲玩法惩罚较少
对于玩家
开始游戏
- 获取一把剑或斧头
- 击杀生物或玩家
- 观察灵魂积累
- 享受增加的伤害!
提示
- 提取灵魂:在武器损坏前提取以保存灵魂
- 净化:当达到最大灵魂数时进行净化
- 注意耐久度:高灵魂数意味着更快的损坏速度
- 猎杀悬赏:以获得大量灵魂
? 完整命令参考
玩家命令
| 命令 |
描述 |
权限 |
/us help |
显示帮助菜单 |
ultimatesouls.use |
/us info |
查看手中武器的灵魂信息 |
ultimatesouls.info |
/us stats |
查看你的统计数据 |
ultimatesouls.stats |
/us stats <player> |
查看其他玩家的统计数据 |
ultimatesouls.stats.others |
/us top |
查看武器灵魂排行榜 |
ultimatesouls.leaderboard |
/us top total |
查看灵魂总数排行榜 |
ultimatesouls.leaderboard |
/us top streak |
查看击杀连击排行榜 |
ultimatesouls.leaderboard |
/us extract |
从手中武器中提取灵魂 |
ultimatesouls.extract |
管理员命令
| 命令 |
描述 |
权限 |
/us reload |
重新加载配置 |
ultimatesouls.reload |
/us set <souls> |
设置手中武器的灵魂数量 |
ultimatesouls.set |
/us set <souls> <player> |
设置玩家武器的灵魂数量 |
ultimatesouls.set |
/us give <souls> |
给手中武器添加灵魂 |
ultimatesouls.give |
/us give <souls> <player> |
给玩家武器添加灵魂 |
ultimatesouls.give |
/us clear |
清除手中武器的灵魂 |
ultimatesouls.clear |
/us clear <player> |
清除玩家武器的灵魂 |
ultimatesouls.clear |
命令别名
/ultimatesouls
/us
/souls
/soulbound
/soul
? 权限参考
基本权限
| 权限 |
描述 |
默认值 |
ultimatesouls.use |
基础插件使用,收集灵魂 |
true |
ultimatesouls.info |
查看武器信息 |
true |
ultimatesouls.stats |
查看个人统计数据 |
true |
ultimatesouls.stats.others |
查看其他玩家的统计数据 |
op |
ultimatesouls.leaderboard |
查看排行榜 |
true |
ultimatesouls.extract |
从武器中提取灵魂 |
true |
ultimatesouls.legendary |
觉醒传说武器 |
true |
ultimatesouls.purify |
使用净化祭坛 |
true |
ultimatesouls.infuse |
灌注灵魂碎片 |
true |
管理员权限
| 权限 |
描述 |
默认值 |
ultimatesouls.admin |
所有管理员命令 |
op |
ultimatesouls.reload |
重新加载配置 |
op |
ultimatesouls.set |
设置武器灵魂 |
op |
ultimatesouls.give |
给予武器灵魂 |
op |
ultimatesouls.clear |
清除武器灵魂 |
op |
ultimatesouls.extract.others |
提取其他玩家的武器灵魂 |
op |
绕过权限
| 权限 |
描述 |
默认值 |
ultimatesouls.bypass |
所有绕过权限 |
false |
ultimatesouls.bypass.gain |
其他人无法通过击杀你获得灵魂 |
false |
ultimatesouls.bypass.curse |
免疫耐久诅咒 |
false |
ultimatesouls.bypass.mending |
经验修补始终生效 |
false |
ultimatesouls.bypass.corruption |
无腐化效果 |
false |
ultimatesouls.bypass.decay |
灵魂永不衰减 |
false |
ultimatesouls.bypass.bounty |
永远不会成为悬赏目标 |
false |
ultimatesouls.bypass.instability |
武器无不稳定状态 |
false |
⚙️ 配置指南
配置文件位置
plugins/UltimateSouls/config.yml
配置部分
核心设置
prefix: "&8[&9B59B6UltimateSouls&8] "
debug: false
灵魂设置
souls:
max-souls: 100
damage-per-soul: 0.5
player-kills-only: false
require-pvp: false
blocked-gamemodes:
- CREATIVE
- SPECTATOR
武器设置
weapons:
enabled-materials:
- DIAMOND_SWORD
- NETHERITE_SWORD
... etc
overrides:
NETHERITE_SWORD:
max-souls: 150
damage-per-soul: 0.75
功能开关
每个扩展功能都有 enabled: true/false:
soul-tiers:
enabled: true
soul-decay:
enabled: true
soul-whispers:
enabled: true
设置为 false 以禁用任何功能
存储设置
storage:
type: "PDC" PDC、SQLITE 或 MYSQL
sqlite:
file: "ultimatesouls_data.db"
mysql:
host: "localhost"
port: 3306
database: "ultimatesouls"
username: "root"
password: ""
?️ 多区块结构
净化祭坛
视觉布局
俯视图:
[S] [S]
\ | /
[C]--[E]--[C]
/ | \
[S] [S]
材料
| 方块 |
材质 |
数量 |
| E |
附魔台 |
1 |
| C |
哭泣的黑曜石 |
4 |
| S |
灵魂营火 |
4 |
建造说明
- 将附魔台放置在中心
- 在附魔台的北/南/东/西方向放置哭泣的黑曜石
- 在四个角落放置灵魂营火
- 手持灵魂武器右键点击附魔台
传说觉醒祭坛
视觉布局
俯视图:
[N] [N] [N]
[N] [B] [N]
[N] [N] [N]
侧视图:
[B]
[N]
材料
| 方块 |
材质 |
数量 |
| B |
信标 |
1 |
| N |
下界合金块 |
9 |
建造说明
- 将下界合金块作为基座(位于信标下方)
- 在上方放置信标
- 用 8 个下界合金块环绕信标
- 手持拥有 100+ 灵魂的武器右键点击信标
- 等待 60 秒完成觉醒
PlaceholderAPI 占位符
| 占位符 |
描述 |
%ultimatesouls_souls% |
手持武器上的灵魂数量 |
%ultimatesouls_max_souls% |
武器的最大灵魂容量 |
%ultimatesouls_tier% |
当前阶位名称 |
%ultimatesouls_tier_number% |
当前阶位编号 |
%ultimatesouls_total_collected% |
已收集的总灵魂数 |
%ultimatesouls_total_kills% |
总击杀数 |
%ultimatesouls_best_streak% |
最佳连杀记录 |
%ultimatesouls_current_streak% |
当前连杀数 |
%ultimatesouls_is_bounty% |
“true”或“false” |
%ultimatesouls_is_legendary% |
“true”或“false” |
%ultimatesouls_legendary_type% |
传奇名称,若无则为空 |
%ultimatesouls_rank_souls% |
排行榜排名(按灵魂数) |
%ultimatesouls_rank_streak% |
排行榜排名(按连杀数) |
%ultimatesouls_damage_bonus% |
伤害加成数值 |
❓ 常见问题解答
通用问题
Q: 这个插件支持 Spigot 吗?
A: 不支持。UltimateSouls 需要 Paper 或其分支(如 Purpur、Pufferfish)。
Q: 服务器重启后我的武器会丢失数据吗?
A: 不会。所有数据都使用 PDC(持久化数据容器)存储在物品本身上,实现持久化保存。
Q: 我可以禁用特定功能吗?
A: 可以。每个功能在配置文件中都有 enabled: true/false 选项。
Q: 创造模式下可以使用吗?
A: 默认情况下,创造模式是被禁止的。你可以在配置文件中更改此设置。
技术问题
Q: 数据是如何存储的?
A: 武器数据使用 PersistentDataContainer (PDC) 存储在物品上。玩家统计数据则使用 SQLite/MySQL 数据库存储。
Q: 它是异步处理的吗?
A: 数据库操作是异步的。为了安全起见,事件处理是同步进行的。
Q: 它会拖慢我的服务器性能吗?
A: 不会。该插件经过优化。如果需要,还可以禁用视觉效果。
Q: 我可以使用 MySQL 吗?
A: 可以。请在 config.yml 中配置 mysql 部分。
游戏性问题
Q: 我可以在武器之间转移灵魂吗?
A: 可以。请先进行提取(extraction),然后再进行注入(infusion)。
Q: 如何移除诅咒?
A: 建造并使用净化祭坛(Purification Altar)。
Q: 为什么我的经验修补(Mending)不起作用?
A: 当灵魂数量达到 25+ 时,经验修补会被诅咒阻止。
Q: 如何成为传奇(Legendary)?
A: 达到 100 个灵魂,建造祭坛,并完成觉醒仪式。
故障排除
Q: 灵魂没有被收集!
A: 请检查:是否为有效武器、是否在正确的世界、是否处于正确的游戏模式、以及是否具有相应权限。
Q: 配置文件更改未生效!
A: 编辑完 config.yml 后,请使用 /us reload 命令重新加载。
Q: 控制台出现错误!
A: 启用调试模式,查看错误信息,并在 Discord 上报告。
? 致谢与支持
作者
geturplugins
支持
特别感谢
- Paper 团队提供的出色 API
- 社区成员提供的反馈和建议
许可证
ARR License - All Rights Reserved
? 感谢您使用 UltimateSouls!
由 geturplugins 用 ❤️ 制作
** UltimateSouls - Complete Documentation Package
? Plugin Description
Overview
UltimateSouls is a premium-quality, feature-rich Minecraft Paper plugin that introduces a revolutionary soul-based weapon progression system. Transform ordinary weapons into living entities that grow stronger with each kill, unlock devastating abilities, and eventually awaken into legendary artifacts with unique powers.
The Concept
In UltimateSouls, every kill matters. When you slay an enemy with a compatible weapon, their soul is absorbed into your blade. Each soul increases your weapon's power, but comes with a terrible price - the curse grows stronger. Your weapon becomes increasingly unstable, consuming durability at alarming rates, blocking mending, and afflicting you with corruption effects.
This creates a compelling risk vs. reward dynamic:
- More souls = More power (increased damage, abilities, legendary potential)
- More souls = More risk (faster breaking, corruption effects, instability)
Players must balance their hunger for power against the very real possibility of their prized weapon shattering in their hands.
Target Audience
- PvP Servers: Perfect for faction, KitPvP, and survival PvP servers
- Survival Servers: Adds depth to the PvE experience
- RPG Servers: Integrates seamlessly with RPG-style gameplay
- Competitive Servers: Leaderboards and bounty systems drive competition
✨ Feature Summary
Core Features
| Feature |
Description |
Configurable |
| Soul Collection |
Absorb souls from kills into your weapon |
✅ |
| Damage Scaling |
Each soul increases attack damage |
✅ |
| Curse System |
Souls increase durability consumption |
✅ |
| Mending Restriction |
High souls block mending enchantment |
✅ |
| Weapon Support |
Swords, axes, tridents, mace |
✅ |
| Per-Weapon Config |
Different settings per weapon type |
✅ |
Extended Features (All Toggleable)
| Feature |
Description |
Default |
| Soul Tiers |
Unlock abilities at soul milestones |
Enabled |
| Soul Decay |
Weapons lose souls over time without kills |
Enabled |
| Soul Whispers |
Weapon "speaks" to the player |
Enabled |
| Soul Shatter |
Explosive weapon break with soul scattering |
Enabled |
| Corruption Effects |
Negative effects at high soul counts |
Enabled |
| Soul Instability |
Random weapon lashouts |
Enabled |
| Bounty System |
High-soul players become targets |
Enabled |
| Soul Stealing |
Steal souls from killed players |
Enabled |
| Revenge Marks |
Damage bonus against your killer |
Enabled |
| Nemesis System |
Bonus damage vs repeated victims |
Enabled |
| Cursed Visuals |
Particles and effects on weapons |
Enabled |
| Dynamic Naming |
Weapon names change with souls |
Enabled |
| Kill Announcements |
Broadcast milestone achievements |
Enabled |
| Soul Extraction |
Extract souls into items |
Enabled |
| Soul Infusion |
Transfer souls between weapons |
Enabled |
| Purification Altar |
Remove curse, keep some power |
Enabled |
| Kill Streaks |
Chain kills for multipliers |
Enabled |
| Soul Types |
Different mobs give different bonuses |
Enabled |
| Legendary Awakening |
Transform into unique legendaries |
Enabled |
| Soul Resonance |
Nearby soul weapons interact |
Enabled |
| Leaderboards |
Competitive rankings |
Enabled |
Technical Features
| Feature |
Description |
| PDC Storage |
Data stored on items (no database needed) |
| SQLite/MySQL |
Optional database for stats/leaderboards |
| Full API |
Developer API with custom events |
| PlaceholderAPI |
Full placeholder support |
| Vault Integration |
Economy support for features |
| WorldGuard |
Region protection compatibility |
| Async Operations |
Database operations are async |
| Performance Optimized |
Efficient event handling |
? Detailed Feature Documentation
- Soul Collection System
How It Works
When you kill an entity while holding a valid soul weapon, you have a chance to absorb their soul. The soul is permanently bound to that weapon until extracted or lost.
Configuration Options
souls:
max-souls: 100 Maximum souls per weapon
damage-per-soul: 0.5 Damage increase per soul
player-kills-only: false Only count player kills
require-pvp: false Require PvP enabled
blocked-gamemodes: Gamemodes that can't gain souls
- CREATIVE
- SPECTATOR
Soul Gain Formula
Base Souls = 1 (per kill)
Streak Multiplier = varies (1.0x - 3.0x)
Bounty Multiplier = 2.0x (if target was bounty)
Bounty Bonus = +5 (flat bonus for bounty kills)
Stolen Souls = 25% of victim's weapon souls
Total Souls = (Base × Streak × Bounty) + Bounty Bonus + Stolen
- Curse System (Durability Penalty)
How It Works
Each soul on your weapon increases durability consumption. At high soul counts, your weapon breaks extremely fast.
Durability Formula
Durability Lost = Base Damage × (1 + (Souls × Multiplier))
Example with 50 souls and 0.15 multiplier:
Durability Lost = 1 × (1 + (50 × 0.15)) = 8.5x normal
Configuration Options
curse:
enabled: true
durability-multiplier-per-soul: 0.15
instant-break-at-max: true
Alternative: Custom thresholds
custom-durability:
enabled: false
thresholds:
10: 2 2x at 10 souls
25: 4 4x at 25 souls
50: 8 8x at 50 souls
100: 9999 Instant break
- Mending Restriction
How It Works
At a configurable soul threshold, the mending enchantment stops working. The curse is too powerful for mending to repair.
Options
- BLOCK: Mending stops working but stays on the item
- REMOVE: Mending is forcibly removed from the item
Configuration
mending:
enabled: true
disable-threshold: 25 Souls needed to block mending
action: "BLOCK" "BLOCK" or "REMOVE"
prevent-application: true Prevent adding mending via anvil
- Soul Tiers & Abilities
Tier Progression
| Tier |
Souls Required |
Name |
Ability |
| 1 |
10 |
Awakened |
Lifesteal (15% heal) |
| 2 |
25 |
Empowered |
Speed II on kill (5s) |
| 3 |
50 |
Ascended |
AOE damage on kill (4 damage, 3.5 radius) |
| 4 |
100 |
LEGENDARY |
20% lightning strike chance |
Ability Details
Lifesteal (Tier 1)
- Heals player for percentage of damage dealt
- Works on every hit
- Configurable percentage
Speed on Kill (Tier 2)
- Grants Speed potion effect after kills
- Configurable level and duration
- Stacks refresh duration
AOE Damage (Tier 3)
- Deals damage to nearby enemies on kill
- Creates particle explosion
- Configurable radius and damage
Lightning Strike (Tier 4)
- Chance to strike lightning on hit
- Can deal real damage or just visual
- Configurable chance
- Soul Decay
How It Works
Weapons "hunger" for souls. If you don't feed them with kills, they lose souls over time.
Configuration
soul-decay:
enabled: true
check-interval: 60 Check every 60 minutes
decay-amount: 1 Lose 1 soul per check
only-while-online: true Only decay when holding player is online
decay-threshold: 5 Don't decay below 5 souls
grace-period: 120 2 hour grace after last kill
Decay Prevention
- Kill enemies regularly to reset the timer
- Players with
ultimatesouls.bypass.decay never decay
- Weapons below threshold don't decay
- Soul Whispers
How It Works
Your weapon develops personality! It sends you messages based on how many souls it contains.
Message Examples
| Soul Count |
Example Messages |
| 5+ |
"I hunger for more...", "Feed me..." |
| 10+ |
"We grow stronger together..." |
| 25+ |
"Their screams fuel me...", "I taste their fear..." |
| 50+ |
"We are becoming one...", "Your hand, my blade..." |
| 75+ |
"BLOOD. SOULS. POWER." |
| 100+ |
"I AM ETERNAL", "THEY WILL ALL FALL" |
Kill Whispers
50% chance on kill to receive messages like:
- "Yes... YES!"
- "Another offering..."
- "Their soul is MINE!"
- Soul Shatter
How It Works
When a high-soul weapon breaks, it doesn't go quietly. It explodes!
Shatter Effects
- Explosion: Visual explosion at weapon location
- Wielder Damage: Player takes damage (configurable)
- Soul Scatter: Souls drop as collectible fragments
- Nearby Alert: Players nearby see a message
Soul Fragments
- Drop as glowing items
- Can be picked up by anyone
- Used with Soul Infusion system
- Despawn after configurable time
- Corruption Effects
Effect Progression
| Effect |
Souls Required |
Description |
| Hunger Drain |
25 |
Slowly lose food |
| Blindness Flicker |
50 |
Brief blindness moments |
| Wither Aura |
75 |
Smoke particles around you |
| Soul Sounds |
100 |
Eerie ambient sounds |
| Slowness |
150 |
Constant slowness effect |
| Nausea |
200 |
Random nausea episodes |
Bypass
Players with ultimatesouls.bypass.corruption are immune.
- Soul Instability
How It Works
At 50+ souls, weapons become unstable. Each hit has a chance to "lash out" against the wielder.
Lashout Effects
- Damage: Player takes 3 damage
- Lightning: Visual lightning effect
- Particles: Soul fire burst
- Sound: Thunder crack
Chance Calculation
Chance = Base (2%) + (Souls × 0.1%)
At 50 souls: 2% + 5% = 7%
At 100 souls: 2% + 10% = 12%
- Bounty System
How It Works
Players wielding weapons with 30+ souls become "bounty targets". Other players are notified and rewarded for hunting them.
Features
- Announcement: Server-wide broadcast when someone becomes bounty
- Glowing Effect: Bounty targets glow red
- Particle Trail: Flame particles follow bounty targets
- Rewards: 2x souls + 5 bonus for killing bounties
Compass Tracking
Players can use a compass to track the nearest bounty target (optional feature).
- Soul Stealing
How It Works
When you kill a player who has a soul weapon equipped, you steal some of their souls!
Configuration
soul-stealing:
enabled: true
steal-percentage: 0.25 Steal 25% of their souls
minimum-victim-souls: 5 Victim needs at least 5 souls
max-steal-per-kill: 10 Maximum 10 souls per kill
require-weapon-equipped: true Victim must hold weapon
- Revenge Mark System
How It Works
When killed by someone, you receive a "revenge mark" giving you bonus damage against them.
Features
- Damage Bonus: +20% damage against your killer
- Duration: 30 minutes
- Stacking: Up to 3 stacks (+30% total with stacking)
- Satisfaction: Special message when you get revenge
- Nemesis System
How It Works
Your weapon remembers victims. Kill the same player repeatedly for increasing damage bonuses!
Damage Scaling
Bonus = Kills × 5% (capped at 50%)
Kill count 1: +5%
Kill count 5: +25%
Kill count 10+: +50% (max)
Lore Display
Weapons show "Blood-Sworn Enemies" in lore with kill counts.
- Cursed Visual Effects
Effect Progression
| Souls |
Effects |
| 10 |
Red dust particles |
| 25 |
Flame particles, glowing |
| 50 |
Soul fire, enchant glow |
| 75 |
Soul particles, smoke, player aura |
| 100 |
Intense particles, lightning crackles |
- Dynamic Weapon Naming
Name Progression
| Souls |
Name Format |
| 0 |
Original name |
| 10 |
Bloodied {name} |
| 25 |
Crimson {name} |
| 50 |
Soulbound {name} |
| 75 |
{name} of Slaughter |
| 100 |
Soulreaver |
| 150+ |
Random legendary name |
Legendary Names Pool
- Eternal Reaper
- Voidbringer
- Bloodmoon's Edge
- Shadowfang
- Damnation
- Soulrender
- Oblivion
- Kill Announcements
Milestone Broadcasts
| Souls |
Announcement |
Effects |
| 10 |
"{player}'s weapon has claimed its 10th victim!" |
Broadcast |
| 25 |
"{player}'s weapon bathes in 25 souls!" |
Broadcast + Sound |
| 50 |
"{player}'s weapon ascends with 50 souls!" |
Broadcast + Title |
| 100 |
"LEGENDARY WEAPON FORGED! {player} reaches 100 SOULS!" |
Everything + Firework |
- Soul Extraction
How It Works
Extract souls from your weapon into portable "Soul Fragments" that can be traded or saved.
Process
- Hold your soul weapon
- Use
/us extract command
- Pay entropy tax (30% souls lost)
- Receive Soul Fragment item
Fragment Item
- Material: Echo Shard
- Glowing effect
- Shows soul count in lore
- Can be infused into other weapons
- Soul Infusion
How It Works
Right-click a soul fragment on a weapon to transfer souls.
Mechanics
- Efficiency: Only 75% of fragment souls transfer
- Limit: Maximum 50 infused souls per weapon
- Stacking: Can infuse multiple times up to limit
- Purification Altar
How It Works
Build a multiblock altar to remove the curse from your weapon while keeping some power.
Structure
[S] [S]
\ | /
[C]--[E]--[C]
/ | \
[S] [S]
E = Enchanting Table (center, interact here)
C = Crying Obsidian (4 pieces)
S = Soul Campfire (4 pieces)
Requirements
- 16 Diamonds
- 1 Nether Star
- 1 Totem of Undying
- 30 seconds ritual time
Results
- Soul Retention: Keep 50% of damage bonus
- Curse Removal: No more durability penalty
- Corruption Clear: No more negative effects
- Legendary Lost: Removes legendary status
- Kill Streaks
Streak Multipliers
| Streak |
Multiplier |
Message |
| 3 |
1.5x |
KILLING SPREE! |
| 5 |
2.0x |
RAMPAGE! |
| 7 |
2.5x |
UNSTOPPABLE! |
| 10 |
3.0x |
GODLIKE! |
Mechanics
- Timeout: 60 seconds between kills
- Reset: Death resets streak
- Action Bar: Shows current streak and multiplier
- Soul Types
Mob Soul Effects
| Mob |
Drop Rate |
Max |
Effect |
| Player |
100% |
∞ |
+0.5 damage per soul |
| Zombie |
5% |
20 |
+2% lifesteal per soul |
| Skeleton |
4% |
15 |
+10% projectile damage per soul |
| Creeper |
3% |
10 |
+5% explosion resistance per soul |
| Enderman |
6% |
12 |
+1% teleport chance per soul |
| Blaze |
5% |
15 |
+1s fire aspect per soul |
| Wither Skeleton |
2% |
10 |
+2% wither chance per soul |
| Warden |
80% |
3 |
+5% sonic boom chance per soul |
| Ender Dragon |
100% |
1 |
Dragon breath AOE ability |
| Wither |
100% |
1 |
Wither aura ability |
- Legendary Awakening
Requirements
- 100+ souls on weapon
- Beacon altar structure
- Sacrifice materials
Altar Structure
[N] [N] [N]
[N] [B] [N]
[N] [N] [N]
|
[N] (below)
B = Beacon (center)
N = Netherite Block (9 total)
Sacrifices Required
- 3 Nether Stars
- 1 Dragon Egg
- 2 Totems of Undying
Available Legendaries
Shadowfang
- Ability: Shadow Step
- Effect: 3 seconds invisibility on kill
- Damage Multiplier: 1.5x
Bloodmoon's Edge
- Ability: Blood Frenzy
- Effect: +10% damage per kill (stacks 5x, 10s)
- Damage Multiplier: 1.3x
Voidbringer
- Ability: Void Rift
- Effect: 20% chance AOE void damage on kill
- Damage Multiplier: 1.4x
- Soul Resonance
Modes
BUFF Mode (Default)
- Nearby soul weapons strengthen each other
- +5% damage per nearby weapon (max +25%)
CONFLICT Mode
- Nearby soul weapons weaken each other
- -10% damage per nearby weapon (max -40%)
DYNAMIC Mode
- Higher-soul weapon drains from lower
- Dominant weapon: +15% buff
- Submissive weapon: -10% debuff
- Leaderboards
Types
- Weapon Souls: Most souls on a single weapon
- Total Souls: Total souls ever collected
- Kill Streaks: Best kill streak achieved
Weekly Rewards (Optional)
rewards:
1st: 64 Diamonds, 16 Netherite
2nd: 32 Diamonds, 8 Netherite
3rd: 16 Diamonds, 4 Netherite
? Installation Guide
Requirements
| Requirement |
Version |
| Server |
Paper 1.21 - 1.21.11 |
| Java |
21 or higher |
| RAM |
512MB+ recommended |
Optional Dependencies
| Plugin |
Purpose |
| Vault |
Economy for extraction costs |
| PlaceholderAPI |
Placeholder support |
| WorldGuard |
Region protection |
Installation Steps
Step 1: Download
Download UltimateSouls-1.0.0.jar from the releases page.
Step 2: Install
Place the JAR file in your server's plugins folder.
Step 3: Restart
Restart your server (not reload).
Step 4: Configure
Edit plugins/UltimateSouls/config.yml to your preferences.
Step 5: Reload
Use /us reload to apply configuration changes.
? Quick Start Guide
For Server Owners
Minimal Setup (Use Defaults)
- Install plugin
- Restart server
- Done! All features enabled with balanced defaults
Recommended Customization
- Adjust
max-souls based on server style
- Set
damage-per-soul for desired power level
- Configure
bounty-threshold for your player count
- Customize announcement messages
PvP Server Settings
souls:
player-kills-only: true
max-souls: 150
soul-stealing:
enabled: true
steal-percentage: 0.30
soul-bounty:
enabled: true
bounty-threshold: 25
PvE Server Settings
souls:
player-kills-only: false
max-souls: 100
soul-types:
enabled: true
soul-decay:
enabled: false Less punishing for casual play
For Players
Getting Started
- Get a sword or axe
- Kill mobs or players
- Watch souls accumulate
- Enjoy increased damage!
Tips
- Extract souls before weapon breaks to save them
- Purify when you reach max souls
- Watch durability - high souls = fast breaking
- Hunt bounties for massive soul gains
? Complete Command Reference
Player Commands
| Command |
Description |
Permission |
/us help |
Display help menu |
ultimatesouls.use |
/us info |
View held weapon's soul info |
ultimatesouls.info |
/us stats |
View your statistics |
ultimatesouls.stats |
/us stats <player> |
View another player's stats |
ultimatesouls.stats.others |
/us top |
View weapon souls leaderboard |
ultimatesouls.leaderboard |
/us top total |
View total souls leaderboard |
ultimatesouls.leaderboard |
/us top streak |
View kill streak leaderboard |
ultimatesouls.leaderboard |
/us extract |
Extract souls from held weapon |
ultimatesouls.extract |
Admin Commands
| Command |
Description |
Permission |
/us reload |
Reload configuration |
ultimatesouls.reload |
/us set <souls> |
Set souls on held weapon |
ultimatesouls.set |
/us set <souls> <player> |
Set souls on player's weapon |
ultimatesouls.set |
/us give <souls> |
Add souls to held weapon |
ultimatesouls.give |
/us give <souls> <player> |
Add souls to player's weapon |
ultimatesouls.give |
/us clear |
Clear souls from held weapon |
ultimatesouls.clear |
/us clear <player> |
Clear souls from player's weapon |
ultimatesouls.clear |
Command Aliases
/ultimatesouls
/us
/souls
/soulbound
/soul
? Permission Reference
Basic Permissions
| Permission |
Description |
Default |
ultimatesouls.use |
Basic plugin usage, soul collection |
true |
ultimatesouls.info |
View weapon information |
true |
ultimatesouls.stats |
View personal statistics |
true |
ultimatesouls.stats.others |
View other players' stats |
op |
ultimatesouls.leaderboard |
View leaderboards |
true |
ultimatesouls.extract |
Extract souls from weapons |
true |
ultimatesouls.legendary |
Awaken legendary weapons |
true |
ultimatesouls.purify |
Use purification altars |
true |
ultimatesouls.infuse |
Infuse soul fragments |
true |
Admin Permissions
| Permission |
Description |
Default |
ultimatesouls.admin |
All admin commands |
op |
ultimatesouls.reload |
Reload configuration |
op |
ultimatesouls.set |
Set weapon souls |
op |
ultimatesouls.give |
Give souls to weapons |
op |
ultimatesouls.clear |
Clear weapon souls |
op |
ultimatesouls.extract.others |
Extract from others' weapons |
op |
Bypass Permissions
| Permission |
Description |
Default |
ultimatesouls.bypass |
All bypass permissions |
false |
ultimatesouls.bypass.gain |
Others can't gain souls from killing you |
false |
ultimatesouls.bypass.curse |
Immune to durability curse |
false |
ultimatesouls.bypass.mending |
Mending always works |
false |
ultimatesouls.bypass.corruption |
No corruption effects |
false |
ultimatesouls.bypass.decay |
Souls never decay |
false |
ultimatesouls.bypass.bounty |
Never become bounty target |
false |
ultimatesouls.bypass.instability |
No weapon instability |
false |
⚙️ Configuration Guide
Configuration File Location
plugins/UltimateSouls/config.yml
Configuration Sections
Core Settings
prefix: "&8[&9B59B6UltimateSouls&8] "
debug: false
Soul Settings
souls:
max-souls: 100
damage-per-soul: 0.5
player-kills-only: false
require-pvp: false
blocked-gamemodes:
- CREATIVE
- SPECTATOR
Weapon Settings
weapons:
enabled-materials:
- DIAMOND_SWORD
- NETHERITE_SWORD
... etc
overrides:
NETHERITE_SWORD:
max-souls: 150
damage-per-soul: 0.75
Feature Toggles
Every extended feature has enabled: true/false:
soul-tiers:
enabled: true
soul-decay:
enabled: true
soul-whispers:
enabled: true
Set to false to disable any feature
Storage Settings
storage:
type: "PDC" PDC, SQLITE, or MYSQL
sqlite:
file: "ultimatesouls_data.db"
mysql:
host: "localhost"
port: 3306
database: "ultimatesouls"
username: "root"
password: ""
?️ Multiblock Structures
Purification Altar
Visual Layout
Top View:
[S] [S]
\ | /
[C]--[E]--[C]
/ | \
[S] [S]
Materials
| Block |
Material |
Count |
| E |
Enchanting Table |
1 |
| C |
Crying Obsidian |
4 |
| S |
Soul Campfire |
4 |
Building Instructions
- Place Enchanting Table in center
- Place Crying Obsidian on N/S/E/W sides
- Place Soul Campfires in corners
- Shift+Right-click Enchanting Table with soul weapon
Legendary Awakening Altar
Visual Layout
Top View:
[N] [N] [N]
[N] [B] [N]
[N] [N] [N]
Side View:
[B]
[N]
Materials
| Block |
Material |
Count |
| B |
Beacon |
1 |
| N |
Netherite Block |
9 |
Building Instructions
- Place Netherite Block as base (below beacon)
- Place Beacon on top
- Surround beacon with 8 Netherite Blocks
- Shift+Right-click Beacon with 100+ soul weapon
- Wait 60 seconds for awakening
PlaceholderAPI Placeholders
| Placeholder |
Description |
%ultimatesouls_souls% |
Souls on held weapon |
%ultimatesouls_max_souls% |
Max souls for weapon |
%ultimatesouls_tier% |
Current tier name |
%ultimatesouls_tier_number% |
Current tier number |
%ultimatesouls_total_collected% |
Total souls collected |
%ultimatesouls_total_kills% |
Total kills |
%ultimatesouls_best_streak% |
Best kill streak |
%ultimatesouls_current_streak% |
Current streak |
%ultimatesouls_is_bounty% |
"true" or "false" |
%ultimatesouls_is_legendary% |
"true" or "false" |
%ultimatesouls_legendary_type% |
Legendary name or empty |
%ultimatesouls_rank_souls% |
Leaderboard rank |
%ultimatesouls_rank_streak% |
Streak rank |
%ultimatesouls_damage_bonus% |
Bonus damage value |
❓ Frequently Asked Questions
General Questions
Q: Does this work on Spigot?
A: No, UltimateSouls requires Paper or a Paper fork (Purpur, Pufferfish).
Q: Will my weapons lose data on server restart?
A: No, all data is stored persistently using PDC (on the item itself).
Q: Can I disable specific features?
A: Yes, every feature has enabled: true/false in config.
Q: Does this work in creative mode?
A: By default, creative mode is blocked. You can change this in config.
Technical Questions
Q: How is data stored?
A: Weapon data uses PersistentDataContainer (PDC), stored on the item. Player statistics use SQLite/MySQL.
Q: Is it async?
A: Database operations are async. Event handling is sync for safety.
Q: Will it lag my server?
A: No, the plugin is optimized. Visual effects can be disabled if needed.
Q: Can I use MySQL?
A: Yes, configure the mysql section in config.yml.
Gameplay Questions
Q: Can I transfer souls between weapons?
A: Yes, use extraction then infusion.
Q: How do I remove the curse?
A: Build and use the Purification Altar.
Q: Why does my mending not work?
A: At 25+ souls, mending is blocked by the curse.
Q: How do I become legendary?
A: Reach 100 souls, build the altar, and complete the awakening ritual.
Troubleshooting
Q: Souls aren't being collected!
A: Check: valid weapon, correct world, correct gamemode, has permission.
Q: Config changes don't apply!
A: Use /us reload after editing config.yml.
Q: Getting errors in console!
A: Enable debug mode, check the error, report on Discord.
? Credits & Support
Author
geturplugins
Support
Special Thanks
- Paper team for the amazing API
- Community members for feedback and suggestions
License
ARR License - All Rights Reserved
? Thank You for Using UltimateSouls!
Made with ❤️ by geturplugins
**
评论 0
登录后参与评分
还没有评论,来抢沙发吧