SovereignTraders

NPC shop plugin for Paper 1.21+

Create shops, attach them to NPC vendors, and let players buy, sell, or barter — all through a clean in-game GUI with no YAML editing required.

Features

Requirements

• Paper 1.21+ or Folia 1.21+
• Java 21
• PacketEvents — required for vendor NPCs
• One of: Vault + EssentialsX, GemsEconomy, CoinsEngine, or PlayerPoints

Installation

1. Drop the JAR into your plugins/ folder
2. Install PacketEvents if you haven't already
3. Start the server — a default config will generate
4. Run /traders in-game to get started

See docs/installation.md for a full setup walkthrough.

Building

# Clone the repo
git clone https://github.com/JimSpecter/SovereignTraders.git
cd SovereignTraders

# Build (obfuscated with ProGuard)
./gradlew buildFree

# Development build (unobfuscated)
./gradlew shadowFreeJar

# Spin up a local test server
./gradlew runServerFree

The test server task downloads Paper automatically and pre-installs VaultUnlocked, EssentialsX, and PacketEvents. Drop any additional plugin JARs (Citizens.jar, GemsEconomy.jar, etc.) in the project root and they'll be picked up automatically.

Documentation

Contributing

See CONTRIBUTING.md. TL;DR: fork, make a focused change, ensure ./gradlew check passes, then open a PR.

License

Source-available under the PolyForm Noncommercial License 1.0.0. You can read, learn from, and modify the code for noncommercial purposes. The author retains all commercial distribution rights.