Pitchi | easyTimer

Time Your Way

Forget boring white text – bring your server timer to life! easyTimer gives you absolute control over how, where, and when your time is displayed.

Whether you are hosting speedruns, server events, or mini-games, you can customize every single second with smooth animations, custom fonts, and a smart world-filter system.

Core Features

RGB & Animations: Full HEX support with smooth Gradients and Rainbow modes (speeds 1–10).
Flexible Displays: Show the timer in the ActionBar, TabList, BossBar, or keep it running silently (None).
World Filter: Whitelist specific worlds for your events.
Multi-Language: 24 built-in languages, instantly switchable in-game.
Custom Formats: Build your own layout and map custom unicode characters or small caps.
Zero Lag: Heavily optimized asynchronous ticks and packet handling.

Commands & Permissions

Required permission for all administrative commands: timer.admin. Fully equipped with smart tab-completion.

⏯️ Core Controls

/timer start - Starts the timer.
/timer pause - Pauses the timer.
/timer reset - Resets the timer to 0.
/timer set <seconds> - Sets the timer value.
/timer add <seconds> - Adds time.
/timer take <seconds> - Subtracts time.

🖌️ Design & Customization

/timer design position <pos> - Change display area.
/timer design color static <color/HEX> - Set static color.
/timer design color gradient <c1> <c2> - Smooth gradient.
/timer design color rainbow - Enable RGB rainbow mode.
/timer design animationspeed <1-10> - Adjust speed.
/timer design format <format> - Change layout string.
/timer design bossbar <type> <val> - BossBar tweaks.
/timer design chars <char> <repl> - Map custom fonts.

🛠️ Utility Commands

/timer world <add|remove|list> <world> - Manage world visibility whitelist.
/timer lang <language_code> - Instantly change plugin language globally.
/timer reload - Reloads configuration files live.

PlaceholderAPI Support

Integrate easyTimer seamlessly into any plugin supporting PlaceholderAPI (like TAB, DeluxeMenus, or holograms) using these built-in placeholders:

📌 Available Placeholders

%easytimer_time_designed% - Outputs the styled timer with active colors/gradients.
%easytimer_time% - Outputs the plain formatted time string.
%easytimer_seconds% - Returns the raw number of remaining/elapsed seconds.
%easytimer_status% - Returns whether the timer is running or paused.

⚙️ Recommended TAB Setup

If you're using our placeholders with the TAB plugin, configure fast refresh intervals in its config:

placeholder-refresh-intervals:
  "%easytimer_time_designed%": 50
  "%easytimer_time%": 50
  "%easytimer_seconds%": 50

Configuration

Customize default behaviors, display formats, and animations directly in the config. Everything can also be changed live in-game using /timer design.

config.yml

# easyTimer Main Configuration

# Choose where the timer is displayed: ACTIONBAR, BOSSBAR, TABLIST, NONE
display-position: ACTIONBAR

# Design Settings
design:
  format: '{hours:"h "} {minutes:"m "} {seconds:"s"}'
  # Available color modes: STATIC, GRADIENT, RAINBOW
  color-mode: GRADIENT
  color1: '#FF5555'
  color2: '#5555FF'
  animation-speed: 5
  bold-text: true

# BossBar Specifics
bossbar:
  color: BLUE
  style: SOLID
  # Use 'TIME' to sync with seconds, or a fixed percentage (0.0 - 1.0)
  progress: TIME

# World Filter (Leave empty to allow all worlds)
allowed-worlds:
  - 'event_world'
  - 'speedrun_map'

Frequently Asked Questions

Does it support Paper/Purpur?

Yes! easyTimer is fully optimized for modern Paper, Purpur, and Spigot servers from 1.16 up to the latest version.

Do I need PlaceholderAPI?

PlaceholderAPI is optional. The plugin handles ActionBar, TabList, and Bossbar displays natively out of the box.

Included Languages (24)

The plugin ships with extensive native localization support 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

Stats & Success

24 Languages

Built-in & instantly switchable

Fully Custom

Gradients, BossBars & HEX colors

High Performance

Optimized async ticks