LegacyMoney
LegacyMoney 的 /money add 只能指定玩家名,能不能用目標選擇器(如 @s、@a)給玩家加錢?有沒有 LL2 LLMoney 那樣的 money_s?
可以。LegacyMoney 重寫了命令,舊版 LLMoney 的 money_s 改為在子命令後加 s 的寫法,使用目標選擇器:/money adds <选择器> <数量>、/money reduces <选择器> <数量>、/money sets <选择器> <数量>、/money querys <选择器>,例如 /money adds @s 10。不帶 s 的 /money add/reduce/set/query 則接受玩家名(可對離線玩家操作)。這些操作需要 OP(GameDirectors 及以上)權限。用法見倉庫 README。
適用版本:LegacyMoney 0.x 至當前(v0.23.0)
LeviLamina 還像 LiteLoaderBDS 那樣內置經濟系統嗎?LeviLamina 下用什麼經濟插件,怎麼安裝和使用?
LeviLamina 不再內置經濟系統。原 LiteLoaderBDS 的 LLMoney 已移植為獨立模組 LegacyMoney(https://github.com/LiteLDev/LegacyMoney),大部分 LSE 腳本插件的經濟功能(money API)都調用它。
用 lip 安裝 LegacyScriptEngine(如 lip install github.com/LiteLDev/LegacyScriptEngine)時會作為依賴自動安裝;也可單獨安裝:lip install github.com/LiteLDev/LegacyMoney。
遊戲內通過 /money 命令使用(query/pay/add/reduce/set/hist/top 等),配置文件為模組目錄下的 money.json(currency_symbol、def_money、enable_commands、pay_tax)。
適用版本:LeviLamina 全部版本(當前 LegacyMoney v0.23.0 / LSE v0.23.1)
LegacyMoney 的 /money 命令“沒法用”:對玩家操作提示找不到玩家/沒反應,或提示沒有權限,怎麼解決?
兩類常見原因:
- 提示
Player not found或對玩家操作無效:/money add/set/reduce/query/hist <玩家名>通過 LeviLamina 的 PlayerInfo 服務(玩家數據庫,記錄 uuid、xuid、name)按名字查找玩家。該服務默認是懶加載的,只有在首次被調用後才開始記錄進服玩家,之前進服但沒記錄過的玩家會找不到。在 LeviLamina 配置文件Config.json中把playerInfo的alwaysLaunch設為true,讓服務器啟動時就啟用玩家信息記錄(佔用資源極小),之後玩家重新進服一次即可被記錄。 - 提示
You don't have permission to do this:/money命令本身對所有人可見(註冊權限為 Any),但 add/reduce/set、查詢他人餘額、hist <玩家名>、purge 在執行時要求 OP(GameDirectors)及以上權限,普通玩家會被拒絕;控制台權限最高,不會因此被拒,但 pay 和不帶玩家名的 hist 只能由玩家執行,控制台會提示Console is not allowed to use this command。
適用版本:LeviLamina 當前版本;LegacyMoney 0.23.0
如何在玩家離線時修改其 LegacyMoney 餘額?為什麼有的離線玩家能改成功、有的會失敗?
用不帶 s 的命令按玩家名操作即可對離線玩家生效,例如 /money add <玩家名> <数量>、/money set <玩家名> <数量>(帶 s 的選擇器版本只能選中在線玩家)。
按名字操作依賴 LeviLamina 的 PlayerInfo 記錄把名字解析為 xuid:
- 如果該玩家從未被 PlayerInfo 記錄(例如 PlayerInfo 服務未在啟動時開啟、玩家之後沒再進過服),會提示
Player not found。 - 如果玩家 xuid 為空(如離線模式/未登錄 Xbox 的玩家),LegacyMoney 會直接返回失敗(
Failed to add money)。
可在 LeviLamina 的 Config.json 中把 playerInfo.alwaysLaunch 設為 true,並讓玩家重新進服一次以寫入記錄。腳本插件中也可直接用 money.add(xuid, value) 等按 xuid 操作離線玩家。
適用版本:LegacyMoney v0.23.0;LeviLamina 當前版本
自己寫的插件想註冊一個命令(如 /checkin)給玩家加經濟(LegacyMoney 的錢),可以直接操作嗎?
可以。LegacyMoney 是前置模組,LSE 提供了經濟接口:money.get/set/add/reduce/trans/getHistory/clearHistory(參數為玩家 xuid),以及 Player 對象上的 getMoney/setMoney/addMoney/reduceMoney 等,可直接在腳本插件中加減玩家餘額,詳見 LSE 文檔“經濟系統 API”。
原生 C++ 模組可鏈接 LegacyMoney 並調用 LLMoney.h 中導出的 LLMoney_Add/LLMoney_Reduce 等函數。
若不想寫插件,也可以用第三方插件的命令映射功能(如 GMEssentials 的 command_map)把自定義命令映射為 /money add 等命令。
適用版本:LSE v0.23.1;LegacyMoney v0.23.0
LSE 領地等插件配置裡要求花費“貨幣/硬幣”,這個貨幣從哪來?LLMoney 是什麼,需要單獨裝嗎?
這類 LSE 插件的經濟一般對接的是 LLMoney 經濟系統,在 LeviLamina 上即 LegacyMoney(LLMoney 的移植版),插件裡說的“貨幣/硬幣”就是它的餘額。安裝 LegacyScriptEngine(運行 JS/Lua 等腳本插件的引擎)時它會作為依賴自動安裝,無需另裝。之後還需要通過其他插件或命令給玩家提供獲取貨幣的途徑,例如管理員用 /money add <玩家> <数量>,或在 money.json 中設置 def_money 作為新玩家初始金額。
適用版本:當前 LSE / LegacyMoney 所有版本
LegacyMoney 的 /money 以前有 GUI 表單,更新 LSE 後沒有了,是 LegacyMoney 自帶的 GUI 被刪了嗎?
LegacyMoney 本身從來沒有 GUI,只有命令。以前看到的表單來自其他 LSE 插件(如 TMEssential/TMET)註冊了同名 /money 命令,覆蓋了 LegacyMoney 的命令。新版 LSE 規範了命令註冊,已存在的命令不能再被腳本覆蓋(只會提示命令已存在),所以表單消失。
解決方法:
- 修改該 LSE 插件裡註冊的命令名(如改成
/moneys)。 - 或者使用提供經濟 GUI 的其他插件。
- 如果不需要 LegacyMoney 自帶命令,也可在 LegacyMoney 的
money.json中把enable_commands設為false,讓出/money命令名。 - 也可以去 LegacyMoney 倉庫提 feature request。
LegacyMoney v0.23.0 仍無 GUI。
適用版本:LSE 0.17.x 及以後;LegacyMoney 當前版本
LegacyMoney(LLMoney)支持多貨幣或小數金額嗎?
不支持。LegacyMoney 是單一貨幣系統,每個玩家(xuid)只有一個餘額,金額為整數(內部為 long long,LSE API 參數類型為 Integer)。需要多貨幣可以用計分板等方案實現;需要小數(如兩位小數)時,建議以整數存儲最小單位(如“分”),顯示時再換算。
適用版本:LegacyMoney 當前所有版本
LegacyMoney(LLMoney)支持用 UUID 作為玩家標識嗎?
不支持,LegacyMoney 以 xuid 作為玩家標識,所有接口(LLMoney_* 及 LSE 的 money.* API)都傳 xuid。沒有 xuid 的玩家(如離線模式未登錄 Xbox)無法使用,相關操作會直接返回失敗。若只有 UUID,可先通過 LeviLamina 的 PlayerInfo(ll::service::PlayerInfo::fromUuid)或 LSE 的數據接口換算出 xuid。
適用版本:LegacyMoney 當前所有版本
使用 LegacyMoney 時,如何查看經濟(金錢)流水/來源記錄?
使用 /money hist 查看自己的流水(僅玩家可執行,可選參數 time 為秒數,默認最近 24 小時);OP 可用 /money hist <玩家名> [time] 查看他人流水(控制台查詢需帶玩家名)。清除流水用 /money purge,需再輸入 /money purge confirm [time] 確認。腳本中可用 LSE 的 money.getHistory(xuid, time)。
適用版本:LegacyMoney 當前所有版本
LeviLamina 本體自帶經濟系統嗎?如何在多個服務器之間同步 LegacyMoney 經濟數據、實現跨服傳送?
LeviLamina 本體不自帶經濟系統。經濟功能由獨立的原生 mod LegacyMoney 提供(lip install github.com/LiteLDev/LegacyMoney),LegacyScriptEngine 依賴它,安裝 LSE 時會自動拉取。LegacyMoney 只把數據存在本地 SQLite(mods/LegacyMoney/economy.db),不提供跨服同步或跨服傳送功能;這類需求需要藉助第三方的跨服協調插件(例如 MineBBS 上的 CoordinationWSS,含跨服傳送),或自行開發同步方案。
適用版本:當前版本(LegacyMoney 0.23.x;LeviLamina 26.60.x)。未能從源碼或文檔中直接證實,僅供參考。
重構後的 LegacyMoney 有哪些功能?能否提供備份記分板數據的功能?
LegacyMoney 支持查詢排行(/money top [number],默認前 10 名)、通過配置項 currency_symbol 自定義貨幣符號,並已提供中文本地化(lang/zh_CN.json)。它不提供備份記分板數據的功能,經濟數據本身存在 mods/LegacyMoney/economy.db(SQLite),備份記分板需自行找第三方工具/插件。
適用版本:LegacyMoney 0.2 及以上
LLMoney(經濟插件)在哪裡下載?在 MineBBS 上找不到。
LLMoney 在 LeviLamina 下的繼任者叫 LegacyMoney,由 LiteLDev 在 GitHub 發佈(https://github.com/LiteLDev/LegacyMoney),推薦用 lip 安裝:lip install github.com/LiteLDev/LegacyMoney。舊的 LLMoney 倉庫已歸檔,不適用於 LeviLamina。
適用版本:LeviLamina 全部版本
從 GitHub 下載的 LegacyMoney 怎麼手動安裝(不用 lip)?
推薦用 lip 安裝(lip install github.com/LiteLDev/LegacyMoney),它會自動處理 LeviLamina 版本依賴。
手動安裝:
- 在 Release 中下載對應端的壓縮包(服務端為
LegacyMoney-server-windows-x64.zip)。 - 解壓後只取其中的
LegacyMoney文件夾,放到服務端的mods目錄下(即mods/LegacyMoney/)。
注意 LegacyMoney 版本必須與 LeviLamina 版本匹配(如 0.23.x 對應 LeviLamina 26.60.*)。
適用版本:LegacyMoney 0.8 及以上
經濟插件(LegacyMoney)裡玩家餘額變成 -1,用命令設置成任何值都無效,是什麼原因?
通常是 server.properties 中把 online-mode 關閉了。關閉在線模式後玩家拿不到 xuid,而 LegacyMoney 以 xuid 為鍵:xuid 為空時查詢餘額直接返回 -1,set/add/reduce 也會直接失敗。應保持 online-mode=true;關閉期間產生的數據可能因 xuid 缺失/錯亂而無法對應。另外數據庫讀寫出錯時也會返回 -1,可查看控制台的 Database error 日誌。
適用版本:LegacyMoney 0.8.4 及以上
C++ 插件中要調用 LegacyMoney(LLMoney)的 API,直接 include LLMoney.h 就行嗎?
不行,需要先在 xmake.lua 中引入 levimc-repo 裡的 legacymoney 包,例如 add_requires("legacymoney 0.23.*"),並在 target 中 add_packages("legacymoney"),然後 #include "LLMoney.h" 使用 LLMoney_Get、LLMoney_Add 等函數(需鏈接其導入庫)。運行時服務器上也必須安裝 LegacyMoney,建議在 mod 的依賴中聲明它。
適用版本:LegacyMoney 當前所有版本
從 https://github.com/LiteLDev/LLMoney/releases 手動下載的 LLMoney 在 LeviLamina 下出問題(經濟數據被清零、db/配置文件消失),LLMoney 不支持 LeviLamina 嗎?
LLMoney 是 LiteLoaderBDS 時代的插件,倉庫已歸檔,不支持 LeviLamina。LeviLamina 下應使用其繼任者 LegacyMoney(https://github.com/LiteLDev/LegacyMoney),通過 lip install github.com/LiteLDev/LegacyMoney 安裝,不要像 LL2 時代那樣手動下載放文件。數據位於 mods/LegacyMoney/economy.db(配置為 mods/LegacyMoney/money.json);舊數據可把原 economy.db 複製到該目錄繼續使用,LL2 舊格式的 money.db 放到 mods/LegacyMoney/LLMoney/money.db,啟動時會自動轉換。
適用版本:LeviLamina 全部版本
LegacyMoney(llmoney)的數據庫文件為什麼越來越大?如何清理?
數據庫 mods/LegacyMoney/economy.db 除餘額表 money 外,還有流水錶 mtrans,玩家轉賬、加減錢都會寫入,積少成多。清理流水需 OP(GameDirectors 及以上)執行 /money purge confirm [time](直接輸入 /money purge 只會提示危險操作並要求加 confirm;time 為秒數,只刪除早於該時間的流水,默認 0 即全部清空)。也可以停服後用 SQLite 工具手動刪除無用數據(如餘額為 0 的記錄)。
適用版本:LegacyMoney 0.7 及以上
LeviLamina 下 LegacyMoney(原 LLMoney)的經濟數據保存在哪個文件?
經濟數據是一個 SQLite 數據庫,位於模組目錄下:服務端為 .\plugins\LegacyMoney\economy.db(餘額表 money 和流水錶 mtrans 都在裡面)。同一目錄下的 money.json 是配置文件。如果模組目錄裡有舊版 LLMoney 的數據 .\plugins\LegacyMoney\LLMoney\money.db,LegacyMoney 啟動時會自動把它導入 economy.db,然後把原文件重命名為 money_old.db。
這也適用於當前的 LegacyMoney v0.23.0(服務端模組根目錄為 plugins/)。
適用版本:LeviLamina 0.13.x 及以上