bank Plugin

# 🏦 BankPlugin **A fully-featured banking system for economy servers — deposits, interest, loans, transfers, and more.** > 預金・利子・ローン・送金を備えた、本格派サーバー銀行プラグイン。 --- ## ✨ Features / 機能一覧 ### 💰 Deposit & Withdraw / 預金・引き出し - Separate your **in-hand money** (Vault wallet) from your **bank savings** - Deposit and withdraw any amount via GUI or command - Auto account creation on first deposit > 所持金（Vault残高）と銀行預金を分けて管理。GUIまたはコマンドで即時操作。初回預金時に口座が自動開設されます。 --- ### 📈 Interest System / 利子システム - Configurable **compound or simple interest** - Set interval (e.g. every 24 hours), minimum balance, and per-cycle interest cap - Online players receive a notification when interest is applied > 複利・単利を選べる利子システム。付与間隔・最低預金額・上限額をすべて設定可能。オンライン時にはチャットで通知されます。 --- ### 🏦 Loan System / ローンシステム - Players can borrow money up to a configurable maximum - Daily loan interest accumulates automatically - **Overdue penalties** — extra interest charges after the repayment deadline - **Force collection** — if a loan is severely overdue, the remaining balance is automatically deducted from the player's Vault wallet - Optional **deposit ratio screening** — require players to hold a minimum savings balance before borrowing > 最大借入額・金利・返済期限・延滞ペナルティをすべて設定可能。延滞が続くとVault残高から強制徴収されます。審査機能（預金比率）もオプションで有効化できます。 --- ### 💸 Transfer System / 送金システム - Send money **directly to another player's bank account** - Configurable transfer fee (%) and maximum transfer amount - Recipient receives an in-game notification when online > プレイヤー間で銀行口座に直接送金できます。手数料・上限額も設定可能。受取人がオンラインであれば即時通知されます。 --- ### 📋 Transaction History / 取引履歴 - Paginated GUI showing all past transactions - Records: deposits, withdrawals, transfers, interest, loan borrows & repayments - Configurable retention limit (number of records and days) > 預金・引き出し・送受金・利子・ローンすべての取引をページ付きGUIで確認できます。保持件数・保持日数も設定可能。 --- ### 🏆 Wealth Ranking / 資産ランキング - In-game GUI leaderboard showing the top players by bank balance - Great for competitive economy servers > 銀行預金残高のトップランキングをGUIで表示。経済競争サーバーに最適です。 --- ### 📱 Bedrock Support / Bedrock対応 - Full **Geyser + Floodgate** compatibility via native Form UI - Bedrock players see mobile-friendly forms instead of inventory GUIs > Geyser・Floodgate経由のBedrockプレイヤーにはフォームUIを表示。Java・Bedrock両対応のクロスプレイサーバーで動作します。 --- ### 🔌 PlaceholderAPI Support / PlaceholderAPI対応 | Placeholder | Description | |---|---| | `%bank_balance%` | Bank savings balance / 預金残高 | | `%bank_vault%` | Vault wallet balance / Vault所持金 | | `%bank_total%` | Wallet + savings combined / 所持金＋預金の合計 | | `%bank_loan%` | Remaining loan amount / ローン残債 | | `%bank_loan_status%` | Loan status (active/overdue/none) / ローン状態 | --- ## 📜 Commands / コマンド | Command | Description | |---|---| | `/bank` | Open the bank GUI / 銀行GUIを開く | | `/bank deposit <amount>` | Deposit money / 預金 | | `/bank withdraw <amount>` | Withdraw money / 引き出し | | `/bank transfer <player> <amount>` | Transfer to a player / 送金 | | `/bank loan <amount>` | Take out a loan / ローン借入 | | `/bank repay <amount>` | Repay your loan / ローン返済 | | `/bank balance` | Check balances / 残高確認 | | `/bank history` | View transaction history / 取引履歴 | | `/bank ranking` | View wealth ranking / ランキング | **Aliases:** `/b`, `/銀行` **Japanese subcommand aliases:** `預金`, `引出`, `送金`, `ローン`, `返済`, `残高`, `履歴`, `ランキング` --- ## 🔐 Permissions / 権限 | Permission | Default | Description | |---|---|---| | `bank.use` | Everyone | Basic bank access / 基本利用 | | `bank.transfer` | Everyone | Transfer money / 送金 | | `bank.loan` | Everyone | Take out loans / ローン | | `bank.admin` | OP | Admin access / 管理者権限 | --- ## ⚙️ Configuration Highlights / 設定ハイライト ```yaml interest: enabled: true rate: 0.5 # Interest rate (%) / 利率(%) interval-hours: 24 # How often interest is applied / 付与間隔（時間） type: compound # compound or simple / 複利 or 単利 min-balance: 100.0 # Minimum balance to earn interest / 最低預金額 loan: enabled: true max-amount: 100000.0 # Max borrowable amount / 最大借入額 interest-rate: 1.0 # Daily loan interest (%) / 日次金利(%) repayment-days: 30 # Days to repay / 返済期限（日） late-penalty-rate: 0.5 # Extra penalty rate when overdue / 延滞ペナルティ(%) max-late-days: 7 # Days before force collection / 強制徴収までの日数 transfer: enabled: true fee-percent: 0.0 # Transfer fee (%) / 送金手数料(%) max-amount: 0.0 # Max per transfer, 0 = unlimited / 上限額(0=無制限) database: type: sqlite # sqlite or mysql / SQLite or MySQL ``` --- ## 📦 Requirements / 必要環境 - **Paper 1.21.x** - **Vault** (required / 必須) - **PlaceholderAPI** (optional / 任意) - **Geyser + Floodgate** (optional, for Bedrock support / Bedrock対応) --- ## 🔗 Plugin Integration / プラグイン連携 BankPlugin exposes a reflection-friendly API so other plugins can interact with bank accounts silently: - `depositBank(uuid, amount, note)` — deposit directly into a bank account - `withdrawBank(uuid, amount, note)` — withdraw from a bank account - `getLoanRemaining(uuid)` — check a player's remainin