{"id":29573833,"url":"https://github.com/tavstaldev/openheads","last_synced_at":"2026-05-14T20:06:50.380Z","repository":{"id":305142291,"uuid":"942620501","full_name":"TavstalDev/OpenHeads","owner":"TavstalDev","description":"A free and open-source heads menu plugin with GUI support.","archived":false,"fork":false,"pushed_at":"2025-07-18T11:29:39.000Z","size":10158,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-18T15:34:16.006Z","etag":null,"topics":["java","minecraft","minecraft-plugin","open-source","papermc","papermc-plugin"],"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/TavstalDev.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-04T11:53:20.000Z","updated_at":"2025-07-18T11:29:30.000Z","dependencies_parsed_at":"2025-07-18T15:49:57.694Z","dependency_job_id":null,"html_url":"https://github.com/TavstalDev/OpenHeads","commit_stats":null,"previous_names":["tavstaldev/openheads"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/TavstalDev/OpenHeads","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TavstalDev%2FOpenHeads","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TavstalDev%2FOpenHeads/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TavstalDev%2FOpenHeads/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TavstalDev%2FOpenHeads/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TavstalDev","download_url":"https://codeload.github.com/TavstalDev/OpenHeads/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TavstalDev%2FOpenHeads/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279016930,"owners_count":26085911,"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","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["java","minecraft","minecraft-plugin","open-source","papermc","papermc-plugin"],"created_at":"2025-07-19T07:01:08.540Z","updated_at":"2026-05-14T20:06:50.371Z","avatar_url":"https://github.com/TavstalDev.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenHeads\n\n![Release (latest by date)](https://img.shields.io/github/v/release/TavstalDev/OpenHeads?style=plastic-square)\n![Workflow Status](https://img.shields.io/github/actions/workflow/status/TavstalDev/OpenHeads/ghrelease.yml?branch=stable\u0026label=build\u0026style=plastic-square)\n![License](https://img.shields.io/github/license/TavstalDev/OpenHeads?style=plastic-square)\n![Downloads](https://img.shields.io/github/downloads/TavstalDev/OpenHeads/total?style=plastic-square)\n![Issues](https://img.shields.io/github/issues/TavstalDev/OpenHeads?style=plastic-square)\n\n**OpenHeads** is a **free and open-source** plugin for Minecraft servers, \ndesigned to enhance player experience by providing an **intuitive graphical interface (GUI)** for **Browse and obtaining custom decorative heads**. \nIntegrate unique aesthetics into your server with ease and expand customization options for your players.\n\n## Key Features\n\n* **Extensive Head Collection:** Access a vast library of custom player heads from `minecraft-heads.com`.\n* **User-Friendly GUI:** Navigate effortlessly through categories and preview heads with a clean graphical interface.\n* **Seamless Acquisition:** Players can easily select and obtain heads directly through the GUI.\n* **Essential Integrations:** Built-in compatibility with **Vault** (for economy features, if implemented) and **ProtocolLib** (for advanced packet handling).\n* **Granular Permissions:** Full control over who can access the plugin and its specific features.\n\n## Installation\n\nGetting OpenHeads up and running on your server is straightforward:\n\n1.  **Download:** Obtain the latest stable `.jar` file from the [GitHub Releases page](https://github.com/TavstalDev/OpenHeads/releases).\n2.  **Placement:** Move the downloaded `.jar` file into your Minecraft server's `plugins/` directory.\n3.  **Restart:** Fully restart your Minecraft server to properly load OpenHeads and its required dependencies.\n\n## Commands\n\nOpenHeads commands are designed for ease of use for both players and administrators. All commands begin with `/heads`.\n\n| Command          | Description                                     | Permissions                                  |\n| :--------------- | :---------------------------------------------- | :------------------------------------------- |\n| `/heads`         | Opens the main OpenHeads GUI menu.              | `openheads.command.heads` / `openheads.player` |\n| `/heads help`    | Displays a list of all available OpenHeads commands and their usage. | `openheads.command.help` / `openheads.player` |\n| `/heads version` | Shows the currently installed version of OpenHeads. | `openheads.command.version` / `openheads.player` |\n| `/heads reload`  | Reloads the plugin's configuration and data.    | `openheads.command.reload` / `openheads.admin` |\n\n## Permissions\n\nOpenHeads features a robust permission system, allowing server administrators to control access to various functionalities. Permissions are managed through your server's permission plugin (e.g., LuckPerms).\n\n| Permission Node             | Description                                          | Default Access (without permission plugin) |\n| :-------------------------- | :--------------------------------------------------- | :--------------------------------------- |\n| `openheads.command.heads`   | Allows a player to open the main heads GUI.          | OP                                       |\n| `openheads.command.help`    | Allows a player to view the plugin's help messages.  | OP                                       |\n| `openheads.command.version` | Allows a player to check the plugin version.         | OP                                       |\n| `openheads.command.reload`  | Grants permission to reload the plugin (admin command). | OP                                       |\n| `openheads.player`          | A meta-permission node that grants all player-related permissions (e.g., `openheads.command.heads`, `openheads.command.help`, `openheads.command.version`). | None                                     |\n| `openheads.admin`           | A meta-permission node that grants all administrative permissions (e.g., `openheads.command.reload`). | None                                     |\n| `openheads.*`               | Grants all permissions for the OpenHeads plugin.     | OP                                       |\n\n\n## Dependencies\n\nTo ensure OpenHeads functions correctly, your server must have the following plugins installed:\n\n* **[Vault](https://www.spigotmc.org/resources/vault.34315/)**: Required for general API compatibility. \n* * If you plan to use economy features (e.g., purchasing heads), you will also need an **economy plugin that integrates with Vault** (e.g., [EssentialsX](https://essentialsx.net/), [CMI](https://www.spigotmc.org/resources/cmi-300-commands-insane-kits-portals-essentials-economy-mysql-sqlite-much-more.3742/) etc.).\n\n## Screenshots\n\n![Preview](docs/images/img0.png)\n![Preview](docs/images/img1.png)\n![Preview](docs/images/img2.png)\n![Preview](docs/images/img3.png)\n![Preview](docs/images/img4.png)\n![Preview](docs/images/img5.png)\n\n## Contributing\n\nI welcome contributions! If you have ideas for features, bug fixes, or improvements, please consider contributing to the project.\n\n1.  **Fork** the repository on GitHub.\n2.  **Create a new branch** for your feature or bug fix (e.g., `feature/add-category` or `fix/gui-bug`).\n3.  **Commit your changes** with clear, concise, and descriptive commit messages.\n4.  **Push your branch** to your forked repository.\n5.  **Open a Pull Request** to the `main` branch of this repository, describing your changes.\n\n## License\n\nThis project is licensed under the **GNU General Public License v3.0**. You can find the full license text in the `LICENSE` file within this repository.\n\n## Contact\n\nFor any questions, bug reports, or feature requests, please use the [GitHub issue tracker](https://github.com/TavstalDev/OpenHeads/issues).\n\n## Credits \u0026 Disclaimer\n\n\u003e **Important Disclaimer:**\n\u003e This plugin utilizes and displays head data sourced from [minecraft-heads.com](https://minecraft-heads.com). We want to clarify that **we do not own, control, or claim intellectual property rights over any content originating from `minecraft-heads.com`**. All credit, rights, and ownership for the custom heads displayed within OpenHeads belong solely to their original creators on the [minecraft-heads.com](https://minecraft-heads.com) website.\n\n![Minecraft Heads Banner](docs/images/minecraft-heads-large.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftavstaldev%2Fopenheads","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftavstaldev%2Fopenheads","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftavstaldev%2Fopenheads/lists"}