# TSLscale - Minecraft身体尺寸调整插件
## 介绍
TSLscale是一个专为Minecraft服务器设计的身体尺寸调整插件，允许玩家动态调整他们的角色大小。无论您想变得更小、更可爱，还是更高大，TSLscale都能满足您的个性化需求！
## 功能特性
- 🎮 **简单易用** - 仅需一个命令即可调整体型
- 🔒 **权限控制** - 灵活的权限系统确保服务器安全
- 📝 **智能补全** - 支持Tab键自动补全命令
- ⚡ **即时生效** - 身体尺寸调整立即生效，无需再次登录
- 🎨 **自定义配置** - 自定义身体尺寸范围和所有消息文本
- 🔄 **热重载** - 支持配置文件的热重载，无需重启服务器
## 兼容性
- **Minecraft版本**: 1.21+
- **服务器类型**: Spigot, Paper, Folia
- **Java版本**: Java 21+
## 安装方法
1. 下载`TSLscale.jar`文档
2. 将文件放入服务器`plugins`文件夹
3. 重启服务器或使用`/reload`命令
4. 插件将自动生成配置文件
## 命令用法
### 基本命令
```
/TSLscale - 将尺寸调整到指定大小
/scale - 命令缩写
```
### 功能示例
```bash
# 将尺寸调整到0.8倍（变小）
/TSLscale 0.8
/tscale 0.8
# 将尺寸调整到1.1倍（变大）
/TSLscale 1.1
/tscale 1.1
# 将身体尺寸恢复到默认尺寸
/TSLscale reset
/tscale reset
```
### 管理员命令
```bash
# 重新加载插件配置（仅限OP可用）
/TSLscale reload
/tscale reload
```
## 权限系统
| 权限节点 | 描述 | 默认值 |
|---------|------|--------|
| `tslscale.use`| 所有玩家 |
| `tslscale.reload`| 允许重新加载插件配置 | OP only |
### 权限配置示例
使用权限管理插件（如LuckPerms）配置权限：
```bash
# 给玩家授予使用权限
/lp user <玩家名称> permission set tslscale.use true
# 给管理员授予重新加载权限
/lp user <管理员> permission set tslscale.reload true
```
## 配置文件
插件首次运行后，将在`plugins/TSLscale/`目录下生成`config.yml`配置文件：
```yaml
# 身体尺寸调整范围
scale_min: 0.8 # 最小尺寸 (0.8倍)
scale_max: 1.1 # 最大尺寸 (1.1倍)
# 消息配置
messages:
prefix: "&c[TSL Meow]&r "
set: "%prefix%您的身体尺寸已调整为 %scale%"
reset: "%prefix%您的身体尺寸已恢复到默认"
usage: "%prefix%用法: /TSLscale "
no-permission: "%prefix%您没有权限"
console-only: "%prefix%只有玩家可以执行此命令"
```
### 配置文件说明
- **scale_min/scale_max**: 设置允许的身体尺寸调整范围
- **messages**: 自定义所有插件消息，支持颜色代码 (&a, &c, 等)
- **%prefix%**: 消息前缀占位符
- **%scale%**: 身体尺寸数值占位符
## 使用场景
### 适用场景
- 🎭 **角色扮演服务器** - 扮演不同种族或年龄的角色
- 🏗️ **建筑服务器** - 调整尺寸以进入小空间建造
- 🎪 **娱乐服务器** - 增加乐趣和互动性游戏
- 📸 **截图和照片** - 调整您的体型以获得更好的照片效果
### 身体尺寸建议
- **0.8** - 小巧可爱，适合儿童角色
- **0.9** - 略小尺寸，适合青少年
- **1.0** - 默认体型 (用于重置)
- **1.1** - 高大魁梧，适合成人角色
## 常见问题
### Q: 我调整了身体尺寸后为什么改变了？
A: 请确保：
1. 您有`tslscale.use`权限
2. 输入值在配置范围内 (默认 0.8-1.1)
3. 服务器版本支持 (需要 1.21+)
### Q: 身体尺寸调整会影响游戏的平衡吗？
A: 身体尺寸调整主要是视觉效果，对游戏机制影响不大。建议管理员根据服务器类型合理设置调整范围。
### Q: 我能调整其他玩家的身体尺寸吗？
A: 当前版本仅支持调整自己的身体形状。后续版本可能会添加管理员调整他人身体形状的功能。
### Q: 服务器重启后尺寸会重置吗？
A: 是的，身体尺寸调整不会永久保存，需要重启后重置。
## 技术支持
如果您遇到问题或有功能建议，请联系：
- **作者**: Zvbj
- ** 版本**: 1.0-SNAPSHOT
- **支持**: TSL 服务器
## 更新日志
### v1.0-SNAPSHOT
- 初次发布
- 基本身体尺寸调整功能
- 权限系统
- 配置文件支持
- Tab 补全功能
---
感谢使用 TSLscale！希望这个插件能为您的 Minecraft 体验增添更多乐趣！🎮✨