Logo
MINECRAFTBIBLE
Items
Items

All game items

Blocks
Blocks

Building blocks

Mobs
Mobs

Creatures & monsters

Biomes
Biomes

World biomes

Structures
Structures

Generated structures

Recipes
Recipes

Crafting guides

Advancements
Advancements

Achievements

Loot Tables
Loot Tables

Drop rates

Tags
Tags

Item groupings

All Versions
View all data รขโ€ โ€™
Capes
Cape ArchiveNEW

Browse rare Minecon capes, OptiFine capes, and custom capes from players worldwide

Browse

Player Database
Player DatabasePopular

Search any player

Skin Browser
Skin Browser

Browse & download skins

Cape Gallery
Cape GalleryNEW

Minecon & OptiFine capes

Seed Vault
Seed Vault

Curated seeds

Learn

Guides
GuidesNew

Tutorials & tips

Blog
Blog

News & updates

Community

Community Hub
Community HubHub

Posts, discussions & more

All Versions
View community รขโ€ โ€™
Seed Analyzer
Seed Analyzer

World seed analysis

Loot Explorer
Loot Explorer

Drop rates

Crafting Calculator
Crafting Calculator

Material planning

Enchant Calculator
Enchant Calculator

Probability math

Redstone Lab
Redstone Lab

Signal timing

Trading Profit
Trading Profit

Villager ROI

All Versions
View all tools รขโ€ โ€™
Mods
Mods

Browse all mods

Plugins
Plugins

Server plugins

Resource Packs
Resource Packs

Textures & sounds

Shaders
Shaders

Visual enhancements

Datapacks
Datapacks

World logic

Scanner
Mod Intelligence

Scan & analyze any mod

All Versions
View all mods รขโ€ โ€™
Loading...
IntroductionIntroductionVersion HistoryVersion HistoryGuidesGuidesBlog & NewsBlog & News
ItemsItemsBlocksBlocksMobsMobsRecipesRecipesBiomesBiomesStructuresStructuresAdvancementsAdvancementsLoot TablesLoot TablesTagsTags
ModsModsPluginsPluginsResource PacksResource PacksShadersShadersDatapacksDatapacks

MinecraftBible

The Ultimate Wiki

Logo
MINECRAFTBIBLE

The ultimate Minecraft reference. Every item, block, mob, and recipe documented with precision.

Community

  • Skin Browser
  • Cape Gallery
  • Seed Vault
  • Blog
  • Guides

Database

  • Items
  • Blocks
  • Mobs
  • Recipes
  • Biomes
  • Structures

Tools

  • Seed Analyzer
  • Mod Intelligence
  • Crafting Calculator
  • Enchant Calculator

Mods & Packs

  • Mods
  • Plugins
  • Resource Packs
  • Shaders
  • Datapacks

Site & Legal

  • About
  • Authors
  • Editorial Policy
  • Corrections
  • Contact
  • Privacy Policy
  • Terms of Service
  • DMCA
  • Sitemap

ยฉ 2026 MinecraftBible. Not affiliated with Mojang or Microsoft.

PrivacyTermsContact
RelishEconomy
PluginLicenseRef-License

RelishEconomy

[BIG UPDATE ๐Ÿ”ฅ] ๐Ÿ’ฐ multi-Currency Economy โ€ข Shop โ€ข Sell GUI โ€ข Physical Currency โ€ข ATM โ€ข Natural source currencyโญ

529
Downloads
4
Followers
1 months ago
Updated
๐Ÿ“ฆ
15
Versions
economygame-mechanicsutilitybukkitpaperpurpurspigot
Download Latestv1.1.5-BetaView on Modrinth

๐Ÿ“–About RelishEconomy

๐Ÿ’ฐ Multi-Currency Economy โ€ข Shop โ€ข Sell GUI โ€ข Physical Currency

Relish-Economy-Logo
M5LB Store Banner
Discord
Documentation
Issues
Store
Donate


๐ŸŒŸ Why Choose RelishEconomy?

RelishEconomy provides a solid economy foundation with multi-currency support, database flexibility, and seamless plugin integrations. Built for modern Minecraft servers with performance and reliability in mind.

โœจ Key Highlights

๐Ÿฆ Multi-Currency System - Support for multiple custom currencies
๐Ÿš€ High Performance - Advanced caching with Caffeine for fast operations
๐Ÿ”ง Full Integration - Vault and PlaceholderAPI support
๐Ÿ—„๏ธ Database Flexibility - SQLite and MySQL support
๐ŸŒ Multi-Language - Built-in English, Arabic, and Portuguese translations


