# Assailents Economic Additions
\n## Introduction
\nAssailents Economic Additions is my solution to the current struggle to find a good bloat-free and customizable economy plugin. After a while of running\/developing servers (Homieworld and Aeros before they shut down and while they were under original owners) and struggling to find good Economy Plugins I decided to make my own.
\n## Requirements:
\n* Vault (Even thought it says last test version is 1.17 it works for 1.20.4): https:\/\/www.spigotmc.org\/resources\/vault.34315\/
\n* PlaceholderAPI
\nhttps:\/\/www.spigotmc.org\/resources\/placeholderapi.6245\/<\/p>\n
## Commands & Permissions ### User Commands * \/pay * \/toggleactionbar * \/economygui * \/stockdisplay ## Custom Features ### Action Bar ### Stock display ### Economy Gui ## Configuration<\/p>\n In the configuration files pretty much two types of configuration that you need to know about; ### Normal Configuration ### Items ### Full Config Files<\/p>\n #### Lang.yml A Basic Economy Plugin that allows for \/pay \/bal and more!<\/p>\n (Bloat Free, Highly Customisable!)<\/p>\n","protected":false},"featured_media":61534,"template":"","meta":{"_minecraft_slug":"economic-additions","_minecraft_project_id":"hzhCHJ0z","_minecraft_author":"AssailentDev","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":879,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"economic-additions.zip","_minecraft_size_bytes":94935306,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T09:03:43.855455Z","_minecraft_date_created":"2024-03-11T06:32:41.016260Z","_minecraft_date_modified":"2024-04-22T10:25:08.728705Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/economic-additions","_minecraft_icon_attachment_id":61534,"_minecraft_imported_at":"2026-06-03T13:52:22+00:00","_minecraft_import_hash":"1542b6555a17d8654df4209eaee50eda","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,126,127,129],"mod_loader":[132,134],"minecraft_version":[59,36,60,93,94],"class_list":["post-61533","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4"],"yoast_head":"\n
\nAs the Introduction says, with the goal to stay bloat free there are only a couple commands.
\n### Admin Commands
\n* \/economy
\nGet the balance of a player, give the player money, take money from the player, or set the player’s balance.
\nPermission Required: `EconomicAdditions.economygui`
\nAliases: N\/A<\/p>\n
\n* \/bal [player]
\nThis returns the balance of a player.
\nPermission Required: `EconomicAdditions.balance` and `EconomicAdditions.balance.others`
\nAliases: \/balance<\/p>\n
\nThis pays a player from you’re balance.
\nPermission Required: `EconomicAdditions.pay`
\nAliases: N\/A<\/p>\n
\nThis toggles the action bar above the players hotbar (See Custom Features)
\nPermission Required: `EconomicAdditions.toggleactionbar`
\nAliases: \/actionbar \/ab<\/p>\n
\nOpens the economy gui (Allows for paying and balances, Balances are viewable no matter the permissions)
\nPermission Required: `EconomicAdditions.economygui`
\nAliases: \/econgui \/econ \/egui \/money<\/p>\n
\nThis toggles the Stock display (See Custom Features)
\nPermission Required: `EconomicAdditions.stockdisplay`
\nAliases: \/toggledisplay \/togglestock \/toggletickdisplay \/stock \/display \/tickdisplay<\/p>\n
\n### Mini Message support
\nEvery message supports AdventureLib mini message formatting! Allowing for gradients, custom colours and etc…
\nLink to MiniMessage Formats: https:\/\/docs.advntr.dev\/minimessage\/format.html<\/p>\n
\nThe action bar is a display that can be toggled in the lang.yml (See Configuration), By default it updates every 2 seconds and displays the balance of the player and the name of the currency above it.<\/p>\n
\nThis essentially is just a title that appears and ticks up from 80% of an amount of money recieved or taken up to the full %. Can be toggled in the lang.yml (See Configuration)<\/p>\n
\nJust a basic UI that allows the player to Pay, View Balances, And other stats in the form of a UI!
\nIt also has page support if you have more than 27 players online and everything is customisable!<\/p>\n
\nNormal Configuration,
\nItems.<\/p>\n
\nThis is pretty straight forward. Things like `starting-money: 1500` mean that players start with 1500. And doesn’t require much thought. This is also where almost EVERY message in the plugin can be customised (Including translated or completely different messages.<\/p>\n
\nItems are mainly defined within the `gui\/economy:` section; and have a few key features!
\nHere is an example item
\n“`yml
\nTestItem:
\n Material: “DIAMOND” # Grab materials from https:\/\/hub.spigotmc.org\/javadocs\/bukkit\/org\/bukkit\/Material.html besides “PLAYERHEAD” more on that later.
\n Amount: 1 # How many in the ItemStack
\n Title: “Diamond Stick” # Name of the item
\n Lore:
\n – “This is the first line of lore!”
\n – “This is the second!”
\n – “You can have as many lines as you want!”
\n – “I support MiniMessage and PlaceholderAPI format!”
\n “`
\n This item wouldn’t show up as the plugin doesnt call for it. This is why you must NOT! Change the names of the variables in the lang.yml.
\n You can add CustomModelData to the items with just a simple line at the bottom
\n Example:
\n “`yml
\n TestItem:
\n Material: “DIAMOND”
\n Amount: 1
\n Title: “Diamond Stick”
\n Lore:
\n – “Some Cool Lore”
\n – “Yep!”
\n CustomModelData: 1
\n “`
\n Custom model data is only useful if you know what you’re doing!<\/p>\n
\n“`yml
\ncommon:
\n prefix: “
\n currency-singular: “Sheep”
\n currency-plural: “Sheeps”
\n starting-money: 1500
\n error-color: “<#EB7272>”
\n success-color: “<#A6F8C6>”
\n non-valid-number: “The amount must be a valid decimal number. Got: ”
\n sender-not-a-player: “Only players can use this command!”
\n target-hasnt-player-before: “The player %parse% has never played on this server before!”
\n no-permission: “You don’t have permission for this command!”
\neconomy:
\n took-money: “Took %currency% from %parse%’s account.”
\n gave-money: “Gave %currency% to %parse%’s account.”
\n set-money: “Set %parse%’s account to %currency%.”
\n balance: “%parse%’s balance: %currency%”
\n paid-player: “You paid %parse% %currency%”
\n recieved-money: “You were paid %currency% from %parse%”
\n not-enough-money: “You don’t have enough money for that!”
\nactionbar:
\n enabled: true
\n update: 2
\n text: “
\n toggle-on-text: “Action bar toggled ON!”
\n toggle-off-text: “Action bar toggled OFF!”
\nstockdisplay:
\n enabled: true
\n min-amount: 2000
\n negative:
\n prefix: “
\n suffix: ”
\n positive:
\n prefix: “
\n suffix: ”
\n toggle-on-text: “Stock Display toggled ON!”
\n toggle-off-text: “Stock Display toggled OFF!”
\ngui:
\n economy:
\n messages:
\n cancel-payment: “Cancelling Payment!”
\n mainMenu:
\n Title: “Economic Additions”
\n payItem:
\n Material: ‘DIAMOND’
\n Amount: 1
\n Title: “
\n Lore:
\n – “
\n – “
\n balItem:
\n Material: ‘GOLD_INGOT’
\n Amount: 2
\n Title: “
\n Lore:
\n – “
\n – “
\n statsItem:
\n Material: “PLAYERHEAD”
\n Amount: 1
\n Title: “
\n Lore:
\n – “You %player_displayname% have: ”
\n – “%vault_eco_balance% Sheeps!”
\n emptyItem:
\n Material: “GRAY_STAINED_GLASS_PANE”
\n Amount: 1
\n Title: “”
\n payMenu:
\n Title: “\u1d18\u1d00\u028f \u1d18\u029f\u1d00\u028f\u1d07\u0280\ua731”
\n pay-message: “How much would you like to pay?”
\n nextFullItem:
\n Material: “LIME_DYE”
\n Amount: 1
\n Title: “
\n nextEmptyItem:
\n Material: “GRAY_DYE”
\n Amount: 1
\n Title: “
\n prevFullItem:
\n Material: “LIME_DYE”
\n Amount: 1
\n Title: “
\n prevEmptyItem:
\n Material: “GRAY_DYE”
\n Amount: 1
\n Title: “
\n playerHead:
\n Material: “PLAYERHEAD”
\n Amount: 1
\n Title: “<#C7FFEA>%player_displayname%”
\n Lore:
\n – “<#A2A2A2>Left Click to pay this player!”
\n emptyItem:
\n Material: “GRAY_STAINED_GLASS_PANE”
\n Amount: 1
\n Title: “”
\n balMenu:
\n Title: “\u1d18\u029f\u1d00\u028f\u1d07\u0280 \u0299\u1d00\u029f\u1d00\u0274\u1d04\u1d07\ua731”
\n nextFullItem:
\n Material: “LIME_DYE”
\n Amount: 1
\n Title: “
\n nextEmptyItem:
\n Material: “GRAY_DYE”
\n Amount: 1
\n Title: “
\n prevFullItem:
\n Material: “LIME_DYE”
\n Amount: 1
\n Title: “
\n prevEmptyItem:
\n Material: “GRAY_DYE”
\n Amount: 1
\n Title: “
\n playerHead:
\n Material: “PLAYERHEAD”
\n Amount: 1
\n Title: “<#C7FFEA>%player_displayname%’s Balance”
\n Lore:
\n – “<#A2A2A2>%vault_eco_balance% Sheeps!”
\n emptyItem:
\n Material: “GRAY_STAINED_GLASS_PANE”
\n Amount: 1
\n Title: “”
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"