{"id":22136498,"url":"https://github.com/olillin/rainbowquartz","last_synced_at":"2026-05-18T04:41:09.603Z","repository":{"id":180191697,"uuid":"662620564","full_name":"olillin/RainbowQuartz","owner":"olillin","description":"Easy to use Paper plugin for creating custom items","archived":false,"fork":false,"pushed_at":"2024-03-28T13:09:42.000Z","size":515,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-29T15:33:58.327Z","etag":null,"topics":["minecraft-plugin","papermc"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","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/olillin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"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}},"created_at":"2023-07-05T14:19:05.000Z","updated_at":"2024-02-23T13:14:53.000Z","dependencies_parsed_at":"2024-03-01T01:48:46.443Z","dependency_job_id":"34db0b2d-58d3-4a11-a379-568c99097143","html_url":"https://github.com/olillin/RainbowQuartz","commit_stats":null,"previous_names":["olithehoodieboi/rainbowquartz","olillin/rainbowquartz"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olillin%2FRainbowQuartz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olillin%2FRainbowQuartz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olillin%2FRainbowQuartz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/olillin%2FRainbowQuartz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/olillin","download_url":"https://codeload.github.com/olillin/RainbowQuartz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245249232,"owners_count":20584497,"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-plugin","papermc"],"created_at":"2024-12-01T19:22:47.030Z","updated_at":"2026-05-18T04:41:04.569Z","avatar_url":"https://github.com/olillin.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cimg src=\"icon.png\" height=\"34em\" style=\"position:relative; top: 4px;\" alt=\"\"\u003e RainbowQuartz\n\n[![build](https://github.com/olillin/RainbowQuartz/actions/workflows/build.yml/badge.svg)](https://github.com/olillin/RainbowQuartz/actions/workflows/build.yml)\n[![coverage](https://img.shields.io/codecov/c/github/olillin/RainbowQuartz?token=LKVYMULDYF)](https://app.codecov.io/gh/olillin/RainbowQuartz)\n\n**RainbowQuartz** is an easy to use plugin for creating custom items.\n\n## Features\n\n- Creating custom items\n- Editing basic properties of those items (name, lore, item type)\n- Creating and editing recipes for those items\n- Registering event handlers for custom items with API\n\n### Planned features\n\n- Live updates of pre-existing items on modification\n- Registering event handlers in GUI\n- Custom enchantments\n- API support for registering custom recipe types\n\n## Creating items\n\nRainbowQuartz enables two ways of creating items: by [using the API in another plugin](#creating-items-with-the-api) or [with the in-game GUI](#creating-items-with-the-in-game-gui).\n\n### Creating items with the API\n\n\u003cdetails open\u003e\n\u003csummary\u003eKotlin example\u003c/summary\u003e\n\n#### MyPlugin.kt\n\n```kotlin\nval builder = ItemBuilder(NamespacedKey(this, \"emerald_pickaxe\"))\n    .setName(Component.text(\"Emerald pickaxe\")\n        .color(NamedTextColor.GREEN))\n    .addLore(\"Lorem ipsum\")\n    .addRecipe(\n        ShapedRecipe(\"RRR\", \" S \", \" S \")\n            .setIngredient('R', Material.EMERALD)\n            .setIngredient('S', Material.STICK))\nRainbowQuartz.itemManager.registerDefault(builder.build())\n```\n\n\u003c/details\u003e\n\u003cdetails\u003e\n\u003csummary\u003eJava example\u003c/summary\u003e\n\n#### MyPlugin.java\n\n```java\nItemBuilder builder = new ItemBuilder(new NamespacedKey(this, \"emerald_pickaxe\"), Material.DIAMOND_PICKAXE, new ArrayList\u003c\u003e())\n    .setName(Component.text(\"Emerald pickaxe\")\n         .color(NamedTextColor.GREEN))\n    .addLore(\"Lorem ipsum\")\n    .addRecipe(\n        new ShapedRecipe(\"RRR\", \" S \", \" S \")\n            .setIngredient('R', new Ingredient(Material.EMERALD, null))\n            .setIngredient('S', new Ingredient(Material.STICK, null)));\nRainbowQuartz.Companion.getItemManager().registerDefault(builder.build());\n```\n\n\u003c/details\u003e\n\nFor more examples using the API have a look at the [RainbowQuartzExample](https://github.com/olillin/RainbowQuartzExample) plugin.\n\n### Creating items with the in-game GUI\n\nThe GUI is the selling feature of RainbowQuartz, allowing for the creation and modfication of custom items all without restarting the server.\n\n1. Open the GUI with the `/rainbowquartz` command\n\n2. Open the **Item Editor**  \n![Click on Item Editor in main menu](doc/main-menu-item-editor.png)  \n\n3. Click the **New item** button in the top left  \n![ ](doc/item-editor-create-new-item.png)  \n\n4. Set your item id  \n![Click on Set item id](doc/new-item-set-item-id.png)  \n![Enter your item id and click Submit](doc/item-id-submit.png)  \n\n5. Set your material by placing an item with the material from your inventory in the first slot.  \n![Click on Set material](doc/new-item-set-material.png)  \n![Place your material in the first slot and click Submit](doc/material-submit.png)  \n\n6. Click the `Submit` button  \n![Click on Submit](doc/new-item-submit.png)  \n\n7. Modify any additional properties\n8. Click the `Back` button to save the item\n9. You've created your first item! 🎉\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folillin%2Frainbowquartz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Folillin%2Frainbowquartz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Folillin%2Frainbowquartz/lists"}