EcoSTG Paper

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

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

Requirements

• Paper 1.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)

Button	What it does
Homes	Up to 3 homes; set & instant teleport
Auction / Sell	Existing AH GUIs
Teleport	TPA / TPAHere (accept required; no timeout). Privacy can allow instant TPA for anyone/friends/nobody
Leaderboards	Money, playtime, kills, deaths, blocks, mobs
RTP	Random spot in current world, inside the world border (cooldown)
RTP Queue	Teleport to a random online player (no cooldown)
Friends	Follow someone; you are friends only when they follow you back
Pay	Pay online players
Stats	View a player's profile (respects privacy settings)
Settings	Chat, notifications, visuals, privacy, general toggles

Logging

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

Commands

Command	Who	Description
/menu	Everyone	Open hub
/ecostg / /ecostg help	Everyone	In-game help
/tpa [player] /tpahere [player]	Everyone	Teleport requests
/tpaccept /tpdeny	Everyone	Accept / deny TPA
/rtp /rtpq	Everyone	Random teleport / random player
/home [name] /sethome [name] /delhome <name>	Everyone	Homes
/stats [player]	Everyone	Stats (respects privacy)
/friend add	remove	list
/leaderboard [type] /lb	Everyone	Leaderboards
/settings	Everyone	Settings menu
/pay [player] [amount] /bal [player]	Everyone	Pay / balance
/shop /sell /moneytop	Everyone	Auction house
/job /jobsell /jobinfo	Everyone	Jobs
/ecoset /ecogive /ecostg toggle	OP	Economy admin
/jobcancel /activejobs /job-timer-reset	OP	Jobs admin
/ecostg mainletters change <name>	OP	ESC / hub title

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 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