{"action":"created","comment":{"url":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/comments/74154407","id":74154407,"diff_hunk":"@@ -0,0 +1,47 @@\n+Items\n+=====\n+\n+Along with blocks, items make up the backbone of any good mod. While blocks make up the world around you, items are what let you change it.\n+\n+Creating an Item\n+----------------\n+\n+### Basic Items\n+\n+Basic items that need no special functionality (think sticks or sugar) don't need custom classes. You can simply instantiate `Item` and call its various setters to set some simple properties.\n+\n+|         Method         |                  Description                  |\n+|:----------------------:|:----------------------------------------------|\n+|    `setCreativeTab`    | Sets which creative tab this item is under. Must be called if this item is meant to be shown on the creative menu. Vanilla tabs can be found in the class `CreativeTabs`. |\n+|     `setMaxDamage`     | Sets the maximum damage value for this item. If it's over `0`, 2 item overrides \"damaged\" and \"damage\" are added. |\n+|    `setMaxStackSize`   | Sets the maximum stack size.                  |\n+|      `setNoRepair`     | Makes this item impossible to repair, even if it is damageable. |\n+|  `setUnlocalizedName`  | Sets this item's unlocalized name, with \"item.\" prepended. |\n+|    `setHarvestLevel`   | Adds or removes a pair of harvest class (`\"shovel\"`, `\"axe\"`) and harvest level. This method is not chainable. |\n+\n+The above methods are chainable, unless otherwise stated, meaning they `return this` to facilitate calling them in series.\n+\n+### Advanced Items\n+\n+Setting the properties of an item as above only works for very simple items. If you want more complicated items, you should subclass Item and override its methods.\n+\n+Registering an Item\n+-------------------\n+\n+### The Item Itself\n+\n+Now that you have created an item, it is time to register it. As with most things you register an Item by passing it to `GameRegistry.register`. Before you register an item, you must also set its registry name. To set the registry name, simply call `setRegistryName` on the item. You may also pass a `ResourceLocation` directly to `GameRegistry.register`, but this is just shorthand for calling `setRegistryName` beforehand.\n+\n+!!! note\n+\n+    When you set the registry name with a simple string like `\"myItem\"`, the active modid is prefixed onto it. So if examplemod was registering this item, the actual name will be `\"examplemod:myItem\"`.\n+\n+### The Item's model\n+\n+Unlike blocks, which are automatically bound to their blockstate files, items must have their models explicitly registered. This holds true even for `ItemBlock`s. This registering can only happen on the clientside, so make sure you only call this code through your client proxy.\n+\n+Item model registering happens through `ModelLoader.setCustomModelResourceLocation`. This method registers a mapping from (item, meta) to a `ModelResourceLocation`. A `ModelResourceLocation` is the combination of a `ResourceLocation` (like `examplemod:foo`) with a variant string (like `variant=iron`). For a blockstate JSON `examplemod:block`, we can construct an RL for it, and then an MRL refers to a certain variant within that JSON.\n+\n+However, items don't have blockstate JSONs, therefore vanilla Minecraft forces the variant to be `\"inventory\"` and requires that \"variants\" be done through [property overrides](overrides). Forge goes ahead and undoes this, so you can now use variant strings on items.","path":"docs/items/items.md","position":45,"original_position":45,"commit_id":"cab14f60a23d52e700fd6c0f55d0c08133c081af","original_commit_id":"cab14f60a23d52e700fd6c0f55d0c08133c081af","user":{"login":"howtonotwin","id":15616055,"avatar_url":"https://avatars.githubusercontent.com/u/15616055?v=3","gravatar_id":"","url":"https://api.github.com/users/howtonotwin","html_url":"https://github.com/howtonotwin","followers_url":"https://api.github.com/users/howtonotwin/followers","following_url":"https://api.github.com/users/howtonotwin/following{/other_user}","gists_url":"https://api.github.com/users/howtonotwin/gists{/gist_id}","starred_url":"https://api.github.com/users/howtonotwin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/howtonotwin/subscriptions","organizations_url":"https://api.github.com/users/howtonotwin/orgs","repos_url":"https://api.github.com/users/howtonotwin/repos","events_url":"https://api.github.com/users/howtonotwin/events{/privacy}","received_events_url":"https://api.github.com/users/howtonotwin/received_events","type":"User","site_admin":false},"body":"I'm not quite sure what to rephrase this as. Would it be better as \"If the variant is `inventory`, the game loads the model file under models/item/, and if the variant is anything else, it will load a blockstate JSON from blockstates/\"","created_at":"2016-08-09T22:10:47Z","updated_at":"2016-08-09T22:10:47Z","html_url":"https://github.com/MinecraftForge/Documentation/pull/58#discussion_r74154407","pull_request_url":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58","_links":{"self":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/comments/74154407"},"html":{"href":"https://github.com/MinecraftForge/Documentation/pull/58#discussion_r74154407"},"pull_request":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58"}}},"pull_request":{"url":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58","id":80702692,"html_url":"https://github.com/MinecraftForge/Documentation/pull/58","diff_url":"https://github.com/MinecraftForge/Documentation/pull/58.diff","patch_url":"https://github.com/MinecraftForge/Documentation/pull/58.patch","issue_url":"https://api.github.com/repos/MinecraftForge/Documentation/issues/58","number":58,"state":"open","locked":false,"title":"Add Category on Items and add some pages to it","user":{"login":"howtonotwin","id":15616055,"avatar_url":"https://avatars.githubusercontent.com/u/15616055?v=3","gravatar_id":"","url":"https://api.github.com/users/howtonotwin","html_url":"https://github.com/howtonotwin","followers_url":"https://api.github.com/users/howtonotwin/followers","following_url":"https://api.github.com/users/howtonotwin/following{/other_user}","gists_url":"https://api.github.com/users/howtonotwin/gists{/gist_id}","starred_url":"https://api.github.com/users/howtonotwin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/howtonotwin/subscriptions","organizations_url":"https://api.github.com/users/howtonotwin/orgs","repos_url":"https://api.github.com/users/howtonotwin/repos","events_url":"https://api.github.com/users/howtonotwin/events{/privacy}","received_events_url":"https://api.github.com/users/howtonotwin/received_events","type":"User","site_admin":false},"body":"Add a base page on items analogous to the base page on blocks.\r\nAdd a page on item property overrides.","created_at":"2016-08-09T22:00:25Z","updated_at":"2016-08-09T22:10:47Z","closed_at":null,"merged_at":null,"merge_commit_sha":"eed8bb82571064b56b40f33aa3717c2bddbd6840","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58/commits","review_comments_url":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58/comments","review_comment_url":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/MinecraftForge/Documentation/issues/58/comments","statuses_url":"https://api.github.com/repos/MinecraftForge/Documentation/statuses/cab14f60a23d52e700fd6c0f55d0c08133c081af","head":{"label":"howtonotwin:items","ref":"items","sha":"cab14f60a23d52e700fd6c0f55d0c08133c081af","user":{"login":"howtonotwin","id":15616055,"avatar_url":"https://avatars.githubusercontent.com/u/15616055?v=3","gravatar_id":"","url":"https://api.github.com/users/howtonotwin","html_url":"https://github.com/howtonotwin","followers_url":"https://api.github.com/users/howtonotwin/followers","following_url":"https://api.github.com/users/howtonotwin/following{/other_user}","gists_url":"https://api.github.com/users/howtonotwin/gists{/gist_id}","starred_url":"https://api.github.com/users/howtonotwin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/howtonotwin/subscriptions","organizations_url":"https://api.github.com/users/howtonotwin/orgs","repos_url":"https://api.github.com/users/howtonotwin/repos","events_url":"https://api.github.com/users/howtonotwin/events{/privacy}","received_events_url":"https://api.github.com/users/howtonotwin/received_events","type":"User","site_admin":false},"repo":{"id":65155264,"name":"MCForgeDocumentation","full_name":"howtonotwin/MCForgeDocumentation","owner":{"login":"howtonotwin","id":15616055,"avatar_url":"https://avatars.githubusercontent.com/u/15616055?v=3","gravatar_id":"","url":"https://api.github.com/users/howtonotwin","html_url":"https://github.com/howtonotwin","followers_url":"https://api.github.com/users/howtonotwin/followers","following_url":"https://api.github.com/users/howtonotwin/following{/other_user}","gists_url":"https://api.github.com/users/howtonotwin/gists{/gist_id}","starred_url":"https://api.github.com/users/howtonotwin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/howtonotwin/subscriptions","organizations_url":"https://api.github.com/users/howtonotwin/orgs","repos_url":"https://api.github.com/users/howtonotwin/repos","events_url":"https://api.github.com/users/howtonotwin/events{/privacy}","received_events_url":"https://api.github.com/users/howtonotwin/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/howtonotwin/MCForgeDocumentation","description":"Read the docs MinecraftForge documentation","fork":true,"url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation","forks_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/forks","keys_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/teams","hooks_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/hooks","issue_events_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/issues/events{/number}","events_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/events","assignees_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/assignees{/user}","branches_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/branches{/branch}","tags_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/tags","blobs_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/statuses/{sha}","languages_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/languages","stargazers_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/stargazers","contributors_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/contributors","subscribers_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/subscribers","subscription_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/subscription","commits_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/contents/{+path}","compare_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/merges","archive_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/downloads","issues_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/issues{/number}","pulls_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/pulls{/number}","milestones_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/milestones{/number}","notifications_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/labels{/name}","releases_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/releases{/id}","deployments_url":"https://api.github.com/repos/howtonotwin/MCForgeDocumentation/deployments","created_at":"2016-08-07T21:39:41Z","updated_at":"2016-08-07T21:42:49Z","pushed_at":"2016-08-09T22:03:10Z","git_url":"git://github.com/howtonotwin/MCForgeDocumentation.git","ssh_url":"git@github.com:howtonotwin/MCForgeDocumentation.git","clone_url":"https://github.com/howtonotwin/MCForgeDocumentation.git","svn_url":"https://github.com/howtonotwin/MCForgeDocumentation","homepage":null,"size":248,"stargazers_count":0,"watchers_count":0,"language":null,"has_issues":false,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"MinecraftForge:master","ref":"master","sha":"b68b57c41f0262f39548adc521438ded3b38c0fb","user":{"login":"MinecraftForge","id":1390178,"avatar_url":"https://avatars.githubusercontent.com/u/1390178?v=3","gravatar_id":"","url":"https://api.github.com/users/MinecraftForge","html_url":"https://github.com/MinecraftForge","followers_url":"https://api.github.com/users/MinecraftForge/followers","following_url":"https://api.github.com/users/MinecraftForge/following{/other_user}","gists_url":"https://api.github.com/users/MinecraftForge/gists{/gist_id}","starred_url":"https://api.github.com/users/MinecraftForge/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MinecraftForge/subscriptions","organizations_url":"https://api.github.com/users/MinecraftForge/orgs","repos_url":"https://api.github.com/users/MinecraftForge/repos","events_url":"https://api.github.com/users/MinecraftForge/events{/privacy}","received_events_url":"https://api.github.com/users/MinecraftForge/received_events","type":"Organization","site_admin":false},"repo":{"id":34235955,"name":"Documentation","full_name":"MinecraftForge/Documentation","owner":{"login":"MinecraftForge","id":1390178,"avatar_url":"https://avatars.githubusercontent.com/u/1390178?v=3","gravatar_id":"","url":"https://api.github.com/users/MinecraftForge","html_url":"https://github.com/MinecraftForge","followers_url":"https://api.github.com/users/MinecraftForge/followers","following_url":"https://api.github.com/users/MinecraftForge/following{/other_user}","gists_url":"https://api.github.com/users/MinecraftForge/gists{/gist_id}","starred_url":"https://api.github.com/users/MinecraftForge/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MinecraftForge/subscriptions","organizations_url":"https://api.github.com/users/MinecraftForge/orgs","repos_url":"https://api.github.com/users/MinecraftForge/repos","events_url":"https://api.github.com/users/MinecraftForge/events{/privacy}","received_events_url":"https://api.github.com/users/MinecraftForge/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/MinecraftForge/Documentation","description":"Read the docs MinecraftForge documentation","fork":false,"url":"https://api.github.com/repos/MinecraftForge/Documentation","forks_url":"https://api.github.com/repos/MinecraftForge/Documentation/forks","keys_url":"https://api.github.com/repos/MinecraftForge/Documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/MinecraftForge/Documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/MinecraftForge/Documentation/teams","hooks_url":"https://api.github.com/repos/MinecraftForge/Documentation/hooks","issue_events_url":"https://api.github.com/repos/MinecraftForge/Documentation/issues/events{/number}","events_url":"https://api.github.com/repos/MinecraftForge/Documentation/events","assignees_url":"https://api.github.com/repos/MinecraftForge/Documentation/assignees{/user}","branches_url":"https://api.github.com/repos/MinecraftForge/Documentation/branches{/branch}","tags_url":"https://api.github.com/repos/MinecraftForge/Documentation/tags","blobs_url":"https://api.github.com/repos/MinecraftForge/Documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/MinecraftForge/Documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/MinecraftForge/Documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/MinecraftForge/Documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/MinecraftForge/Documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/MinecraftForge/Documentation/languages","stargazers_url":"https://api.github.com/repos/MinecraftForge/Documentation/stargazers","contributors_url":"https://api.github.com/repos/MinecraftForge/Documentation/contributors","subscribers_url":"https://api.github.com/repos/MinecraftForge/Documentation/subscribers","subscription_url":"https://api.github.com/repos/MinecraftForge/Documentation/subscription","commits_url":"https://api.github.com/repos/MinecraftForge/Documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/MinecraftForge/Documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/MinecraftForge/Documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/MinecraftForge/Documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/MinecraftForge/Documentation/contents/{+path}","compare_url":"https://api.github.com/repos/MinecraftForge/Documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/MinecraftForge/Documentation/merges","archive_url":"https://api.github.com/repos/MinecraftForge/Documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/MinecraftForge/Documentation/downloads","issues_url":"https://api.github.com/repos/MinecraftForge/Documentation/issues{/number}","pulls_url":"https://api.github.com/repos/MinecraftForge/Documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/MinecraftForge/Documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/MinecraftForge/Documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/MinecraftForge/Documentation/labels{/name}","releases_url":"https://api.github.com/repos/MinecraftForge/Documentation/releases{/id}","deployments_url":"https://api.github.com/repos/MinecraftForge/Documentation/deployments","created_at":"2015-04-20T03:34:18Z","updated_at":"2016-08-06T17:21:39Z","pushed_at":"2016-08-09T22:03:10Z","git_url":"git://github.com/MinecraftForge/Documentation.git","ssh_url":"git@github.com:MinecraftForge/Documentation.git","clone_url":"https://github.com/MinecraftForge/Documentation.git","svn_url":"https://github.com/MinecraftForge/Documentation","homepage":null,"size":355,"stargazers_count":76,"watchers_count":76,"language":null,"has_issues":true,"has_downloads":true,"has_wiki":true,"has_pages":false,"forks_count":33,"mirror_url":null,"open_issues_count":4,"forks":33,"open_issues":4,"watchers":76,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58"},"html":{"href":"https://github.com/MinecraftForge/Documentation/pull/58"},"issue":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/issues/58"},"comments":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/issues/58/comments"},"review_comments":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58/comments"},"review_comment":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/pulls/58/commits"},"statuses":{"href":"https://api.github.com/repos/MinecraftForge/Documentation/statuses/cab14f60a23d52e700fd6c0f55d0c08133c081af"}}}}
{"actor":{"display_login":"howtonotwin"}}