StarBucks

StarBucks is a Paper plugin that turns Nether Stars into a server-traded commodity.

Players can buy and sell Nether Stars through /starbank, track a live market price, pay credits to other players, and view recent transaction history.

Features

Dynamic Nether Star pricing based on shared server supply
Buy and sell orders through /starbank
Bulk trade confirmation with price impact preview
Player balances stored by UUID
Player-to-player payments
Transaction history ledger
Admin market simulation tools
Simple config.yml economy tuning

Requirements

Paper 1.21.11
Java 21

Installation

Stop your server.
Download the latest StarBucks release JAR.
Place the JAR in your server's plugins folder.
Start the server once to generate config and data files.
Edit plugins/StarBucks/config.yml if needed.
Restart the server.

Commands

Command	Description
`/starbank buy <amount>`	Buy Nether Stars from the bank
`/starbank sell <amount>`	Sell Nether Stars to the bank
`/starbank confirm`	Confirm a pending bulk buy or sell
`/starbank rate`	View current market prices and trend
`/starbank bal`	View your balance
`/starbank balance`	Alias for `/starbank bal`
`/starbank pay <player> <amount>`	Send credits to an online player
`/starbank ledger`	View your recent transactions
`/starbank admin`	View admin market stats
`/starbank admin sim <amount>`	Simulate a buy or sell impact

Permissions

All commands are player-only.
Admin commands require op.

Config

Default config.yml:

economy:
  star:
    starting-price: 75
    base-price: 250
    min-price: 25
    max-price: 1000
    smoothing-factor: 0.15
    tax: 0.03
    spread: 0.08
    volume-normalization: 256
    volume-decay: 0.95

What the main settings do:

starting-price: price used when supply is empty
base-price: overall market price scale
min-price: floor price
max-price: ceiling price
smoothing-factor: how quickly the market moves toward target price
tax: sell-side reduction
spread: buy-side markup
volume-normalization: how strongly recent volume affects price
volume-decay: how quickly recent volume fades per trade

Notes

New players start with 0.0 credits.
The bank starts with 0 Nether Stars in supply.
Players cannot buy stars until stars have first been sold into the bank or supply is seeded manually.
/starbank pay only works on online players.
This plugin uses its own internal balance system and does not integrate with Vault.

License

Released under the Unlicense. See LICENSE.