## 🎯 功能
### 快捷键组合
- **F3 + F**: 增加渲染距离 1 个区块
- **Shift + F3 + F**: 减少渲染距离 1 个区块
### 客户端 & 服务器安装
1. 从 [Releases](https://github.com/RealKomander/f3f/releases) 下载最新版本
2. 将 `f3f-VERSION.jar` 放置在你的 `mods/` 文件夹中 **客户端和服务器都要放置**
3. 如果尚未安装,安装 [Fabric API](https://modrinth.com/mod/fabric-api)
4. (可选) 安装 [LuckPerms](https://luckperms.net/) 用于权限管理
## 🔐 权限
### LuckPerms 设置
```
f3f.change - 允许管理服务器渲染距离
/lp user <用户名> permission set f3f.change true
```
- **如果没有 LuckPerms**,所有玩家都可以更改渲染距离
## ⚙️ 配置文件
模组会自动创建 `config/f3f.json`。
### 配置文件选项
| 设置 | 描述 | 默认值 |
|---------|-------------|---------|
| `permissionNode` | 更改渲染距离所需的 LuckPerms 权限 | `f3f.change` |
| `minRenderDistance` | 允许的最小渲染距离(区块) | `2` |
| `maxRenderDistance` | 允许的最大渲染距离(区块) | `32` |
| `enableAutoSync` | 启用设置中更改渲染距离时自动同步 | `true` |
| `enableF3FKeys` | 启用 F3+F 快捷键组合 | `true` |
| `f3fCooldown` | F3+F 使用后的冷却时间(毫秒) | `1000` |
| `serverUpdateCooldown` | 服务器更新后的冷却时间(毫秒) | `1000` |
### 🌍 本地化
- **英语** (`en_us`)
- **俄语** (`ru_ru`)
## 🛠️ 开发
### 从源代码构建
```
git clone https://github.com/RealKomander/f3f.git
cd f3f
./gradlew build
```
## 📋 更新日志
### 版本 1.1.0
- 现在支持 Minecraft 1.20.1-1.21.8
- 当多名玩家更改渲染距离时,服务器-客户端同步更好
- 现在可以在客户端环境中使用
### 版本 1.0.0
- 初始发布
- F3+F 快捷键组合用于渲染距离控制
- LuckPerms 集成
- 自动客户端-服务器同步
- 可配置设置
- 多语言支持(英语,俄语)
- 智能冲突预防