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

1. Stop your server.
2. Download the latest StarBucks release JAR.
3. Place the JAR in your server's plugins folder.
4. Start the server once to generate config and data files.
5. Edit plugins/StarBucks/config.yml if needed.
6. 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.