# Pomodoro
一个高度可定制的、基于GUI的番茄工作法计时器，旨在帮助Minecraft玩家管理时间并保持专注。
 
[](./LICENSE)
## 要求
- **服务器版本**: Paper / Folia 1.21+
- **依赖**: [PacketEvents](https://modrinth.com/plugin/packetevents) (必需)
## 使用方法
该插件主要通过其交互式GUI来使用。
1. **打开主菜单**: 键入 `/pomodoro` 或 `/pomo`。
2. **在GUI中，您可以**:
- **开始计时器**: 选择预配置的预设开始您的会话。
- **创建自定义预设**: 设计您自己的工作/休息时间表。
- **编辑 & 删除**: 右键单击您的自定义预设以修改或删除它们。
- **控制活动计时器**: 暂停、恢复、停止，并切换Boss Bar和屏幕标题等视觉效果。
## 命令 & 权限
虽然大多数操作都在GUI中执行，但命令可用作便捷的快捷方式。 主命令是 `/pomodoro` (别名: `/pomo`)。
### 玩家命令
- `/pomo` 或 `/pomo gui`: 打开主菜单。
- `/pomo start [preset_name]`: 开始一个会话。 如果未指定预设，则打开GUI。
- `/pomo pause`: 暂停计时器。
- `/pomo resume`: 恢复计时器。
- `/pomo stop`: 停止当前会话。
- `/pomo next`: 手动进入下一个状态（例如，从工作到休息）。
### 管理员命令
- `/pomo reload`: 重新加载所有配置文件。
- **权限**: `pomodoro.admin`
## 配置文件
可以通过两个主要文件对插件的行为进行广泛的定制：`config.yml` 和 `presets.yml`。
### `config.yml`
此文件控制插件的全局设置。 您可以在这里配置：
- **限制**: 控制玩家在工作期间的行动，例如聊天和移动。
- **显示默认值**: 设置Boss Bar和标题计时器的默认可见性。
- **语言**: 配置默认语言并启用/禁用自适应语言检测。
- **颜色 & 声音**: 自定义所有插件事件的Boss Bar颜色和声音效果。
有关每个选项的详细信息，请参阅 `config.yml` 文件中的注释。
### `presets.yml`
此文件定义了提供给所有玩家的默认番茄工作法计时器预设，作为示例或起点。 您可以在此处添加、删除或修改这些预设。 玩家创建的自定义预设存储在单独的位置，并且不会更改此文件。
**预设结构:**
```yaml
presets:
standard:
name: "Standard"
icon: "CLOCK"
enchanted: false
work: 25 # minutes
break: 5 # minutes
long-break: 15 # minutes
sessions: 4 # Number of work sessions before a long break
```
- `name`: GUI 中的显示名称。
- `icon`: GUI 中图标的材质名称（例如 `BOOK`、`DIAMOND_SWORD`）。
- `enchanted`: 如果为 `true`，则图标将具有魔法光泽。
- `work`、`break`、`long-break`: 分钟为单位的持续时间。
- `sessions`: 在长休息开始之前的完成的工作周期数。
## 支持的语言
该插件是完全可翻译的，并支持以下语言：
| 语言 | 代码 | 语言 | 代码 |
| :------------------- | :------ | :-------------------- | :------ |
| 英语 | `en` | 德语 | `de` |
| 西班牙语 | `es` | 法语 | `fr` |
| 日语 | `ja` | 韩语 | `ko` |
| 波兰语 | `pl` | 葡萄牙语 | `pt` |
| 俄语 | `ru` | 瑞典语 | `sv` |
| 简体中文 | `zh_CN` | 繁体中文 | `zh_TW` |
| 香港中文 | `zh_HK` | | |
## 许可
本项目采用 Apache 2.0 许可。 请参阅 [LICENSE](./LICENSE) 文件以获取详细信息。