- 概述
SetImmortal 是一款适用于 Minecraft Java 1.21.10 的 Paper 插件,允许管理员或控制台为任意用户名授予或移除不死状态。处于不死状态的玩家仍会正常显示受伤动画、音效、击退、火焰效果等,但生命值永远不会减少。由于系统存储的是用户名而非在线玩家对象,因此即使玩家离线也能正常工作。
- 命令
/setimmortal <username> — 将玩家加入不死名单
/removeimmortal <username> — 将玩家从不死名单中移除
规则:
仅限 OP(管理员)或控制台使用命令
防止重复添加
支持离线玩家
- 工作原理
插件监听伤害事件。当玩家受到伤害时:
检查实体是否为玩家
检查用户名是否在不死名单中
如果是 → 将伤害值设为 0(不取消事件)
这样可以保留所有视觉和物理效果,同时防止生命值损失。
- 存储系统
自动生成文件:
plugins/SetImmortal/players.yml
格式:
immortals:
规则:
缺失文件时安全加载
更改后立即保存
不会意外删除其他条目
- 伤害防护覆盖范围
可防止来自所有伤害来源的生命值损失,包括:
PvP、怪物、摔落伤害、火焰/熔岩、爆炸、魔法、窒息、自定义插件伤害
- 权限
允许:
服务器控制台
操作员(OP)
禁止:
所有非 OP 玩家
(无需权限插件。)
- 稳定性要求
在以下情况下插件不得崩溃:
数据文件缺失
文件为空
玩家离线
无效的用户名
服务器重载
命令拼写错误
- Plugin.yml 要求
必须包含:
name(名称)
main class(主类)
version(版本)
api-version(API 版本)
commands list(命令列表)
- 代码规范
整洁的类结构
空值安全检查
不使用已弃用的 API
不使用 NMS(Net Minecraft Server)代码
使用插件数据文件夹 API
安全的文件处理
- 可扩展性设计
架构应便于未来添加如下功能:
immortallist 命令
clear 命令
UUID 支持
权限节点
临时不死状态
特定世界的不死状态
- Overview
SetImmortal is a Paper plugin for Minecraft Java 1.21.10 that allows operators or console to grant or remove an immortal status for any username. Immortal players still appear to take damage normally (animation, sound, knockback, fire, etc.) but never lose health. The system works even if the player is offline because usernames are stored instead of active player objects.
- Commands
/setimmortal <username> — Adds a player to the immortal list
/removeimmortal <username> — Removes a player from the immortal list
Rules:
Only OP or console can use commands
Duplicate entries are prevented
Works for offline players
- How It Works
The plugin listens to damage events. When a player takes damage:
Check if entity is a player
Check if username is in immortal list
If yes → set damage to 0 (do not cancel event)
This preserves all visual and physical effects while preventing health loss.
- Storage System
File automatically generated:
plugins/SetImmortal/players.yml
Format:
immortals:
Rules:
Loads safely if missing
Saves instantly after changes
Never deletes other entries accidentally
- Damage Protection Coverage
Health loss is prevented from all damage sources, including:
PvP, mobs, fall damage, fire/lava, explosions, magic, suffocation, custom plugin damage
- Permissions
Allowed:
Server console
Operators
Denied:
All non-OP players
(No permission plugin required.)
- Stability Requirements
The plugin must not crash if:
data file missing
file empty
player offline
invalid username
server reload
command typo
- Plugin.yml Requirements
Must include:
name
main class
version
api-version
commands list
- Code Standards
clean class structure
null-safe checks
no deprecated API
no NMS usage
uses plugin data folder API
safe file handling
- Expandability Design
Architecture should allow easy future additions such as:
immortallist command
clear command
UUID support
permission nodes
temporary immortality
world-specific immortality
评论 0
登录后参与评分
还没有评论,来抢沙发吧