📚Information

Highly optimized, feature-packed, and unique Economy plugin.

Transform your server’s economy with the Economy plugin, offering unparalleled flexibility to create and manage an unlimited number of custom currencies. Whether you need multiple in-game currencies or unique tokens for special events, Economy provides a dynamic solution tailored to your needs. With cross-server support, comprehensive management tools, and advanced features, this plugin ensures a robust and adaptable economic system.

Highlights:

• Unlimited Currency Types: Design and manage any number of custom currencies to fit diverse purposes.

• Cross-Server Support: Seamlessly integrate and synchronize currencies across multiple servers.

• Flexible Placeholder Formatting: Use various formatting options for placeholders to display currency information effectively.

• Comprehensive Management Commands: Access full player and admin management commands for efficient control.

• Recent Earnings Tracking: Monitor how much you’ve earned from currencies over the past 60 seconds.

• Advanced Shop System: Utilize both rotating shops (where items refresh every set time) and static shops for diverse shopping experiences.

• Date and Time Unlock Requirements: Set specific date and time criteria for unlocking categories, enhancing event management and progression.

• Currency Multiplier Events: Initiate multiplier events that boost currency earnings for the entire server during the event duration, ideal for running special promotions like weekend boosters.

Short Showcase Video

Interested in purchasing the plugin? Visit https://blockm.art or join our Discord server and open a ticket!

PlaceholderAPI Support

You must have PlaceholderAPI installed on your Minecraft Server for these Placeholders to register, but you can format/display your currencies in 3 different ways to the player.

• %abysseconomy_<economy>_raw% — Will return the raw, unformatted currency value (Example: 1000000)

• %abysseconomy_<economy>_comma% — Will return the formatted currency in a comma-based format (Example: 1,000,000)

• %abysseconomy_formatted% — Returns the currency value in roman-numeral-decimal format. (1k, 10k, 100k, 1M, 1.5M, etc)

Commands

Arguments wrapped in diamonds <arg> are required for the command to run properly. Arguments wrapped in square braces[arg] are treated as optional

Admin Commands (Permission: abysseconomy.admin)

Global Commands:

• /econ help

  • Sends the admin economy command help message

• /econ reload

  • Reloads all economy configs, and the TideEconomy plugin

Per-Currency Commands:

• /<economy> give <player> <amount>

  • Gives the player a specified amount of currency

• /<economy> take <player> <amount>

  • Takes a specified amount of currency from the player

• /<economy> set <player> <amount>

  • Sets the players currency balance to the specified amount

• /<economy> event start <seconds>

  • Starts the multiplier event on the currency for the specified amount of time

• /<economy> event stop

  • Stops the multiplier event for the currency if it is currently active

• /<economy> recalc

  • Forces the economies leaderboard to recalculate

Player Commands (Permission: None unless specified)

Per-Currency Commands:

• /<economy> [player]

  • Retrieves the specified player's balance if they were specified, otherwise returns your own balance.

• /<economy> help

  • Sends the player help message or the admin help message based on the player's permission level

• /<economy> event

  • Checks if the event is active or not, and if it is then it will retrieve the amount of time left

• /<economy> top

  • Opens the economy leaderboard menu

• /<economy> shop

  • Opens the default economy shop category

• /<economy> withdraw <amount>

  • Withdraws the specified amount of currency into a redeemable voucher

• /<economy> pay <player> <amount>

  • Pays the specified player the specified amount of currency if you have enough

• /<economy> paytoggle

  • Toggles whether or not you can receive payments from other players

• /<economy> togglemsgs

  • Toggles whether or not you receive messages from gaining currencies naturally

Default Configuration Files

Default Economy Config

economies/credits.yml

