{"id":16377684,"url":"https://github.com/sirblobman/cooldownsx","last_synced_at":"2025-10-26T10:30:42.641Z","repository":{"id":41149909,"uuid":"198347019","full_name":"SirBlobman/CooldownsX","owner":"SirBlobman","description":"A plugin that adds configurable cooldowns to items.","archived":false,"fork":false,"pushed_at":"2024-12-21T01:20:22.000Z","size":550,"stargazers_count":4,"open_issues_count":5,"forks_count":12,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-01-31T18:12:11.237Z","etag":null,"topics":["bukkit","bukkit-plugin","cooldown","ender","java","minecraft","papermc","pearl","plugin","spigot-plugin","spigotmc"],"latest_commit_sha":null,"homepage":"https://www.spigotmc.org/resources/41981/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/SirBlobman.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":".github/funding.yml","license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["SirBlobman"],"custom":["https://bit.ly/SirBlobmanDonate"]}},"created_at":"2019-07-23T03:45:39.000Z","updated_at":"2024-12-21T01:20:25.000Z","dependencies_parsed_at":"2024-11-10T20:24:52.327Z","dependency_job_id":"c8d1f895-ace1-4c9c-9c13-e91b48454712","html_url":"https://github.com/SirBlobman/CooldownsX","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SirBlobman%2FCooldownsX","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SirBlobman%2FCooldownsX/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SirBlobman%2FCooldownsX/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/SirBlobman%2FCooldownsX/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/SirBlobman","download_url":"https://codeload.github.com/SirBlobman/CooldownsX/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238310165,"owners_count":19450802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bukkit","bukkit-plugin","cooldown","ender","java","minecraft","papermc","pearl","plugin","spigot-plugin","spigotmc"],"created_at":"2024-10-11T03:43:46.247Z","updated_at":"2025-10-26T10:30:42.636Z","avatar_url":"https://github.com/SirBlobman.png","language":"Java","funding_links":["https://github.com/sponsors/SirBlobman","https://bit.ly/SirBlobmanDonate"],"categories":[],"sub_categories":[],"readme":"# CooldownsX\n\nA plugin that adds customizable cool down timers to items.\nUsing this plugin, you can ensure that your server is balanced and that players\nuse items strategically instead of spamming them. \n\n## Requirements\n\n- Java 21\n- [Spigot](https://spigotmc.org/), [Paper](https://papermc.io/downloads/paper), or [Folia](https://papermc.io/software/folia) 1.21.7\n- [BlueSlimeCore](https://jenkins.sirblobman.xyz/job/SirBlobman/job/BlueSlimeCore/) 2.9.7 or higher.\n\n## Placeholders\n\nCooldownsX adds placeholders to plugins that support PlaceholderAPI.\nReview the table below for placeholder information:\n\n| Placeholder                           | Description                                                   | Example Output |\n|---------------------------------------|---------------------------------------------------------------|----------------|\n| %cooldownsx_time_left_`\u003cid\u003e`%         | The amount of seconds left for a specific cooldown. (integer) | 5              |\n| %cooldownsx_time_left_decimal_`\u003cid\u003e`% | The amount of seconds left for a specific cooldown. (decimal) | 5.2            |\n\n`\u003cid\u003e`: The configuration identifier. \n\n## API Information\n\nCooldownsX has a useful API that is hosted on my own repository.\nTo use the api, add the following values to your `pom.xml` file:\n\n\u003cdetails\u003e\n\u003csummary\u003eMaven Repository\u003c/summary\u003e\n\n```xml\n\u003crepositories\u003e\n    \u003c!-- SirBlobman Public Repository --\u003e\n    \u003crepository\u003e\n        \u003cid\u003esirblobman-public\u003c/id\u003e\n        \u003curl\u003ehttps://nexus.sirblobman.xyz/public/\u003c/url\u003e\n    \u003c/repository\u003e\n\u003c/repositories\u003e\n```\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eMaven Dependency\u003c/summary\u003e\n\n```xml\n\u003cdependencies\u003e\n    \u003c!-- CooldownsX --\u003e\n    \u003cdependency\u003e\n        \u003cgroupId\u003ecom.github.sirblobman.plugin.cooldowns\u003c/groupId\u003e\n        \u003cartifactId\u003ecooldowns-api\u003c/artifactId\u003e\n        \u003cversion\u003e6.0.0-SNAPSHOT\u003c/version\u003e\n        \u003cscope\u003eprovided\u003c/scope\u003e\n    \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\u003c/details\u003e\n\n## API Usage\n\nTo use the API you should make sure that CooldownsX is enabled on the server first.  \nThe main things you need to know are how to get the plugin instance and how to get data for a player:\n\n\u003cdetails\u003e\n\u003csummary\u003eExample Code\u003c/summary\u003e\n\n```java\nimport org.bukkit.Bukkit;\nimport org.bukkit.entity.Player;\nimport org.bukkit.plugin.Plugin;\nimport org.bukkit.plugin.PluginManager;\n\nimport com.github.sirblobman.plugin.cooldown.CooldownsX;\nimport com.github.sirblobman.plugin.cooldown.Cooldown;\nimport com.github.sirblobman.plugin.cooldown.PlayerCooldown;\nimport com.github.sirblobman.plugin.cooldown.PlayerCooldownManager;\n\nimport org.jetbrains.annotations.Nullable;\nimport org.jetbrains.annotations.NotNull;\n\npublic final class CooldownHelper {\n    public @NotNull CooldownsX getCooldownsX() {\n        PluginManager pluginManager = Bukkit.getPluginManager();\n        Plugin plugin = pluginManager.getPlugin(\"CooldownsX\");\n        return (CooldownsX) plugin;\n    }\n\n    public @NotNull PlayerCooldown getData(@NotNull Player player) {\n        CooldownsX plugin = getCooldownsX();\n        PlayerCooldownManager manager = plugin.getCooldownManager();\n        return manager.getData(player);\n    }\n    \n    public @Nullable Cooldown getCooldownSettings(@NotNull String id) {\n        CooldownsX plugin = getCooldownsX();\n        PlayerCooldownManager manager = plugin.getCooldownManager();\n        return manager.getCooldownSettings(id);\n    }\n\n    /*\n     *  You can check the expiration time of a specific cooldown for a player:\n     */\n    public long getCooldownExpireMillis(@NotNull Player player, @NotNull String id) {\n        Cooldown cooldown = getCooldownSettings(id);\n        if (cooldown == null) {\n            return 0L;\n        }\n\n        PlayerCooldown data = getData(player);\n        return data.getCooldownExpireTime(cooldown);\n    }\n}\n```\n\u003c/details\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirblobman%2Fcooldownsx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsirblobman%2Fcooldownsx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirblobman%2Fcooldownsx/lists"}