๐Ÿ“‹ Requirements

Component Requirement
Minecraft 1.21+
Server Paper, Purpur, or Paper-based forks
Java 21+
Soft Dependencies Vault (recommended), PlaceholderAPI (optional)

๐Ÿš€ Features Overview

๐Ÿ†“ Free Version

  • โœ… Basic economy commands (/balance, /pay, /baltop, /eco)
  • โœ… Multi-currency system with custom properties
  • โœ… Per-currency formatting, permissions, and decimal control
  • โœ… Currency exchange with per-currency exchange rates
  • โœ… Command-based selling (/sellhand, /sellhotbar, /sellall)
  • โœ… Sold-item hover breakdowns for sell commands
  • โœ… Baltop leaderboard placeholders and balance placeholders
  • โœ… Data migration from other plugins
  • โœ… Player username storage alongside UUID balances
  • โœ… Towny and Vault economy compatibility
  • โœ… Vault and PlaceholderAPI support
  • โœ… SQLite and MySQL support
  • โœ… Config validation, backup, and auto-recovery for bundled files

โญ Premium Version

  • โญ Shop GUI with category browsing
  • โญ Sell GUI for item selling
  • โญ Transaction Logs GUI for sell history navigation
  • โญ Block interactions (shop/sell blocks)
  • โญ GUI customization and interactions
  • โญ Physical currency withdraw and shift-deposit
  • โญ ATM GUI for physical currency deposit and withdraw
  • โญ Craftable physical currency with owner metadata
  • โญ Custom model data support for physical currencies
  • โญ Natural-source currency conversion for configured item sources
  • โญ Composter selling - throw items on composter to sell them

๐Ÿ“ฆ Installation

  1. Download the plugin JAR file
  2. Place it in your server's plugins folder
  3. Start/Restart your server
  4. (Optional) For premium features, buy a license key from M5LB Store
  5. Place license key in config.yml
  6. Reload the plugin
# Quick setup commands
/re help          # View all commands
/re version       # Check plugin status
/re reload        # Reload configuration

๐ŸŽฎ Commands & Usage

๐Ÿ‘ค Player Commands

Command Description Example
/balance [player] [currency] Check balance /bal coins
/pay <player> <amount> Send money /pay Steve 100
/baltop [currency] [page] View leaderboard /baltop dollars 2
/currency <list|info> View currencies /currency list
/exchange <from> <to> <amount> Convert currencies /exchange dollars coins 500
/shop โญ Open shop GUI /shop
/shop help โญ Show shop help /shop help
/sell [subcommands] โญ Open sell GUI /sell price
/re atm โญ Open ATM GUI /re atm
/sellhand Sell item in hand /sellhand
/sellhotbar Sell hotbar items /sellhotbar
/sellall Sell all items /sellall confirm
/withdraw <currency> <amount> โญ Get physical currency /withdraw coins 10

๐Ÿ‘‘ Admin Commands

Command Description Example
/eco <give|take|set> <player> <amount> Manage balances /eco give Steve 1000
/re reload Reload configuration /re reload
/re migrate <plugin> <currency> Import from other plugins /re migrate essentials dollars

๐Ÿ’ก Amount Shortcuts

  • k = thousand (e.g., 5k = 5,000)
  • m = million (e.g., 2m = 2,000,000)
  • b = billion (e.g., 1b = 1,000,000,000)

๐Ÿ”ง Configuration

Currency Setup

currencies:
  dollars:
    name: "dollars"
    symbol: "$"
    display-name: "Dollars"
    color: "<green>"
    default: true
    starting-balance: 100.0
    payments-enabled: true
    permission: ""
    decimals-enabled: true
    exchange-rates:
      coins: 0.01
    physical-item:
      material: PAPER
      deposit-enabled: true
      withdraw-enabled: true
      name: "<green><bold>Dollar Bill"
      lore:
        - "<gray>Value: {formatted_amount}"
        - "<gray>Owner: <white>{owner}"
        - ""
        - "<yellow>Shift + Right-Click to deposit"
    crafting:
      enabled: false
      value: 100.0
      amount: 1

  coins:
    name: "coins"
    symbol: "โ—Ž"
    display-name: "Coins"
    color: "<gold>"
    default: false
    starting-balance: 50.0
    payments-enabled: true
    permission: ""
    decimals-enabled: false
    exchange-rates:
      dollars: 100.0
    physical-item:
      material: GOLD_NUGGET
      deposit-enabled: true
      withdraw-enabled: true
      name: "<gold><bold>Gold Coin"
      lore:
        - "<gray>Value: {formatted_amount}"
        - "<gray>Owner: <white>{owner}"
        - ""
        - "<yellow>Shift + Right-Click to deposit"
      custom-model-data: 2001
      natural-source:
        enabled: true
        value-per-item: 1.0
        match-any-meta: false
    crafting:
      enabled: false
      value: 1.0
      amount: 1

