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対応

📜 Commands / コマンド

Aliases: /b, /銀行 Japanese subcommand aliases: 預金, 引出, 送金, ローン, 返済, 残高, 履歴, ランキング

🔐 Permissions / 権限

⚙️ Configuration Highlights / 設定ハイライト

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 remaining loan
• takeLoanSilent(uuid, amount) / repayLoanSilent(uuid, amount) — for instalment integrations

他プラグインからリフレクション経由で口座操作・ローン連携が可能です。MarketPlugin等との統合を想定した設計です。

Made for economy-focused Minecraft servers. Perfect as a standalone bank or as part of a larger economy plugin suite.

経済サーバー向けに設計された銀行プラグイン。単体でも、複数プラグインで構成されるエコノミースイートの一部としても機能します。