Cback
Cback 提供玩家在发生传送事件或死亡后返回先前位置的功能。针对 Geyser / Floodgate 跨平台架构进行底层优化,修正基岩版网络延迟与服务器端反作弊拉回导致坐标被错误覆盖的问题。此外,插件提供 /eback 历史记录菜单,会根据客户端来源自动派发 Java 箱子界面或基岩版原生表单。
功能架构
- 双端界面适配
- 自动检测客户端连接协议。
- Java 版:调用标准箱子容器界面。
- 基岩版:通过 Floodgate 与 Cumulus API 调用客户端原生按钮表单。
- 坐标防抖动与校验机制
- 时间间隔限制 (
save-cooldown-ms):设定最短存储冷却时间,过滤密集包与短期连续位移。
- 最小距离判定 (
min-distance):同世界内小于指定距离的位移不予记录,防止反作弊插件拉回修正时覆盖真实传送点。
- 历史位置队列
- 每个玩家最多保留 10 条历史坐标。
- 记录项包含触发类型(传送点 / 死亡点)、所属世界、X/Y/Z 坐标以及时间戳。
- 传送等待与中断防护
- 支持传送倒计时。
- 倒计时期间可配置是否在玩家移动或受到伤害时中断传送。
- 性能与存储
- 全面采用 Paper 异步传送 API (
teleportAsync),降低跨世界或未加载区块传送对服务器主线程的负载。
- 玩家历史记录采用 UUID 独立 YAML 文件持久化存储。
- 配置文件具备缺失键自动补齐功能,更新版本时保留现有自定义参数。
指令列表
| 指令 |
参数 |
默认权限 |
说明 |
/back |
无 |
所有人 (true) |
返回上一次记录的位置(传送点或死亡点) |
/cback |
无 |
所有人 (true) |
主要指令,功能同 /back |
/cback |
reload |
管理员 (op) |
重新加载配置文件与玩家历史数据 |
/eback |
无 |
所有人 (true) |
打开历史位置清单界面 |
权限节点
| 权限节点 |
默认指派 |
说明 |
cback.use |
所有人 (true) |
允许执行 /back、/cback 及 /eback 指令 |
cback.admin |
管理员 (op) |
允许执行 /cback reload 指令 |
Cback
Cback 提供玩家在發生傳送事件或死亡後返回先前位置的功能。針對 Geyser / Floodgate 跨平台架構進行底層優化,修正基岩版網路延遲與伺服器端防作弊拉回導致座標被錯誤覆蓋的問題。此外,插件提供 /eback 歷史紀錄選單,會依據客戶端來源自動派發 Java 箱子介面或基岩版原生表單。
功能架構
- 雙端介面適配
- 自動偵測客戶端連線協議。
- Java 版:調用標準箱子容器介面。
- 基岩版:透過 Floodgate 與 Cumulus API 調用客戶端原生按鈕表單。
- 座標防抖動與校驗機制
- 時間間隔限制 (
save-cooldown-ms):設定最短儲存冷卻時間,過濾密集封包與短期連續位移。
- 最小距離判定 (
min-distance):同世界內小於指定距離的位移不予記錄,防止防作弊插件拉回修正時覆蓋真實傳送點。
- 歷史位置佇列
- 每個玩家最多保留 10 筆歷史座標。
- 記錄項目包含觸發類型(傳送點 / 死亡點)、所屬世界、X/Y/Z 座標以及時間戳記。
- 傳送等待與中斷防護
- 支援傳送倒數計時。
- 倒數期間可配置是否在玩家移動或受到傷害時中斷傳送。
- 效能與儲存
- 全面採用 Paper 異步傳送 API (
teleportAsync),降低跨世界或未載入區塊傳送對伺服器主執行緒的負載。
- 玩家歷史紀錄採 UUID 獨立 YAML 檔案持久化儲存。
- 設定檔具備缺漏鍵自動補齊功能,更新版本時保留現有客製化參數。
指令列表
| 指令 |
參數 |
預設權限 |
說明 |
/back |
無 |
所有人 (true) |
返回上一次記錄的位置(傳送點或死亡點) |
/cback |
無 |
所有人 (true) |
主要指令,功能同 /back |
/cback |
reload |
管理員 (op) |
重新載入設定檔與玩家歷史資料 |
/eback |
無 |
所有人 (true) |
開啟歷史位置清單介面 |
權限節點
| 權限節點 |
預設指派 |
說明 |
cback.use |
所有人 (true) |
允許執行 /back、/cback 及 /eback 指令 |
cback.admin |
管理員 (op) |
允許執行 /cback reload 指令 |
Cback is a Paper-based teleportation callback (/back) plugin designed to restore a player's previous location after teleportation or death. It addresses cross-platform coordinate desynchronization in Geyser / Floodgate environments, specifically mitigating packet latency issues and anti-cheat rubberbanding. The plugin also features an /eback menu that dynamically renders either a chest GUI or a native Bedrock form based on the client's platform.
Technical Features
- Platform-Aware UI Dispatching
- Determines client type at runtime.
- Java Edition: Dispatches standard container inventory interface.
- Bedrock Edition: Uses Floodgate and Cumulus APIs to render native button forms.
- Position Filtering and Validation
- Cooldown Threshold (
save-cooldown-ms): Enforces a minimum interval between location writes to drop redundant or delayed packets.
- Distance Threshold (
min-distance): Ignores positional changes within the same world that do not exceed the specified block distance, preventing anti-cheat setbacks from overriding valid coordinates.
- Location History Queue
- Maintains a fixed-size queue of up to 10 entries per player.
- Stores location metadata including event cause (teleport / death), world identifier, XYZ coordinates, and UNIX timestamps.
- Warmup and Cancellation Handling
- Configurable teleport countdown.
- Event listeners monitor player movement and damage during warmup to cancel pending teleports when configured.
- Performance and Storage
- Uses Paper's
teleportAsync API to prevent main-thread hangs during cross-world or unloaded-chunk teleports.
- Persists player location data into individual YAML files indexed by player UUID.
- Automatically merges new configuration entries on startup while preserving existing values.
Commands
| Command |
Arguments |
Default |
Description |
/back |
None |
Everyone (true) |
Teleports to the most recent location (teleport or death) |
/cback |
None |
Everyone (true) |
Primary command; aliases /back |
/cback |
reload |
Operator (op) |
Reloads config.yml and re-reads player data |
/eback |
None |
Everyone (true) |
Opens the location history interface |
Permissions
| Permission |
Default |
Description |
cback.use |
Everyone (true) |
Grants access to /back, /cback, and /eback |
cback.admin |
Operator (op) |
Grants access to /cback reload |
评论 0
登录后参与评分
还没有评论,来抢沙发吧