尚尤里斯客户端

Chanyoris Client

Chanyoris 插件會在地圖物品上渲染遊戲。這個模組拋棄了那種方式，改為以你電腦的原始幀率重新繪製所有內容。

---

運作原理

地圖物品更新緩慢，且伺服器需要為每個像素的渲染付出成本。這個模組完全消除了這項成本。伺服器停止為你繪製地圖，改為每遊戲刻發送緊湊的棋盤狀態（約 220 位元組）。模組解碼該狀態，並以你電腦運行的任何幀率（60fps、120fps 或更高）在你的螢幕上繪製完整的 HUD 疊加層。伺服器不做任何像素運算。全部由你的電腦完成。

加入 Chanyoris 伺服器後，握手會自動發生——無需指令，無需設定。狀態協定有版本號（目前為 v6）且完全向下相容：新模組會讀取伺服器附加的可選字段，舊伺服器則不發送這些字段，無論哪種組合都不會出錯。

• G — 隨時切換原生 HUD 和原始地圖顯示。
• J — 切換模組輸入（將你的鍵盤/控制器直接發送給伺服器）。
• K — 開啟控制器設定畫面。

---

🎨 以原生幀率獲得的效果

以下所有效果均由模組逐幀繪製，與你的硬體同步。這些都不會觸及伺服器。

3D 方塊渲染 — Tapioka 風格的方塊，帶有玻璃光澤、頂部/左側高光、底部/右側陰影、內部色彩核心和雙層中心發光。在 60fps 以上流暢運行。

霓虹發光邊框 — 棋盤邊框以多層次向外發光，顏色與模式相關，並以正弦波緩慢脈動，使其看起來充滿生氣。

模式強調色 — 終界龍變為紫色。TNT 變為橙紅色。苦力怕變為綠色。普通模式使用溫暖的茶褐色。

暖色漸層背景 — 棋盤背景從頂部的暖深褐色垂直漸變到底部的深紫黑色。

內部暗角 — 微妙的暗色內邊框增加了深度感和聚焦感。

危險脈衝 — 當你的堆疊到達頂部行時，內邊框會以快速的正弦波脈動紅色。堆疊越高，脈動越強烈。

硬降軌跡 — 發光的垂直條紋追蹤你方塊落下的確切路徑，每次硬降後逐漸淡出。

落地閃光與灰塵 — 方塊鎖定的瞬間，落地行會出現閃光，灰塵粒子向外爆發。

消除行閃光 — 每次消除時棋盤都會閃爍；更大或特殊的消除會以青色閃爍，更亮、持續更久。

畫面震動 — 整個棋盤在硬降和消除時會震動，並隨著時間平滑衰減。

粒子爆發 — 彩色粒子從被消除的行中噴出。

帶彈跳效果的浮動技巧文字 — SINGLE / DOUBLE / TRIPLE / QUAD / PERFECT CLEAR / B2B / REN 會以彈跳動畫彈入視野（與原始 HTML 版本相同），然後淡出。文字是你的伺服器插件發送的確切標籤——因此模組會自動跟隨已安裝的版本用語。

垃圾行計量表 — 顏色編碼的警告軌道：灰色 → 黃色 → 紅色 → 閃爍紅色 → 就緒。直接從伺服器讀取每行階段數據，因此始終與實際佇列匹配。

目標警告線 — 一條紅色虛線精確標記即將到來的垃圾行將堆疊到的高度。

方塊上的苦力怕臉 — 苦力怕格子顯示一個縮放到方塊大小的點陣圖臉。

對手棋盤 — 在 CPU、VS 和在線模式中，對手的棋盤會與你的棋盤並排即時渲染，他們的名字會以 "VS …" 的形式顯示在 HUD 中。

大逃殺 HUD — 即時 KO 計數和徽章等級，以及脈動的 "KO!" / 對手消除閃光，以及在跨伺服器比賽中的剩餘玩家計數器。

