iListenAttentively
iListenAttentively-LseExport(ila-lseexport)是什麼?是 iListenAttentively 的擴展嗎?提供哪些功能、支持哪些版本?
iListenAttentively-LseExport(https://github.com/MiracleForest/iListenAttentively-LseExport)是把 LeviLamina 的事件系統導出給 LSE(LegacyScriptEngine)腳本插件使用的模組。它不是隻服務於 iListenAttentively:凡是註冊到 LeviLamina 事件總線上的事件(LeviLamina 自帶事件、iListenAttentively 事件、其他模組的自定義事件)都可以在 LSE 裡監聽,並能攔截/修改事件參數(前提是該事件實現了序列化/反序列化),例如數據包發送事件,這樣 LSE 插件不用自己寫 Hook。
除事件外還提供:
- NativeAPI 類功能(
getAddressFromSymbol/getAddressFromSignature取地址、hook/unhook原生函數、內存讀寫等,用於替代 LSE 已移除的 NativeAPI) - 帶 Proxy 的 NBT 便捷封裝
registerEvent/publish自定義事件getAllEvent等查詢接口
它的硬依賴只有 LeviLamina 和 LegacyRemoteCall,不強制依賴 iListenAttentively。當前最新 v0.5.0(2026-09-09)採用多版本內嵌二進制,內置 LeviLamina 1.0.0-rc.1、1.2.0-rc.1、1.9.7、26.10.5、26.20.0、26.32.0 的適配,運行時按當前 LeviLamina 版本選不高於它的最接近版本。基本沒有文檔,參考倉庫 README 和 lib/iListenAttentively.d.ts 類型聲明。
適用版本:iListenAttentively-LseExport v0.5.0(LeviLamina 1.0.0-rc.1 起;官方聲明適配到 26.20.x/26.30.x,更新的 LeviLamina 26.60.x 使用 26.32.0 適配,兼容性需自測)
LSE 腳本插件能否使用 iListenAttentively(ila)提供的事件(如玩家關閉容器、紅石更新、方塊被燒燬等 LSE 原生沒有的事件)?需要依賴什麼、事件名怎麼寫、能拿到參數嗎、有文檔嗎?
可以。安裝 iListenAttentively(lip install github.com/LiteLDev/iListenAttentively)和 iListenAttentively-LseExport(https://github.com/MiracleForest/iListenAttentively-LseExport/releases),在自己插件的 manifest 中聲明依賴 iListenAttentively-LseExport,然後:
/** @type {import("iListenAttentively")} */
const iListenAttentively = require("./iListenAttentively-LseExport/lib/iListenAttentively.js");
iListenAttentively.emplaceListener("事件名", event => { ... }, 优先级可选);要點:
- LseExport 本身只依賴 LeviLamina 和 LegacyRemoteCall(其 manifest 只聲明瞭 LegacyRemoteCall,
tooth.json也不含 iListenAttentively),並不依賴 iListenAttentively,所以需要自行確保 iListenAttentively 本體已安裝(當前版本 LSE 自身已依賴 iListenAttentively,用 lip 安裝 LSE 時會一併裝上)。 - 能否拿到/修改事件參數取決於提供該事件的模組是否實現了
serialize/deserialize:LeviLamina 和 iListenAttentively 的事件實現了,可讀取並修改參數(改完的字段會寫回),Cancellable事件可設置cancelled攔截;沒實現的事件只能監聽和攔截。可以設置監聽優先級。 - 事件名是 C++ 類型名(LeviLamina 的事件 ID 來自去掉 inline 命名空間後的類型名),例如
ila::mc::ExplosionBeforeEvent、ll::event::PlayerJoinEvent;不確定時用iListenAttentively.getAllEvent()列出當前所有事件名再確認。 - 沒有專門文檔,參考
lib/iListenAttentively.d.ts類型聲明和 iListenAttentively 源碼頭文件(https://github.com/LiteLDev/iListenAttentively)。
另外 LseExport 還提供了取地址、hook 等函數,用於替代 LSE 已刪除的 NativeAPI。
適用版本:iListenAttentively 0.14.0 及以上;iListenAttentively-LseExport v0.5.0
LSE 中在 onMobHurt 裡修改 damage 參數想削減 TNT 傷害但沒效果,source.id === "tnt" 也判斷不到,正確做法是什麼?
- LSE 的
onMobHurt回調只能return false攔截,修改回調參數不會生效;想改傷害等參數需要藉助 iListenAttentively(ila)的事件。 - 判斷實體類型應使用
entity.type(命名空間 id,如"minecraft:tnt"),entity.id是實體類型枚舉數字。 - 安裝 iListenAttentively(https://github.com/LiteLDev/iListenAttentively)和 iListenAttentively-LseExport(https://github.com/MiracleForest/iListenAttentively-LseExport),在插件 manifest 中聲明依賴
iListenAttentively-LseExport,然後:
/** @type {import("iListenAttentively")} */
const iListenAttentively = require("./iListenAttentively-LseExport/lib/iListenAttentively.js");
iListenAttentively.emplaceListener("ila::mc::ExplosionBeforeEvent", event => {
if (mc.getEntity(event.sourceId)?.type == "minecraft:tnt") {
event.damageScaling = event.damageScaling * 0.25;
}
});mc.getEntity 需要數字類型 id。ila 沒有文檔,字段可看 ila 源碼 ExplosionEvent.cpp 的 serialize,或在 VSCode 中打開 lib 下的 .d.ts 聲明文件獲得補全。
適用版本:iListenAttentively 0.14.0 及以上(配合 iListenAttentively-LseExport);LSE 當前版本
LSE 中怎麼讓模擬玩家被創建時不顯示“XXX 加入了遊戲”?
LSE 原生 API 做不到,思路是攔截服務器發出的加入消息 TextPacket。可以讓插件依賴 iListenAttentively 和 iListenAttentively-LseExport,用 ila 的發包事件(SendPacketBeforeEvent,可攔截)在發送前判斷並攔截對應的 TextPacket。
ila 除了通用的發包事件外,還按包類型分別發佈事件,事件名形如 ila::mc::SendPacketBeforeEvent<class TextPacket>,可只監聽 TextPacket;實際事件名請用 iListenAttentively.getAllEvent() 確認。
注意該事件在腳本側只把 packet 作為原生對象指針暴露,判斷包內容(是否為某玩家的加入消息)需要藉助 LseExport 的內存/原生調用接口。
適用版本:LeviLamina + iListenAttentively + iListenAttentively-LseExport;LiteLoaderBDS 舊版做法已不適用。未能從源碼或文檔中直接證實,僅供參考。
LSE 中玩家編輯告示牌對應哪個事件?onBlockInteracted 能用嗎?
onBlockInteracted 是方塊交互事件,不是告示牌編輯事件。LSE 目前沒有專門的告示牌編輯事件;iListenAttentively 提供了 PlayerEditSignBeforeEvent / PlayerEditSignAfterEvent(C++ 中為 ila::mc::PlayerEditSignBeforeEvent,Before 可攔截,可讀取/修改 pos、text,side 為正反面),源碼見 https://github.com/LiteLDev/iListenAttentively/blob/main/src/ila/event/world/actor/player/PlayerEditSignEvent.cpp。LSE 腳本可通過 iListenAttentively-LseExport 使用。新遊戲內容的事件也歡迎向 LSE 提交 PR。
適用版本:iListenAttentively 0.14.0 及以上(LiteLDev 倉庫);LSE 當前版本
LSE 插件中如何攔截末影人搬運方塊?C++ mod 如何使用 iListenAttentively(ila)事件庫?
LSE:現在已有原生事件 onEndermanTakeBlock(回調 function(entity, block, pos),返回 false 攔截;LSE 0.11.3 起提供,當前版本內部基於 ila 的 MobTakeBlockBeforeEvent 實現),直接用即可。
C++ mod:使用 iListenAttentively 的 ila::mc::MobTakeBlockBeforeEvent(可攔截)。在 xmake.lua 中:
add_repositories("levimc-repo https://github.com/LiteLDev/xmake-repo.git")
add_requires("ilistenattentively 0.18.*")並在 target 中 add_packages("ilistenattentively"),然後用 ll::event::EventBus::getInstance().emplaceListener<ila::mc::MobTakeBlockBeforeEvent>(...) 監聽。服務器上需安裝 iListenAttentively(lip install github.com/LiteLDev/iListenAttentively),版本號按當前 LeviLamina 對應的 ila 版本選擇。
適用版本:LSE 0.11.3 及以上(onEndermanTakeBlock);iListenAttentively 0.14.0 及以上,當前 0.18.0(LeviLamina 26.60.*)
LSE 插件用 onDestroyBlock 攔截破壞箱子時,大箱子會被拆成兩半,放置時也無法攔截大箱子合併,有沒有對應事件?
iListenAttentively 提供了箱子合併事件 ChestPairWithBeforeEvent / ChestPairWithAfterEvent(C++ 中為 ila::mc::ChestPairWithBeforeEvent,中間的 world/level/block/actor 都是 inline 命名空間可省略),可在 Before 事件中攔截箱子合併。LSE 側通過 iListenAttentively-LseExport 監聽;事件名不確定時先調用 iListenAttentively.getAllEvent() 查看實際名稱。
適用版本:iListenAttentively 0.14.0 及以上(LiteLDev 倉庫)
LSE 無法直接攔截實體死亡事件,怎麼實現阻止實體死亡?
LSE 的 onMobDie 不可攔截。可以用 iListenAttentively 的血量變化事件 MobHealthChangeBeforeEvent(ila::mc::MobHealthChangeBeforeEvent,配合 iListenAttentively-LseExport 在腳本中使用):當 newValue 小於等於 0 時設置 cancelled 攔截,或把 newValue 改成 0.1 之類的正數(該事件實現了反序列化,修改會寫回)。
適用版本:iListenAttentively 0.14.0 及以上(配合 iListenAttentively-LseExport)
LSE(LegacyScriptEngine)插件有沒有辦法監聽玩家發送的數據包?
LSE 本身沒有數據包監聽接口。可以依賴 iListenAttentively(ila)和 iListenAttentively-LseExport:ila 提供收包/發包事件(ila::mc::ReceivePacketBeforeEvent / ReceivePacketAfterEvent、SendPacketBeforeEvent / SendPacketAfterEvent 等,ila 很多事件本身就是基於數據包實現的),通過 LseExport 導出給 LSE 使用。
此外 ila 還按包類型分別發佈事件(事件名形如 ila::mc::ReceivePacketBeforeEvent<class TextPacket>),可只監聽某種包,準確名稱用 iListenAttentively.getAllEvent() 查看。注意腳本側拿到的 packet 是原生對象指針。
ila 沒有單獨文檔,“頭文件即文檔”。地址:https://github.com/LiteLDev/iListenAttentively(0.14.0 之前的舊版本在 https://github.com/MiracleForest/iListenAttentively-Release/releases)。
適用版本:iListenAttentively 0.14.0 及以上(配合 iListenAttentively-LseExport)
LeviLamina C++ mod 如何監聽玩家丟棄物品事件?LeviLamina 的 API 和源碼裡都找不到,需要自己 hook 嗎?
LeviLamina 本體沒有該事件,不需要自己 hook,使用 iListenAttentively(ila,LiteLDev 官方事件擴展庫,https://github.com/LiteLDev/iListenAttentively)提供的 ila::mc::PlayerDropItemBeforeEvent(可攔截)/ PlayerDropItemAfterEvent。xmake 中添加 levimc-repo 後 add_requires("ilistenattentively")(版本與 LeviLamina 對應,當前 0.18.*)即可。
適用版本:iListenAttentively 0.14.0 及以上;當前 0.18.0 對應 LeviLamina 26.60.*
iListenAttentively 的 JS 封裝裡,給 NBT 賦值能不能直接寫 nbt[key] = 值,而不用 nbt.setString 之類的方法?數字會被轉成哪種 NBT 類型?
可以。iListenAttentively-LseExport 的 JS 封裝(lib/iListenAttentively.js)給 NBT 套了一層 Proxy,可以直接 nbt[key] = "字符串",會自動轉換;也能直接賦值 object(轉 NbtCompound)或數組(轉 NbtList),列表可以用 nbt[数字下标] 訪問。
轉換規則:整數 number 轉 Int,帶小數的 number 轉 Float,boolean 轉 Byte,bigint 轉 Long,string 轉 String;需要 Short/Double 等其他類型時要自己用對應的 NBT 類顯式構造(JS 的 number 無法區分 byte/short/int)。
適用版本:iListenAttentively-LseExport 當前版本(v0.5.0)
在 LSE JS 裡通過 iListenAttentively(ILA)監聽事件時,直接打印 event 只顯示 NbtClass,怎麼查看一個事件裡包含哪些字段(NBT 內容)?
回調拿到的 event 是 NBT(NbtCompound,經 iListenAttentively-LseExport 的 lib 包了一層 Proxy),調用它的 toSNBT() 把內容轉成 SNBT 字符串再打印即可,例如 logger.info(event.toSNBT())。
適用版本:當前所有版本(通過 iListenAttentively-LseExport 在 LSE 中監聽 ILA/LL 事件)
在 LSE 中用 iListenAttentively-LseExport 監聽事件時,類型聲明 .d.ts 裡事件名只是 string,去哪裡找可監聽的事件名列表?
事件名用 string 是因為任何 native(C++)mod 註冊到 LeviLamina EventBus 的事件都能按名字監聽,無法全部寫進類型。可以在腳本里調用 iListenAttentively.getAllEvent() 獲取當前所有已註冊事件(含 modName 與 eventName),用 getAllEventAlias() / getEventAlias() / getEventName() 查詢別名。
別名現在由 LseExport 啟動時自動生成:ILA 事件可用 ila::mc::<事件类名>(或帶部分命名空間)的簡寫,LL 自帶事件可用 ll::event::<事件类名>,例如 "ll::event::PlayerJoinEvent"。lib/events 目錄下也附帶了 LeviLamina、LeviAntiCheat 等事件的 .d.ts。
LseExport 本身只依賴 LeviLamina 和 LegacyRemoteCall,不強制依賴 ILA;要用 ILA 的事件需同時安裝 ILA。
適用版本:iListenAttentively-LseExport 0.5.0 及以上
在 LSE 的 JS 插件裡監聽 iListenAttentively(ILA)的事件,想攔截事件時在回調裡 return false 沒有效果,應該怎麼攔截?怎麼知道哪些事件能攔截?
ILA 事件不是靠回調返回 false 來攔截的。回調拿到的 event 本質上是 NBT 對象,可取消事件帶有 cancelled 字段,把它設為 true 即可攔截:event["cancelled"] = true;(不需要 return)。
只有 C++ 側繼承了 Cancellable 的事件(通常是 xxxBeforeEvent)才能攔截,After 事件或未實現取消的事件即使設置也無效;可以看 ILA 源碼中對應事件頭文件是否繼承 ll::event::Cancellable,或打印 event.toSNBT() 看有沒有 cancelled 字段。
適用版本:當前版本(通過 iListenAttentively-LseExport 使用 ILA 事件)
有沒有監聽方塊被火焰燒燬的事件?iListenAttentively 是否支持?
iListenAttentively 提供 FireTryBurnBlock 事件:FireTryBurnBlockBeforeEvent(可取消,取消後火不會在該位置燃燒)和 FireTryBurnBlockAfterEvent,帶 pos 字段。注意它掛在 FireBlock::isValidFireLocation 上,是在“嘗試燃燒”時觸發,監聽時方塊尚未實際被燒燬。可以用來替代監聽 onBlockChanged 的做法。在 LSE 中經 LseExport 可用別名 ila::mc::FireTryBurnBlockBeforeEvent 監聽。
適用版本:iListenAttentively 當前版本(0.18.0)
其他插件(如 LSE 插件、機器人轉發)怎麼讀取玩家死亡消息,包括被別的插件修改過的死亡消息?
可以使用 iListenAttentively 提供的死亡消息事件:DeathMessageBeforeEvent(可取消,並可修改 result)和 DeathMessageAfterEvent。事件 NBT 中有 sourceUniqueId、cause 以及 result{key, params}(死亡消息的翻譯鍵和參數)。如果某插件只是修改了死亡返回的消息而沒有改原版死亡事件,讀取最終消息應監聽 After 事件。LSE 中經 iListenAttentively-LseExport 可用別名 ila::mc::DeathMessageAfterEvent 監聽。
適用版本:iListenAttentively 當前版本(0.18.0)
依賴 iListenAttentively 事件的 LSE 腳本插件(如 ShoppingMall、iLand)裝上後不生效,該怎麼辦?
LSE 腳本插件要使用 iListenAttentively 的事件,除了安裝 iListenAttentively 本身外,還需要額外安裝 ILA 的 LSE 導出模塊 iListenAttentively-LseExport,從 https://github.com/MiracleForest/iListenAttentively-LseExport/releases 下載(無法訪問 GitHub 可用鏡像),解壓到 plugins/iListenAttentively-LseExport/。它依賴 LeviLamina 與 LegacyRemoteCall。
注意 iListenAttentively 本體需與 LeviLamina 版本匹配(當前 ILA 0.18.0 對應 LeviLamina 26.60.*),可用 lip install github.com/LiteLDev/iListenAttentively 安裝。LSE 自 0.21.2 起自身依賴 ILA,但腳本直接用 ILA 事件仍需 LseExport。
如何在 LeviLamina C++ mod(xmake 項目)中引入 iListenAttentively(ILA)事件庫作為依賴?
ILA 包現在已收錄在 LiteLDev 的 xmake-repo 裡(模板默認已添加的 levimc-repo),在 xmake.lua 中:
add_repositories("levimc-repo https://github.com/LiteLDev/xmake-repo.git")
add_requires("ilistenattentively 0.18.*", {configs = {target_type = get_config("target_type")}})並在 target 裡 add_packages("ilistenattentively")。版本要與所用 LeviLamina 匹配(ILA 0.18.* 對應 LeviLamina 26.60.*)。然後執行 xmake project -y -k compile_commands 生成補全信息。
另外記得在 mod 的 manifest.json 的 dependencies 裡聲明 {"name": "iListenAttentively"},保證加載順序。
適用版本:iListenAttentively 0.14.0 及以上,當前 0.18.0 / LeviLamina 26.60.*
iListenAttentively 的 LSE 導出插件(iListenAttentively-LseExport)很久沒更新,還能用嗎?
可以繼續使用。LseExport 不需要隨 LeviLamina 版本頻繁更新:它內置了針對多個 LeviLamina 版本編譯的內部二進制,啟動時按當前加載器版本自動選擇最合適的一份加載,事件則通過 EventBus 按名字動態導出。最新版本為 v0.5.0(倉庫仍在維護,2026-11 有提交)。
適用版本:iListenAttentively-LseExport 0.5.0 及以上
iListenAttentively(ILA)為什麼沒有玩家權限變動事件(PlayerChangePermissions)?還能加回來嗎?
ILA 在 0.3.0(適配 LeviLamina 1.1.0-rc.1 / BDS 1.21.60)時刪除了 PlayerChangePermissions(玩家權限變動)事件。原因是 BDS 1.21.60 把相關函數內聯了,原來的函數調用變成了直接賦值,沒有可以 hook 的函數,所以這個事件加不回來,至今最新版 ILA 也沒有該事件。一般來說,BDS 每次更新都可能因為內聯丟掉一些函數,依賴這些函數的事件或 API 也會隨之被移除。
另外,若只需監聽玩家命令權限等級(CommandPermissionLevel)的變化,LeviLamina 自身提供 ll::event::PlayerChangePermEvent(hook Player::setCommandPermissions,可取消,newPerm() 返回新等級),可作為替代。
適用版本:iListenAttentively 0.3.0 及以上(當前最新 0.18.0 仍無此事件)