๐Ÿ—„๏ธ Database Options

database:
  type: sqlite  # or mysql for networks
  
  mysql:
    host: localhost
    port: 3306
    database: relisheconomy
    username: root
    password: password

โญ Physical currency notes and coins keep the owner name in their item metadata. /withdraw sets the owner to the player, crafted physical currency is rewritten to the crafting player, and custom model data can be applied per currency item.

Physical coin

โญ Natural-source currency conversion can also turn configured gameplay item sources into the physical currency item itself. This is configured per currency.

Natural-currency

โญ ATM menu for physical currencies. Players can deposit supported currency items directly into the tray, switch between currencies, choose withdraw amounts, and confirm the action from a single GUI.

ATM Highlights:

  • Deposit tray - Queue supported physical currency items for deposit
  • Withdraw flow - Select currency, adjust amount, and withdraw as physical items
  • Block access - Open the ATM from a configured block interaction
  • Shop-style layout - Uses the same focused quantity workflow as the purchase GUI

ATM Config

atm:
  enabled: true
  block:
    material: LOOM
    require-sneak: true

ATM Overview

๐Ÿ”„ Currency Exchange

exchange-fee-percentage: 2.5

currencies:
  dollars:
    exchange-rates:
      coins: 0.01  # 1 dollar = 0.01 coins
  coins:
    exchange-rates:
      dollars: 100.0  # 1 coin = 100 dollars

๐Ÿ”„ Data Migration

RelishEconomy can import data from other economy plugins:

Supported Plugins:

  • EssentialsX - Import from userdata files
  • CMI - Import from SQLite database
  • TokenManager - Import token balances
  • PlayerPoints - Import point balances
  • CoinsAPI - Import coin balances
  • GemsEconomy - Import gem balances

Migration Features:

  • โœ… Automatic detection of source plugin data
  • โœ… UUID conversion for modern Minecraft
  • โœ… Offline player support - migrates all accounts
  • โœ… Progress tracking with detailed reports
  • โœ… Async processing - no server lag

โญ Shop System

๐Ÿ“ฆ Shop Features

RelishEconomy's premium shop system provides a comprehensive item marketplace with intuitive GUI interfaces and flexible configuration options.

ShopGUI

Core Shop Capabilities:

  • Creative-style categories (11) - Default layout follows the creative inventory tab order (operator utilities disabled by default)
  • Favorites system - Favorite items, browse a dedicated favorites view, and optionally render favorites with a glow highlight (favorites.yml)
  • Purchase GUI flow - Click an item to open a buy menu with quantity +/- controls, confirm/cancel, and back-to-category paging
  • Dynamic pricing - Buy prices can be calculated from sell prices using a configurable multiplier
  • Category management - Enable/disable categories, set icons, and control slots with page:slot
  • Search + paging - Search across categories and navigate pages
  • Optional disabled display - Show items with no buy price as disabled instead of hiding them (show-unpriced-items)

Shop GUI Interface:

  • Category browser - Navigate creative-style category tabs
  • Item preview - See item details and buy prices
  • Balance display - Live balance display in the GUI
  • Sound effects - Audio feedback for purchases and navigation (configured in gui.yml)
  • Pagination - Navigate through multiple pages of items
  • Search functionality - Find items across all categories

๐Ÿช Shop Configuration

# shop.yml
shop:
  enabled: true
  buy-currency: "dollars"
  buy-multiplier: 2.0
  items-per-page: 28
  show-unpriced-items: false

categories:
  building_blocks:
    display-name: "Building Blocks"
    icon: STONE
    enabled: true
    slot: "1:0"
    items:
      - STONE
      - COBBLESTONE
      - BRICKS
      # ... more items

Available Categories (Default Layout):

  • Building Blocks
  • Colored Blocks
  • Natural Blocks
  • Functional Blocks
  • Redstone Blocks
  • Tools & Utilities
  • Combat
  • Food & Drinks
  • Ingredients
  • Spawn Eggs
  • Operator Utilities (disabled by default)

๐ŸŽฏ Shop Commands

/shop                    # Open main shop interface
/shop help               # Show shop help

๐Ÿ’ฐ Sell System

