转载 开源 世界管理 维权保护 1.1.0

[MD]
# Viciont Protections

一个轻量、灵活的 Minecraft 服务端领地保护插件，允许玩家自行创建和管理受保护区域。

## 功能特性

- 支持多种尺寸的保护区，大小可自定义
- 多主人（owner）机制
- 成员管理
- 保护区自定义命名
- 临时边界可视化（放置黄色羊毛，持续 1 分钟）
- 内置自定义村民商人交易系统
- 使用 SQLite 存储数据，开箱即用，无需额外配置

## 保护区类型

| 类型 | 默认尺寸 |
|------|----------|
| 小型（Small） | 32 × 32 |
| 中型（Medium） | 64 × 64 |
| 大型（Large） | 128 × 128 |

## 保护区机制

1. 边界可视化（黄色羊毛，持续 1 分钟）
2. 多主人机制
3. 成员管理
4. 自定义名称
5. 防重叠保护
6. 方块保护
7. 交互保护

## 命令

### 玩家命令

| 命令 | 描述 | 权限 |
|------|------|------|
| /addnamepr `<名称>` | 为你的保护区命名 | `viciontprotections.user.name` |
| /addmember `<玩家>` | 将玩家添加为成员 | `viciontprotections.user.add` |
| /delmember `<玩家>` | 将玩家从成员中移除 | `viciontprotections.user.del` |
| /addowner `<玩家>` | 将玩家添加为主人 | `viciontprotections.user.owner` |
| /delowner `<玩家>` | 将玩家从主人中移除 | `viciontprotections.user.owner` |
| /ownerlist | 列出保护区的所有主人 | `viciontprotections.user.owner` |
| /memberlist | 列出保护区的所有成员 | `viciontprotections.user.owner` |
| /prlist | 列出所有保护区 | 无 |

> /addowner 和 /delowner 仅限保护区的**主要主人**使用。
> 普通主人可以添加或移除保护区成员。

### 管理员命令

| 命令 | 描述 | 权限 |
|------|------|------|
| /givepr `<类型>` | 给予保护方块（`small` / `medium` / `large`） | `viciontprotections.admin.give` |
| /newnamepr `<名称>` | 为未命名的保护区设置名称 | `viciontprotections.admin.name` |
| /modnamepr `<保护区> <新名称>` | 修改已有保护区的名称 | `viciontprotections.admin.name` |
| /modmember `<保护区> <add/del> <玩家>` | 添加或移除保护区成员 | `viciontprotections.admin.mod` |
| /modowner `<保护区> <add/del> <玩家>` | 添加或移除保护区主人 | `viciontprotections.admin.owner` |
| /removepr `<保护区>` | 删除一个保护区 | `viciontprotections.admin.remove` |
| /prvillager `[x] [y] [z]` | 在指定坐标生成保护区商人村民 | `viciontprotections.admin.villager` |
| /vpreload | 重载插件配置 | `viciontprotections.admin.reload` |

## 交易系统

插件内置自定义村民商人，出售各类保护方块。交易配方支持 1 或 2 种物品作为货币，可在配置文件中自由调整。

配置示例：

```yaml
large:
name: "Protección Premium 320x320"
size: 320
cost:
- IRON_NUGGET:2
- NETHERITE_BLOCK:2
```

```yaml
small:
name: "Protección Básica"
size: 32
cost:
- DIAMOND:1
```

## 配置

所有配置项均在 `config.yml` 中修改，包括：

- 保护方块的交易费用
- 插件消息文本
- 村民商人参数
- 数据库设置
- 保护区尺寸
- 保护方块的自定义名称

> **注意：** 修改保护方块的名称可能影响已创建的保护区。建议在服务器首次部署插件时设定好名称，或直接沿用默认名称，后续不再更改。

## 权限

### 玩家权限

```yaml
viciontprotections.user.*:
description: 授予所有玩家命令权限
children:
viciontprotections.user.name: true
viciontprotections.user.add: true
viciontprotections.user.del: true
viciontprotections.user.owner: true
```

### 管理员权限

```yaml
viciontprotections.admin.*:
description: 授予所有管理员命令权限
children:
viciontprotections.admin.give: true
viciontprotections.admin.mod: true
viciontprotections.admin.owner: true
viciontprotections.admin.remove: true
viciontprotections.admin.name: true
viciontprotections.admin.villager: true
```

## 安装

1. 下载插件 JAR 文件
2. 将其放入服务器的 `plugins` 目录
3. 重启服务器
4. 如需自定义，在 `config.yml` 中修改配置

## 计划兼容版本

- 1.20.x
- 1.19.x

## 许可证

本项目基于 MIT 许可证发布。
[/MD]