{"id":24551695,"url":"https://github.com/regulad/advancementhunt","last_synced_at":"2026-04-11T21:46:08.951Z","repository":{"id":41976565,"uuid":"324779795","full_name":"regulad/AdvancementHunt","owner":"regulad","description":"Minigame Plugin for Minecraft.","archived":false,"fork":false,"pushed_at":"2024-11-04T00:53:29.000Z","size":334,"stargazers_count":0,"open_issues_count":5,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-23T01:17:43.036Z","etag":null,"topics":["bukkit","bukkit-plugin","java","java-11","minecraft","minecraft-plugin","mysql","player","spigot","spigot-plugin","yml"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/regulad.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2020-12-27T14:32:04.000Z","updated_at":"2024-05-29T00:04:18.000Z","dependencies_parsed_at":"2024-04-23T13:56:43.890Z","dependency_job_id":"6ab528c7-8b49-402f-8b8d-1b903a21c475","html_url":"https://github.com/regulad/AdvancementHunt","commit_stats":null,"previous_names":["regulad/advancementhunt"],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regulad%2FAdvancementHunt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regulad%2FAdvancementHunt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regulad%2FAdvancementHunt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/regulad%2FAdvancementHunt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/regulad","download_url":"https://codeload.github.com/regulad/AdvancementHunt/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243878408,"owners_count":20362431,"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","java","java-11","minecraft","minecraft-plugin","mysql","player","spigot","spigot-plugin","yml"],"created_at":"2025-01-23T01:17:54.169Z","updated_at":"2026-04-11T21:46:03.915Z","avatar_url":"https://github.com/regulad.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# AdvancementHunt\n\nAdvancementHunt is a minigame plugin.\n\nThe objective of the game is to obtain a certain advancement within the time limit without dying.\n\nThere are two teams, the Hunters and the Hunted.\n\nAt the beginning of the game, the Hunted will recieve the name of an advancement and are tasked with completing it.\n\nThey must first figure out what the advancement is and then obtain it.\n\nAlso, at the beginning of the game, the Hunters are tasked with killing the Hunted before they obtain the advancement.\nThe Hunters may not know what the advancement is.\n\nAll games have a time limit, and if it is reached, the game will stalemate.\n\nGame stats are logged and can be accessed via PlaceholderAPI placeholders.\n\n## Requirements\n\n1. The following plugins:\n    * Multiverse-Core\n    * Multiverse-NetherPortals\n    * Multiverse-Inventories\n    * PlaceholderAPI\n2. Paper 1.20.4+\n\n## Setup\n\nAdvancementHunt is ready to go out of the box.\n\n## Use\n\n### Commands\n\n* `/gamestart [Hunted player] [Advancement] \u003cTime (Minutes)\u003e [World seed] \u003cWorldborder\u003e`: Allows you to start the game.\n* `/gameend`: Allows you to end the game.\n* `/registeradvancement \u003cAdvancement\u003e \u003cTime (Minutes)\u003e`: Allows you to add an advancement and time limit to the\n  database.\n* `/registerseed \u003cWorld seed\u003e \u003cWorldborder\u003e`: Allows you to add a seed and worldborder size to the database.\n\n## Placeholders\n\n### Identifier is `ah`\n\n* `wins`: The total amount of wins a player has.\n* `losses`: The total amount of losses a player has.\n* `kills`: Shows total kills of the player.\n* `deaths`: Shows total deaths of the player.\n* `id`: The advancement ID.\n* `advancement`: The name of the advancement.\n* `hunted`: Shows the display name of the player being hunted.\n* `hunters`: Shows a list of display names for the players that are hunting. Seperated by commas.\n* `time`: Shows time remaining, in `HH:MM:SS` format.\n\nExample:\n\n```\n%ah_time% | %ah_advancement%\n```\n\nWill produce:\n\n```\n10:10 | Stone Age\n```\n\n(Provided there are 10 minutes and 10 seconds left, and the current advancement is Stone Age)\n\n## Developers\n\n### Maven\n\nPlease note that this plugin uses NMS via reflection. This is against my will, and may not be required\nafter https://github.com/PaperMC/Paper/pull/6175 is merged.\n\nInsert the following snippets into your POM.xml.\n\nFor the repository:\n\n```xml\n\n\u003crepositories\u003e\n    ...\n    \u003crepository\u003e\n        \u003cid\u003egithub\u003c/id\u003e\n        \u003cname\u003eGitHub Packages\u003c/name\u003e\n        \u003curl\u003ehttps://maven.pkg.github.com/EnderQuestMC/AdvancementHunt\u003c/url\u003e\n    \u003c/repository\u003e\n    ...\n\u003c/repositories\u003e\n```\n\nFor the dependency:\n\n```xml\n\n\u003cdependencies\u003e\n    ...\n    \u003cdependency\u003e\n        \u003cgroupId\u003equest.ender\u003c/groupId\u003e\n        \u003cartifactId\u003eadvancementhunt\u003c/artifactId\u003e\n        \u003cversion\u003e{version}\u003c/version\u003e\n    \u003c/dependency\u003e\n    ...\n\u003c/dependencies\u003e\n```\n\nReplace `{version}` with the current version. You can see the current version below. Don't include the \"v\".\n\n![Current Version](https://img.shields.io/github/v/release/EnderQuestMC/AdvancementHunt)\n\n### Use\n\nYou can get the instance of the AdvancementHunt plugin like any other plugin.\n\n```java\nfinal AdvancementHunt plugin = (AdvancementHunt) Bukkit.getServer().getPluginManager().getPlugin(\"AdvancementHunt\");\n```\n\nIf you want to change the game state, see the `startGame()` or `endGame()` methods of `AdvancementHunt`.\n\nIf you only want to listen to events, look at the events `PreGameStateChangeEvent` or `PostGameStateChangeEvent`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregulad%2Fadvancementhunt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fregulad%2Fadvancementhunt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fregulad%2Fadvancementhunt/lists"}