Deathcore

                                   **DEATHCORE 1.3.0**

Fabric 1.21.11 纯服务端个人死亡排行榜

==================== 中文 ====================

简介

Deathcore 为 Fabric 1.21.11 服务器添加一个简洁的侧边栏死亡榜。榜单按死亡数从高到低排列，每位玩家可以独立设置自己想看到的人数，管理员可以设置服务器默认显示人数和更多展示选项。

这是纯服务端模组：Java 客户端无需安装。通过 Geyser 加入服务器的基岩版玩家同样可以看到榜单，无需安装客户端内容。Geyser 受到支持，但不是本模组的必需依赖。

运行要求

• Minecraft 1.21.11
• Fabric Loader 0.16.0 或更高版本
• 对应 1.21.11 的 Fabric API
• Java 21 或更高版本

功能

• 纯服务端，无需客户端模组
• 兼容 Java 客户端和通过 Geyser 加入的基岩版玩家
• 按死亡数从高到低排列，相同死亡数按玩家名排序
• 每位玩家可单独设置自己的榜单显示人数
• 可设置全局默认榜单人数
• 个人设置不需要 OP 权限
• 全局服务器设置需要 2 级权限
• 自定义榜单标题
• 可选显示排名序号
• 可选显示零死亡的在线玩家
• 支持启用、关闭、重载与强制刷新
• JSON 配置自动保存

玩家命令

/deathcore 查看 Deathcore 当前状态。

/deathcore help 查看常用命令。

/deathcore home set <0-15> 设置自己看到的死亡榜人数。设为 0 可只对自己隐藏死亡榜。

/deathcore home reset 删除个人设置，重新使用服务器全局默认人数。

/deathcore home status 查看当前使用的是个人设置还是全局设置。

管理员命令（需要 2 级权限）

/deathcore server set <0-15> 设置全局默认死亡榜人数。

/deathcore server on 为所有玩家启用死亡榜。

/deathcore server off 为所有玩家关闭死亡榜。

/deathcore server reload 重新读取 config/deathcore.json。

/deathcore server refresh 立即刷新所有在线玩家的死亡榜。

/deathcore server title <文字> 修改侧边栏标题，最多 32 个字符。

/deathcore server showzero on|off 控制是否显示零死亡的在线玩家。

/deathcore server showrank on|off 控制玩家名前是否显示排名序号。

/deathcore set <玩家名> <死亡数> 直接设置指定玩家的死亡数。

配置文件

首次启动后会生成：

config/deathcore.json

示例：

{ "enabled": true, "display_limit": 5, "include_zero_deaths": false, "show_rank": true, "title": "死亡榜", "player_limits": {} }

注意事项

个人设置优先于全局默认值。玩家执行 /deathcore home reset 后，才会重新跟随之后的全局修改。

服务端 mods 文件夹内只能保留一个 Deathcore jar。安装 1.3.0 前请移除旧版。

==================== English ====================

Overview

Deathcore adds a clean sidebar death leaderboard for Fabric 1.21.11 servers. The leaderboard is sorted by death count in descending order. Every player can choose how many entries they see, while operators can control the server default and additional display options.

This is a server-side-only mod. Java clients do not need to install Deathcore. Bedrock players joining through Geyser can also see the leaderboard without installing anything. Geyser is supported but not required.

Requirements

• Minecraft 1.21.11
• Fabric Loader 0.16.0 or newer
• Fabric API for Minecraft 1.21.11
• Java 21 or newer

Features

• Server-side only, with no client mod required
• Compatible with Java clients and Bedrock players through Geyser
• Death counts sorted from highest to lowest, then by player name
• Per-player leaderboard length settings
• Global default leaderboard length
• Personal settings work without OP permission
• Server-wide settings require permission level 2
• Custom leaderboard title
• Optional rank numbers
• Optional zero-death online players
• Enable, disable, reload, and force-refresh controls
• Persistent JSON configuration

Player Commands

/deathcore Shows the current Deathcore status.

/deathcore help Shows common commands.

/deathcore home set <0-15> Sets how many players you see on your own death leaderboard. Set it to 0 to hide the leaderboard for yourself.

/deathcore home reset Removes your personal setting and uses the server default again.

/deathcore home status Shows whether you are using a personal or global setting.

Operator Commands (Permission Level 2)

/deathcore server set <0-15> Sets the global default leaderboard length.

/deathcore server on Enables the leaderboard for everyone.

/deathcore server off Disables the leaderboard for everyone.

/deathcore server reload Reloads config/deathcore.json.

/deathcore server refresh Immediately refreshes all online player leaderboards.

/deathcore server title Changes the sidebar title. Maximum 32 characters.

/deathcore server showzero on|off Controls whether zero-death online players appear in the leaderboard.

/deathcore server showrank on|off Controls whether rank numbers appear before player names.

/deathcore set Sets a player's death count directly.

Configuration

The configuration file is created after first startup:

config/deathcore.json

Example:

{ "enabled": true, "display_limit": 5, "include_zero_deaths": false, "show_rank": true, "title": "Deathcore", "player_limits": {} }

Notes

Personal settings take priority over the global default. A player must run /deathcore home reset to follow future global changes again.

Only install one Deathcore jar in the server mods folder. Remove the older Deathcore version before installing 1.3.0.

License: CCO