๐Ÿ“ค Sell Features

The sell system provides multiple ways for players to convert their items into currency, from quick command-based selling to an interactive GUI interface.

Relish-Economy-SellGUI.gif

Sell Methods:

  • Command-based selling - Quick /sellhand, /sellhotbar, and /sellall commands (Free)
  • โญ Interactive Sell GUI - Drag-and-drop interface for selective selling
  • Auto-grab functionality - Automatically collect sellable items from inventory
  • Price calculation - Real-time value calculation with currency conversion
  • Confirmation system - Prevent accidental sales with confirmation prompts
  • โญ Logs view - Open sell history from the sell GUI

SellGUI

Advanced Sell Features:

  • Multi-currency payouts - Receive payment in configured target currency
  • Bulk selling - Sell entire stacks or inventory contents at once
  • 500+ sellable items - Comprehensive item price database
  • โญ Composter selling - Throw items on composter for instant selling
  • Transaction logging - Track all sell transactions for auditing
  • Sold-items hover summary - Hover chat output to view sold item breakdown

Sell Hover Preview

๐ŸŽฎ Sell Commands (Free)

/sellhand               # Sell the item in your hand
/sellhotbar             # Sell all sellable items in your hotbar
/sellall                # Sell all sellable items in inventory
/sellall confirm        # Confirm bulk selling with safety check

These commands work without a premium license. Only the sell GUI, composter selling, and sell block interactions are premium.

โญ Sell GUI Interface

The premium Sell GUI provides an intuitive drag-and-drop interface for item selling:

GUI Features:

  • Drag-and-drop zones - Simply drag items to sell them
  • Quick grab button - Auto-collect all sellable items from inventory
  • Live pricing - See total sale value update as you add items
  • Total calculator - View total sale value before confirming
  • Confirmation system - Confirm sale with total summary
  • Sound effects - Audio feedback for all interactions

โš™๏ธ Sell Configuration

# prices.yml
sell:
  enabled: true

target-currency: "dollars"

prices:
  # Basic format
  STONE: 0.5
  COBBLESTONE: 0.3
  OAK_LOG: 1.5
  
  # Multi-currency format (if needed)
  DIAMOND: { price: 100, currency: "gems" }
  EMERALD: { price: 150, currency: "tokens" }

500+ Sellable Items Including:

  • Stone variants - Stone, cobblestone, bricks, deepslate
  • Wood materials - All logs, planks, stripped variants
  • Natural blocks - Dirt, sand, gravel, clay
  • Precious materials - Diamonds, emeralds, gold, iron
  • Nether materials - Netherrack, soul sand, nether bricks
  • End materials - End stone, purpur blocks
  • Mob drops - Bones, string, gunpowder, leather
  • Food items - Wheat, carrots, potatoes, meat

โญ Sell Block Interactions

Premium users can use physical blocks for convenient item selling:

Sell Block Features:

  • Right-click COMPOSTER - Opens sell GUI interface
  • Composter item selling - Throw items on composter to sell instantly
  • Configurable cooldown - Prevents spam (500ms default)
  • Visual/audio feedback - Confirmation messages and sounds
# config.yml
composter-selling:
  enabled: true
  cooldown: 500

sell-gui-block: COMPOSTER
shop-gui-block: EMERALD_BLOCK

โญ Physical Currency

Players can withdraw supported currencies into physical items, trade them, then deposit them back with Shift + Right-Click.

Each currency can control this separately:

  • currencies.<name>.physical-item.withdraw-enabled
  • currencies.<name>.physical-item.deposit-enabled
  • currencies.<name>.crafting.enabled
  • currencies.<name>.physical-item.custom-model-data
  • currencies.<name>.physical-item.natural-source.enabled

Crafted physical currency also stores the crafting player as the owner, matching withdrawn notes and coins.


โญ GUI Features

โญ Shop Interface

The premium shop GUI provides an elegant and user-friendly shopping experience with full customization options.

ShopGUI

Interface Highlights:

  • Category browsing with configurable icons and colors
  • Item purchasing with multiple quantity options (1, 32, 64)
  • Balance display with live updates
  • Sound effects for all interactions
  • Configurable GUI size and layout options
  • Permission-based category access

โญ Sell Interface

The premium sell GUI offers an intuitive drag-and-drop experience for item selling.

Interface Features:

  • Drag-and-drop item selling with visual feedback
  • Quick grab button to auto-collect sellable items
  • Live value calculation and display
  • Confirmation system with total sale summary
  • Sound effects and particle animations
  • Multi-currency payout options

โญ GUI Customization

