SuperiorSkyblock2 integrates with Vault to provide economy functionality for island banks, allowing players to deposit and withdraw money from their island’s shared bank account.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/BG-Software-LLC/SuperiorSkyblock2/llms.txt
Use this file to discover all available pages before exploring further.
Overview
The Vault integration enables:- Island Bank System - Shared economy accounts for islands
- Deposit & Withdrawal - Transfer money between personal and island banks
- Transaction Validation - Automatic error handling and balance limits
- Multi-Economy Support - Works with any Vault-compatible economy plugin
Setup
Install Vault
Download Vault from SpigotMC and place it in your
plugins folder.Install Economy Plugin
Install a Vault-compatible economy plugin such as:
- EssentialsX
- CMI
- CraftConomy
- Any other Vault economy provider
Features
Island Bank
Each island has a shared bank account that all members can access based on their permissions. Commands:/is bank- Open the island bank interface/is deposit <amount>- Deposit money into the island bank/is withdraw <amount>- Withdraw money from the island bank/is balance- Check the island bank balance
superior.island.deposit- Deposit moneysuperior.island.withdraw- Withdraw moneysuperior.island.balance- View balance
Transaction Handling
The Vault integration includes robust transaction processing:Automatic Account Creation
Automatic Account Creation
Player accounts are automatically created if they don’t exist when accessing the economy system.
Balance Limits
Balance Limits
Transactions respect bank limits configured per island:
- Configurable maximum bank capacity
- Upgrade-based limit increases
- Permission-based limit bonuses
Error Handling
Error Handling
Clear error messages for:
- Insufficient funds
- Bank capacity exceeded
- Transaction failures
- Invalid amounts
Precision Control
Precision Control
All transactions use 3 decimal place precision to ensure accurate balance tracking.
Configuration
Bank Settings
Configure island bank behavior inconfig.yml:
config.yml
Bank Limit Upgrades
Define bank limit upgrades inupgrades.yml:
upgrades.yml
Admin Commands
Manage island economies with admin commands:superior.admin.*
API Usage
Developers can interact with the Vault economy integration:Getting the Economy Provider
Island Bank Operations
Economy Placeholders
Display economy information with PlaceholderAPI:| Placeholder | Description | Example |
|---|---|---|
%superior_island_bank% | Formatted bank balance | 1,234,567 |
%superior_island_bank_format% | Fancy formatted balance | 1.23M |
%superior_island_bank_int% | Balance as integer | 1234567 |
%superior_island_bank_raw% | Raw balance value | 1234567.89 |
%superior_island_bank_limit% | Formatted bank limit | 10,000,000 |
%superior_island_bank_limit_format% | Fancy formatted limit | 10M |
%superior_island_bank_next_interest% | Time until next interest | 5h 30m |
%superior_island_bank_last_interest% | Time since last interest | 30m ago |
Supported Economy Plugins
Any Vault-compatible economy plugin works with SuperiorSkyblock2:EssentialsX
Most popular economy plugin with extensive features
CMI
All-in-one plugin with built-in economy
CraftConomy
Multi-currency economy system
iConomy
Classic economy plugin
Troubleshooting
Vault not detected
Vault not detected
Issue: Console doesn’t show Vault integration messageSolutions:
- Ensure Vault is installed and enabled (
/plugins) - Verify an economy plugin is installed
- Check that the economy plugin registered with Vault
- Restart the server in the correct order: Vault → Economy → SuperiorSkyblock2
Cannot deposit/withdraw money
Cannot deposit/withdraw money
Issue: Transactions fail with errorsSolutions:
- Check player has sufficient funds for deposits
- Verify island bank hasn’t reached its limit
- Ensure player has the required permissions
- Check the economy plugin is functioning (
/balance)
Bank limit not working
Bank limit not working
Issue: Can deposit beyond configured limitSolutions:
- Check
config.ymlfor correct bank limit settings - Verify upgrade levels are configured properly
- Ensure
raw_bank_limitvalues are set correctly - Use
/is admin setbanklimitto manually set limits
Transaction amounts incorrect
Transaction amounts incorrect
Issue: Money values don’t match expected amountsSolutions:
- SuperiorSkyblock2 uses 3 decimal precision
- Check if the economy plugin has different precision
- Verify no other plugins are interfering with transactions
- Review transaction logs for rounding issues
Best Practices
Set Appropriate Limits
Configure bank limits to match your server’s economy scale and prevent inflation.
Enable Interest
Use bank interest to encourage players to save money in their island banks.
Tiered Upgrades
Create progressive bank limit upgrades to give players long-term goals.
Monitor Transactions
Regularly review bank transactions to detect exploits or economy issues.
Related Features
- Island Upgrades - Upgrade bank limits and other features
- Permissions - Control who can deposit/withdraw
- PlaceholderAPI - Display bank information
- Commands - Full list of economy commands