UCExchange

!(https://img.shields.io/bstats/servers/30365?style=for-the-badge&label=Servers) !(https://img.shields.io/bstats/players/30365?style=for-the-badge&label=Players)

# UCExchange

UCExchange is a complete daily rotating exchange market plugin for Paper and Folia servers.

It allows players to exchange common resources for money or rarer items through a clean and configurable GUI.

Available offers can rotate automatically, keeping the market fresh and encouraging players to return regularly.

UCExchange is designed for survival, economy, public, and custom servers that need a dynamic exchange system without installing a complete shop plugin.

The plugin includes in-game administration, transaction tracking, SQLite and MySQL support, audit logs, Discord webhook notifications, PlaceholderAPI integration, bStats metrics, and update checking.

Everything can be configured, including the menu, available offers, rotation behavior, messages, database settings, webhook notifications, permissions, and administrative tools.

## Features

• Daily rotating exchange market
• Clean GUI-based exchange menu
• Resource-to-money exchanges using Vault
• Resource-to-item exchanges
• Automatic market rotation
• Configurable rotation interval
• Manual market rotation
• Complete in-game offer management
• Create offers using items held by the administrator
• Activate offers in specific GUI slots
• Delete configured offers
• List all configured offers
• SQLite local database support
• MySQL database support
• Detailed player transaction tracking
• Administrative audit logs
• Console exchange logs
• Discord webhook logs
• PlaceholderAPI support
• bStats integration
• Modrinth update checker
• Vault transaction validation
• Automatic item refund when a payment fails
• Configurable messages
• Configurable menu title and size
• Configurable offer slots
• Configurable item names and lore
• Shift-click maximum exchange support
• Separate administrator permissions
• Dedicated Paper 1. 21. 11 build
• Dedicated Paper and Folia 26. 1 build

## Commands

### Player Commands

`/dailyexchange`

`/exchange`

Opens the daily exchange market.

### Administrator Commands

Displays all configured exchange offers.

`/de create money `

Creates an item-to-money offer using the item held in the administrator's main hand.

`/de create item `

Creates an item-to-item offer using the main hand as the required item and the off-hand as the reward item.

`/de activate `

Activates an existing offer immediately in a selected GUI slot.

`/de delete `

Deletes a configured offer.

Displays recent player transactions.

`/de logs `

Displays a specific number of recent player transactions.

`/de refresh`

Forces a new market rotation.

`/de reload`

Reloads the UCExchange configuration.

## Creating a Money Offer

Hold the required item in your main hand.

The amount contained in the held stack becomes the required exchange quantity.

Hold 64 wheat in your main hand and execute:

`/de create money wheat_sale 250`

The following exchange will be created:

`64 Wheat → $250`

The identifier `wheat_sale` can then be used to activate, list, or delete the offer.

Example activation:

`/de activate wheat_sale 10`

This activates the offer in GUI slot 10.

## Creating an Item Offer

Place the required item in your main hand.

Place the reward item in your off-hand.

The amount of each held stack is used as the exchange quantity.

`16 Diamonds`

`32 Emeralds`

`/de create item diamond_emerald`

The following exchange will be created:

`16 Diamonds → 32 Emeralds`

Example activation:

`/de activate diamond_emerald 12`

## Permissions

### Player Permission

`ucexchange.use`

Allows players to open and use the daily exchange market.

### Global Administrator Permission

`ucexchange.admin`

Grants access to every UCExchange administrator feature.

This permission includes:

• `ucexchange.admin.view`
• `ucexchange.admin.logs`
• `ucexchange.admin.edit`
• `ucexchange.admin.rotate`
• `ucexchange.admin.reload`

### Detailed Administrator Permissions

`ucexchange.admin.view`

Allows administrators to view configured offers and administrative information.

`ucexchange.admin.logs`

Allows administrators to view player transaction history.

`ucexchange.admin.edit`

Allows administrators to create, activate, modify, and delete exchange offers.

`ucexchange.admin.rotate`

Allows administrators to force a new market rotation.

`ucexchange.admin.reload`

Allows administrators to reload UCExchange.

## Database Support

UCExchange supports two storage systems:

• SQLite
• MySQL

SQLite is enabled by default and does not require an external database server.

The local SQLite database is automatically created at:

`plugins/UC