UltimateEconomyPlus

UltimateEconomyPlus is a complete economy, marketplace and server-management plugin built for modern Paper servers.

Instead of requiring separate plugins for balances, shops, auctions, crates, key events, teams, leaderboards, holograms and economy administration, UltimateEconomyPlus combines these systems into one connected economy.

All major systems use the same native balance authority, so shops, Auction House purchases, team banks, administrative balance changes and API integrations stay synchronized.

Main Features

• Complete native economy system
• Player balances and payments
• /baltop money leaderboard
• Configurable server shops
• Advanced /sell system
• Player Auction House
• Auction search, sorting and pagination
• Auction returns and expired-item recovery
• Auction transaction history
• Configurable crates
• Persistent Crate Studio editor
• Crate keys and key gifting
• KeyAll and scheduled Key Drop events
• Item Control / disabled-item protection
• Advanced Economy GUI
• Native teams
• Team banks and shared storage
• Native holograms and live leaderboards
• PlaceholderAPI support
• Scoreboard placeholders
• SmartSpawner integration
• Optional OmniPanel integration
• Auction and Shop schema system
• Schema Studio
• Native Economy API
• Native Team API
• Schema API
• Economy audit logging
• Per-server sell-price profiles
• Server warps
• Economy diagnostics and recovery systems

Native Economy

UltimateEconomyPlus contains its own native economy engine.

The economy engine is the authoritative balance source used throughout the plugin.

It powers:

• /bal
• /money
• /pay
• /bank
• /baltop
• Shops
• /sell
• Auction House
• Team banks
• Economy GUI
• APIs
• Placeholders
• Holograms
• Other supported integrations

Balances are persistent and are not separated into different databases for individual features.

Other UltimateEconomyPlus systems read and modify the same player balance.

Player Commands

Balance

/bal

View your current balance.

/bal <player>

View another player's balance where allowed.

Alias:

/balance

Payments

/pay <player> <amount>

Send money directly to another player.

Money

/money

View money information.

Administrative money clearing/reset functionality is also available to authorized staff.

Balance Top

/baltop

Opens the server money leaderboard.

This uses the same native economy balances as the rest of UltimateEconomyPlus.

Shop System

Use:

/shop

UltimateEconomyPlus includes a configurable GUI shop backed directly by the native economy.

The shop supports multiple sections, configurable prices and server-defined categories.

Examples of built-in shop areas include:

• Main Shop
• End Shop
• Nether Shop
• Gear Shop
• Food Shop
• Shard Shop
• Custom sections

Shop purchases validate the player's balance before completing the transaction.

Shop categories and individual materials can also be disabled through Item Control.

Sell System

UltimateEconomyPlus includes an advanced item selling system.

Use:

/sell

Supported functionality includes:

/sell all

/sell hand

/sell price

/sell pricecheck

/sell clearprice

/sell profile

/sell reloadprices

The sell system supports configurable item values and per-server price profiles.

The global price catalogue can be stored in:

items.properties

Individual servers can then use separate override profiles without needing completely separate copies of the entire price database.

Sell pricing supports live reloading and price-source diagnostics.

Container/shulker handling includes safety logic so unsupported leftovers are not silently destroyed.

Auction House

Use:

/ah

Aliases:

/auction

/auc

The Auction House allows players to create and purchase listings using the native UltimateEconomyPlus economy.

Supported player routes include:

/ah

/ah sell <price> [amount]

/ah my

/ah returns

The Auction House includes:

• Player listings
• Seller names
• Prices
• Expiration
• Search
• Sorting
• Multiple pages
• Up to 45 visible listings per page
• Personal listings
• Returns
• Expired listing recovery
• Configurable listing limits
• Listing fees
• Price limits
• Purchase confirmation
• Market statistics
• Seller statistics
• Average listed-price information
• Saved/watchlisted auctions
• Persistent auction data
• Automatic expiry cleanup
• Item Control enforcement
• Schema market support

Player-created and schema-created listings use the same Auction House transaction authority.

Auction Returns

Items that expire or cannot safely be delivered can be moved into the player's Auction House Returns system.

This prevents an expired or interrupted auction from simply deleting the player's item.

Players can access their returns through the Auction House interface.

Auction Transaction History

Use:

/transactions

Players can view their Auction House transaction history.

