{"id":140682,"date":"2026-06-08T11:26:59","date_gmt":"2026-06-08T08:26:59","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/"},"modified":"2026-06-08T11:26:59","modified_gmt":"2026-06-08T08:26:59","slug":"simple-timer","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/","title":{"rendered":"Simple Timer"},"content":{"rendered":"<p># Simple Timer<\/p>\n<p>A simple and interactive timer plugin for Minecraft servers (Spigot, Paper, etc.),<br \/>\nsupporting multiple named timers with intuitive commands and clickable in-game UI elements.<\/p>\n<p>&#8212;<\/p>\n<p>**\u26a0\ufe0f Note:** This version of the plugin (v2.0.0 and above) has been completely rewritten,<br \/>\nincluding the documentation. For the old documentation, see here:<br \/>\nhttps:\/\/github.com\/IschdeFelin\/mc-simple-timer\/tree\/main-v1<\/p>\n<p>&#8212;<\/p>\n<p>## Features<\/p>\n<p>&#8211; Manage multiple timers with custom names.<br \/>\n&#8211; Clickable in-game timer list with hover tooltips and command suggestions.<br \/>\n&#8211; Supports pausing, resuming, resetting, saving, and reloading.<br \/>\n&#8211; Configurable display with color options and pause messages.<br \/>\n&#8211; Timers can run without players online and pause automatically on player death (configurable).<\/p>\n<p>&#8212;<\/p>\n<p>## Commands<\/p>\n<p>### `\/timer resume`<br \/>\nResumes the current timer.<\/p>\n<p>### `\/timer pause`<br \/>\nPauses the current timer.<\/p>\n<p>### `\/timer reset`<br \/>\nStops and resets the current timer to 0.<\/p>\n<p>### `\/timer create <name>`<br \/>\nCreates a new timer with the given name.<br \/>\nTimer names must be:<\/p>\n<p>&#8211; Not empty<br \/>\n&#8211; \u2264 20 characters<br \/>\n&#8211; Contain only letters, numbers, _ or &#8211;<\/p>\n<p>Example:<br \/>\n&#8220;`bash<br \/>\n\/timer create speedrun1<br \/>\n&#8220;`<\/p>\n<p>If successful, a clickable message appears allowing you to select the timer immediately.<\/p>\n<p>### `\/timer select <name>`<br \/>\nSelects the timer with the given name and pauses it by default.<\/p>\n<p>### `\/timer name`<br \/>\nShows the name of the currently selected timer.<\/p>\n<p>### `\/timer rename <name>`<br \/>\nRenames the current timer to the specified name. The same naming rules apply as for `\/timer create <name>`.<\/p>\n<p>### `\/timer state <name>`<br \/>\nShows the current state (time) of the specified timer or the active timer if no name is given.<\/p>\n<p>### `\/timer list`<br \/>\nLists all available timers with their current times.<br \/>\nEach entry is:<\/p>\n<p>&#8211; **Clickable:** suggests `\/timer select <name>`<br \/>\n&#8211; **Hoverable:** shows &#8220;Click to select&#8221;<\/p>\n<p>Example output:<br \/>\n&#8220;`plaintext<br \/>\nThese timers exist:<br \/>\n&#8211; speedrun1 (0s)<br \/>\n&#8211; bossfight (1h 23m 51s)<br \/>\n&#8220;`<\/p>\n<p>### `\/timer set <time>`<br \/>\nSets the current timer to a specific time.<\/p>\n<p>The `<time>` argument can be either a simple number of seconds (e.g. `300`)<br \/>\nor a more detailed format combining days, hours, minutes, and seconds, e.g.:<br \/>\n`13d2s`, `78m12s`, `15h7s`, `12h`, `465s`, `484`<\/p>\n<p>Example:<br \/>\n&#8220;`bash<br \/>\n\/timer set 1d3h17m12s<br \/>\n&#8220;`<\/p>\n<p>### `\/timer add <time>`<br \/>\nAdds the given time to the current timer.<\/p>\n<p>The `<time>` argument accepts the same formats as `\/timer set`, for example:<br \/>\n`300`, `78m12s`, `15h7s`, `13d2s`, `465s`<\/p>\n<p>Example:<br \/>\n&#8220;`bash<br \/>\n\/timer add 1h30m<br \/>\n&#8220;`<\/p>\n<p>### `\/timer subtract <time>`<br \/>\nSubtracts the given time from the current timer.<\/p>\n<p>The `<time>` argument accepts the same formats as `\/timer set`, for example:<br \/>\n`300`, `78m12s`, `15h7s`, `13d2s`, `465s`<\/p>\n<p>Example:<br \/>\n&#8220;`bash<br \/>\n\/timer subtract 45m20s<br \/>\n&#8220;`<\/p>\n<p>### `\/timer remove <name>`<br \/>\nRemoves the specified timer. If no name is given, removes the current timer.<br \/>\nIf the currently active timer is removed, no timer remains selected.<\/p>\n<p>### `\/timer reload`<br \/>\nReloads the configuration file from disk.<\/p>\n<p>### `\/timer save`<br \/>\nManually saves all timer data to disk.<br \/>\nOtherwise, the data is saved with every server shutdown.<\/p>\n<p>&#8212;<\/p>\n<p>## Installation<\/p>\n<p>1) Download the `.jar` file from Modrinth.<br \/>\n2) Place it in your server&#8217;s `\/plugins` folder.<br \/>\n3) Restart the server.<\/p>\n<p>&#8212;<\/p>\n<p>## Configuration<\/p>\n<p>Located at:<br \/>\n&#8220;`<br \/>\n\/plugins\/SimpleTimer\/config.yml<br \/>\n&#8220;`<\/p>\n<p>### Options<\/p>\n<p>| Option                | Description                                                        | Default          |<br \/>\n|&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211;|&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;&#8211;|&#8212;&#8212;&#8212;&#8212;&#8212;&#8212;|<br \/>\n| show_pause_message\t   | Show a custom message while paused (alternating with time)?        | `true`           |<br \/>\n| pause_message         | The message to display when the timer is paused.                   | `&#8221;Timer paused&#8221;` |<br \/>\n| color_running         | Timer color when running (`YELLOW`, `WHITE`, etc.)                 | `&#8221;YELLOW&#8221;`       |<br \/>\n| color_paused          | Timer value color when paused.                                     | `&#8221;GOLD&#8221;`         |<br \/>\n| color_pause_message   | Color of the pause message.                                        | `&#8221;GOLD&#8221;`         |<br \/>\n| run_without_players   | If `true`, timer continues running even when no players are online | `false`          |<br \/>\n| pause_on_player_death | If `true`, timer pauses automatically when a player dies           | `false`          |<br \/>\n| auto_select_new_timer | Automatically select the newly created timer                       | `false`          |<\/p>\n<p>### Available Colors<\/p>\n<p>AQUA, BLACK, BLUE, DARK_AQUA, DARK_BLUE, DARK_GRAY, DARK_GREEN, DARK_PURPLE,<br \/>\nDARK_RED, GOLD, GRAY, GREEN, LIGHT_PURPLE, RED, WHITE, YELLOW<\/p>\n<p>&#8212;<\/p>\n<p>For issues, suggestions, or contributions, feel free to open an issue or pull request on the GitHub repository.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>A simple Timer Plugin for Minecraft Servers. Works on Paper, Purpur, Pufferfish etc.<\/p>\n","protected":false},"featured_media":140683,"template":"","meta":{"_minecraft_slug":"simple-timer","_minecraft_project_id":"WUJcmiH2","_minecraft_author":"flxcraft","_minecraft_license":"MIT","_minecraft_downloads":1086,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simple-timer.zip","_minecraft_size_bytes":131100,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-16T08:22:00.935027Z","_minecraft_date_created":"2023-05-21T16:45:26.420663Z","_minecraft_date_modified":"2025-06-02T19:38:46.499384Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simple-timer","_minecraft_icon_attachment_id":140683,"_minecraft_imported_at":"2026-06-08T08:26:59+00:00","_minecraft_import_hash":"8906adacb294245027b816bffa1dd8d1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,866,127,128,867,129,123,92],"mod_loader":[130,132,133,134],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,73,74,38,78],"class_list":["post-140682","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Simple Timer - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Simple Timer - Minecraft\" \/>\n<meta property=\"og:description\" content=\"A simple Timer Plugin for Minecraft Servers. Works on Paper, Purpur, Pufferfish etc.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/\",\"name\":\"Simple Timer - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simple-timer-icon-6ee33db5a8040a4bb78d98b19d6de6e1d66077c5_96.webp\",\"datePublished\":\"2026-06-08T08:26:59+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simple-timer-icon-6ee33db5a8040a4bb78d98b19d6de6e1d66077c5_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simple-timer-icon-6ee33db5a8040a4bb78d98b19d6de6e1d66077c5_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simple-timer\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Simple Timer\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Simple Timer - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/","og_locale":"en_US","og_type":"article","og_title":"Simple Timer - Minecraft","og_description":"A simple Timer Plugin for Minecraft Servers. Works on Paper, Purpur, Pufferfish etc.","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/","name":"Simple Timer - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simple-timer-icon-6ee33db5a8040a4bb78d98b19d6de6e1d66077c5_96.webp","datePublished":"2026-06-08T08:26:59+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simple-timer-icon-6ee33db5a8040a4bb78d98b19d6de6e1d66077c5_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simple-timer-icon-6ee33db5a8040a4bb78d98b19d6de6e1d66077c5_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simple-timer\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"Simple Timer"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/140682","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/140683"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=140682"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=140682"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=140682"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=140682"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}