EpicBeheading

# EpicBeheading Plugin

## 插件简介 / Plugin Introduction

EpicBeheading 是一个 Minecraft 插件，当玩家击杀其他玩家时，有几率掉落被击杀玩家的头颅，并在屏幕中间显示斩首提示。

EpicBeheading is a Minecraft plugin that allows players to get player heads with a chance when killing other players, and displays beheading notifications in the center of the screen.

## 功能特性 / Features

- **头颅掉落**：击杀玩家时有几率掉落玩家头颅（默认5%）
- **标题提示**：成功斩首时在屏幕中间显示炫酷标题
- **皮肤显示**：掉落的头颅会显示被击杀玩家的皮肤
- **自定义描述**：头颅拥有独特的描述信息
- **配置灵活**：可在配置文件中修改掉落几率、标题和描述
- **多语言支持**：支持英文和中文

- **Head Drop**：Chance to drop player heads when killing players (default 5%)
- **Title Notification**：Cool title display in the center of the screen when beheading
- **Skin Display**：Dropped heads show the victim's skin
- **Custom Lore**：Heads have unique description information
- **Flexible Configuration**：Modify drop chance, titles and lore in config file
- **Multi-language Support**：Supports English and Chinese

## 支持的MC版本 / Supported MC Versions

- **原生主版本**：1.19.2
- **已测试版本**：1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.20.6, 1.21

- **Primary Version**：1.19.2
- **Tested Versions**：1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19, 1.20, 1.20.6, 1.21

## 安装方法 / Installation

1. 下载 EpicBeheading.jar 文件
2. 将文件放入 Minecraft 服务器的 `plugins` 目录
3. 启动服务器，插件会自动生成配置文件
4. 可根据需要修改配置文件

1. Download the EpicBeheading.jar file
2. Put the file into the `plugins` directory of your Minecraft server
3. Start the server, the plugin will automatically generate configuration files
4. Modify configuration files as needed

## 配置说明 / Configuration

插件启动后，会在 `plugins/EpicBeheading/` 目录生成配置文件 `config.yml`：

After the plugin starts, it will generate a configuration file `config.yml` in the `plugins/EpicBeheading/` directory:

```yaml
# EpicBeheading 配置文件

# 头颅掉落几率 (默认: 0.05 = 5%)
drop-chance: 0.05

# 标题设置
title: "&c&l斩首"
subtitle: "&e&l玩家的头颅已放入背包"

# 头颅 lore 设置
lore:
line1: "&d✦ &6%player% 的头颅"
line2: "&a✧ &7击杀玩家获得"

# 语言设置 (en, zh_cn)
language: "zh_cn"
```

## 命令说明 / Commands

- `/epicbeheading reload` - 重新加载配置文件（需要 `epicbeheading.reload` 权限）
- `/ebh reload` - 命令别名

- `/epicbeheading reload` - Reload configuration file (requires `epicbeheading.reload` permission)
- `/ebh reload` - Command alias

## 头颅示例 / Head Example

当击杀玩家 "Linchangqing" 时，获得的头颅会显示：

When killing player "Linchangqing", the obtained head will show:

- **名称**：✦ Linchangqing 的头颅
- **描述**：✧ 击杀玩家获得
- **皮肤**：显示 Linchangqing 的皮肤

- **Name**：✦ Linchangqing's Head
- **Lore**：✧ Obtained by killing a player
- **Skin**：Shows Linchangqing's skin

## 语言文件 / Language Files

插件支持多语言，语言文件位于 `plugins/EpicBeheading/lang/` 目录：

The plugin supports multiple languages, language files are located in the `plugins/EpicBeheading/lang/` directory:

- `en.yml` - 英文语言文件
- `zh_cn.yml` - 中文语言文件

- `en.yml` - English language file
- `zh_cn.yml` - Chinese language file

## 常见问题 / FAQ

**Q: 头颅掉落几率可以调整吗？**
A: 可以，在配置文件中修改 `drop-chance` 值，例如 0.1 表示 10% 几率。

**Q: 头颅会显示玩家皮肤吗？**
A: 是的，头颅会显示被击杀玩家的完整皮肤。

**Q: 背包满了怎么办？**
A: 如果击杀者背包满了，头颅会掉落在地面上。

**Q: Can I adjust the head drop chance?**
A: Yes, modify the `drop-chance` value in the config file, for example 0.1 means 10% chance.

**Q: Will heads show player skins?**
A: Yes, heads will show the complete skin of the victim.

**Q: What if the inventory is full?**
A: If the killer's inventory is full, the head will drop on the ground.

## 作者信息 / Authors

- **Kobayashi**
- **Linchangqing**
- **Website**： https://blog.187322.xyz/

## 许可 / License

此插件采用 MIT 许可证，可自由使用和修改。

This plugin is licensed under the MIT License, free to use and modify.