COSMOGRIDMinecraft Plugins
Paper
ECONOMY SYSTEM

經濟系統

純數值的伺服器端經濟插件。每位玩家只有一個資料庫餘額，不使用實體貨幣、不設銀行，死亡與 keepInventory 都不會影響金錢。

功能介紹安裝資訊
資料庫
SQLite / MySQL / MariaDB
玩家功能
餘額・轉帳・排行榜
選用整合
Vault / PlaceholderAPI
OVERVIEW

不把金錢做成物品

金錢只存在資料庫中，不會掉落、不會被撿走，也不會因死亡或 keepInventory 設定而改變。

玩家沒有銀行、存款、提款或利息，每個帳戶只有一個餘額。伺服器可自行設定初始金額、上下限、顯示格式、付款規則與交易紀錄保留時間。

純伺服器端精確金額運算離線玩家付款繁中與英文
FEATURES

玩家日常使用與伺服器管理

餘額與顯示

查詢自己或其他玩家的餘額，並可使用內建計分板、Action Bar 或 PlaceholderAPI 顯示。

玩家轉帳

支援最低金額、單次與每日上限、冷卻、高額付款確認，以及離線玩家收款。

排行榜

提供分頁金錢排行榜，可設定是否排除被凍結的帳戶。

管理與稽核

管理員可 give、take、set、reset、freeze，並查詢玩家歷史與單筆交易資料。

COMMANDS

玩家與管理指令

玩家指令

/balance查看自己的餘額；別名 /bal、/money /balance <玩家>查看其他玩家的餘額，預設限 OP /pay <玩家> <金額>付款給線上或離線玩家 /payconfirm / /paycancel確認或取消高額付款 /baltop [頁碼]查看金錢排行榜

管理指令

/economy balance <玩家>查看餘額與帳戶狀態 /economy give|take <玩家> <金額>增加或扣除玩家金錢 /economy set <玩家> <金額>直接設定玩家餘額 /economy reset <玩家>重設為初始金額 /economy freeze|unfreeze <玩家>凍結或解除凍結帳戶 /economy history <玩家> [頁碼]查詢玩家交易紀錄 /economy transaction <交易 ID>查詢單筆交易明細 /economy reload重新載入設定檔與語言檔
TRANSACTION SAFETY

針對多人伺服器的交易安全

精確金額

核心運算使用精確十進位；SQLite 以最小貨幣單位整數保存，避免浮點誤差。

原子交易

鎖定帳戶、驗證餘額、更新金額與寫入紀錄都在同一個資料庫交易內完成。

重複扣款防護

整合插件可提供 Reference ID，已成功的同一筆操作不會被重複執行。

非同步資料庫

資料庫工作使用專用執行緒池，不直接阻塞 Minecraft 主執行緒。

STORAGE & INTEGRATIONS

資料庫與選用整合

SQLite適合單台伺服器，資料保存在插件資料夾。
MySQL / MariaDB適合正式環境或多台伺服器共用同一套帳戶資料。
Vault選用。讓支援 Vault 的商店、領地或其他插件使用 CosmoEconomy。
PlaceholderAPI選用。提供餘額與排行榜名次等 Placeholder。
內建顯示不安裝其他顯示插件，也可使用側邊欄計分板或 Action Bar。
CONFIGURATION

付款規則與資料庫設定

以下是使用 SQLite 的安全範例，不包含任何資料庫帳號或密碼。切換資料庫類型後需要重新啟動伺服器。

config.yml

一般金額、付款與顯示設定可在修改後執行 /economy reload；資料庫類型必須重啟才會切換。

language: zh-TW

currency:
  starting-balance: 1000
  maximum-balance: 999999999

payments:
  maximum-per-transaction: 100000
  maximum-per-day: 500000
  cooldown-seconds: 10
  require-confirmation-above: 10000

storage:
  type: SQLITE
  sqlite:
    file: economy.db
DOWNLOAD & INSTALLATION

下載與安裝

將插件放入 Paper 伺服器的 plugins 資料夾後完整重新啟動。首次啟動會由 Paper 解析 JDBC 驅動與連線池函式庫。

插件版本支援環境檔案
v1.0.0Paper 26.1.2 · Java 25CosmoEconomy.jar
  1. 01
    放入插件

    將 CosmoEconomy.jar 複製到伺服器的 plugins 資料夾。

  2. 02
    首次啟動

    完整啟動伺服器，讓 Paper 載入插件所需的資料庫函式庫。

  3. 03
    調整設定

    設定貨幣、付款限制、資料庫與選用整合；變更資料庫類型後請重新啟動。

發布前請移除真實連線資訊

公開 JAR 或原始碼時，預設 config.yml 不應包含正式資料庫主機、帳號或密碼。