Premium users have full control over GUI appearance and behavior:

Customization Options:

  • GUI sizes - Choose from 9, 18, 27, 36, 45, or 54 slot layouts
  • Custom titles - Set personalized GUI titles with color codes
  • Item icons - Use any material as category or button icons
  • Sound effects - Configure custom sounds for different actions
  • Layout templates - Pre-designed layouts or create your own

๐Ÿ”Œ Integrations

๐Ÿ›๏ธ Vault API

Full economy provider implementation:

  • getBalance(), depositPlayer(), withdrawPlayer()
  • Compatible with any plugin using Vault
  • Multi-currency support through Vault
  • Towny bank deposits are supported (including /t deposit <amount> flow)

๐Ÿ“Š PlaceholderAPI Integration

Balance Placeholders:

%relisheconomy_balance_[currency]%        # Raw balance (e.g. 1000.50)
%relisheconomy_balance_[currency]_[type]_[style]%  # Formatting options (e.g. 1,250.00 via full_plain)
%relisheconomy_formatted_[currency]%      # Formatted balance (e.g. $1,000.50)

Leaderboard Placeholders:

%relisheconomy_baltop_[position]_[currency]_name%     # Player name at position
%relisheconomy_baltop_[position]_[currency]_balance%  # Formatted balance at position
%relisheconomy_baltop_[position]_[currency]_raw%      # Raw balance at position
%relisheconomy_rank_[currency]%                       # Player's rank

Currency Information:

%relisheconomy_currency_[currency]_symbol%       # Currency symbol
%relisheconomy_currency_[currency]_display%      # Display name
%relisheconomy_currency_[currency]_starting%     # Starting balance
%relisheconomy_currency_[currency]_default%      # Is default currency

Utility Placeholders:

%relisheconomy_hasenough_[amount]_[currency]%    # true/false if player has enough
%relisheconomy_exchangerate_[from]_[to]%         # Exchange rate between currencies

Server Statistics:

%relisheconomy_stats_currencies%    # Number of currencies
%relisheconomy_stats_accounts%      # Number of cached accounts
%relisheconomy_stats_dbtype%        # Database type (sqlite/mysql)
%relisheconomy_stats_dbhealthy%     # Database health status

PlacholdersAPI


๐ŸŒ Multi-Language Support

๐Ÿ—ฃ๏ธ Built-in Languages

  • ๐Ÿ‡บ๐Ÿ‡ธ English (en) - Complete
  • ๐Ÿ‡ธ๐Ÿ‡ฆ Arabic (ar) - Complete
  • ๐Ÿ‡ต๐Ÿ‡น Portuguese (pt) - Complete

๐ŸŒ Custom Languages

Create lang/[code].yml files for any language:

# Example: lang/es.yml for Spanish
balance:
  current: "<green>Tu saldo: {balance}"
  other: "<green>Saldo de {player}: {balance}"

๐Ÿ“ˆ Performance & Scalability

โšก Optimization Features

  • Caffeine caching for instant data access
  • Connection pooling with HikariCP (MySQL)
  • Async operations for database queries
  • Baltop caching with configurable duration
  • Auto-cleanup of stale cache data

๐Ÿ“Š Scalability Options

  • SQLite for small-medium servers (0-500 players)
  • MySQL for large networks (500+ players)
  • Real-time read mode for external integrations
  • Database health monitoring

๐Ÿ“„ License

RelishEconomy is proprietary software. All rights reserved.

License Types

๐Ÿ†“ Free Version

  • Available without license key
  • Includes multi-currency, exchange, baltop, migration, and command-based selling
  • May be used on unlimited servers
  • NOT open source - modification and redistribution prohibited

โญ Premium Version

  • Requires valid license key from M5LB
  • Includes premium-only features such as Shop GUI, Sell GUI, ATM GUI, transaction logs GUI, physical currency, and premium block interactions
  • License key tied to purchaser and server count
  • NOT open source - modification and redistribution prohibited

For full license terms, see LICENSE file.

Obtain Premium License

To get a premium license key:

  • ๐Ÿ›’ Buy a key from M5LB Store

Made with โค๏ธ by M5LB

๐Ÿ‘ฅ Team & Contributors

iM5LB1
iM5LB1Owner

โš™๏ธ Compatibility

Environment
๐Ÿ–ฅ๏ธ Server-side
Loaders
bukkitpaperpurpurspigot
Minecraft Versions
1.201.20.11.20.21.20.31.20.41.20.51.20.61.21+14 more

๐Ÿ”— Links

Modrinth Page