Setforge

# SetForge

SetForge is a customizable RPG equipment set editor for Paper 1.21.1 servers.

Create and manage complete equipment sets directly in game. Configure swords, armor, abilities, upgrades, recipes, effects, colors and resource-pack visuals without requiring every player to install a gameplay mod.

## Features

- In-game admin editor
- Custom swords, armor and equipment sets
- Set upgrades, cloning and independent IDs
- Slash, dash, parry, auras and weapon trails
- Custom recipes and item abilities
- Automatic resource-pack generation
- Custom PNG texture import
- Demo equipment sets
- Safe blueprint export and import
- Optional Fabric client companion for articulated 3D armor

## Requirements

- Paper 1.21.1
- Java 21

The server plugin works without the optional client companion.

## Installation

1. Put `SetForge-1.0.0.jar` into the server's `plugins` folder.
2. Start the server once.
3. Configure the resource-pack settings in `plugins/SetForge/config.yml`.
4. Use `/sf pack build` after changing equipment designs.
5. Use `/sf` to open the editor.

## Commands

- `/sf` — Open the editor
- `/sf create <id>` — Create a new set
- `/sf give <id>` — Give a complete set
- `/sf edit <id>` — Edit a set
- `/sf upgrade` — Upgrade held equipment
- `/sf slash` — Use the sword ability
- `/sf pack build` — Build the resource pack
- `/sf pack send` — Send the configured resource pack
- `/sf help` — Show all commands

The optional Fabric companion requires Minecraft 1.21.1, Fabric Loader 0.16.14 or newer, Fabric API and Java 21.