Authorized users can also inspect supported player history.

Staff tools include:

/checkah <player>

This can be used to inspect Auction House sales associated with a player.

Sell History

Use:

/showhistory <player> [page]

This provides staff with history from the /sell system.

Item Control

UltimateEconomyPlus includes an authoritative Item Control system.

Administrators can disable items or categories from economy functionality.

Item Control applies above schema configuration.

This means a schema cannot bypass a material that the server owner has disabled.

Restrictions can apply to:

• Shop items
• Auction listings
• Auction purchases
• Schema-generated AH listings
• Schema shop entries
• Recipe-style schema shops
• Schema ingredients
• Schema outputs
• Other supported economy routes

There is also a dedicated owner bypass permission for trusted use:

ultimateeconomyplus.disableditems.bypass

The bypass should only be assigned to trusted/owner accounts.

Economy GUI

Use:

/economygui

The Economy GUI is the central administration panel for UltimateEconomyPlus.

It brings the plugin's management systems into one interface instead of forcing administrators to remember large numbers of commands.

The Economy GUI provides access to systems including:

• Economy administration
• Player balance controls
• Shops
• Shop sections
• Sell pricing
• Auction House administration
• Auction health information
• Crates
• Crate Studio
• KeyAll / Key Drop controls
• Item Control
• Schema Studio
• Native Teams
• Hologram Studio
• SmartSpawner integration
• API/integration status
• Economy diagnostics
• Economy audit information
• System health information

Crates

UltimateEconomyPlus includes a native crate system.

Main commands include:

/crate

/crates

/givec

/gift

Crates support:

• Custom crate creation
• Crate deletion
• Crate renaming
• Reward editing
• Crate searching
• Crate prices
• Crate keys
• Key clearing
• Physical crate blocks
• Protected crate blocks
• Crate holograms
• Persistent rewards
• Custom ItemStacks
• Enchantments
• Item names
• Item lore
• Amounts
• Item metadata

Crate Studio

Crate Studio provides an in-game editor for crate rewards.

Administrators can add and remove items directly through the GUI.

Edited crate rewards are persisted as real item data instead of being rebuilt from a default reward template every restart.

This allows rewards to retain:

• Material
• Amount
• Display name
• Lore
• Enchantments
• Other supported ItemStack metadata

Crate saving includes additional persistence protection to reduce the risk of edited rewards being lost because of an interrupted write.

Crate Keys

UltimateEconomyPlus includes its own persistent crate-key storage.

Players can hold different quantities for supported crate types.

Keys can be:

• Awarded
• Removed
• Gifted
• Distributed through KeyAll
• Distributed through scheduled Key Drops
• Displayed through PlaceholderAPI

KeyAll / Key Drop Events

UltimateEconomyPlus includes server-wide crate-key events.

Administrators can configure scheduled key distributions or immediately give keys to everyone currently online.

Features include:

• Scheduled Key Drops
• Randomized event timing
• Countdown announcements
• Active-event status
• Queued drops
• Custom selected key bundles
• Immediate selected bundle drops
• KeyAll Now
• Event cancellation
• Player receipt notifications
• GUI controls

The system clearly reports whether an event is currently running.

When keys are delivered, players receive a clean confirmation instead of internal key maps being printed into chat.

Example:

KEY DROP » 2m remaining • 6 crates • 20 keys/player

When a player receives the reward they can also receive a title and a clean total showing how many keys were awarded.

KeyAll Scoreboard Support

PlaceholderAPI can be used to show the KeyAll countdown directly on a scoreboard, tab list, hologram or another PlaceholderAPI-compatible plugin.

Example:

%ultimateeconomyplus_keyall_timer%

Output:

00:18:42

Raw seconds are also available:

%ultimateeconomyplus_keyall_seconds%

Example:

1122

This makes it possible to create scoreboard lines such as:

Next KeyAll: %ultimateeconomyplus_keyall_timer%

PlaceholderAPI Integration

PlaceholderAPI is optional.

When PlaceholderAPI is installed, UltimateEconomyPlus registers TWO placeholder prefixes:

%ultimateeconomyplus_*%

and the shorter:

%uep_*%

Both prefixes can be used with supported placeholders.

This means:

%ultimateeconomyplus_balance%

and

%uep_balance%

