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

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:

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

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

1. Download the latest .jar from Releases.
2. Place the jar in your server's plugins/ folder.
3. Restart the server.
4. (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