{"id":22838650,"url":"https://github.com/asintotoo/itemcreator","last_synced_at":"2025-03-31T03:47:27.581Z","repository":{"id":267263350,"uuid":"900704127","full_name":"Asintotoo/ItemCreator","owner":"Asintotoo","description":"Items Creation Library for Minecraft Plugins","archived":false,"fork":false,"pushed_at":"2024-12-12T07:04:25.000Z","size":80,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T03:47:24.309Z","etag":null,"topics":["api","customization","items","library","minecraft","paper","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Asintotoo.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,"publiccode":null,"codemeta":null}},"created_at":"2024-12-09T10:14:30.000Z","updated_at":"2024-12-12T07:04:29.000Z","dependencies_parsed_at":"2024-12-09T11:37:22.168Z","dependency_job_id":null,"html_url":"https://github.com/Asintotoo/ItemCreator","commit_stats":null,"previous_names":["asintotoo/itemcreator"],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asintotoo%2FItemCreator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asintotoo%2FItemCreator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asintotoo%2FItemCreator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Asintotoo%2FItemCreator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Asintotoo","download_url":"https://codeload.github.com/Asintotoo/ItemCreator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246413244,"owners_count":20773053,"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":["api","customization","items","library","minecraft","paper","papermc","plugin"],"created_at":"2024-12-13T00:07:46.408Z","updated_at":"2025-03-31T03:47:27.562Z","avatar_url":"https://github.com/Asintotoo.png","language":"Java","readme":"# ItemCreator\nItems Creation Library for Minecraft Plugins\n***\n\n**Note**: This library requires PaperMC server software in order to work. Make sure that your plugin uses the papermc-api instead of the usual (and obsulate) spigot-api\n\n\n## How to get the library\nYou can include this library in your project by declaring the following dependency:\n\nMaven:\n```xml\n\u003crepositories\u003e\n  \u003crepository\u003e\n    \u003cid\u003ejitpack.io\u003c/id\u003e\n    \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n  \u003c/repository\u003e\n\u003c/repositories\u003e\n\n\u003cdependencies\u003e\n  \u003cdependency\u003e\n    \u003cgroupId\u003ecom.github.Asintotoo\u003c/groupId\u003e\n    \u003cartifactId\u003eItemCreator\u003c/artifactId\u003e\n    \u003cversion\u003eVERSION\u003c/version\u003e\n  \u003c/dependency\u003e\n\u003c/dependencies\u003e\n```\n\nGradle:\n```groovy\nrepositories {\n  mavenCentral()\n  maven { url 'https://jitpack.io' }\n}\n\ndependencies {\n  implementation 'com.github.Asintotoo:ItemCreator:VERSION'\n}\n```\nReplace VERSION with the latest version avaiable that can be found [here](https://github.com/Asintotoo/ItemCreator/releases/latest)\n\n## How to use\nYou can either create an Item from scratch or describe it in a .yml file as following:\n```java\nPlayer player = ... // Your method to get a Player instance\nItemStack myItem = ItemCreator.of(Material.POTATO) // Create an item based on a given Material\n                                 .display_name(\"\u0026eRandom Potato of %player_name%\") // Set the name of the item using color codes\n                                 .amount(5) // Set the amount\n                                 .source(player) // Set the item source from the given player, which means that any placeholders will be parsed as the given player (Requires PlaceholdersAPI installed on the server)\n                                 .build() // Build the item \n                                 .itemstack(); // Return the ItemStack version\n\nItemStack myItemFromConfig = ItemCreator.of(plugin.getConfig(), \"items.king-sword\") // This will create an item by reading from a YamlConfiguration file at the given path\n                                        .build()\n                                        .itemstack();\n```\nHere is the  example of the YamlConfiguration format used above:\n```yaml\nitems:\n  king-sword:\n    material: DIAMOND_SWORD # Specify the Material of the item\n    display-name: \"\u0026dKing's Sword\" # Set its display name\n    custom-model-data: 2 # Set a Custom Model Data\n    enchantments: # Specify the list of the item's enchants\n      - \"sharpness:5\"\n      - \"looting:3\"\n    unbreakable: true # Make the item unbreakable\n```\n\nIt's also possible to get an ItemProvider from an ItemsAdder's or an Oraxen's custom item, this requires ItemsAdder or Oraxen to be installed on the server:\n```java\nItemStack myItemsAdderItem = ItemCreator.ofItemsAdder(\"my-namespace:my-item-id\") // Get the ItemsAdder item at the given namespace id as an ItemProvider\n                                        .build() // Build the ItemProvider\n                                        .itemstack(); // Convert it to ItemStack\n\nItemStack myOraxenItem = ItemCreator.ofOraxen(\"my-oraxen-item-id\") // Get the Oraxen item with the given id as an ItemProvider\n                                        .build() // Build the ItemProvider\n                                        .itemstack(); // Convert it to ItemStack\n```\n\nAn improved documentation will come soon...\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasintotoo%2Fitemcreator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fasintotoo%2Fitemcreator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fasintotoo%2Fitemcreator/lists"}