# Simple Banking<\/p>\n
Simple Banking is a Vault-enabled, scoreboard-driven bank plugin for Spigot servers. Players deposit a configurable currency item (and optionally its block form) into shared “Bank Chests” but maintain per-player balances. Withdrawals convert bank balance back into items and blocks based on a configurable multiplier.<\/p>\n
## Features
\n– Per-player balances stored in `config.yml`
\n– Configurable currency: item and optional block with multiplier (e.g., 1 `DIAMOND_BLOCK` = 9 `DIAMOND`)
\n– Deposits via:
\n – Shift-click into Bank Chests
\n – Cursor click onto Bank Chest slots
\n – Hopper transfer with per-hopper owner tracking
\n– Withdrawals split into blocks first (to save inventory slots), then leftover items
\n– Live scoreboard updates in tab list and below player names
\n– Vault `Economy` provider for compatibility with other plugins
\n– In-game currency management command with autocompletion for `minecraft:[item]`<\/p>\n
## Requirements
\n– Server: Bukkit\/Spigot\/Paper 1.21.x
\n– Java: 17+
\n– Plugins: `Vault`<\/p>\n
## Installation ## Configuration (`src\/main\/resources\/config.yml`) Changes are persisted automatically when using `\/currency`; manual edits require a server restart or configuration reload.<\/p>\n ## Commands ## Permissions ## How Deposits Work ## Scoreboard ## Vault Economy ## Troubleshooting A Vault Enabled Scoreboard Driven Banking Plugin<\/p>\n","protected":false},"featured_media":139884,"template":"","meta":{"_minecraft_slug":"simple-banking","_minecraft_project_id":"ST2n5UGF","_minecraft_author":"MVPFishstock","_minecraft_license":"MIT","_minecraft_downloads":112,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-banking.zip","_minecraft_size_bytes":61626,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:25:45.871892Z","_minecraft_date_created":"2025-12-02T05:40:29.185232Z","_minecraft_date_modified":"2026-03-05T11:52:42.704807Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-banking","_minecraft_icon_attachment_id":139884,"_minecraft_imported_at":"2026-06-08T07:05:07+00:00","_minecraft_import_hash":"edf84b9618ad852ae7cbed2c8b9a6974","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,89,127,867,129,91],"mod_loader":[130,132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-139883","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-social","mod_category-spigot","mod_category-storage","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n1. Ensure `Vault` is installed.
\n2. Copy `simplebanking-
\n3. Start the server. The plugin creates default `config.yml`.
\n4. Verify startup logs show:
\n – Registered SimpleBanking as Vault provider
\n – Simple Banking enabled \/ account count<\/p>\n
\n“`
\nplayers: {}
\nbank-chests: []
\ncurrency:
\n item: DIAMOND
\n block: DIAMOND_BLOCK
\n block_multiplier: 9
\n name_singular: Diamond
\n name_plural: Diamonds
\n“`
\n– `currency.item`: Base item material ID
\n– `currency.block`: Optional block material ID; omit to disable block deposits\/withdrawals
\n– `currency.block_multiplier`: Units per block
\n– `name_singular` \/ `name_plural`: Display names used in scoreboard and messages<\/p>\n
\n– `\/givebankchest`
\n – Gives a tagged chest that becomes a Bank Chest when placed
\n – Permission: `diamondbank.admin`
\n– `\/withdraw
\n – Withdraws `
\n – Converts to blocks first, then items using the configured multiplier
\n – Permission: `diamondbank.withdraw`
\n– `\/balance`
\n – Shows leaderboard of players with non-zero balances
\n – Permission: `diamondbank.balance`
\n– `\/currency
\n – Changes the currency item and optional block\/multiplier and display names
\n – Autocompletes as `minecraft:[item]` for first arg and `minecraft:[block]` for second
\n – Requires all player balances to be zero before change
\n – Permission: `diamondbank.admin`<\/p>\n
\n– `diamondbank.admin`: Admin tasks like giving Bank Chests and changing currency (default `op`)
\n– `diamondbank.withdraw`: Allows withdrawals (default `true`)
\n– `diamondbank.balance`: Allows viewing the leaderboard (default `true`)<\/p>\n
\n– Bank Chest placement: placing the given chest item registers the location as a Bank Chest
\n– Manual deposits:
\n – Shift-click: moving currency items\/blocks from inventory into a Bank Chest credits units
\n – Cursor click: placing currency items\/blocks into Bank Chest slots credits units
\n– Hopper deposits:
\n – Hoppers track owner via persistent data when placed
\n – Moving currency items\/blocks into a Bank Chest credits that owner\u2019s balance
\n – If owner is unknown, credits the nearest player within 16 blocks<\/p>\n
\n– Displays currency plural name (e.g., “Diamonds”) in tab list and below player names
\n– Updates on every deposit\/withdrawal and player join<\/p>\n
\n– Implements Vault `Economy` for compatibility; account balance maps to bank units
\n– No bank accounts (only player accounts). Vault bank-related methods return NOT_IMPLEMENTED<\/p>\n
\n– Invalid `plugin.yml`:
\n – Ensure no non-ASCII\/control characters; fix and rebuild
\n– Scoreboard class errors:
\n – Must import `org.bukkit.scoreboard.Scoreboard` and `ScoreboardManager`
\n – Always restart server after updating the plugin to avoid stale classes
\n– Duplicate JARs:
\n – Remove old copies (e.g., both `SimpleBanking.jar` and `simplebanking-
\n– Currency change blocked:
\n – `\/currency` refuses changes if any player balance > 0; have players withdraw first and retry<\/p>\n","protected":false},"excerpt":{"rendered":"