SoulForge
一款强大的 Minecraft Paper 插件,集成了自定义工具、灵魂收割系统、升级商店以及内置资源包——全部合而为一。
功能
自定义工具
| 工具 |
描述 |
| Drill 3×3 |
一把下界合金镐,一击即可挖掘 3×3 范围的方块。使用钻石块合成。 |
| Drill 5×5 |
升级版的钻头,可挖掘 5×5 范围。使用后界合金块合成。 |
| TNT Pickaxe |
破坏方块时有概率生成引燃的 TNT。使用 TNT 和下界合金合成。 |
| Scythe of the Grim Reaper |
一把下界合金剑,有概率从击杀的生物身上收割灵魂。 |
| Timber Axe |
一次砍伐整棵树(原木 + 树叶),但使用时存在冷却时间。 |
| Murasame |
一把诅咒下界合金剑,会对生物施加蔓延的诅咒——叠加 5 层后目标死亡。使用凋灵骷髅头颅合成。 |
所有自定义物品均不可损坏,显示附魔光泽,并可通过可选资源包支持自定义模型。
灵魂系统
- 手持 Scythe 击杀生物以收割灵魂。
- 灵魂按玩家单独追踪,并在会话之间持久保存(存储于
souls.yml)。
- 使用
/souls 查看你的余额,或使用 /soulsgive <player> <amount> 转移灵魂。
- 使用
/souls <player> 查看其他玩家的灵魂数量(需要 souls.seeothers 权限)。
灵魂商店 (/soulsshop)
花费灵魂购买永久性的、针对每位玩家的升级,这些升级会在你制作新工具时生效:
| 升级 |
描述 |
费用 |
等级 |
| Souls: Multiplier |
每次掉落额外获得 +1 灵魂(每级增加,上限可配置) |
5 灵魂 |
4 |
| Scythe: Efficiency |
添加效率附魔 |
15 灵魂 |
5 |
| Scythe: Looting |
添加掠夺附魔 |
20 灵魂 |
3 |
| Scythe: Soul Harvest |
提高灵魂收割概率 |
50 灵魂 |
5 |
| Scythe: Sharpness |
添加锋利附魔 |
20 灵魂 |
5 |
| TNT Pickaxe: Fortune |
添加幸运附魔 |
25 灵魂 |
3 |
| TNT Pickaxe: Silk Touch |
添加精准采集附魔 |
25 灵魂 |
1 |
| TNT Pickaxe: Unbreakable |
使其不可损坏 |
40 灵魂 |
1 |
| Timber Axe: Remove Cooldown |
移除砍树冷却时间 |
30 灵魂 |
1 |
| Timber Axe: Efficiency |
添加效率附魔 |
15 灵魂 |
5 |
| Timber Axe: Fortune |
添加幸运附魔 |
20 灵魂 |
3 |
| Timber Axe: Silk Touch |
添加精准采集附魔 |
20 灵魂 |
1 |
| Unlock Murasame Crafting |
永久解锁 Murasame 的合成配方 |
100 灵魂 |
1 |
购买升级后,重新制作该工具即可获得新的附魔。
资源包
SoulForge 包含一个内置的可选资源包,为所有工具提供自定义模型。该资源包可以:
- 在玩家加入时自动下载(可在
config.yml 中配置)。
- 通过
/soulforge reload 实时切换——无需重启服务器。
- 物品模型会自动同步到背包、末影箱和潜影盒中。
合成配方
所有工具均可通过原版风格的形状合成配方进行制作。使用 /recipe 浏览所有配方,或使用 /3x3recipe、/5x5recipe、/tntrecipe 查看特定配方。可通过 /recipe <search> 使用搜索对话框。
命令
| 命令 |
描述 |
权限 |
/recipe [search] |
浏览所有配方或搜索 |
— |
/3x3recipe |
显示 Drill 3×3 配方 |
— |
/5x5recipe |
显示 Drill 5×5 配方 |
— |
/tntrecipe |
显示 TNT Pickaxe 配方 |
— |
/souls [player] |
查看你的(或其他人的)灵魂数量 |
souls.seeothers (op) |
/soulsshop |
打开灵魂商店 |
— |
/soulsgive <player> <amount> |
给予其他玩家灵魂 |
— |
/givesouls <player> <amount> |
管理员:给予玩家灵魂 |
givesouls (op) |
/silktouch |
将精准采集附魔应用于背包中的所有钻头 |
— |
/fortune |
将幸运附魔应用于背包中的所有钻头 |
— |
/opci give/remove <player> <item> |
管理员:给予/移除自定义物品 |
drill_itemgiver (op) |
/soulforge reload |
重载配置和资源包 |
soulforge.admin (op) |
配置
所有设置均在 config.yml 中。关键选项如下:
texturepack:
wanted: false # 启用资源包
url: "https://..." # 下载 URL
id: "00000000-..." # 资源包 UUID
hash: "" # 可选 SHA-1 哈希值(加速启动)
tntpickaxe:
chance: 10 # 破坏方块时生成 TNT 的概率 (%)
scythe:
soul-chance: 2 # 每次击杀收割灵魂的概率 (%)
soul-harvest-bonus: 3 # 来自“灵魂收割”升级的额外概率
timberaxe:
cooldown-seconds: 10 # 砍树之间的冷却时间(秒)
max-tree-logs: 100 # 每棵树的最大原木数量
soulsshop:
multiplier: 5
multiplier-levels: 4 # 灵魂倍增器的最大等级
multiplier-cap: 5 # 每次掉落的最大灵魂数
tntpickaxe:
fortune: 25
silktouch: 25
unbreakable: 40
timberaxe:
remove-cooldown: 30
efficiency: 15
fortune: 20
silktouch: 20
scythe:
efficiency: 15
looting: 20
soul-harvest: 50
sharpness: 20
murasame:
crafting-unlock: 100
要求
- Minecraft 1.21+
- Paper 服务器(使用 Paper API 特性,如数据组件和 Adventure API)
- Java 21+
安装
- 从 Releases 下载最新的
.jar 文件。
- 将 jar 文件放入服务器的
plugins/ 文件夹中。
- 重启服务器。
- (可选)编辑
plugins/SoulForge/config.yml 以启用资源包或调整设置。
从源代码构建
./gradlew build
编译后的 jar 文件将位于 build/libs/ 中。
由 SniperJohnny 创建,Affenix Studios 成员
SoulForge
A powerful Minecraft Paper plugin that adds custom tools, a soul harvesting system, an upgrade shop, and a built-in resource pack — all in one.
Features
Custom Tools
| Tool |
Description |
| Drill 3×3 |
A netherite pickaxe that mines a 3×3 area in one strike. Crafted with diamond blocks. |
| Drill 5×5 |
An upgraded drill that mines a 5×5 area. Crafted with netherite blocks. |
| TNT Pickaxe |
Has a configurable chance to spawn primed TNT when breaking blocks. Crafted with TNT and netherite. |
| Scythe of the Grim Reaper |
A netherite sword that harvests souls from slain mobs with a chance-based drop. |
| Timber Axe |
Fells entire trees (logs + leaves) in one chop, with a cooldown between uses. |
| Murasame |
A cursed netherite sword that applies a spreading curse to mobs — after 5 stacks, the target dies. Crafted with wither skeleton skulls. |
All custom items are unbreakable, display an enchantment glint, and support custom models via the optional resource pack.
Soul System
- Kill mobs while holding the Scythe to harvest souls.
- Souls are tracked per-player and persist across sessions (
souls.yml).
- Use
/souls to check your balance, or /soulsgive <player> <amount> to transfer souls.
- View another player's souls with
/souls <player> (requires souls.seeothers permission).
Souls Shop (/soulsshop)
Spend souls on permanent, per-player upgrades that apply whenever you craft a new tool:
| Upgrade |
Description |
Cost |
Levels |
| Souls: Multiplier |
+1 soul per drop per level (cap configurable) |
5 souls |
4 |
| Scythe: Efficiency |
Adds Efficiency enchantment |
15 souls |
5 |
| Scythe: Looting |
Adds Looting enchantment |
20 souls |
3 |
| Scythe: Soul Harvest |
Increases soul harvest chance |
50 souls |
5 |
| Scythe: Sharpness |
Adds Sharpness enchantment |
20 souls |
5 |
| TNT Pickaxe: Fortune |
Adds Fortune enchantment |
25 souls |
3 |
| TNT Pickaxe: Silk Touch |
Adds Silk Touch |
25 souls |
1 |
| TNT Pickaxe: Unbreakable |
Makes it unbreakable |
40 souls |
1 |
| Timber Axe: Remove Cooldown |
Removes the felling cooldown |
30 souls |
1 |
| Timber Axe: Efficiency |
Adds Efficiency enchantment |
15 souls |
5 |
| Timber Axe: Fortune |
Adds Fortune enchantment |
20 souls |
3 |
| Timber Axe: Silk Touch |
Adds Silk Touch |
20 souls |
1 |
| Unlock Murasame Crafting |
Permanently unlocks the Murasame recipe |
100 souls |
1 |
After purchasing an upgrade, craft the tool again to receive the new enchantments.
Resource Pack
SoulForge includes a built-in optional resource pack with custom models for all tools. The pack can be:
- Auto-downloaded by players on join (configurable in
config.yml).
- Toggled live with
/soulforge reload — no server restart required.
- Item models automatically sync across inventories, ender chests, and shulker boxes.
Crafting Recipes
All tools are craftable through vanilla-style shaped recipes. Use /recipe to browse all recipes, or /3x3recipe, /5x5recipe, /tntrecipe for specific ones. A search dialog is available via /recipe <search>.
Commands
| Command |
Description |
Permission |
/recipe [search] |
Browse all recipes or search |
— |
/3x3recipe |
Show Drill 3×3 recipe |
— |
/5x5recipe |
Show Drill 5×5 recipe |
— |
/tntrecipe |
Show TNT Pickaxe recipe |
— |
/souls [player] |
View your (or another's) soul count |
souls.seeothers (op) |
/soulsshop |
Open the Souls Shop |
— |
/soulsgive <player> <amount> |
Give souls to another player |
— |
/givesouls <player> <amount> |
Admin: give souls to a player |
givesouls (op) |
/silktouch |
Apply Silk Touch to all drills in inventory |
— |
/fortune |
Apply Fortune to all drills in inventory |
— |
/opci give/remove <player> <item> |
Admin: give/remove custom items |
drill_itemgiver (op) |
/soulforge reload |
Reload config & resource pack |
soulforge.admin (op) |
Configuration
All settings are in config.yml. Key options:
texturepack:
wanted: false # Enable the resource pack
url: "https://..." # Download URL
id: "00000000-..." # Resource pack UUID
hash: "" # Optional SHA-1 hash (speeds up startup)
tntpickaxe:
chance: 10 # % chance TNT spawns on block break
scythe:
soul-chance: 2 # % chance to harvest a soul per kill
soul-harvest-bonus: 3 # Bonus chance from Soul Harvest upgrade
timberaxe:
cooldown-seconds: 10 # Cooldown between tree fells
max-tree-logs: 100 # Maximum logs per tree
soulsshop:
multiplier: 5
multiplier-levels: 4 # Max levels for Souls Multiplier
multiplier-cap: 5 # Max souls per drop
tntpickaxe:
fortune: 25
silktouch: 25
unbreakable: 40
timberaxe:
remove-cooldown: 30
efficiency: 15
fortune: 20
silktouch: 20
scythe:
efficiency: 15
looting: 20
soul-harvest: 50
sharpness: 20
murasame:
crafting-unlock: 100
Requirements
- Minecraft 1.21+
- Paper server (uses Paper API features like Data Components and Adventure API)
- Java 21+
Installation
- Download the latest
.jar from Releases.
- Place the jar in your server's
plugins/ folder.
- Restart the server.
- (Optional) Edit
plugins/SoulForge/config.yml to enable the resource pack or adjust settings.
Building from Source
./gradlew build
The compiled jar will be in build/libs/.
Created by SniperJohnny, member of Affenix Studios
评论 0
登录后参与评分
还没有评论,来抢沙发吧