LeviAntiCheat
能否不用 LeviAntiCheat(LAC)自帶的處罰,而由自己的插件監聽作弊事件並自定義處罰?LeviPenalizeCheat 怎麼用,有 LSE 版本嗎?攔截(cancel)事件會怎樣?
可以。LAC 通過 LeviLamina 的 EventBus 發佈 lac::punish::PlayerCheatEvent(檢測到作弊,含 mCheatType、mExtraData、mDuration、mType)、lac::punish::PlayerBanWaveEvent(BanWave 踢出/封禁)和 lac::punish::SusClientEvent(可疑客戶端),均為可取消事件。
官方模板 https://github.com/LiteLDev/LeviPenalizeCheat 是一個 LeviLamina C++ mod 模板(自帶這幾個事件的頭文件),按寫 C++ mod 的方式用 ll::event::EventBus::getInstance().emplaceListener<lac::punish::PlayerCheatEvent>(...) 訂閱並實現自己的處罰邏輯。官方沒有 LSE 版本;如需在腳本中使用,只能自己寫 C++ mod 把事件轉發出去(例如通過 RemoteCall 導出給 LSE)。
關於攔截:LAC 在執行內置日誌與處罰之前先發布 PlayerCheatEvent,若事件被 cancel,本次作弊既不會輸出日誌、也不會執行內置處罰或計入 BanWave 違規值。如果只想監聽而不影響內置處罰,處理函數里不要 cancel;如果想完全接管處罰,也可以直接在 config.json 中把 punish.enable 設為 false。
適用版本:LeviAntiCheat 0.1.2 起(當前 v0.18.0 仍適用)
玩家移動時頻繁被拉回、TPS 下降,是 LeviAntiCheat(LAC)造成的嗎?用了 LAC 後 server.properties 裡的服務端權威移動(server-authoritative-movement)需要怎麼設置?
拉回來自 BDS 自帶的服務端權威移動校驗,不是 LAC。當前版本的 LAC 已經沒有移動(非法移動)檢測:舊版 LAC 的 IllegalMovementCheck 本身也只是啟用 BDS 自帶的服務端移動校驗,並在 v0.15.0 中被移除。因此 LAC 不需要你調整 server.properties 中的權威移動相關配置,保持默認即可。
有用戶反饋,新版 BDS(約 1.21.70 起)強制開啟權威移動,server.properties 已無法關閉;服務器 TPS 過低(約低於 10)時更容易頻繁拉回,此時應先排查卡頓原因,如確需關閉只能藉助專門的 mod hook。
適用版本:LeviAntiCheat 0.15.0 及以上(當前 v0.18.0);BDS 行為部分依賴原版版本。未能從源碼或文檔中直接證實,僅供參考。
BDS 設置 online-mode=false(關閉正版驗證)後玩家數據/背包一直丟失,進服像新玩家一樣,怎麼解決?
關閉正版驗證後玩家數據可能無法按原方式讀取而“丟檔”。LeviAntiCheat(LAC)自帶離線模式背包保護(修復離線模式玩家背包丟失問題),在 mods/LeviAntiCheat/config/config.json 中把 worldSafety.offlineInventoryProtection 設為 true(默認為 false)後重啟或執行 /lac reload 即可;也可以自己寫插件保存玩家數據。
適用版本:當前 LeviAntiCheat(v0.18.0)
LeviAntiCheat(LAC)提示檢測到使用 NoPacket 是什麼意思?
表示檢測到該玩家超過一定時間沒有發送數據包(停止發包檢測)。閾值由 config.json 中 movement.noPacketCheck.maxNoPacketTime 控制(默認 12 秒)。如果誤報,可調大該值或將 movement.noPacketCheck.enable 設為 false 關閉;開發調試時也可以關閉該檢測,或通過訂閱 PlayerCheatEvent 自行處理(見 LeviPenalizeCheat)。
適用版本:當前 LeviAntiCheat(v0.18.0)
LeviAntiCheat 的禁言命令怎麼用?直接輸入 mute 無法運行。
禁言是 LAC 主命令 lac 的子命令,需要用 /lac mute <玩家> [时长(分钟)] 禁言,/lac unmute <玩家> 解除禁言,/lac query <玩家> 可查詢玩家的封禁/禁言狀態,而不是單獨的 mute 命令。
適用版本:LeviAntiCheat 0.4.4 及以上
LeviAntiCheat 日誌出現 "xxx" 已被检测到使用: Reach, current reach distance: 5.517 cheat level: 6 並把玩家 BanWave 踢出,是什麼意思?能否關閉?記錄在哪看?
Reach 表示攻擊距離過遠(長臂猿):current reach distance 是本次檢測到的攻擊距離;cheat level 是該玩家累計的超距命中計數(每次超距 +1、正常攻擊 -1),超過 detectLevel(默認 7)才會判定為 Reach 並輸出該日誌。可能是玩家開了長臂外掛,也可能是高延遲導致誤判。
相關配置在 mods/LeviAntiCheat/config/config.json 的 combat.reachDistanceCheck:
enable:開關;reachDistance:非創造模式最大攻擊距離,默認約 3.2;reachDistanceCreative:創造模式,默認約 5.3;detectLevel:判定閾值。
每次 Reach 計入的違規值在 punish.checkTypeViolationMap.Reach(默認 20),累計達到 punish.kickVL(默認 100)會被 BanWave 踢出,punish.enableBanWave 可關閉 BanWave。LAC 所有檢測都可在配置中單獨開關。
LAC 的專用日誌文件為 ./logs/LeviAntiCheat.log,控制台輸出由 consoleLog 控制;舊版曾出現日誌文件不記錄的問題,已在 0.8.1 修復。
適用版本:當前 LeviAntiCheat(v0.18.0);reachDistance 配置項自 0.4.4 起
LeviAntiCheat 的 GitHub 地址是什麼?LLAC 和 LAC 有什麼區別?
地址:https://github.com/LiteLDev/LeviAntiCheat,可用 lip install github.com/LiteLDev/LeviAntiCheat 安裝。LLAC(LLAntiCheat)是 LiteLoaderBDS(LL2)時代的舊版反作弊,倉庫已歸檔;LAC(LeviAntiCheat)是對應 LeviLamina 的反作弊,目前仍在維護。
LeviAntiCheat(LAC)開源嗎?它的反礦透對礦透材質包/作弊客戶端有效嗎?
LAC 是閉源項目(公開倉庫只提供 README、配置說明、語言文件和發佈包),不接受直接代碼貢獻。
反礦透是服務端在發送子區塊數據時改寫方塊(參考 PaperMC 的 Anti-Xray),與客戶端用材質包還是作弊端無關,客戶端無法繞過。配置在 cheatPrevention.antiXray,每個維度可選 engineMode:
0:把被完全包裹的礦物替換成石頭/深板岩等(隱藏模式);1:把被隱藏的實心方塊隨機替換成obfuscateBlocks中的假礦(假礦模式);2:類似1,但按 Y 層統一替換。
注意:暴露在空氣/水中的礦物、高於 maxHeight 的礦物仍可能被看到;另外要保持 worldSafety.fakeSeed 開啟,防止通過種子反推礦物位置。
適用版本:LeviAntiCheat 當前版本(反礦透在 0.16.0/0.17.2 重寫,現行 engineMode 0/1/2)
LeviAntiCheat(LAC)能防區塊邊界刷物(區塊物品複製)等複製物品漏洞嗎?
LAC 目前沒有針對區塊邊界刷物的修復,也不攔截傀儡刷物。它在 bugFixes 中提供的刷物相關修復有:
uiItemDuplicateFix:UI 槽位刷物;fallingBlockCopyFix:重力方塊/刷沙機類,例如垂滴葉刷沙;bundleContainerIdentityFix:存儲容器身份變化導致的刷物,與收納袋相關;blockActorContainerMoveFix:活塞推動容器方塊刷物。
區塊刷物可以先通過行為日誌排查刷物玩家,或者另裝針對性的修復插件。
適用版本:LeviAntiCheat 0.17.5 及以上(當前 0.18.0)
想用 LeviAntiCheat 修復利用工作臺/UI 槽位無限複製物品的 bug,但不想開啟 LAC 的全部功能,怎麼辦?
LAC 自帶 UI 槽位刷物修復,對應配置項是 bugFixes.uiItemDuplicateFix(默認 true)。LAC 的各項功能都可以在 mods/LeviAntiCheat/config/config.json 裡單獨關閉:保留 bugFixes.uiItemDuplicateFix 為 true,把不需要的檢測的 enable 或布爾值改為 false(例如 cheatPrevention.antiXray.enable、movement.timerCheck.enable、combat.autoClickCheck.enable 等;如不想被踢出也可把 punish.enable 設為 false)。建議直接修改值,不要刪除配置項。改完後執行 /lac reload 或重啟服務器。安裝:lip install github.com/LiteLDev/LeviAntiCheat
適用版本:LeviAntiCheat 當前版本(0.18.0,LeviLamina 26.60.*)
LeviAntiCheat 的反礦透(AntiXray)功能原理是什麼?
LAC 的反礦透基於混淆(參考 PaperMC 的實現)。服務端改寫發給客戶端的區塊數據,被實心方塊完全包住、玩家本來看不到的礦石會被替換成假方塊,客戶端拿不到真實方塊,礦透材質包也就失效。它有三種模式:
engineMode0:把obfuscateBlocks裡的礦石替換成mainBlock(默認 stone/deepslate);engineMode1:把隱藏的實心方塊隨機替換成obfuscateBlocks裡的方塊;engineMode2:按 y 層統一替換。
配置在 config.json 的 cheatPrevention.antiXray 下,按維度在 dimensions 中設置,詳見倉庫的 anti_x_ray.zh.md。暴露在空氣中的礦石不會被隱藏。另外要保持 worldSafety.fakeSeed 開啟,否則可以通過種子反推礦物位置。
適用版本:LeviAntiCheat 當前版本(0.18.0)
LeviAntiCheat 會把 OP/管理員也判定並踢出,有 OP 豁免嗎?怎麼讓 LAC 忽略管理員?
LAC 不區分是否為 OP,一視同仁,這是正常行為,配置中也沒有 OP 豁免項。處理辦法:
- 把誤判的那項檢測在
config.json中單獨關掉(例如movement.timerCheck、noPacketCheck,或combat下的檢測); - 用官方模板 LeviPenalizeCheat(https://github.com/LiteLDev/LeviPenalizeCheat)自定義處罰邏輯,跳過管理員;也可以調整
punish下的kickVL等閾值。
舊的第三方插件 Lac-IgnoreOperator 已歸檔,最後發佈於 2025-01,不建議在新版上使用。
適用版本:LeviAntiCheat 當前版本(0.18.0)
LeviAntiCheat 的反礦透高度設得過高(如下界設成 256)後,玩家進下界一直卡在生成地形/加載界面;這個『高度』配置能改地獄高度嗎?
不能。這個配置是 cheatPrevention.antiXray.dimensions.<维度>.maxHeight,表示只混淆該 y 座標以下的方塊,也就是反礦透生效的最大高度,跟維度本身的高度無關,反作弊插件不會修改遊戲本身。maxHeight 應設在該維度的高度範圍內(下界默認 128),並且必須是 16 的倍數(否則會在日誌報錯,該維度不啟用反礦透)。
據維護者說明,把混淆高度設到超出維度高度時,服務端發出的區塊客戶端不認,會卡在加載界面,調回 128 即可。要修改地獄高度需要另裝專門的插件。
適用版本:LeviAntiCheat 當前版本(0.18.0)
LeviLamina 服務器怎樣對玩家隱藏或偽造世界種子?還需要單獨裝 FakeSeed 插件嗎?
不需要單獨裝,LeviAntiCheat 自帶假種子功能(worldSafety.fakeSeed,默認開啟),它會直接改寫服務端發給客戶端的種子。安裝:lip install github.com/LiteLDev/LeviAntiCheat。
addon 做不到這一點;用資源包隱藏設置界面裡的種子顯示只是不顯示,客戶端仍能拿到真實種子。也可以用行為包的 feature rule 和自定義群系改動世界生成,這樣即使知道種子也推不出結構位置。
適用版本:LeviAntiCheat 當前版本(0.18.0)
LeviAntiCheat 配置文件中的 fakeSeed 項(enable、randomSeed、seed)分別是什麼意思?
fakeSeed 位於 config.json 的 worldSafety 下,用於向客戶端發送假種子。
enable:是否啟用假種子;randomSeed:為true時使用隨機的假種子,此時seed不生效;seed:randomSeed為false時發送的固定假種子數值。
默認值:
"worldSafety": { "fakeSeed": { "enable": true, "randomSeed": false, "seed": 0 } }啟用假種子後不需要手動關閉客戶端區塊生成(ClientSideChunkGen),LAC 會自動處理。
適用版本:LeviAntiCheat 當前版本(0.18.0)
LeviLamina 服務器有什麼反作弊插件可用?舊的 LLAC 有 LeviLamina 版本嗎?
有,LiteLDev 官方的 LeviAntiCheat(LAC),倉庫是 https://github.com/LiteLDev/LeviAntiCheat。可以用 lip 安裝:lip install github.com/LiteLDev/LeviAntiCheat,也可以從 GitHub Releases 下載。注意要選與所用 LeviLamina 版本匹配的 LAC 版本(例如 LAC 0.18.0 依賴 LeviLamina 26.60.*)。
適用版本:LeviLamina 當前版本
LeviLamina 服務器上能否直接使用為 LiteLoaderBDS(LL2)編寫的反作弊 dll 插件?
不能,LiteLoaderBDS(LL2)的原生插件無法在 LeviLamina 上運行。LeviLamina 下請使用官方反作弊 LeviAntiCheat(LAC):https://github.com/LiteLDev/LeviAntiCheat,可通過 lip install github.com/LiteLDev/LeviAntiCheat 安裝,或在 Releases 頁面(https://github.com/LiteLDev/LeviAntiCheat/releases)下載。注意 LAC 版本需與 LeviLamina 版本對應(如 LAC v0.18.0 依賴 LeviLamina 26.60.*)。
適用版本:當前所有 LeviLamina 版本
LeviAntiCheat(LAC)為什麼會被 Windows Defender / Windows 安全中心 / 360 識別為病毒或木馬並刪除?怎麼辦?
這是誤報。LAC 是閉源插件,維護者稱其做了加殼/代碼保護(VMProtect),且 dll 沒有數字簽名,殺毒軟件容易把這類文件誤判為木馬。請只從官方 GitHub Releases 或 lip 下載,然後把服務器目錄(或 mods/LeviAntiCheat 目錄)加入 Windows Defender 等殺軟的排除項/信任列表,再重新解壓或安裝即可。
適用版本:當前所有 LeviAntiCheat 版本(Windows)。未能從源碼或文檔中直接證實,僅供參考。
開啟 LeviAntiCheat 反礦透後,玩家反饋挖到的鑽石等礦石變成了石頭,這是 bug 嗎?
不是 bug。在 engineMode: 1 / 2(默認配置為 1)下,反礦透會把被實心方塊完全包圍的實心方塊替換成 obfuscateBlocks 裡的假礦發給客戶端,用來迷惑礦透玩家;當方塊發生變化(開始挖掘、爆炸等)時,服務器會重新發送周圍的真實方塊,假礦於是顯示為真實的石頭。
如果玩家貼臉就能看到礦石變化,可以調大對應維度的 cheatPrevention.antiXray.dimensions.<维度>.updateRadius(默認 2),但範圍越大客戶端能透視的範圍也越大。
適用版本:LeviAntiCheat 當前版本(v0.17.2 重寫反礦透後的配置結構)
LeviAntiCheat 的反礦透(anti x-ray)開了感覺沒效果,或者導致回彈,參數怎麼調?
參考官方文檔調整參數:https://github.com/LiteLDev/LeviAntiCheat/blob/release/anti_x_ray.zh.md。文檔說明了 cheatPrevention.antiXray 下各配置項(enable、maxThreads、autoSolidCheck、dimensions.<维度>.engineMode/maxHeight/updateRadius/obfuscateBlocks/mainBlock 等)的含義,給出了 engineMode 0/1/2 的主世界與下界推薦配置,並有“仍能看到礦物”“y=0 以下不起作用”等常見問題排查。
適用版本:LeviAntiCheat 當前版本
有沒有能檢測 32k 等違禁物品(非法附魔、基岩、傳送門方塊、刷怪籠、刷怪蛋、特殊值方塊等)的插件?
可以用 LiteLDev 官方反作弊 LeviAntiCheat(LAC)。在 mods/LeviAntiCheat/config/config.json 的 inventoryManagement.banItem.blacklist 中填寫要禁用的物品命名空間 ID(如 "minecraft:bedrock");超等級附魔可開啟 inventoryManagement.enchantCheck(默認關閉)並在 maxEnchantLevel 中設置各附魔最大等級,另有 anvilEnchantLimits(鐵砧附魔檢查)、invalidItemDetection、invalidStackDetection、antiInvalidNbtItem 等檢測。
適用版本:LeviAntiCheat 當前版本(配置 version 21)
LeviAntiCheat 的違禁/非法物品檢測為什麼沒報告玩家身上已有的末地傳送門框架?如何禁用某些物品?
裝了 LAC 後玩家是刷不出這類物品的,會被阻止並在控制台提示;未報告的通常是安裝前就已存在的殘留物品。
要禁用物品,在 mods/LeviAntiCheat/config/config.json 的 inventoryManagement.banItem.blacklist(字符串數組)中填寫物品命名空間 ID,如 "blacklist": ["minecraft:bedrock", "minecraft:end_portal_frame"],並保持 banItem.enable 為 true。命中後觸發 BanItem 檢測並按 punish.checkTypeViolationMap.BanItem 計違規值;LAC 設計上不負責清除物品,如需清除可監聽 lac::punish::PlayerCheatEvent(參考 LeviPenalizeCheat 模板)自行處理。
適用版本:LeviAntiCheat 當前版本(配置 version 21)
LeviAntiCheat(LAC)配置中的 banItem(禁用物品列表)支持正則表達式嗎?
不支持。inventoryManagement.banItem.blacklist 只能寫具體的物品命名空間 ID(如 "minecraft:bedrock"),不能用正則或通配符匹配。
適用版本:LeviAntiCheat 當前版本。未能從源碼或文檔中直接證實,僅供參考。
LeviAntiCheat 的附魔檢測誤踢人(如脫裝備時觸發鐵砧附魔檢測)或關不掉,怎麼辦?
LAC 有兩項獨立的附魔檢測:inventoryManagement.enchantCheck(附魔等級檢查,默認關閉)和 inventoryManagement.anvilEnchantLimits(鐵砧附魔檢查,默認開啟)。只關 enchantCheck.enable 是不夠的,還需要把 "anvilEnchantLimits": false 才能完全關閉附魔相關檢測,改完執行 /lac reload 或重啟。也可以只降低 punish.checkTypeViolationMap 中 InvalidAnvilEnchant / InvalidEnchantLevel 的違規值來避免被踢。早期 0.4.0-rc6 等版本的脫裝備誤判已在 rc.6~rc.8 修復,請使用最新版。
適用版本:LeviAntiCheat 當前版本(配置 version 21)
下載了 LeviAntiCheat(LAC,含反礦透功能)放進服務器後不加載、沒有任何提示,也找不到配置文件,應該怎麼裝?
推薦直接用 lip 安裝:lip install github.com/LiteLDev/LeviAntiCheat,lip 會自動放到正確位置並匹配 LeviLamina 版本。
手動安裝時,從 GitHub Release 下載 LeviAntiCheat-windows-x64.zip,把壓縮包裡的 LeviAntiCheat/ 整個文件夾(含 manifest.json 和 dll)放到服務端的 mods/ 下,即 mods/LeviAntiCheat/,不要只放 dll 或多套一層文件夾。只看到 manifest 等描述文件而沒有配置文件,說明插件沒被正確加載;正確加載後會生成 mods/LeviAntiCheat/config/config.json。
另外要確認下載的 LAC 版本與當前 LeviLamina 版本對應(例如 LAC 0.18.0 依賴 LeviLamina 26.60.*),舊版(如給 LiteLoaderBDS/舊 LL 用的 0.2.x)不會加載。反礦透功能在配置的 cheatPrevention.antiXray 中調整。
適用版本:LeviLamina 當前版本(LAC 0.18.0 / LeviLamina 26.60.*)
安裝了 LeviAntiCheat 後找不到它的配置文件在哪?
配置文件需要開服一次(插件成功加載)後才會自動生成,位置是 mods/LeviAntiCheat/config/config.json。修改後可重啟服務器,或使用 /lac reload 重載配置。
適用版本:LeviAntiCheat 當前版本(0.18.0)
在 docker 容器裡用 lip 卸載 LeviAntiCheat 失敗,怎麼卸載?
lip uninstall 是命令行操作,不會因服務器在運行而拒絕;但若要刪除的文件正被運行中的服務器佔用(Windows 下 BDS 加載的 LeviAntiCheat.dll),操作會失敗並整體回滾,此時需先停服再執行 lip uninstall github.com/LiteLDev/LeviAntiCheat(lip 圖形界面在服務器運行時會直接拒絕卸載)。
當前官方 docker 鏡像中,容器的主進程就是 lip run,停服即容器退出,因此不能“停服後再進容器”。做法是在容器運行時執行:
docker exec -it <容器名> lip uninstall github.com/LiteLDev/LeviAntiCheat這與官方教程用 docker exec ... lip install 添加模組的方式相同。然後 docker stop 再啟動容器使改動生效。
Wine 鏡像中 lip 原生運行在 Linux 上,一般不會遇到文件佔用;若在 Windows 容器鏡像中因文件佔用失敗,可停掉容器後用同一數據卷臨時起一個容器、把入口改為 lip 執行卸載。另外如果是通過 PACKAGES 變量安裝的,它只在首次啟動時生效,刪除該變量不會卸載已裝的包。
適用版本:lip 當前版本(v0.41.x),docker-levilamina-server 當前鏡像(latest-wine / latest-windows)
LeviAntiCheat 一開始正常(或用 lip 裝好後),後來啟動時加載報錯,發現 LeviAntiCheat.dll 不見了,是什麼原因?
通常不是 lip 或插件本身的問題,而是 Windows Defender(Windows 安全中心)把 LeviAntiCheat.dll 當作威脅隔離/刪除了(LAC 為閉源並做了保護處理,容易被誤報)。到 Windows 安全中心的“保護歷史記錄”裡恢復該文件,並把服務器目錄加入排除項,然後重新安裝插件(如 lip install github.com/LiteLDev/LeviAntiCheat)。
適用版本:Windows 上運行的 LeviLamina 服務器,當前所有版本。未能從源碼或文檔中直接證實,僅供參考。
LeviAntiCheat 反礦透(antiXray)的 engineMode 應該填什麼值?各模式有什麼區別、哪個最省性能、會修改存檔嗎?
當前取值是 0/1/2(不是舊的 1/2/3,舊文檔/圖片裡 PaperMC 的模式 1/2/3 分別對應這裡的 0/1/2),按維度在 cheatPrevention.antiXray.dimensions.<维度>.engineMode 中設置:
engineMode: 0:把obfuscateBlocks中的礦物替換為假方塊(mainBlock,默認minecraft:stone;y<0 用mainBlockMinus,默認minecraft:deepslate),只隱藏被實心方塊完全包住的礦,暴露在空氣/水中的礦不隱藏;計算開銷最低。engineMode: 1:把被包住的實心方塊隨機替換為obfuscateBlocks中的方塊,防透視效果更強,但數據量更大。engineMode: 2:與 1 類似,但同一 y 層替換為同一種假方塊,子區塊更規整、更利於數據包壓縮。
區塊改寫在工作線程中進行(maxThreads,0 表示使用 CPU 線程數),對主線程影響小;反礦透只改寫發給客戶端的數據包,不修改存檔。只混淆 maxHeight(須為 16 的倍數)以下的方塊,方塊變化時按 updateRadius 重發真實方塊。建議同時保持 worldSafety.fakeSeed 開啟以防種子反推。也可以關閉 LAC 的反礦透改用獨立的 GlacieTeam/AntiXray,二者配置項基本對應(AntiXray 用下劃線命名,LAC 用小駝峰),但需自行確認其版本是否支持當前 LeviLamina。
適用版本:LeviAntiCheat 0.16.0 及以上(當前 0.18.0)
給 LeviLamina 服務器裝上 LeviAntiCheat(LAC)後服務器崩潰(開服即崩或運行中崩潰),原因是什麼?有解決辦法嗎?
首先確認 LAC 版本與 LeviLamina 版本匹配:LAC 每個版本只適配特定的 LeviLamina 版本(例如有用戶把支持 LeviLamina 1.2 的 LAC 裝在 1.1 上導致開服即崩)。請下載與當前 LeviLamina 對應的 LAC 版本,或把 LeviLamina 升級到 LAC 要求的版本;推薦用 lip install github.com/LiteLDev/LeviAntiCheat 安裝,lip 會按依賴檢查版本。
若版本匹配後運行中仍崩潰,可在 mods/LeviAntiCheat/config/config.json 中將 cheatPrevention.antiXray.enable 設為 false(反礦透是歷史上 LAC 崩服的常見來源)來排查,並向官方提交 issue。不需要反礦透等功能的話也可以不裝 LAC,LeviLamina 自身的漏洞修復(vulnerabilityFixes)不依賴 LAC。
適用版本:當前所有版本(最新 LAC v0.18.0 對應 LeviLamina 26.60.*)
服務器安裝 LeviAntiCheat(LAC)後主世界出現方塊顯示異常,如何解決?
這通常是 LAC 的反礦透(anti-xray)功能導致的(它會對被實心方塊完全包圍的方塊進行混淆,默認 engineMode 為 1,會把這些被隱藏的實心方塊隨機替換為 obfuscateBlocks 中的礦物再發給客戶端)。在 mods/LeviAntiCheat/config/config.json 中將 cheatPrevention.antiXray.dimensions.overworld.enable 設為 false 即可關閉主世界的反礦透(或將 cheatPrevention.antiXray.enable 設為 false 全部關閉),然後執行 /lac reload 或重啟服務器。若是附加包方塊顯示異常,也可檢查 treatAddonBlocksAsNonSolid、nonSolidBlocks 等設置。
適用版本:當前所有版本(配置鍵以 LAC 0.17.x/0.18.0 為準)
安裝 LeviAntiCheat(LAC)後啟動報版本相關錯誤、無法加載,怎麼辦?
LAC 是針對特定 LeviLamina 版本編譯的,版本必須匹配。請安裝與當前 LeviLamina 版本對應的 LAC(或把兩者一起升級到對應版本),推薦用 lip 安裝以自動解析依賴:lip install github.com/LiteLDev/LeviAntiCheat。例如當前最新 LAC 0.18.0 要求 LeviLamina 26.60.*;各 LAC 版本對應的 LL 版本見 CHANGELOG。
適用版本:當前所有版本(LAC 0.18.0 對應 LeviLamina 26.60.*)
LeviAntiCheat(LAC)能和 Fishing 反作弊(FAC)一起裝嗎?
當時維護者表示不兼容:FAC 會破壞 LeviLamina 的一個 API,二者只能選一個。
適用版本:2024 年 4 月 LeviLamina 0.x 時期;當前版本未知。未能從源碼或文檔中直接證實,僅供參考。
LeviAntiCheat(LAC)懲罰配置中的封禁時長(duration)字段是什麼意思?
它是懲罰(封禁)的持續時間,不是作弊次數。當前配置中對應 punish.banDuration,單位為秒,0 表示永久封禁;是否封禁由 punish.banVL 決定(-1 表示不封禁),kickVL 為踢出違規值。另外手動命令 /lac ban <玩家> [原因] [时长(分钟)] 的時長單位是分鐘。
適用版本:當前版本(LeviAntiCheat 0.18.0,配置版本 21)
LeviAntiCheat 報「已被檢測到使用: InvalidFilterString, string size: ...」並通過 BanWave 把玩家踢出,但玩家只是用命名牌加原版 § 顏色符號改了物品名,怎麼回事?
這是 LAC 的物品名稱長度檢查(違規類型 InvalidFilterString):物品名字符串長度超過了配置上限。日誌中的 string size 與名字的 UTF-8 字節數一致,§ 格式代碼和中文都佔多個字節,所以看起來不長的名字也可能超限。在 mods/LeviAntiCheat/config/config.json 中把 playerInteractions.itemNameLengthCheck.maxStringLength(默認 90)調大,或將 itemNameLengthCheck.enable 設為 false 關閉該檢測;也可以調低 punish.checkTypeViolationMap.InvalidFilterString(默認 50)的違規值(punish.enableBanWave 控制封禁潮)。改完後執行 /lac reload。
適用版本:當前版本(LeviAntiCheat 0.18.0)
修改過 LeviAntiCheat 的 config.json 後日志報錯(如與 AntiXray 方塊相關的配置錯誤),怎麼處理?
多半是改配置時刪掉了必需項、方塊名寫錯或 JSON 格式出錯。可以備份後刪除 mods/LeviAntiCheat/config/config.json,重啟服務器讓其生成默認配置,再按需重新修改。AntiXray 的維度名、engineMode 或 maxHeight(須為 16 的倍數)寫錯時日誌會報錯,該維度不會啟用反礦透。
適用版本:當前版本(配置路徑 mods/LeviAntiCheat/config/config.json)。未能從源碼或文檔中直接證實,僅供參考。
LeviAntiCheat 的 Timer(發包速率)檢測誤判正常玩家,站著不動也被踢,日誌顯示 rate 在 25~30 左右,怎麼辦?
正常客戶端發送移動輸入包的速率與 tick 一致,約每秒 20 個(波動約 18~22),LAC 默認閾值為 24。網絡抖動時可能出現誤判,可在配置中把 movement.timerCheck.maxPacketSpeed 調高到 30 左右(也可調整 detectLevel,默認 15,或降低 punish.checkTypeViolationMap.Timer 違規值),改完執行 /lac reload。
適用版本:當前版本(LeviAntiCheat 0.18.0)
LeviAntiCheat 的反礦透支持 MoreDimensions 創建的自定義維度嗎?
反礦透按維度配置,在 cheatPrevention.antiXray.dimensions 下以維度名稱為鍵(默認只有 overworld、nether)。維護者表示自定義維度需自行在該處添加對應維度名的配置。若維度名無法識別,日誌會報錯且該維度不啟用反礦透,請據此檢查。
適用版本:當前版本(AntiXray 已在 0.16.0/0.17.2 重寫)。未能從源碼或文檔中直接證實,僅供參考。
LeviAntiCheat 的配置文件有中文說明/教程嗎?
有。倉庫中有中文 README:https://github.com/LiteLDev/LeviAntiCheat/blob/release/README.zh.md,其中給出了帶中文註釋的完整默認配置(配置文件位於 mods/LeviAntiCheat/config/config.json);反礦透子模塊另有說明文檔 anti_x_ray.zh.md。注意配置文件中的 "version" 字段是配置版本號,不要手動修改(當前為 21)。
適用版本:LeviAntiCheat 當前版本(0.18.0)
LeviAntiCheat(LAC)經常誤封/誤踢正常玩家,怎麼降低誤判或關閉某些檢測(比如只保留防礦透)?
編輯 mods/LeviAntiCheat/config/config.json(改完後執行 /lac reload 或重啟服務器),把容易誤判的檢測的 enable 設為 false,或調寬對應閾值:
- 變速齒輪檢測(誤封常見來源):
movement.timerCheck.enable,或調大maxPacketSpeed(每秒最多移動輸入包數,默認 24); - 停止發包檢測:
movement.noPacketCheck.enable,或調大maxNoPacketTime; - 連點器、攻擊距離:
combat.autoClickCheck、combat.reachDistanceCheck; - 物品相關檢測:
inventoryManagement下的invalidItemDetection、invalidStackDetection、antiInvalidNbtItem、anvilEnchantLimits、banItem等; - 懲罰相關:
punish.enable(總開關)、punish.enableBanWave(封禁潮)、kickVL/banVL(踢出/封禁違規值),以及punish.checkTypeViolationMap中每種檢測每次增加的違規值,可調低某項的違規值以降低誤踢。
如果只想要防礦透,可保留 cheatPrevention.antiXray.enable=true,把其他檢測關掉。各項含義見 https://github.com/LiteLDev/LeviAntiCheat/blob/release/README.zh.md。
注意:LAC 自 0.15.0 起已移除 IllegalMovementCheck,走路被拉回等移動校驗來自 BDS 原版的服務端權威移動,不再能通過 LAC 調整。
適用版本:LeviAntiCheat 0.15.0 及以上(當前 0.18.0)
裝了 LeviAntiCheat(LAC)後,玩家在平地跳躍/跑動也會摔傷掉血(TPS、延遲都正常),怎麼解決?
這是 LAC“移除客戶端對玩家動作的權威”功能引起的。在 mods/LeviAntiCheat/config/config.json 中把 movement.disablePlayerActionsAuthority 設為 false(0.17.4 起默認就是 false;0.17.3 中該功能名為 PlayerActionsAuthority 且默認開啟,建議直接升級到最新版)。
適用版本:LeviAntiCheat 0.17.3 及以上(當前 0.18.0 鍵名為 disablePlayerActionsAuthority)
裝了 LeviAntiCheat(LAC)後,服務器後臺一直踢人,甚至所有玩家都被踢、進不去服務器,怎麼解決?
這通常是 LAC 的“停止發包檢測”(NoPacket)誤判。該檢測是檢查玩家是否長時間停止向服務器發包,關閉它不會讓作弊者“無敵”。在 mods/LeviAntiCheat/config/config.json 中把 movement.noPacketCheck.enable 設為 false,或調大 movement.noPacketCheck.maxNoPacketTime(默認 12 秒)。另外 0.4.5 已修復服務器主線程卡頓時 NoPacket 誤判的問題,請先確認使用的是最新版 LAC。
適用版本:LeviAntiCheat 當前版本(0.18.0)
某些通過發包修改玩家名字顯示的插件和 LeviAntiCheat 的假名檢測衝突,怎麼處理?
在 mods/LeviAntiCheat/config/config.json 中把 cheatPrevention.antiFakeName 設為 false 即可(當前版本默認就是 false)。
適用版本:LeviAntiCheat 當前版本(0.18.0)
裝了 LeviAntiCheat 後,玩家連續輸入 shop 等命令會被踢出,怎麼辦?
這是防命令刷屏檢測(CommandSpam,用於防 Horion 之類一秒發大量命令的外掛)觸發的。在 mods/LeviAntiCheat/config/config.json 中調大 playerInteractions.antiSpam.maxCmdRate(每秒最高命令數,默認 2),或調低 punish.checkTypeViolationMap.CommandSpam(每次觸發增加的違規值,默認 50)。
適用版本:LeviAntiCheat 當前版本(0.18.0)
裝了 LeviAntiCheat(LAC)後仍有人刷屏攔不住怎麼辦?
調整 mods/LeviAntiCheat/config/config.json 中 playerInteractions.antiSpam 的設置:確認 enable 為 true,調小 maxChatRate(chatRateDuration 秒內允許的最多聊天數,默認 10 秒內 5 條)、maxCmdRate(每秒最多命令數)、maxChatLength(最大聊天長度),可開啟 disableSelector 禁止在命令中使用目標選擇器;也可以提高 punish.checkTypeViolationMap 中 Spam / CommandSpam / MessageTooLong 的違規值,讓刷屏者更快被踢。
適用版本:LeviAntiCheat 當前版本(0.18.0)