[MD]
一个灵魂绑定模组,将物品绑定到特定玩家,防止其他玩家使用。
(仅需服务端安装,或者在单人游戏/整合包也适用)
---
## 特点
- 物品绑定 — 将物品绑定到指定玩家,仅绑定者可使用
- 禁止丢弃 — 绑定物品无法以任何方式丢弃
- 禁止拾取 — 其他玩家无法拾取绑定物品
- 死亡保留 — 死亡后保留绑定物品(可配置)
- 自动绑定 — 首次获取指定物品时自动绑定
- 命令系统 — 完整的命令系统,支持多页帮助
- 可配置 — 通过配置文件自定义所有功能
---
## 安装
1. 安装 Fabric Loader 和 Fabric API
2. 将 JAR 文件放入 `.minecraft/mods/` 目录
3. 启动游戏
---
## 命令用法
所有命令需要管理员权限(默认权限等级:2)。
### 基础命令
| 命令 | 说明 |
|:---|:---|
| `/soulbind` | 显示帮助信息 |
| `/soulbind help [页码]` | 显示指定页帮助信息 |
| `/soulbind bind` | 将手持物品绑定到自己 |
| `/soulbind bind <玩家>` | 将手持物品绑定到指定玩家 |
| `/soulbind unbind` | 解绑手持物品 |
| `/soulbind check` | 查看手持物品绑定状态 |
| `/soulbind list` | 列出背包中所有绑定物品 |
| `/soulbind reload` | 重载配置文件(需要权限等级 3) |
### 自动绑定命令
| 命令 | 说明 |
|:---|:---|
| `/soulbind autobind add` | 将手持物品添加到自动绑定列表 |
| `/soulbind autobind add <物品ID>` | 将指定物品添加到自动绑定列表 |
| `/soulbind autobind remove` | 将手持物品从自动绑定列表移除 |
| `/soulbind autobind remove <物品ID>` | 将指定物品从自动绑定列表移除 |
| `/soulbind autobind list` | 列出所有自动绑定物品 |
| `/soulbind autobind toggle` | 切换自动绑定功能(需要权限等级 3) |
### 示例
```
/soulbind bind Steve
/soulbind unbind
/soulbind help 2
/soulbind autobind add minecraft:diamond_pickaxe
/soulbind autobind add
/soulbind autobind remove diamond_sword
/soulbind autobind list
```
---
## 配置
配置文件位于 `.minecraft/config/soulbinding/soulbinding.json`。
```json
{
"keepOnDeath": true,
"allowUnbind": true,
"showTooltip": true,
"preventDrop": true,
"preventPickup": true,
"commandPermissionLevel": 2,
"autoBindEnabled": true,
"autoBindItems": [
"minecraft:diamond_sword",
"minecraft:netherite_sword",
"minecraft:elytra"
],
"language": "zh_cn"
}
```
| 字段 | 说明 |
|:---|:---|
| `keepOnDeath` | 死亡后保留绑定物品 |
| `allowUnbind` | 允许玩家手动解绑 |
| `showTooltip` | 在物品提示中显示绑定状态 |
| `preventDrop` | 禁止丢弃绑定物品 |
| `preventPickup` | 禁止其他玩家拾取绑定物品 |
| `commandPermissionLevel` | 命令最低权限等级 (0-4) |
| `autoBindEnabled` | 启用自动绑定功能 |
| `autoBindItems` | 自动绑定物品列表 |
| `language` | 语言代码 |
---
## 注意事项
1. 绑定物品会在物品栏中显示紫色斜体的绑定信息。
2. 绑定物品可以在玩家背包和容器之间自由移动。
3. 管理员可以解绑任何物品。
4. 修改配置文件后,可使用 `/soulbind reload` 重新加载。
5. 自动绑定物品会在玩家首次获得时立即绑定。
6. 自动绑定支持以下获取方式:
- 从地面拾取
- 从容器中取出
- 通过命令给予
- 通过合成获得
- 创造模式中取出
---
## 开发信息
- Minecraft: 1.20.1
- Fabric Loader: 0.17.2
- Fabric API: 0.92.6+1.20.1
- Java 17
[/MD]