## 🔄 使用方法
### 选择攻击者
用钓竿右键点击一个有 AI 的生物(Mob,如僵尸、骷髅、苦力怕等)作为“源生物”。
成功提示:收到绿色消息提示选择成功。
### 锁定攻击目标
再次用钓竿右键点击任意实体(玩家、生物、盔甲架等)作为目标。
效果:源生物将立即追杀目标!
### 自动/手动重置
仇恨连接成功后,自动清除选择状态。
若在指定时间(默认 30 秒,可配置)内未选择目标,自动清除选择。
随时潜行(Shift)+右键任意实体,手动清除选择。
## ⚡ 核心功能
✅ 智能过滤:仅允许有 AI 的生物(如僵尸、骷髅)作为源生物,杜绝无效选择。
✅ 全实体兼容:目标支持任意 LivingEntity,包括玩家、动物、BOSS 等。
✅ 防误触机制:选择超时后自动清除(默认 30 秒,可配置)。
✅ 零记忆负担:操作完成后自动重置,简单易用。
✅ 自定义世界:通过配置文件限制生效维度,灵活掌控环境。
✅ 自定义钓鱼竿:启用 use-custom-rod 后,可用 1 铁锭 + 1 木棒合成特殊钓鱼竿,名称和描述可自定义。

## 🎮 指令与权限
/hl 或 /hatelink:显示帮助信息。
/hl clear:清除当前源生物选择。
/hl status:查看当前源生物选择。
/hl give:获取特殊钓鱼竿(需 hatelink.give 权限,仅限 use-custom-rod 启用时)。
/hl reload:重载配置文件(需 hatelink.reload 权限)。
### 权限
hatelink.use:允许使用插件功能(默认对所有玩家开放)。
hatelink.give:允许使用 /hl give 命令(默认仅限 OP)。
hatelink.reload:允许使用 /hl reload 命令(默认仅限 OP)。
## ⚙️ 配置
插件首次加载时会在 plugins/HateLink/ 目录下生成 config.yml
```
HateLink 插件配置文件
# 选择源生物后,自动清除选择的超时时间(秒)
# 默认值为 30 秒,设为 0 禁用自动清除
selection-timeout: 30
# 自定义维度限制(可选),指定允许插件生效的维度名称
# 留空或注释掉表示无限制
# 维度名称示例:overworld, the_nether, the_end
allowed-dimensions:
- overworld
- the_nether
# 是否启用特殊钓鱼竿(true 表示仅使用配置的特殊钓鱼竿,false 表示接受任意钓鱼竿)
# 默认值为 false
use-custom-rod: false
# 仅当 use-custom-rod 为 true 时生效
item:
display-name: "&a白金之八戒钓鱼竿"
lore:
- ""
- "&f可以连接生物之间的仇恨"
- ""
- "&a特殊物品|"
```
修改 config.yml 后,使用 /hl reload 立即应用新配置。
## 🚀 版本与兼容性
### 当前版本:1.0.4
### 支持版本:Minecraft 1.16 至 1.21.8
### 服务端支持:兼容 Spigot, Paper, Folia 及分支
## 🌟 后续更新计划
✅ 防误触机制:超时自动清除选择(已完成)。
✅ 自定义世界:通过配置文件自由设置(已完成)。
✅ 多版本支持:1.16~1.21.8 兼容(已完成)。
✅ 服务端兼容:支持 Folia 及分支。
⏳ 新功能:计划添加冷却时间、音效反馈等(欢迎建议!)
## 💡 反馈与支持
有任何想法或问题?欢迎在 Modrinth 或社区反馈,我会尽量回复并优化!
## 🔄 Usage
### Selecting the Attacker
Right-click on an AI-controlled creature (Mob, such as zombies, skeletons, creepers, etc.) with a fishing rod to designate it as the "source creature."
Success prompt: Receive a green message indicating successful selection.
### Lock Attack Target
Click any entity (player, creature, armor stand, etc.) with a fishing rod again as the target.
Effect: The source creature will immediately chase the target!
### Auto/Manual Reset
HateLink successfully connected, and the selection state is automatically cleared.
If the target is not selected within the specified time (default 30 seconds, configurable), the selection is automatically cleared.
Press stealth (Shift) + right-click any entity to manually clear the selection.
## ⚡ Core Features
✅ Smart Filtering: Only allows AI-enabled creatures (such as zombies, skeletons) as source entities, eliminating invalid selections.
✅ Full Entity Compatibility: Targets support any LivingEntity, including players, animals, bosses, etc.
✅ Mis-click Prevention Mechanism: Automatically clears selection after timeout (default 30 seconds, configurable).
✅ Zero Memory Load: Automatically resets after operation, simple and easy to use.
✅ Customizable Worlds: Limit the effective dimensions through configuration files, flexibly control the environment.
✅ Custom Fishing Rod: After enabling use-custom-rod, you can craft a special fishing rod with 1 Iron Ingot + 1 Stick. The name and description can be customized.

## 🎮 Commands and Permissions
/hl or /hatelink: Display help information.
/hl clear: Clear the current source entity selection.
/hl status: Check the current source entity selection.
/hl give: Obtain the special fishing rod (requires hatelink.give permission, only available when use-custom-rod is enabled).
/hl reload: Reloads the configuration file (requires hatelink.reload permission).
### Permissions
hatelink.use: Allows using plugin features (default is open to all players).
hatelink.give: Allows using the /hl give command (default is restricted to OP).
hatelink.reload: Allows the use of the /hl reload command (default restricted to OP).
## ⚙️ Configuration
The plugin generates a config.yml in the plugins/HateLink/ directory upon first load.
```
HateLink 插件配置文件
# 选择源生物后,自动清除选择的超时时间(秒)
# 默认值为 30 秒,设为 0 禁用自动清除
selection-timeout: 30
# 自定义维度限制(可选),指定允许插件生效的维度名称
# 留空或注释掉表示无限制
# 维度名称示例:overworld, the_nether, the_end
allowed-dimensions:
- overworld
- the_nether
# 是否启用特殊钓鱼竿(true 表示仅使用配置的特殊钓鱼竿,false 表示接受任意钓鱼竿)
# 默认值为 false
use-custom-rod: false
# 仅当 use-custom-rod 为 true 时生效
item:
display-name: "&a白金之八戒钓鱼竿"
lore:
- ""
- "&f可以连接生物之间的仇恨"
- ""
- "&a特殊物品|"
```
After modifying config.yml, use /hl reload to apply the new configuration immediately.
## 🚀 Version and Compatibility
### Current Version: 1.0.4
### Supported Versions: Minecraft 1.16 to 1.21.8
### Server Support: Compatible with Spigot, Paper, Folia, and branches
## 🌟 Future Update Plans
✅ Anti-tap mechanism: Auto-clear selection after timeout (Completed).
✅ Custom worlds: Set freely via configuration file (Completed).
✅ Multi-version support: Compatible with 1.16~1.21.8 (Completed).
✅ Server compatibility: Supports Folia and its branches.
⏳ New Feature: Planning to add cooldown time, sound feedback, etc. (Suggestions welcome!)
## 💡 Feedback & Support
Have any ideas or issues? Feel free to report on Modrinth or the community, and I'll try my best to respond and optimize!