🪢 Super Lead Rope / 超级拴绳

---

Super Lead Rope 是一个对原版拴绳进行增强的模组，让玩家能够更灵活地管理和牵引生物。
相比原版，它不仅更强大，还具备跨维度与跨服的拓展特性。

Super Lead Rope is a mod that enhances the vanilla lead, allowing players to manage and leash entities more flexibly.
Compared to the original, it is not only more powerful but also supports cross-dimension and even cross-server features.

---

✨ 功能特色 / Features

🔗 多实体拴绳 / Multi-Entity Leash

• 一根绳子可以同时拴多个实体。

• 一个实体也可以被多根绳子拴住，支持复杂连接。

• A single rope can leash multiple entities at the same time.

• One entity can also be leashed by multiple ropes, supporting complex connections.

📏 远距离牵引 / Long-Distance Tethering

• 原版拴绳在一定距离会断裂。

• 超级拴绳支持更远距离（待做）。

• 像橡皮筋一样拉回目标。在Y轴会有一定的弹性阻尼，保证在生物在Y轴下被牵引不会异常的频繁上下蹦极。

• Vanilla leads break after a certain distance.

• Super Lead Rope supports extended leash distance (WIP).

• Pulls entities back like a rubber band. There is a certain amount of damping on the Y axis to ensure that leashed entities do not bounce up and down excessively when being pulled vertically.

---

💾 持久拴绑 / Persistent Leash

• 支持保存拴绳状态，退出/重进游戏不会断开。

• 即使 holder（拴绳端点）暂时消失，回来时也能恢复连接。

• Leash states are persistent and won’t break after rejoining the game.

• Even if the holder (anchor point) disappears temporarily, connections will be restored when it comes back.

---

🌌 跨维度 / 传送 / Cross-Dimension & Teleport

• 目前支持 传送跟随：当拴绳实体或玩家通过传送（如下界传送门、指令）时，拴绳目标会一同跟随。

• Currently, supports teleport-follow: when a leashed entity or player teleports (e.g. Nether portal, commands), the tethered entities follow along.

---

🎨 可视化与材质 / Visuals & Materials

• 比原版拴绳更粗壮，或具有特殊颜色。

• 未来可能支持多种材质（铁链、魔法绳、能量链等）。

• Thicker or colored ropes compared to vanilla leads.

• Future plans include multiple leash materials (iron chains, magical ropes, energy cords, etc.).

---

💻 开发 / Develop

Maven 仓库配置 / Maven Repository Configuration

在您的 build.gradle 中添加以下仓库配置：

Add the following repository configuration in your build.gradle:

repositories {
    maven {
        name = "LTD Maven"
        url = "https://nexus.bot.leisuretimedock.top/repository/maven-public/"
    }
}

依赖导入 / Dependency Import

在 dependencies 区块中添加 Super Lead Rope 依赖：

Add Super Lead Rope dependency in the dependencies block:

dependencies {
    compileOnly 'top.r3944realms.superleadrope:superleadrope:版本号:api@jar'
    runtimeOnly 'top.r3944realms.superleadrope:superleadrope:版本号'
}

版本号示例 / Version Example

compileOnly 'top.r3944realms.superleadrope:superleadrope:1.20.1-0.0.0.7:api@jar'
runtimeOnly 'top.r3944realms.superleadrope:superleadrope:1.20.1-0.0.0.7'

快速开始 / Quick Start

repositories {
    maven {
        name = "LTD Maven"
        url = "https://nexus.bot.leisuretimedock.top/repository/maven-public/"
    }
}

dependencies {
    compileOnly 'top.r3944realms.superleadrope:superleadrope:1.20.1-0.0.0.7:api@jar'
    runtimeOnly 'top.r3944realms.superleadrope:superleadrope:1.20.1-0.0.0.7'
}

---

📜 License / 许可证

This project is licensed under the GNU GPL v3 open source license.
本项目采用 GNU GPL v3 开源协议。

You are free to: / 您可以自由地：

• Use - Use the mod in personal or commercial projects
  使用 - 在个人或商业项目中使用本模组
• Learn - Study and learn from the source code
  学习 - 研究和学习模组的源代码
• Modify - Modify the code to suit your needs
  修改 - 修改模组代码以满足您的需求
• Distribute - Distribute original or modified versions
  分发 - 分发原始或修改后的版本

Under the following conditions: / 在遵循以下条件的前提下：

1. Open Source Requirement - If you distribute modified versions, you must open source them under the same GPL v3 license
   开源要求 - 如果您分发修改后的版本，必须同样使用GPL v3协议开源
2. Copyright Notice - Preserve original copyright and license notices
   版权声明 - 保留原始的版权和许可证声明
3. Source Code Availability - Provide access to the modified source code
   源代码可用 - 提供修改后的源代码访问方式
4. Same License - Use the same GPL v3 license
   相同许可证 - 使用相同的GPL v3协议

Full Terms: View LICENSE file | GPL v3 Details
完整条款： 查看LICENSE文件 | GPL v3详情

🎵 Audio Resources / 音效资源声明

This mod includes supplemental audio assets from Minecraft (by Mojang Studios / Microsoft), which are not covered by the GPL license of this project.
本模组中包含部分来自 Minecraft（Mojang Studios / Microsoft） 的补充音效资源，
这些资源 不属于 本项目 GPL 协议授权的范围。

• Copyright of these audio files belongs to Mojang Studios / Microsoft.
  这些音效文件的版权归 Mojang Studios / Microsoft 所有。
• They are provided here solely for compatibility and gameplay purposes.
  这些音效仅为兼容性和游戏功能提供。
• The GPL v3 license applies only to the original code and assets of this mod,
  and does not apply to the bundled Minecraft audio files.
  GPL v3 协议仅适用于本模组的原创代码与资源，不适用于其中包含的 Minecraft 音效文件。