⏱️ easyTimer | The Ultimate Customizable Minecraft Timer

easyTimer is a comprehensive, highly customizable, and lightweight timer plugin for your Minecraft server. Whether you're hosting speedruns, server events, or mini-games, easyTimer gives you complete control over how, where, and when your time is displayed.

Forget boring white text — bring your timer to life with smooth RGB gradients, custom formats, and dynamic BossBars!

✨ Features

🎨 Limitless Design & Animations

• Full RGB / HEX Support: Use standard Minecraft colors or custom HEX codes (e.g. #FF5555).

• Animated Color Modes: Choose between:

  • Static — A single custom color.
  • Gradient — Smoothly fades between two custom colors.
  • Rainbow — A continuously changing RGB rainbow.

• Adjustable Animation Speed: Control how fast your colors shift with speed levels 1–10.

• Custom Time Formatting: Build your own format using tags such as {hours:"h "} {minutes:"m "} {seconds:"s "}. Empty values are automatically hidden (e.g. 0 hours won't be displayed).

• Custom Character Mapping: Replace standard numbers or letters with custom Unicode symbols or small caps directly in-game.

• Bold Text Toggle: Make your timer stand out with a simple command.
  
  

📍 Display Positions

Display the timer exactly where you need it:

• ActionBar
• BossBar
• TabList
• None — Useful if you want to keep the timer running silently in the background or only use the placeholder.

🐉 Advanced BossBar Control

• Customize the BossBar color (RED, BLUE, PURPLE, etc.).
• Choose from different BossBar styles (SOLID, SEGMENTED_10, etc.).
• Dynamic Progress: Set the progress bar to a static percentage or let it loop smoothly with the running seconds.

🌍 World Filter System

Only want the timer to appear in your event world?

No problem! Use the built-in world whitelist system to specify exactly which worlds the timer should be visible in.

🌐 Massive Multi-Language Support

24 built-in languages, including English, German, French, Spanish, Japanese, Chinese, Arabic, and many more.

• Automatic Language Files: Language files are generated automatically.
• In-Game Switching: Change the entire plugin language instantly with a command — no need to edit configuration files.

⚙️ Admin & Server Friendly

• Smart Tab Completion: Never guess a command again. Every command, color, and setting supports tab completion.
• High Performance: Optimized asynchronous processing and packet handling help keep server impact minimal.
• Live Updates: Change colors, formats, positions, and other settings on the fly. Changes are applied instantly.

---

📜 Commands & Permissions

Permission required for all commands: timer.admin

⏯️ Core Controls

/timer start
/timer pause
/timer reset
/timer set <seconds>
/timer add <seconds>
/timer take <seconds>

Command	Description
/timer start	Starts the timer.
/timer pause	Pauses the timer.
/timer reset	Resets the timer to 0.
/timer set <seconds>	Sets the timer to a specific value.
/timer add <seconds>	Adds time to the timer.
/timer take <seconds>	Subtracts time from the timer.

🖌️ Design & Customization

/timer design position <ACTIONBAR|BOSSBAR|TABLIST|NONE>
/timer design color static <color/HEX>
/timer design color gradient <color1> <color2>
/timer design color rainbow
/timer design animationspeed <1-10>
/timer design format <format>
/timer design bossbar <progress|progressbar|color> <value>
/timer design chars <char> <replacement|reset>

Command Details

• /timer design position <...> — Changes where the timer is displayed.
• /timer design color static <color/HEX> — Sets a single static color.
• /timer design color gradient <color1> <color2> — Creates a smooth gradient between two colors.
• /timer design color rainbow — Enables rainbow mode.
• /timer design animationspeed <1-10> — Changes the animation speed.
• /timer design format <format> — Changes the timer's display format.
• /timer design bossbar <...> — Configures BossBar progress and color.
• /timer design chars <...> — Creates or resets custom character mappings.

🛠️ Utility

/timer world <add|remove|list> <world>
/timer lang <language_code>
/timer reload

• /timer world <add|remove|list> <world> — Manages the worlds in which the timer is displayed.
• /timer lang <language_code> — Changes the plugin language.
• /timer reload — Reloads the plugin configuration.

---

🔗 Placeholders

%easytimer_time_designed%
%easytimer_time%
%easytimer_seconds%

🌍 Included Languages

24 languages included out of the box.

ar_sa, cs_cz, da_dk, de_de, el_gr, en_us, es_es, fi_fi, fr_fr, hi_in, hr_hr, hu_hu, it_it, ja_jp, nl_nl, no_no, pl_pl, pt_br, ru_ru, sv_se, sw_sw, th_th, tr_tr, zh_ch