Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/myth-mc/banco

A simple item-based economy plugin
https://github.com/myth-mc/banco

bukkit-plugin economy economy-plugin minecraft minecraft-plugin paper spigot-plugin vault

Last synced: 7 days ago
JSON representation

A simple item-based economy plugin

Awesome Lists containing this project

README

        





banco


Latest release
Pull requests
Issues
License


A simple item-based economy plugin.

Quick navigation



  1. Information


  2. Installation


  3. Usage

## 📚 Information

**banco 🏦** provides server owners with a simple and configurable item-based currency system, ideal for RPG-style servers.

>[!WARNING]
> banco is still under development. Although most of its features do work, we cannot promise a bug-free experience. You can report any misbehaviours or share any feedback by [creating an issue](https://github.com/myth-MC/banco/issues).

### Features

* **Item-based** economy system
* Customizable items (display name, lore and **custom model data**)
* [Vault](https://www.spigotmc.org/resources/vault.34315/) support (Towny Advanced, Factions, Jobs Reborn...)
* [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) support
* **Multi-language** (full list [here](https://docs.mythmc.ovh/banco/administration/translations))
* **Lightweight** and performant
* Developed with **configurability** and simplicity on mind
* No dependencies other than Vault

### Planned features

* ~~[Folia](https://papermc.io/software/folia) support~~ ✅ (0.3+)
* ~~Commands~~ ✅ (0.2+)
* ~~Custom Model Data support~~ ✅ (0.5+)
* MySQL support
* ~~Update tracker~~ ✅ (0.2+)
* ~~Baltop~~ ✅ (0.6+)
* ~~Count Ender Chest items~~ ✅ (0.4+)

### Compatibility chart

| | Compatible? | Version | Notes |
|---------------------------------------------------------|-------------|---------|----------------------------------------------|
| [PaperMC](https://papermc.io/) | ✅ | 1.20.6+ | |
| [PurpurMC](https://purpurmc.org/) | ✅ | 1.20.6+ | |
| [Spigot](https://www.spigotmc.org) | ✅ | 1.20+ | Consider using [PaperMC](https://papermc.io) |
| [Bukkit](https://bukkit.org) | ✅ | 1.20+ | Consider using [PaperMC](https://papermc.io) |
| [Folia](https://papermc.io/software/folia) | ✅ | 1.20.6+ | |

### Dependencies

* [Vault](https://www.spigotmc.org/resources/vault.34315/) 1.7+ or [VaultUnlocked](https://www.spigotmc.org/resources/vaultunlocked.117277/) 2.2+ (required)
* [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) (optional)
* [Towny Advanced](https://townyadvanced.github.io) (optional)

## 📥 Installation

1. **Download the banco jar file for your platform**. You can find the latest version on [our releases page](https://github.com/myth-MC/banco/releases).
2. **Add the banco jar file to your server's plugin folder**. Make sure to delete any older versions of banco.
3. **Download and install [Vault](https://www.spigotmc.org/resources/vault.34315/)**.
4. **Fully restart your server**. Type `/stop` and start the server again [instead of using `/reload`](https://madelinemiller.dev/blog/problem-with-reload/).

## 🖊️ Usage

When you run banco for the very first time it will automatically generate two files:
* 'settings.yml' contains general settings
* 'accounts.yml' is where data will be stored

banco comes with a very simple gold-based economy setup that can be expanded by modifying `settings.yml`

#### Other supported plugins

* [Towny Advanced](https://townyadvanced.github.io)
* [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
* Any other plugin with Vault support