# Pomodoro<\/p>\n
A highly customizable, GUI-driven Pomodoro timer to help players manage their time and stay focused in Minecraft.<\/p>\n
 
\n
\n<\/p>\n
## Requirements<\/p>\n
– **Server Version**: Paper \/ Folia 1.21+
\n– **Dependencies**: PacketEvents (Required)<\/p>\n
## How to Use<\/p>\n
This plugin is designed to be used primarily through its interactive GUI.<\/p>\n
1. **Open the Main Menu**: Simply type `\/pomodoro` or `\/pomo`.
\n2. **From the GUI, you can**:
\n – **Start a Timer**: Select a pre-configured preset to begin your session.
\n – **Create Custom Presets**: Design your own work\/break schedules.
\n – **Edit & Delete**: Right-click your custom presets to modify or remove them.
\n – **Control Active Timers**: Pause, resume, stop, and toggle visuals like the Boss Bar and on-screen titles.<\/p>\n
## Commands & Permissions<\/p>\n
While most actions are performed in the GUI, commands are available as convenient shortcuts. The main command is `\/pomodoro` (alias: `\/pomo`).<\/p>\n
### Player Commands<\/p>\n
– `\/pomo` or `\/pomo gui`: Opens the main menu.
\n– `\/pomo start [preset_name]`: Starts a session. Opens the GUI if no preset is specified.
\n– `\/pomo pause`: Pauses the timer.
\n– `\/pomo resume`: Resumes the timer.
\n– `\/pomo stop`: Stops the current session.
\n– `\/pomo next`: Manually advances to the next state (e.g., from work to break).<\/p>\n
### Admin Commands<\/p>\n
– `\/pomo reload`: Reloads all configuration files.
\n – **Permission**: `pomodoro.admin`<\/p>\n
## Configuration<\/p>\n
The plugin’s behavior can be extensively customized through two main files: `config.yml` and `presets.yml`.<\/p>\n
### `config.yml`<\/p>\n
This file controls the global settings of the plugin. Here you can configure:<\/p>\n
– **Restrictions**: Control player actions like chatting and movement during work sessions.
\n– **Display Defaults**: Set the default visibility for the Boss Bar and Title timers.
\n– **Language**: Configure the default language and enable\/disable adaptive language detection.
\n– **Colors & Sounds**: Customize the Boss Bar colors and sound effects for all plugin events.<\/p>\n
For detailed information on each option, please refer to the comments within the `config.yml` file.<\/p>\n
### `presets.yml`<\/p>\n
This file defines the default Pomodoro timer presets provided to all players, serving as examples or starting points. You can add, remove, or modify these presets here. Player-created custom presets are stored separately and do not alter this file.<\/p>\n
**Preset Structure:**<\/p>\n
“`yaml
\npresets:
\n standard:
\n name: “Standard”
\n icon: “CLOCK”
\n enchanted: false
\n work: 25 # minutes
\n break: 5 # minutes
\n long-break: 15 # minutes
\n sessions: 4 # Number of work sessions before a long break
\n“`<\/p>\n
– `name`: The display name in the GUI.
\n– `icon`: The material name for the icon in the GUI (e.g., `BOOK`, `DIAMOND_SWORD`).
\n– `enchanted`: If `true`, the icon will have an enchanted glint.
\n– `work`, `break`, `long-break`: Duration in minutes.
\n– `sessions`: The number of work cycles to complete before a long break starts.<\/p>\n
## Supported Languages<\/p>\n
The plugin is fully translatable and supports the following languages out of the box. The language can be set globally in `config.yml`, and an **adaptive language** option will automatically use a player’s client language if available.<\/p>\n
| Language | Code | Language | Code |
\n| :——————- | :—— | :——————– | :—— |
\n| English | `en` | German | `de` |
\n| Spanish | `es` | French | `fr` |
\n| Japanese | `ja` | Korean | `ko` |
\n| Polish | `pl` | Portuguese | `pt` |
\n| Russian | `ru` | Swedish | `sv` |
\n| Chinese (Simplified) | `zh_CN` | Chinese (Traditional) | `zh_TW` |
\n| Chinese (Hong Kong) | `zh_HK` | | |<\/p>\n
## License<\/p>\n
This project is licensed under the Apache 2.0 License. See the [LICENSE](.\/LICENSE) file for details.<\/p>\n","protected":false},"excerpt":{"rendered":"
A highly customizable, GUI-driven Pomodoro timer to help players manage their time and stay focused in Minecraft.<\/p>\n","protected":false},"featured_media":123758,"template":"","meta":{"_minecraft_slug":"pomodoro","_minecraft_project_id":"ve1vPMgY","_minecraft_author":"Noctiro","_minecraft_license":"Apache-2.0","_minecraft_downloads":24,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"pomodoro.zip","_minecraft_size_bytes":127212,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:21:40.525499Z","_minecraft_date_created":"2025-08-01T03:49:53.739658Z","_minecraft_date_modified":"2025-07-29T03:05:43.579944Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/pomodoro","_minecraft_icon_attachment_id":123758,"_minecraft_imported_at":"2026-06-07T06:38:12+00:00","_minecraft_import_hash":"454dd939056c704fef715535fdf96999","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128,867],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83],"class_list":["post-123757","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-social","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1"],"yoast_head":"\n