resolve through the same UltimateEconomyPlus placeholder system.

Economy Placeholders

Formatted Balance

%ultimateeconomyplus_balance%

Alias:

%ultimateeconomyplus_money%

Short-prefix examples:

%uep_balance%

%uep_money%

Returns the player's formatted native UltimateEconomyPlus balance.

Raw Balance

%ultimateeconomyplus_balance_raw%

Short form:

%uep_balance_raw%

Useful for scoreboards or plugins that need a raw numeric balance value.

KeyAll Placeholders

Formatted countdown

%ultimateeconomyplus_keyall_timer%

Aliases:

%ultimateeconomyplus_keyall%

%ultimateeconomyplus_next_keyall%

Short-prefix equivalents also work:

%uep_keyall_timer%

%uep_keyall%

%uep_next_keyall%

The formatted timer uses:

HH:MM:SS

Raw countdown seconds

%ultimateeconomyplus_keyall_seconds%

or:

%uep_keyall_seconds%

Returns the remaining KeyAll countdown as seconds.

Crate Key Placeholders

Total Keys

%ultimateeconomyplus_keys%

Alias:

%ultimateeconomyplus_total_keys%

Short form:

%uep_keys%

Common Keys

%ultimateeconomyplus_common_keys%

Prime Keys

%ultimateeconomyplus_prime_keys%

Crimson Keys

%ultimateeconomyplus_crimson_keys%

King Keys

%ultimateeconomyplus_king_keys%

Combined Key Display

%ultimateeconomyplus_combined_keys%

Alias:

%ultimateeconomyplus_crate_keys%

These also support the %uep_*% prefix.

Native Teams

UltimateEconomyPlus includes a complete team system inside the same plugin.

Use:

/team

Alias:

/teams

The team system includes:

• Team creation
• Invitations
• Invitation expiration
• Public joining
• Leaving
• Kicking
• Team renaming
• Protected disbanding
• Ownership
• Co-Leader role
• Moderator role
• Trusted role
• Member role
• Recruit role
• Friendly fire configuration
• Team homes
• Delayed home teleport
• Movement-cancelled teleport
• Team chat
• Ally chat
• Staff chat spy
• Shared team storage
• Alliances
• Alliance requests
• Team bank
• Team member leaderboards
• Team bank leaderboards
• Team administration
• Recent team-chat moderation history
• Team data persistence
• Team import support

Team banks use the same UltimateEconomyPlus native economy authority.

They are not a separate money system.

Team Administration

Authorized administrators can use:

/team admin

UltimateEconomyPlus includes a complete Team Admin interface.

Staff can manage:

• Team creation
• Team disbanding
• Members
• Roles
• Ownership
• Team names
• Public joining
• Friendly fire
• Homes
• Team banks
• Team storage
• Alliances
• Recent team chat
• Team/player searches
• Bulk administration controls

Administrative Team API actions use the same authoritative team persistence and audit routes as normal player actions.

Team PlaceholderAPI Support

UltimateEconomyPlus provides scoreboard-compatible placeholders for the native team system.

Team Name

%ultimateeconomyplus_team_name%

Team ID

%ultimateeconomyplus_team_id%

Member Count

%ultimateeconomyplus_team_members%

Team Bank

%ultimateeconomyplus_team_bank%

Public Joining

%ultimateeconomyplus_team_public%

Friendly Fire

%ultimateeconomyplus_team_friendly_fire%

Player Team Role

%ultimateeconomyplus_team_role%

The short %uep_*% prefix also works.

For example:

%uep_team_name%

%uep_team_role%

%uep_team_bank%

These placeholders can be used with scoreboard, tab-list, nametag or hologram plugins that support PlaceholderAPI.

Example Scoreboard

UltimateEconomyPlus can provide all of the economy/team information while your scoreboard plugin handles the visual scoreboard itself.

Example configuration:

&6&lSKYSTRIKE
&7
&fMoney: &a$%ultimateeconomyplus_balance%
&fTeam: &b%ultimateeconomyplus_team_name%
&fRole: &e%ultimateeconomyplus_team_role%
&fTeam Bank: &a$%ultimateeconomyplus_team_bank%
&7
&fKeys: &d%ultimateeconomyplus_total_keys%
&fNext KeyAll: &e%ultimateeconomyplus_keyall_timer%