搬运一批Bedrock wiki内容,完善翻译

This commit is contained in:
boybook
2025-03-20 00:13:44 +08:00
parent ead7392a76
commit 4896c1a4f2
163 changed files with 33930 additions and 1464 deletions

View File

@@ -0,0 +1,156 @@
---
title: Intro to Items
description: A "Hello world" guide in making items. Learn the item format and how to create basic custom items.
category: General
nav_order: 1
tags:
- guide
- beginner
mentions:
- SirLich
- solvedDev
- Joelant05
- yanasakana
- destruc7ion
- aexer0e
- stirante
- ChibiMango
- MedicalJewel105
- Sprunkles317
- mark-wiemer
- TheItsNameless
- s1050613
- SmokeyStack
---
Minecraft Bedrock allows us to add custom items into our world with various vanilla-like properties
This tutorial will cover how to create basic items for the stable version of Minecraft.
## Registering Items
Item definitions are structured similarly to entities: they contain a description and a list of components that defines the item's behavior.
Below is the **minimum** behavior-side code to get a custom item into the creative inventory.
<CodeHeader>BP/items/custom_item.json</CodeHeader>
```json
{
"format_version": "1.20.50",
"minecraft:item": {
"description": {
"identifier": "wiki:custom_item",
"menu_category": {
"category": "construction"
}
},
"components": {} // Must be here, even if empty!
}
}
```
### Item Description
- Defines the item's identifier - a unique ID in the format of `namespace:identifier`.
- Configures which `menu_category` the item is placed into.
- Also takes the optional parameters `group` and `is_hidden_in_commands`.
## Adding Components
Right now, our custom item is using the default component values (which can be found [here](/items/item-components)).
Let's configure our own functionality!
<CodeHeader>BP/items/custom_item.json</CodeHeader>
```json
{
"format_version": "1.20.50",
"minecraft:item": {
"description": {
"identifier": "wiki:custom_item",
"menu_category": {
"category": "construction"
}
},
"components": {
"minecraft:damage": {
"value": 10
},
"minecraft:durability":{
"max_durability": 36
},
"minecraft:hand_equipped": {
"value": true
}
}
}
}
```
Browse more item components [here](/items/item-components)!
## Applying Textures
We need to create a texture shortname to link it to an image in `RP/textures/item_texture.json`.
<CodeHeader>RP/textures/item_texture.json</CodeHeader>
```json
{
"resource_pack_name": "wiki",
"texture_name": "atlas.items",
"texture_data": {
"custom_item": {
"textures": "textures/items/custom_item"
}
}
}
```
In our item file, we will add the `minecraft:icon` component to apply the texture.
<CodeHeader>BP/items/custom_item.json</CodeHeader>
```json
{
"format_version": "1.20.50",
"minecraft:item": {
"description": {
"identifier": "wiki:custom_item",
"menu_category": {
"category": "construction"
}
},
"components": {
"minecraft:icon": {
"texture": "custom_item"
}
}
}
}
```
## Defining Names
Finally, we will give our item a name. Additionally, you can use the [Display Name](/items/item-components#display_name) component.
<CodeHeader>RP/texts/en_US.lang</CodeHeader>
```c
tile.wiki:custom_item.name=Custom Item
```
## Result
In this page, you've learnt about the following:
<Checklist>
- [x] Basic features of items
- [x] How to apply a texture
- [x] How to link textures using shortnames in `item_textures.json`
- [x] How to define names in the language file
</Checklist>