# Death Return `Death Return` is a Fabric mod focused on death position tracking with a minimal and practical workflow. When a player dies, the mod automatically records the dimension, coordinates, and timestamp, keeps the latest `20` death entries, and provides command-based viewing plus clickable chat actions for quick access and teleportation. Both vanilla and modded dimensions are supported. ![示例图片](https://cdn.modrinth.com/data/cached_images/717ba590a3d48a655e5ec2d6979fe889b4de638f.png) ### Overview - Automatically records death location without manual input. - Keeps the latest `20` death history entries per player. - `/deathpos` shows history in pages of `5` entries. - Each entry includes a clickable teleport action. - Sends a compact chat message on death with quick actions. - Supports admin queries for other players. - Supports vanilla dimensions and mod-added dimensions. - Main logic is server-driven, so client installation is optional for multiplayer use. ### Compatibility | Item | Requirement | | --- | --- | | Minecraft | `1.21` to `1.21.11` | | Fabric Loader | `0.16.0+` | | Java | `21+` | | Fabric API | Required | | Fabric Language Kotlin | Required | ### Required Dependencies Install the following dependencies into the target `mods` directory together with this mod: | Dependency | Required | Notes | | --- | --- | --- | | Fabric API | Yes | Provides Fabric events, commands, and runtime APIs | | Fabric Language Kotlin | Yes | Required because this mod is written in Kotlin | If `fabric-language-kotlin` is missing, the game will fail to load the mod. ### Installation #### Dedicated Server Place the mod and its dependencies into the server `mods` directory. Clients do not need to install the mod in order to join. #### Client / Singleplayer The mod can also be installed on the client side for singleplayer or LAN host usage. Since singleplayer uses an integrated server, the mod works normally when installed locally. ### Commands #### Player Commands | Command | Description | | --- | --- | | `/deathpos` | Show the first page of your death history | | `/deathpos page ` | Show a specific page of your history | | `/deathpos tp ` | Teleport to a specific death record | #### Admin Commands | Command | Description | | --- | --- | | `/deathpos player ` | Show the first page of another player's death history | | `/deathpos player page ` | Show a specific page of another player's history | | `/deathposadmin reload` | Reload the config file | | `/deathposadmin set announceOnDeath ` | Enable or disable death chat notifications | | `/deathposadmin set allowPlayersUseCommand ` | Allow or block regular players from using `/deathpos` | | `/deathposadmin set adminsCanQueryOthers ` | Allow or block admin queries for other players | | `/deathposadmin set allowTeleport ` | Allow or block teleporting back to death points | ### Configuration Config file path: ```text config/death-return.json ``` Default config: ```json { "announceOnDeath": true, "allowPlayersUseCommand": true, "adminsCanQueryOthers": true, "allowTeleport": true } ``` ## 中文 `Death Return` 是一个面向 Fabric 的死亡坐标记录模组，提供简洁、可追溯、可传送的死亡记录体验。玩家死亡后，模组会自动记录所在维度、坐标与时间，保留最近 `20` 次死亡历史，并通过命令与可点击聊天消息提供查看和传送能力。模组支持原版维度与其他模组新增维度。 ## 功能概览 - 玩家死亡后自动记录当前位置，无需手动操作。 - 每位玩家保留最近 `20` 次死亡历史。 - `/deathpos` 以分页列表形式显示记录，每页 `5` 条。 - 每条记录都提供可点击的传送入口。 - 死亡后立即显示一条紧凑消息，包含坐标、历史查看和回传按钮。 - 支持管理员查询其他玩家的死亡历史。 - 支持原版维度与模组新增维度的记录、显示和传送。 - 主要逻辑由服务端驱动，多人联机时客户端可选安装。 ## 兼容性 | 项目 | 说明 | | --- | --- | | Minecraft | `1.21` 到 `1.21.11` | | Fabric Loader | `0.16.0+` | | Java | `21+` | | Fabric API | 必需 | | Fabric Language Kotlin | 必需 | 当前工程以 `Minecraft 1.21.11` 为主目标版本进行开发。 ## 前置依赖安装本模组前，请确保以下依赖已放入对应环境的 `mods` 目录： | 依赖 | 是否必需 | 说明 | | --- | --- | --- | | Fabric API | 必需 | 提供 Fabric 事件、命令和运行时 API | | Fabric Language Kotlin | 必需 | 本模组使用 Kotlin 编写，缺失时无法加载 | 如果缺少 `fabric-language-kotlin`，游戏启动时会出现类似报错： ```text Mod 'Death Return' (death-return) ... requires fabric-language-kotlin, which is missing ``` ## 安装方式 ### 专用服务器将模组与依赖放入服务器的 `mods` 目录后即可生效。客户端连接时不强制要求安装本模组。 ### 客户端 / 单人游戏本模组也可以直接安装在客户端，并在单人世界或局域网主机中正常工作。单人模式本质上运行的是内置服务器，因此本地安装后功能同样可用。 ## 使用方式玩家死亡后，模组会自动完成以下操作： 1. 记录本次死亡的维度、坐标和时间。 2. 将记录插入历史列表头部。 3. 仅保留最近 `20` 条数据。 4. 在聊天栏中发送一条简洁提示消息。默认交互包括： - `查看历史`：打开自己的死亡记录列表。 - `传送回去`：回到最近一次死亡点。如果服务器管理员关闭了传送功能，传送入口将不会显示。 ## 命令说明 ### 玩家命令 | 命令 | 说明 | | --- | --- | | `/deathpos` | 查看自己的死亡历史第一页 | | `/deathpos page <页码>` | 查看自己的指定页历史 | | `/deathpos tp <编号>` | 传送到自己指定编号的死亡记录 | ### 管理员命令 | 命令 | 说明 | | --- | --- | | `/deathpos player <玩家>` | 查看目标玩家的死亡历史第一页 | | `/deathpos player <玩家> page <页码>` | 查看目标玩家的指定页历史 | | `/deathposadmin reload` | 重载配置文件 | | `/deathposadmin set announceOnDeath ` | 是否在死亡后发送提示消息 | | `/deathposadmin set allowPlayersUseCommand ` | 是否允许普通玩家使用 `/deathpos` | | `/deathposadmin set adminsCanQueryOthers ` | 是否允许管理员查询其他玩家记录 | | `/deathposadmin set allowTeleport ` | 是否允许玩家传送回死亡点 | ## 配置说明配置文件路径： ```text config/death-return.json ``` 默认配置： ```json { "announceOnDeath": true, "allowPlayersUseCommand": true, "adminsCanQueryOthers": true, "allowTeleport": true } ``` | 字段 | 默认值 | 说明 | | --- | --- | --- | | `announceOnDeath` | `true` | 玩家死亡后是否发送提示消息 | | `allowPlayersUseCommand` | `true` | 普通玩家是否可以使用 `/deathpos` | | `adminsCanQueryOthers` | `true` | 管理员是否可以查询其他玩家记录 | | `allowTeleport` | `true` | 是否允许通过命令或按钮传送回死亡点 |

Death Return

External resources

Project members

Technical information