EcoSTG Paper - Purpur

Lightweight Paper - Purpur 1.21.11 plugin: economy, auction house, jobs, and an ESC hub menu (Dialog API).

Current version: 1.5.11   Output jar: build/libs/EcoSTG-1.5.11.jar

Requirements

• Paper - Purpur1.21.11+ (Java 21)
• No Vault or other economy plugins required (own SQLite economy)

Features

Economy

• Starting balance: 500 Dollars (configurable)
• /pay — pick a player and amount (hub + presets / custom), or /pay <player> <amount>
• /shop /ah /auction — auction house (forever listings, unlimited per player, buy confirmation)
• /sell — list any item on the AH with a custom price
• /moneytop — top 10 richest players
• /ecoset <player> <amount> / /ecogive <player> <amount> — OP
• /ecostg toggle <player> <on|off> — disable economy for a player (OP)

Jobs

• /job — choose one job
• /jobsell — sell required job items on the AH with badge By a worker + discount % (visible to everyone)
• /jobinfo — chat status (days until delivery due)
• Miss the in-game-day deadline → fired + real-day cooldown
• /jobcancel /activejobs /job-timer-reset — OP

ESC / hub menu

• Pause screen button labeled with main letters (default EcoSTG)
• Or /menu (/ecostgmenu)
• Hub: Homes, Auction, Sell, Teleport, Leaderboards, RTP, RTP Queue, Friends, Pay, Stats, Settings
• Matching chat commands for every hub feature (/tpa, /rtp, /stats, /home, …)
• /ecostg mainletters change <name> — OP (ESC button title needs a server restart)

Logging

Important actions are logged as [ACTION] in the server console.

Commands

Build

./gradlew jar

Use JDK 21. On Windows with a custom JDK:

$env:JAVA_HOME = "$env:USERPROFILE\jdk-21\jdk-21.0.12+8"
.\gradlew.bat jar

Install

1. Put EcoSTG-1.3.9.jar in plugins/
2. Start once to generate config.yml, worth.yml, jobs.yml, and ecostg.db
3. Edit configs, then restart (prefer restart over /reload for Paper plugins)

Config highlights

starting-balance: 500.0
currency-name: Dollars
currency-symbol: "$"


menu:
  main-letters: "EcoSTG"


homes:
  max: 3


rtp:
  cooldown-seconds: 30
  max-radius: 1500
  min-radius: 32
  max-attempts: 80


auction:
  sale-tax-percent: 5.0


jobs:
  deadline-ingame-days: 4
  fire-cooldown-real-days: 30
  ah-buyer-discount-percent: 8.0
  worker-listing-discount-percent: 5.0

• worth.yml — suggested AH prices (and sell hints)
• jobs.yml — job definitions and delivery items

Notes

• This is a Paper and Purpur plugin (paper-plugin.yml + bootstrap). Commands are registered in code, not via YAML.
• Server Links entries are vanity URLs only; the real menu is the ESC button or /menu.
• Changing main-letters updates live menus immediately; the ESC pause button label updates after restart.

Enjoy, STGHECKER