倒數覆蓋層 — 每場比賽都以全螢幕的 "3 → 2 → 1 → GO!" 倒數開始，大尺寸點陣圖數字背後有深色背景，與伺服器同步繪製（與地圖和 HTML 版本計時相同）。數字為金色，GO! 為青色。

死亡模式危險覆蓋層 — 在死亡模式中，螢幕邊緣會脈動紅色，隨著你的棋盤接近失敗而加劇。

遊戲結束覆蓋層 — 當你出局時，一個深色覆蓋層會淡入。

面板發光 — HOLD 和 NEXT 面板帶有柔和的外發光。

---

🐲 3D 世界效果（模組專屬）

這些效果僅從棋盤狀態在你的 Minecraft 世界中生成真實的實體和粒子——伺服器從未修改。無傷害、無方塊破壞、無經驗值、無伺服器負載。其他玩家看不到它們，且每個操作都有保護，因此故障絕不會導致你的客戶端崩潰。

終界龍 — 在終界龍模式期間，一條真正的龍會在你面前生成，原地固定並設置為無敵，因此它無法遊蕩或造成傷害。它的生命值與 Boss 戰同步，當 Boss 受傷時會閃爍紅色，並每 4 秒吼叫一次。被擊敗時會播放完整的原版死亡動畫，然後消失。

苦力怕 — 當棋盤上出現苦力怕格子時，一隻真正的苦力怕會從世界遠方向你走來，靠近時發出嘶嘶聲。格子消除的瞬間，它會引爆並產生粒子和聲音——僅為視覺效果。

TNT — 在 TNT 對戰期間，你周圍會維持 36 個已點燃的 TNT。方塊鎖定、行消除、垃圾行撞擊和遊戲結束都會觸發集群爆炸。全部為視覺效果，僅你可見。

閃電 — 每次大逃殺 KO 都會在你身上降下僅視覺效果的閃電——KO 數越多，閃電越多，3 KO 以上時還會伴隨煙火。

煙火 — Perfect Clear 會觸發煙火和圖騰粒子爆發。

---

🎮 控制器與鍵盤支援

通過直接 GLFW 遊戲手把讀取實現完整的控制器支援——它輪詢所有連接的搖桿，並同時適用於標準遊戲手把映射和原始 HAT 十字鍵。為所有 8 個遊戲動作分配任何按鈕或軸+方向。設定保存到文件中並在會話之間持久化。在遊戲內的 Chanyoris 控制器畫面（K 鍵）中進行配置。

8 個動作中的每一個都有一個第二按鍵綁定槽位（預設未分配，在原版控制畫面中設定）——對於雙手鍵盤佈局或輔助設備很方便。

DAS（130ms）和 ARR（28ms） 在客戶端以 System.nanoTime() 精度處理，因此重複輸入具有與專用方塊益智遊戲相同的清脆感——遠比將原始按鍵轉發到伺服器更緊湊。

開啟模組輸入並釋放 WASD 鍵後，你可以在玩遊戲時在 Minecraft 世界中走動。

---

⚙️ 系統需求

Minecraft — 26.1.2+

載入器 — Fabric (loader 0.19.3+)

Fabric API — 必須安裝

Java — 需要 25 或更高版本

伺服器插件 — 伺服器需要 Chanyoris v1.45.0+

僅限客戶端。如果伺服器上沒有 Chanyoris，則無任何作用。

---

🕹️ 使用方法

將 jar 檔案和 Fabric API 放入你的 mods 資料夾。加入一個 Chanyoris 伺服器。模組會自動啟動。

G 切換 HUD。J 切換模組輸入。K 開啟控制器設定。移除 jar 檔案即可卸載——伺服器會自動回退到地圖渲染。

---

⚠️ 商標聲明

Chanyoris 是一款原創的方塊益智遊戲。"Tetris®" 是 Tetris Company, LLC 的註冊商標。本項目與該公司無任何關聯或得到其認可。

---

本模組移植自作者的 Minecraft 伺服器 "Sankagataki"。該伺服器運行著正統的原始版本。

作者: Hatune — v2.31.1