> **⚠️ 重要提示**
>
> 请注意，此版本是原始 [Telentity](https://github.com/TheMrJezza/Telentity) 插件由 [TheMrJezza](https://github.com/TheMrJezza) 原始开发的一个 **社区维护的分支**。
> 已经更新以支持现代 Minecraft 版本（高达 **1.21.x**），同时我们等待原始作者发布官方更新。
>
> 像任何分支一样，可能存在 **错误或兼容性问题**，应在生产环境中使用前进行彻底测试。
> 感谢您的理解 — 如果您遇到任何 **问题，请随时报告**，以帮助改进该插件，惠及所有人。
# 📦 TelentityX – 轻松实现实体传送！
## 🚀 功能
### 🐎 载具传送
从马匹到矿车、箭、船等——如果您骑着它，当您传送时，**它会与您一同传送**！不再需要在 `/tp` 命令后丢失您的坐骑。
### 👪 乘客传送
您有一只猪在船里？一只小僵尸在鸡身上？不用担心——只要它们是乘客，它们就会与您一起旅行，并在传送后留在载具内。 🛥️✨
### 🔗 牵绳传送
如果您拿着一条拴着生物的牵绳（例如狗或羊驼），它会自动与您一起传送，无论您去向何处。 保持连接，保持安全！ 🐶🔗
## ⚙️ 安装与设置
### 第一步：安装插件
将 `Telentity-XXXX.jar` 文件放入服务器的 **plugins/** 文件夹中，然后重新启动服务器。 这就是基本设置的所有内容——它开箱即用！ 💾✅
> ✅ 提示：要获得简单的“即插即用”体验，无需进一步的步骤。
### 第二步：配置权限（可选）
如果您想精细控制谁可以传送哪些实体、如何传送以及传送到的位置，请按照以下步骤操作：
1. 根据以下内容分配特定的权限：
- 实体类型（`cow`、`boat` 等）
- 传送方法（`vehicle`、`passenger`、`lead`）
## 🔐 权限节点
以下是可用权限节点的分解：
| 权限 | 描述 |
|-----------|-------------|
| `telentity.teleport.*` | 通过载具、乘客或牵绳传送任何实体类型。 |
| `telentity.teleport.` | 通过任何方法传送特定类型的实体。 |
| `telentity.vehicle.*` | 作为载具传送任何实体。 |
| `telentity.vehicle.` | 作为载具传送特定类型的实体。 |
| `telentity.passenger.*` | 作为另一个载具内的乘客传送任何实体。 |
| `telentity.passenger.` | 作为乘客传送特定类型的实体。 |
| `telentity.lead.*` | 传送任何拴着牵绳的实体。 |
| `telentity.lead.` | 传送特定类型拴着牵绳的实体。 |
---
## 🧩 兼容对象
- 原始 Minecraft 实体 🐄
- 来自插件的自定义生物（如果支持） 👻
- 所有主要的传送命令/插件，如 EssentialsX、Multiverse-Core 等 🌍
## ⚠️ 不兼容对象
- **HuskHomes** (由于内部传送处理的限制) ❌
如果您使用 HuskHomes，在家庭或传送门传送期间，实体传送可能无法正常工作。
## 🆕 此版本的新功能？
与原始 **Telentity** 或 **HorseTpWithMe** 相比，此版本带来了几个重要的改进：
- ✅ **支持高达 1.21.x 的较新的 Minecraft 版本**
在最新的游戏版本上继续使用该插件，而不会出现兼容性问题。
- 🐞 **错误修复和性能改进**
已解决诸如乘客脱离不正确和传送行为不一致等已知问题。
- 📝 **更清晰的控制台输出**
与原始版本不同，此版本 **在启动时不向控制台发送所有可用权限**，从而保持控制台清洁可读。
> 通过 **TelentityX** 实现无缝直观的传送——永远不要再丢失您的宠物、坐骑或乘客了！ 🚀🦺