command:
    base-command: "credits"
    aliases:
        - "credit"
        - "tc"
        - "tcredit"
        - "tcredits"
        - "tidecredit"
        - "tidecredits"
    sub-commands:
        "give":
            enabled: true
            base-alias: "give"
            aliases:
                - "add"
        "set":
            enabled: true
            base-alias: "set"
            aliases:
                - "sum"
        "take":
            enabled: true
            base-alias: "take"
            aliases:
                - "subtract"
        "withdraw":
            enabled: true
            base-alias: "withdraw"
            aliases: []
        "help":
            enabled: true
            base-alias: "help"
            aliases: []
        "shop":
            enabled: true
            base-alias: "shop"
            aliases: []
        "top":
            enabled: true
            base-alias: "top"
            aliases: []
        "event":
            enabled: true
            base-alias: "event"
            aliases: []
        "recalc":
            enabled: true
            base-alias: "recalc"
            aliases: []
        "pay":
            enabled: true
            base-alias: "pay"
            aliases: []
        "paytoggle":
            enabled: true
            base-alias: "paytoggle"
            aliases: []
        "togglemsgs":
            enabled: true
            base-alias: "togglemsgs"
            aliases: []
            
withdraw-item:
    enchanted: true
    material: "LIGHT_BLUE_DYE"
    name: "&3&l[&b&l!&3&l] &bCredit Note &7(Right-Click)"
    lore:
        - " "
        - "&bInformation"
        - "&b&l→ &7Amount: &f%amount%"
        - "&b&l→ &7From: &f%player%"
        - " "
        - "&7&o(( Right-Click to redeem &f&o%amount%x&7&o credits. ))"
    
top:
    enabled: true
    update-time: 60

currency-settings:
    solid: true

event-settings:
    gain-multiplier: 1.5
    start-message:
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&a1.5x Credits Multiplier has been started!"
    end-message:
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c1.5x Credits Multiplier has ended!"

mobs:
    enabled: true
    rewards:
        - "ZOMBIE;1;5;50" #Mob, Min coins, Max coins, Chance
    message:
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &bYou have just gained &3%amount%x&b credits from killing a &3%mob%&b."

blocks:
    enabled: false
    rewards:
        - "STONE;1;5;50" #Block, Min coins, Max coins, Chance
    message:
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &bYou have just gained &3%amount%x&b credits from mining a &3%block%&b block."

on-exp-level-up:
    enabled: false
    min: 1
    max: 5
    chance: 10
    message:
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &bYou have just gained &3%amount%x&b credits from leveling up."

on-exp-gain:
    enabled: false
    min: 1
    max: 5
    chance: 10
    message:
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &bYou have just gained &3%amount%x&b credits from gaining exp."

player-kill:
    enabled: false
    min: 1
    max: 5
    chance: 100
    message:
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &bYou have just gained &3%amount%x&b credits from killing &3%player%&b."

menus:
    "main-menu":
        title: "&8&lCATEGORIES"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        categories:
            "static":
                slot: 12
                open:
                    material: "LIME_DYE"
                    name: "&aStatic Shop &7(Open)"
                    lore: [ ]
                closed:
                    material: "RED_DYE"
                    name: "&cStatic Shop &7(Closed)"
                    lore: [ ]
            "rotating":
                slot: 14
                open:
                    material: "LIME_DYE"
                    name: "&aRotating Shop &7(Open)"
                    lore: [ ]
                closed:
                    material: "RED_DYE"
                    name: "&cRotating Shop &7(Closed)"
                    lore: [ ]
    "top-menu":
        title: "&8&lCREDITS TOP"
        rows: 3
        top-slots: [10,11,12,13,14,15,16]
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        invalid-item:
            material: "PLAYER_HEAD"
            skull: "MHF_Question"
            name: "&c???"
            lore: [ ]
        valid-item:
            material: "PLAYER_HEAD"
            skull: "%player%"
            name: "&3&l[&b&l!&3&l] &b%player% &7(#%rank%)"
            lore:
                - "&7&o(( &f&o%player%&7&o has &f&o%amount%x&7&o credits! ))"
        stats-item:
            slot: 26
            material: "PLAYER_HEAD"
            skull: "%player%"
            name: "&3&l[&b&l!&3&l] &b%player% &7(#%rank%)"
            lore:
                - "&7&o(( You currently have &f&o%amount%x&7&o credits! ))"

