Описание
**Server Market** is a Fabric server-side mod that brings a complete player-driven economy and marketplace to your server. Players can check their balance, send money to others (even offline players), and review their transaction history — all through simple commands or an intuitive GUI. The mod features both a player market and a system shop where items can be listed, bought, and sold with full NBT variant support. It also supports purchase orders with parcel station delivery, so buyers can place requests and sellers can fulfill them without needing to meet face-to-face. Administrators can optionally introduce physical currency items, set up system shop prices, manage player balances directly, and configure the economy to suit their needs. Storage defaults to SQLite for zero-setup operation, but can be switched to MySQL with optional [XConomy](https://www.spigotmc.org/resources/xconomy.75669/) record mirroring for shared database environments. For server owners running 1.21.9 or newer, the mod bundles Placeholder API support out of the box. Developers can hook into the exposed API and event system to query balances, process transfers, intercept purchases, or integrate the economy into their own mods.
## Requirements
Required:
- **[Fabric API](https://modrinth.com/mod/fabric-api)** (version matched to your MC version)
- **[Fabric Language Kotlin](https://modrinth.com/mod/fabric-language-kotlin)** **1.13.8+kotlin.2.3.0**
- **[Fabric Permissions API](https://modrinth.com/mod/fabric-permissions-api)** **0.5.0**
Optional:
- **[LuckPerms](https://modrinth.com/mod/luckperms)** (recommended) for permission management
- **[Placeholder API](https://modrinth.com/mod/placeholder-api)** (1.21.9+ JAR only)
## Commands
Player:
```bash
/svm
/svm menu
/svm money
/svm balance
/svm pay
/svm history [page]
/svm sell
/svm restock
/svm pull
/svm list
/svm search
/svm buy [seller]
/svm cash
/svm exchange
/svm order
/svm supply
```
Admin:
```bash
/svm admin balance
/svm admin set
/svm admin add
/svm admin remove
/svm admin rank
/svm admin history [page]
/svm admin price [limit]
/svm admin pull
/svm admin purchase [limit]
/svm admin cash
/svm admin cash get
/svm admin cash del
/svm admin cash list [item]
/svm admin reload
```
## Updates
- Command wording updated:
- purchase order: `/svm purchase` -> `/svm order`
- sell to buyer: `/svm selltopurchase` -> `/svm supply`
- Removed command group: `/svm edit` (admin commands are now under `/svm admin`).
- Deprecated: `/svm admin lang`
## Placeholder API
Available in the **1.21.9+ JAR only** when Placeholder API is installed:
- `%server-market:balance%`
- `%server-market:balance_short%`
- `%server-market:parcel_count%`
- `%server-market:player_name%`
- `%server-market:top_name:%` (rank 1–10)
- `%server-market:top_balance:%` (rank 1–10)
- `%server-market:top_balance_short:%` (rank 1–10)
## Integration API
Entry point: `asagiribeta.serverMarket.api.ServerMarketApiProvider`
- `getBalance`, `hasEnough`, `getParcelCount`
- `addBalance`, `withdraw`, `setBalance`, `transfer`
- `getTopBalances`, `getHistory`, `format`, `openMenu`, `getModVersion`
EconomyProvider (Vault-style): `asagiribeta.serverMarket.api.economy.EconomyProviderRegistry`
- `withdraw`, `format`
Events:
- `ServerMarketEvents.BALANCE_CHANGED`
- `ServerMarketEvents.PRE_PURCHASE` (return false to cancel)
- `ServerMarketEvents.POST_PURCHASE`
## Configuration / Storage
Config file: `config/server-market/config.properties`
Reload in-game: `/svm admin reload`
### Economy
| Key | Default | Description |
|-----|---------|-------------|
| `initial_player_balance` | `100.0` | Balance for first-time joiners |
| `max_transfer_amount` | `1000000.0` | Max amount per `/svm pay` |
| `enable_transaction_history` | `true` | Record transactions |
| `max_history_records` | `10000` | Auto-prune oldest records |
| `enable_tax` | `false` | Tax on player shop sales |
| `market_tax_rate` | `0.05` | Tax rate (0.0–1.0) |
### Storage (SQLite — default)
| Key | Default | Description |
|-----|---------|-------------|
| `storage_type` | `sqlite` | `sqlite` or `mysql` |
| `sqlite_path` | `market.db` | Database file path |
### Storage (MySQL / [XConomy](https://www.spigotmc.org/resources/xconomy.75669/))
Set `storage_type=mysql` and configure `mysql_host`, `mysql_port`, `mysql_database`, `mysql_user`, `mysql_password`, `mysql_use_ssl`, `mysql_jdbc_params`.
[XConomy](https://www.spigotmc.org/resources/xconomy.75669/) table names (when sharing an existing database):
| Key | Default |
|-----|---------|
| `xconomy_player_table` | `xconomy` |
| `xconomy_non_player_table` | `xconomynon` |
| `xconomy_record_table` | `xconomyrecord` |
| `xconomy_login_table` | `xconomylogin` |
| `xconomy_system_account` | `SERVER` |
| `xconomy_write_record` | `false` |
Set `xconomy_write_record=true` to mirror transactions into [XConomy](https://www.spigotmc.org/resources/xconomy.75669/)'s record table (MySQL only).
### Debug
| Key | Default | Description |
|-----|---------|-------------|
| `enable_debug_logging` | `false` | Verbose debug logs |