為什麼做這個

自家生存服的反透視需求。市面上兩派方案都有帳單:封包混淆騙不過 freecam,而且每個玩家的封包都要處理;清礦重生要掃區塊,我第一版就是這樣做的,121 個 forceload 區塊直接把 TPS 壓到 18.9,刪掉整套掃描才回到 20.1。這個數字之後,「順便掃一下區塊」在這個插件裡是寫進文件的紅線。

怎麼運作

原版的礦全部留在原地當誘餌,透視要看就給它看。完全被實心方塊包住的礦,在第一次被挖開露出來的瞬間,才由一個吃伺服器私有 salt 的確定性函數決定是真礦還是石頭。生成時就露在洞穴壁上的礦永遠是真的、永遠不被動;決算又發生在方塊送到客戶端之前——所以不開掛的人從頭到尾什麼都沒看到,作弊的人在挖開之前,連「這顆是不是誘餌」都無從判斷。

機制的完整拆解(誘餌決算、礦脈函數、dirty 規則的邊界條件)寫在〈反 X-Ray 的第三條路:礦根本不用藏〉。

關鍵決策

• salt 只存在伺服器自己的資料庫:種子地圖算不出真礦位置,演算法全開源也推不出來
• 玩家蓋過的位置永不重新決算:把看到的礦蓋起來再挖開,它還在;活塞也偷看不了未決算的誘餌
• 成本上限寫死是常數,事件路徑上不查資料庫、不掃區塊
• 挖礦獎勵不做在裡面,只對外發一個事件,要接的插件自己接,沒人接就安靜

現況與限制

v1.2.0 已公開發佈(GitHub Release,TYUSL 授權)。已上架 SpigotMC 與 Hangar,Modrinth 審核中。Spigot / Paper / Folia 26.1.2、Java 25,零硬依賴,訊息檔內建中英雙語。

• 誘餌模型讓透視、freecam、種子地圖同時失效,老實玩家零感知
• 每次事件成本是常數(消失方塊 × 六個鄰居),無封包混淆、無區塊掃描
• 中英雙語文件與可自訂訊息檔,公開事件 API 可自接挖礦獎勵
• Spigot、Paper、Folia 三平台支援