StarBucks

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

```yaml 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.