shops:
    "static":
        title: "&8&lSTATIC"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
        open-time: "1/28/2022 17:30:00"
        rotating: false
        items:
            "diamond":
                slot: 13
                price: 10
                material: "DIAMOND"
                name: "&bDiamond &7(10 credits)"
                lore: []
                commands:
                    - "give %player% diamond 1"
    "rotating":
        title: "&8&lROTATING"
        rows: 3
        borders:
            "gray":
                material: "GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "0-26"
            "light_gray":
                material: "LIGHT_GRAY_STAINED_GLASS_PANE"
                name: " "
                lore: [ ]
                slots:
                    - "10-16"
        open-time: "1/28/2022 17:30:00"
        rotating: true
        rotating-time: 30 #In Seconds
        item-slots: [10,11,12,13,14,15,16]
        items:
            "diamond":
                price: 10
                material: "DIAMOND"
                name: "&bDiamond &7(10 credits)"
                lore: []
                commands:
                    - "give %player% diamond 1"
            "emerald":
                price: 10
                material: "EMERALD"
                name: "&aEmerald &7(10 credits)"
                lore: []
                commands:
                    - "give %player% emerald 1"
        rotating-item:
            slot: 18
            material: "CLOCK"
            name: "&eRotating in &f%time%&e."
            lore: []

messages:
    "no-permission":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &f&l→ &7You don't have &cpermission&7 to do this."
    "messages-toggled-true":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou are now allowing credit gain messages."
    "messages-toggled-false":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou are no longer allowing credit gain messages."
    "target-payments-toggled-off":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lCredits &8&l→  &4%player%&c has payments toggled off."
    "paid":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou paid &3%player% %amount%x&b credits."
    "received-payment":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou have been paid &3%amount%x &bcredits by &3%player%&b."
    "payments-toggled-true":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou are now accepting credit payments."
    "payments-toggled-false":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou are no longer accepting credit payments."
    "event-toggled-true":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou have enabled the &31.5x Credit Event&b."
    "event-toggled-false":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bYou have disabled the &31.5x Credit Event&b."
    "event-true":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bA &31.5x Credit Event&b has begun!"
    "event-false":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bA &31.5x Credit Event&b has ended!"
    "event-time":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→  &bThe &31.5x Credit Event&b has &3%time%&b left."
    "event-already-started":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lCredits &8&l→  &cThis event has already begun!"
    "event-already-stopped":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lCredits &8&l→  &cThis event has already ended!"
    "event-not-active":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lCredits &8&l→  &cThis event isn't active right now!"
    "top-updating":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &bCredits top is now updating!"
    "top-updated":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &bCredits top has updated in &3%time%ms&b."
    "given-currency-to-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have given &b%player% %amount%&7 credit(s). They now have &b%new-balance%&7 credit(s)."
    "received-currency":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have been given &b%amount%&7 credit(s) by &b%player%&7. You now have &b%new-balance%&7 credit(s)."
    "taken-currency-from-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have taken &b%amount%&7 credit(s) from &b%player%&7. They now have &b%new-balance%&7 credit(s)."
    "currency-taken":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have had &b%amount%&7 credit(s) taken by &b%player%&7. You now have &b%new-balance%&7 credit(s)."
    "set-currency-for-player":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have set &b%player%'s&7 balance to &b%amount%&7 credit(s)."
    "currency-set":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7Your balance has been set to &b%amount%&7 credit(s) by &b%player%&7."
    "balance":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have &b%amount%&7 credit(s)."
    "balance-other":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &b%player%&7 has &b%amount%&7 credit(s)."
    "invalid-player":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lCredits &f&l→ &7You have specified a(n) &cinvalid player&7."
    "invalid-amount":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lCredits &f&l→ &7You have specified a(n) &cinvalid amount&7."
    "not-enough-currency":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lCredits &f&l→ &7You don't have enough &ccredits&7 to perform this action."
    "withdrawn-currency":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have withdrawn &b%amount%x&7 credit(s). You now have &b%new-balance%&7 credit(s)."
    "redeemed-currency":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have redeemed a credit note and received &b%amount%x&7 credit(s). You now have &b%new-balance%&7 credit(s)."
    "purchased":
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7You have successfully purchased &b%item%&7 for &b%cost%&7 credit(s)."
    "rotated": # This is a broadcast
        sound:
            enabled: true
            value: "ORB_PICKUP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lCredits &f&l→ &7The &b%shop%&7 shop has just rotated it's items!"
    "admin-help":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&f&m----------------------------------"
                - " "
                - "&b&lTech&3&lTide &7— &bCredits Admin Help"
                - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
                - " "
                - "&7<> = Required"
                - "&7[] = Optional"
                - " "
                - "&b&lCommands"
                - "&b&l→ &7/tc [player]"
                - "&b&l→ &7/tc give <player> <amount>"
                - "&b&l→ &7/tc take <player> <amount>"
                - "&b&l→ &7/tc set <player> <amount>"
                - "&b&l→ &7/tc withdraw <amount>"
                - "&b&l→ &7/tc pay <player> <amount>"
                - "&b&l→ &7/tc event"
                - "&b&l→ &7/tc top"
                - "&b&l→ &7/tc shop"
                - "&b&l→ &7/tc paytoggle"
                - "&b&l→ &7/tc togglemsgs"
                - " "
                - "&f&m----------------------------------"
    "player-help":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&f&m----------------------------------"
                - " "
                - "&b&lTech&3&lTide &7— &bCredits Help"
                - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
                - " "
                - "&7<> = Required"
                - "&7[] = Optional"
                - " "
                - "&b&lCommands"
                - "&b&l→ &7/tc [player]"
                - "&b&l→ &7/tc withdraw <amount>"
                - "&b&l→ &7/tc pay <player> <amount>"
                - "&b&l→ &7/tc event"
                - "&b&l→ &7/tc top"
                - "&b&l→ &7/tc shop"
                - "&b&l→ &7/tc paytoggle"
                - "&b&l→ &7/tc togglemsgs"
                - " "
                - "&f&m----------------------------------"

