{"id":27394562,"url":"https://github.com/ueva/vg-cluescrollhud","last_synced_at":"2026-05-01T04:41:35.358Z","repository":{"id":287628018,"uuid":"951542359","full_name":"Ueva/vg-ClueScrollHUD","owner":"Ueva","description":"📜 A lightweight HUD mod for the Vulengate Minecraft server that displays clue scroll objectives and progress.","archived":false,"fork":false,"pushed_at":"2025-04-12T22:20:11.000Z","size":5541,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-12T23:24:21.644Z","etag":null,"topics":["minecraft","minecraft-fabric-mod","minecraft-mod","minecraft-modification","vulengate"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Ueva.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,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-03-19T21:04:27.000Z","updated_at":"2025-04-12T21:58:13.000Z","dependencies_parsed_at":"2025-04-12T23:34:35.056Z","dependency_job_id":null,"html_url":"https://github.com/Ueva/vg-ClueScrollHUD","commit_stats":null,"previous_names":["ueva/vg-cluescrollhud"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ueva%2Fvg-ClueScrollHUD","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ueva%2Fvg-ClueScrollHUD/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ueva%2Fvg-ClueScrollHUD/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Ueva%2Fvg-ClueScrollHUD/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Ueva","download_url":"https://codeload.github.com/Ueva/vg-ClueScrollHUD/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248794567,"owners_count":21162613,"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":["minecraft","minecraft-fabric-mod","minecraft-mod","minecraft-modification","vulengate"],"created_at":"2025-04-13T22:45:45.237Z","updated_at":"2026-05-01T04:41:35.352Z","avatar_url":"https://github.com/Ueva.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 📜 Clue Scroll HUD for Vulengate\r\n\r\nThis is a simple mod for use on the [Vulengate](https://www.vulengate.com) Minecraft server. It displays information\r\nabout the [Clue Scrolls](https://wikijs.vulengate.com/en/Cluescrolls) in your inventory directly on your HUD. Using this\r\nmod, you'll no longer have to open your inventory to check your progress towards completing your clues!\r\n\u003cp align=\"center\"\u003e\r\n    \u003cimg alt=\"Animated .gif showing the Vulengate Clue Scroll HUD mod being used.\" height=\"399\" src=\"assets/demo.png\" width=\"392\"/\u003e\r\n\u003c/p\u003e\r\n\r\n### Disclaimer\r\n\r\n**This project is not developed by Vulengate. It is an unofficial, fan-made mod.**\r\n\r\nPlease do **not** contact Vulengate staff for support with this mod, as they are not responsible for it in any way.\r\n\r\n[Vulengate staff have given consent](assets/vg-consent.png) for this modification to be developed and\r\ndistributed.\r\n\r\n### Copyright\r\n\r\nThe *Vulengate* name, logo, and all associated content are the property of their respective owners. No copyrighted,\r\ntrademarked, or otherwise restricted assets have been used in the development of this mod.\r\n\r\nThis project is licensed under the [MIT license](LICENSE).\r\n\r\n---\r\n\r\n## Usage\r\n\r\nThis is a very simple mod, so getting up and running should be a breeze!\r\n\r\nBelow, you'll find guidance about (1) what dependencies you need to install, (2) how to download this mod, (3) how to\r\ninstall this mod, (4) how to use this mod in-game, and (5) how to configure it to your liking.\r\n\r\n### 1. Installing Dependencies\r\n\r\nThis mod has the following hard dependencies:\r\n\r\n- Fabric [Loader](https://fabricmc.net) and [API](https://modrinth.com/mod/fabric-api)\r\n- [Cloth Config API](https://modrinth.com/mod/cloth-config)\r\n\r\nThis mod also has an optional dependency on the [Mod Menu](https://modrinth.com/mod/modmenu) mod. \u003cbr\u003e\r\nAlthough Mod Menu is not required, it will make configuring this mod much easier.\r\n\r\n### 2. Downloading the Latest Release\r\n\r\nFor most users, the easiest way to download this mod is via [Modrinth](https://modrinth.com/project/vg-cluescrollhud/).\r\n\r\nSome users may prefer to download the latest release directly from GitHub. You can find the all pre-built `.jar`\r\nreleases on the [Releases tab](https://github.com/Ueva/vg-ClueScrollHUD/releases) of this repository.\r\n\r\nAlternatively, you can download the source code and build the mod yourself. If this is something you are interested in,\r\nyou probably already know what you're doing; I won't include instructions about how to do so here.\r\n\r\n### 3. Installing the Mod\r\n\r\nThe mod is installed like any other Fabric mod. Simply place the `.jar` file in your `/mods/` folder and launch the\r\ngame.\r\n\r\n*Easy peasy lemon squeezy!*\r\n\r\n### 4. Using the Mod\r\n\r\nOnce installed, you should see a new HUD element in the top-left of your screen when you next join Vulengate. The mod\r\nrequires no manual action on your part - it will display information about your current cluescrolls automatically.\r\n\r\nThe three default keybinds for this mod are:\r\n\r\n- `'` - Toggle the Clue Scroll HUD.\r\n- `[` - Show the previous clue scroll in your inventory.\r\n- `]` - Show the next clue scroll in your inventory.\r\n\r\n### 5. Configuring the Mod\r\n\r\nThis mod's keybinds can be changed in the Controls menu.\r\n\r\nThere are a few configuration options that can be changed via Mod Menu.\r\nIf you have not installed Mod Menu, you can edit the configuration file (`/config/vg-cluescrollhud.toml`)\r\ndirectly.\r\n\r\n---\r\n\r\n## Getting Involved\r\n\r\nIn general, contributions to this project are more than welcome! In particular, I am committed to ironing out any bugs\r\nor unintended behaviour, and to adding features that the community would find useful.\r\n\r\nHowever, please bear in mind that this project is developed in my free time, on a voluntary basis. I will do my best\r\nto respond to issues and pull requests in a timely manner, but I cannot make any guarantees.\r\n\r\n### Contributing Code\r\n\r\nIf you would like to contribute to this project, please fork the repository, make your changes, and submit a pull\r\nrequest.\r\nPlease ensure that your code is well-documented and that you have followed the contribution guidelines.\r\n\r\n### Reporting Bugs\r\n\r\nIf you would like to report a bug, please [open an issue](https://github.com/Ueva/vg-ClueScrollHUD/issues) on the\r\nGitHub repository.\r\nPlease do not contact any developers or maintainers directly.\r\n\r\n### Requesting Features\r\n\r\nIf you would like to request a feature, please [open an issue](https://github.com/Ueva/vg-ClueScrollHUD/issues) on the\r\nGitHub repository and tag it as a feature request.\r\nPlease do not contact any developers or maintainers directly.\r\n\r\n---\r\n\r\n## FAQs\r\n\r\nHere, you will find answers to a collection of frequently asked questions about this mod.\r\n\r\n### In-Game FAQs\r\n\r\nThis section addresses using the mod in normal gameplay on the Vulengate server.\r\n\r\n#### Is this mod allowed on Vulengate?\r\n\r\nYes! This mod is permitted under Vulengate's server rules. It does not give you any unfair advantage over other players,\r\nand it has no potential to degrade server performance.\r\n\r\nI have also received [explicit permission](assets/vg-consent.png) from Vulengate staff to develop and distribute this\r\nmod.\r\n\r\n#### Why isn't my task progress being updated immediately on the HUD?\r\n\r\nThis mod reads your progress directly from the clue scroll items in your inventory - the HUD will update as soon as the\r\nscroll items themselves are updated. This is usually immediate, but there may be a slight delay for certain types\r\nof clues. Movement-related tasks (e.g., \"Walk...\" or \"Ride...\") seem particularly prone to this.\r\n\r\nThis isn’t a bug with this mod. Rather, it is a limitation of how the clue scroll plugin works on the Vulengate server.\r\nOnce the server registers your progress and updates the scroll's data, the HUD will reflect it immediately after.\r\n\r\n### Development FAQs\r\n\r\nThis section addresses broader questions about the mod’s development, feature requests, compatibility, and future plans.\r\n\r\n#### Can you port this mod to Forge/NeoForge?\r\n\r\nMaybe in the future, but not any time soon.\r\n\r\nI've not developed a Forge mod for over a decade, so I don't have any plans to do this any time soon.\r\nIf you'd like to contribute a Forge port, please get in touch.\r\n\r\n**Note**: It may be possible to use this mod on NeoForge using\r\nthe [Sinytra Connector](https://modrinth.com/mod/connector)\r\nmod.\r\n\r\n#### Can you port this mod to Bedrock Edition?\r\n\r\nThis is orders of magnitude less likely than a Forge port. I've honestly never even booted up Bedrock Edition, let alone\r\ndeveloped an addon for it. I don't intend on starting now.\r\n\r\nMy advice: use the Java edition of Minecraft. Be like the cool kids back in 2009.\r\n\r\n#### Can you update to [version]?\r\n\r\nYes! I will do my very best to keep this mod up to date with the latest version of Minecraft used on Vulengate.\r\n\r\nSometimes, this may take a little while, especially if there are breaking changes in (1) the Fabric or Minecraft APIs,\r\nor (2) the clue scroll plugin used on Vulengate.\r\n\r\n#### Can you fix [bug]?\r\n\r\nProbably! Please [open an issue](https://github.com/Ueva/vg-ClueScrollHUD/issues) on the GitHub repository and tag it as\r\na bug report.\r\n\r\nBug fixes take priority over feature additions, so I'll try to implement them as soon as I can.\r\n\r\n#### Can you add [feature]?\r\n\r\nMaybe! If you have a feature request, please [open an issue](https://github.com/Ueva/vg-ClueScrollHUD/issues) on the\r\nGitHub repository and tag it as a feature request.\r\n\r\nThe main things that will influence whether or not a feature is added are (1) how useful it is to the community in\r\ngeneral, and (2) how much free time I have to implement it.\r\n\r\nOftentimes, the fastest way to get a feature added is to implement it yourself and submit a pull request!\r\n\r\n#### Why hasn't my issue been responded to/pull request been merged?\r\n\r\nThe most likely reason is that I haven't had time to look at it yet.\r\nI'm a busy person, and I develop this project in my (often very limited) free time.\r\nI'll do my best to respond to issues and pull requests in a timely manner, but I can't make any guarantees when it comes\r\nto timeframes.\r\n\r\nTo increase the chances of your issue being responded to quickly, please ensure you have followed the provided\r\ntemplates for reporting bugs or submitting feature requests. Similarly, please ensure you follow the contribution\r\nguidelines when making a pull request.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fueva%2Fvg-cluescrollhud","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fueva%2Fvg-cluescrollhud","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fueva%2Fvg-cluescrollhud/lists"}