🏦 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 / 設定ハイライト

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.

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