Messages Config File

lang.yml

messages:
    "no-permission":
        sound:
            enabled: true
            value: "FIZZ"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&c&lTech&4&lTide &f&l→ &7You don't have &cpermission&7 to do this."
    "gained":
        sound:
            enabled: true
            value: "LEVEL_UP"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&3&m-------------------------------"
                - " "
                - "&b&lGained Currencies &8- &bLast 60s"
                - "&7&oBelow you can find your &f&ogained currencies&7&o."
                - " "
                - "&b&lRESULTS:"
                - "&b- &7Credits: &f%credits%"
                - " "
                - "&3&m-------------------------------"
    "admin-help":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&f&m----------------------------------"
                - " "
                - "&b&lTech&3&lTide &7— &bEconomy Admin Help"
                - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
                - " "
                - "&7<> = Required"
                - "&7[] = Optional"
                - " "
                - "&b&lCommands"
                - "&b&l→ &7/economy"
                - "&b&l→ &7/economy reload"
                - " "
                - "&f&m----------------------------------"
    "reloaded":
        sound:
            enabled: true
            value: "BLOCK_NOTE_PLING"
            volume: 1
            pitch: 1
        message:
            enabled: true
            value:
                - "&b&lTech&3&lTide &f&l→ &7You have successfully reloaded &bTideEconomy&7 in &b%time%ms&7."

Settings Config File

settings.yml

command:
    base-command: "economy"
    aliases:
        - "teconomy"
        - "econ"
        - "tecon"
    sub-commands:
        "reload":
            base-alias: "reload"
            aliases:
                - "reloadconfig"

Storage Config File (Cross-Server Currency Support with SQL)

storage.yml

storage:
  type: "JSON" # JSON | SQL
  host: 0.0.0.0
  username: "username"
  password: "password"
  database: "database"
  port: 3306