TSLzone

插件

· 作者 Zvbj

一个与 Folia 兼容的区域伤害插件。

0 本站下载 0 关注 更新于 1 年前

最新 1.0 · 1.21.8 · Folia

一键开服(送7天)

TSLzone - 区域伤害插件

TSLzone 是一款专为 Folia 1.21+ 服务器设计的区域伤害插件,允许服务器管理员创建指定区域,并根据设定的伤害值和频率持续对区域内的实体造成伤害。

✨ 特性

  • ? 精确的区域控制 - 通过点选系统准确定义伤害区域
  • ⚡ 兼容 Folia - 针对 Folia 1.21+ 服务端进行了优化,支持多线程架构
  • ? 灵活的配置 - 可自定义伤害值和伤害频率
  • ? 数据持久化 - 所有区域配置自动保存,重启服务器后自动恢复
  • ?️ 安全限制 - 区域大小限制以防止影响服务器性能
  • ? 消息自定义 - 完全可自定义的消息系统
  • ? 热重载 - 支持在不重启服务器的情况下重载配置文件

? 快速开始

安装步骤

  1. 下载 TSLzone-1.0.jar 插件文件
  2. 将插件文件放入服务器的 plugins 文件夹中
  3. 重启服务器或使用 plugman 加载插件
  4. 插件将自动生成配置文件

基本使用流程

  1. 设置点位选择 - 使用 /tzone pos1 和 /tzone pos2 设置区域的两个对角点
  2. 创建区域 - 使用 /tzone create <region name> <damage> <tick> 创建一个区域
  3. 启动区域 - 使用 /tzone start <region name> 开始对区域内实体造成伤害
  4. 管理区域 - 使用各种命令来管理已创建的区域

? 命令详情

基本命令

  • 主命令:/tslzone 或 /tzone
  • 权限:tslzone.use(基本使用) / tslzone.admin(管理功能)

选择命令

/tzone pos1 # 设置选区中的第一个点(当前玩家位置)
/tzone pos2 # 设置选区中的第二个点(当前玩家位置)

区域管理命令

/tzone create <region name> <damage value> <frequency> # 创建新区域
/tzone start <region name> # 开始对指定区域造成伤害
/tzone stop <region name> # 停止对指定区域造成伤害
/tzone remove <region name> # 删除指定区域
/tzone list # 列出所有区域及其状态

系统命令

/tzone reload # 重新加载所有配置文件
/tzone help # 显示帮助信息

? 使用示例

创建一个伤害区域

  1. 首先移动到该区域的一个角落,并执行:

/tzone pos1


2. 然后移动到该区域的对角位置,并执行:

/tzone pos2


3. 创建一个区域(命名为 "danger_zone",每次造成 2 点伤害,每 5 秒执行一次):

/tzone create danger_zone 2 5


4. 启动该区域:

/tzone start danger_zone


现在,任何进入该区域的生物都将每 5 秒受到 2 点伤害!

### 管理现有区域

- 查看所有区域:

/tzone list


- 临时停止一个区域:

/tzone stop danger_zone


- 重新启动区域:

/tzone start danger_zone


- 彻底删除区域:

/tzone remove danger_zone


## ⚙️ 配置文件

### data.yml
区域数据会自动保存在 `plugins/TSLzone/data.yml` 中,包括:
- 区域坐标信息
- 伤害设置
- 频率设置
- 激活状态

示例配置:
```yaml
zones:
danger_zone:
pos1:
world: world
x: 100.0
Y: 64.0
from: 200.0
pos2:
world: world
x: 150.0
and: 80.0
from: 250.0
damage: 2.0
frequency: 5
active: true

messages.yml

自定义所有插件消息,支持颜色代码:

# 颜色代码: &0-&9, &a-&f, &l(加粗), &o(斜体), &n(下划线), &m(删除线), &k(随机字符), &r(重置)
zone:
create:
success: "&a 成功创建了区域 &e'%s' &a!"
success-info: "&e 伤害: &7%s &e| 频率: &7%s 秒"

? 权限系统

权限节点 描述 默认值
tslzone.use 基本使用权限(pos1、pos2、list) OP
tslzone.admin 管理员权限(create、start、stop、remove、reload) OP

权限配置示例 (LuckPerms)

# 为玩家授予基本权限
/lp user <玩家名称> permission set tslzone.use true

# 赋予管理员完全权限
`/lp user <admin> permission set tslzone.admin true`

## ?️ 安全与限制

### 区域大小限制
- **最大区域**:500×500×500 方块
- **目的**:防止过大的区域影响服务器性能
- **检查时机**:在创建区域时自动检查

### 性能优化
- 使用 Folia 的区域调度器以确保线程安全
- 智能实体检测,仅处理区域内的生物
- 异常处理机制,防止插件崩溃

## ? 故障排除

### 常见问题

**Q:创建区域失败,提示“区域过大”**
A:请确保所选区域未超过 500×500×500 方块。可使用 `/tzone list` 检查区域大小。

**Q:区域内没有造成伤害**
A:检查区域是否已启用(通过 `/tzone list` 查看状态),并确保区域内存在生物实体。

**Q:服务器重启后区域消失**
A:检查 `plugins/TSLzone/data.yml` 文件是否存在且可读可写。

**Q:命令无权限**
A:请确保拥有 `tslzone.use` 或 `tslzone.admin` 权限。

### 调试信息
启用调试模式以查看详细日志:
1. 查看服务器控制台输出
2. 检查插件是否正确加载
3. 使用 `/tzone reload` 重新加载配置

## ? 更新日志

### V1.0.0
- ✨ 初始版本发布
- ✅ 完整的区域管理系统
- ✅ 完全兼容 Folia 1.21+
- ✅ 可自定义的消息系统
- ✅ 数据持久化支持

## ? 支持与反馈

如果您在使用过程中遇到问题或有改进建议,请:
1. 查阅本文档的故障排除部分
2. 确保您正在使用 Folia 1.21+ 服务器
3. 联系插件开发者以报告问题

## ? 许可证

本插件受 MIT 许可证约束,可免费使用、修改和分发。

---

**感谢您使用 TSLzone! ** ?

*让您的服务器区域管理更简单、更高效! *

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源