NoDeath

NoDeath is a Fabric server-first mod that controls the death rules of specific mobs and players.

The goal is intentionally narrow:

• Any mob renamed to NoDeath with a name tag cannot die until it is renamed again
• Protected players cannot die from normal causes
• Protected players can only die through command kill or by falling into the void

Contents

• Overview
• Behavior Rules
• Compatibility
• Dependencies
• Installation
• Commands
• Configuration
• Data Storage
• Development and Build

Overview

• Mobs named NoDeath do not die
• Renaming the mob immediately removes the protection
• Supports protecting a single player through commands
• Supports protecting all players through commands
• Protected players cannot die from combat, environmental damage, or other normal causes
• Protected players can still die through vanilla /kill or by falling into the void
• Protection settings are persisted to a config file
• Core logic runs on the server, so multiplayer clients usually do not need the mod installed

Behavior Rules

Mob Rules

• Protection is enabled only when the mob custom name is exactly NoDeath
• The rule applies to vanilla mobs and mobs added by other mods, as long as they can be named
• The protection blocks the final death step without relying on client-side logic
• Renaming the mob to any other value removes the protection immediately

Player Rules

• Protected players do not die from normal causes
• Death is still allowed in exactly two cases:
  • vanilla command kill such as /kill
  • falling into the void
• When global protection is enabled, the same rule applies to all players

Compatibility

Item	Requirement
Minecraft	1.21 to 1.21.11
Fabric Loader	0.16.0+
Java	21+
Fabric API	Required
Fabric Language Kotlin	Required

The project currently targets Minecraft 1.21.11.

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

Installation

Server-first Usage

This mod is designed primarily as a server-side mod:

• Dedicated server: normally only the server needs this mod and its dependencies
• Singleplayer: local installation is still required because singleplayer uses an integrated server

Commands

All commands require administrator permission by default.

Command	Description
/nodeath	Show the current protection overview
/nodeath list	Show the current protection overview
/nodeath reload	Reload the config file
`/nodeath all <true	false>`
`/nodeath player <true	false>`
/nodeath status <player>	Show whether a player is currently protected

Notes:

• Use vanilla /kill when you intentionally want to kill a protected player
• Command-based configuration only applies to players, not to the NoDeath name-tag rule

Configuration

Config file path:

config/no-death.json

Default config:

{
  "protectAllPlayers": false,
  "protectedPlayers": []
}

Field	Default	Description
protectAllPlayers	false	Enables protection for all players
protectedPlayers	[]	UUID list of individually protected players

Data Storage

Configuration and protection data are stored in:

config/no-death.json

Data characteristics:

• Player protection is persisted
• Individual protection uses UUIDs, so it survives name changes
• Global protection is stored as a separate boolean flag

中文

NoDeath 是一个 Fabric 服务端优先模组，用于控制特定生物和玩家的死亡规则。

核心目标很简单：

• 任何被命名牌命名为 NoDeath 的生物都不会死亡，直到被改名
• 被管理员保护的玩家不会因普通方式死亡
• 被保护玩家只能通过命令击杀或掉入虚空死亡

目录

• 功能概览
• 行为规则
• 兼容性
• 依赖
• 安装方式
• 命令说明
• 配置说明
• 数据存储
• 开发与构建

功能概览

• 命名为 NoDeath 的生物不会死亡
• 生物一旦被改成其他名字，保护立即失效
• 支持通过命令保护单个玩家
• 支持通过命令保护所有玩家
• 被保护玩家不会因普通战斗、环境伤害或其他常规方式死亡
• 被保护玩家仍然允许通过原版 /kill 或掉入虚空死亡
• 保护配置持久化保存到配置文件
• 主逻辑在服务端运行，多人服务器通常只需服务端安装

行为规则

生物规则

• 仅当生物的自定义名称严格等于 NoDeath 时启用保护
• 该规则对原版生物和模组新增生物都生效，只要它们可以被命名
• 保护会阻止最终死亡，而不要求客户端安装模组
• 如果把名字改成其他内容，保护立即移除

玩家规则

• 被保护玩家不会因普通方式死亡
• 以下两种情况仍然允许死亡：
  • 原版命令击杀，例如 /kill
  • 掉入虚空
• 开启“全体玩家保护”后，以上规则会应用到所有玩家

兼容性

项目	要求
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 编写，缺失时无法加载

安装方式

服务端优先

本模组优先按服务端模组使用：

• 专用服务器：通常只需服务端安装本模组和依赖，客户端不需要安装
• 单人游戏：仍需本地安装，因为单人模式本质上运行的是内置服务器

命令说明

所有命令默认要求管理员权限。

命令	说明
/nodeath	查看当前保护概览
/nodeath list	查看当前保护概览
/nodeath reload	重新加载配置文件
`/nodeath all <true	false>`
`/nodeath player <玩家> <true	false>`
/nodeath status <玩家>	查看指定玩家当前是否受保护

说明：

• 如需有意杀死受保护玩家，建议直接使用原版 /kill
• 命令配置只控制玩家保护，不控制命名生物规则

配置说明

配置文件路径：

config/no-death.json

默认配置：

{
  "protectAllPlayers": false,
  "protectedPlayers": []
}

字段	默认值	说明
protectAllPlayers	false	是否让所有玩家进入保护状态
protectedPlayers	[]	单独受保护玩家的 UUID 列表

数据存储

配置和保护数据保存在：

config/no-death.json

数据特点：

• 玩家保护状态会持久化保存
• 单独保护使用 UUID 保存，避免玩家改名后失效
• 全体保护使用单独布尔开关控制