完整版BedrockWiki镜像！
This commit is contained in:
boybook
@@ -1,8 +1,8 @@
|
||||
---
|
||||
title: Custom Weapons
|
||||
category: Tutorials
|
||||
title: 自定义武器
|
||||
category: 巧思案例
|
||||
tags:
|
||||
- experimental
|
||||
- 实验性
|
||||
mentions:
|
||||
- SirLich
|
||||
- solvedDev
|
||||
@@ -13,49 +13,52 @@ mentions:
|
||||
- Xterionix
|
||||
---
|
||||
|
||||
Making a custom weapon is pretty simple since the 1.16.100 changes, as these allow you to simply define an item entry for it in your `BP/items` folder and provide a corresponding texture in the `RP/textures/items` folder with a bit of config and you have a fully working weapon that you can customize however you see fit.
|
||||
# 自定义武器
|
||||
|
||||
## Custom Sword Item
|
||||
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
|
||||
|
||||
Like with the other item tutorials we will start by making a simple custom sword like so.
|
||||
自1.16.100版本更新以来，制作自定义武器变得非常简单。您只需在`BP/items`文件夹中定义物品条目，并在`RP/textures/items`文件夹中提供相应纹理，稍作配置即可获得功能完整的可定制武器。
|
||||
|
||||
<CodeHeader>BP/items/my_sword.json</CodeHeader>
|
||||
## 自定义剑类物品
|
||||
|
||||
```json
|
||||
与其他物品教程类似，我们先从制作基础剑类物品开始。
|
||||
|
||||
::: code-group
|
||||
```json [BP/items/my_sword.json]
|
||||
{
|
||||
"format_version": "1.16.100",
|
||||
"minecraft:item": {
|
||||
"description": {
|
||||
"identifier": "wiki:my_sword",
|
||||
// Notice we give it the equipment category
|
||||
// 注意我们将其归类为装备
|
||||
"category": "equipment"
|
||||
},
|
||||
"components": {
|
||||
// This allows us to have the sword in the creative category of swords
|
||||
// 这样可以将剑放置在创造模式下的剑类物品栏中
|
||||
"minecraft:creative_category": {
|
||||
"parent": "itemGroup.name.sword"
|
||||
},
|
||||
"minecraft:max_stack_size": 1,
|
||||
// This is a new change as we want it to be equippable in the hand
|
||||
// 新增配置使物品可手持
|
||||
"minecraft:hand_equipped": true,
|
||||
"minecraft:durability": {
|
||||
"max_durability": 600
|
||||
},
|
||||
// Give it however much damage you want
|
||||
// 按需设置伤害值
|
||||
"minecraft:damage": 10,
|
||||
// We also let it be enchantable in the "sword" slot
|
||||
// 允许在"sword"槽位附魔
|
||||
"minecraft:enchantable": {
|
||||
"value": 10,
|
||||
"slot": "sword"
|
||||
},
|
||||
// This texture is used for both inventory and the hand model
|
||||
// 该纹理同时用于物品栏和手持模型
|
||||
"minecraft:icon": {
|
||||
"texture": "my_sword"
|
||||
},
|
||||
"minecraft:display_name": {
|
||||
"value": "My Custom Sword"
|
||||
"value": "我的自定义剑"
|
||||
},
|
||||
// Allow the sword to be repaired with sticks
|
||||
// 允许使用木棍修复
|
||||
"minecraft:repairable": {
|
||||
"repair_items": [
|
||||
{
|
||||
@@ -69,50 +72,44 @@ Like with the other item tutorials we will start by making a simple custom sword
|
||||
}
|
||||
```
|
||||
|
||||
So at a bare minimum that is enough to get a sword put into the game, we still need to register the icon with the RP but thats not a massive issue as all we need to do is go to our RP folder and enter it in like so.
|
||||
|
||||
<CodeHeader>RP/textures/item_texture.json</CodeHeader>
|
||||
|
||||
```json
|
||||
```json [RP/textures/item_texture.json]
|
||||
{
|
||||
"resource_pack_name": "vanilla",
|
||||
"texture_name": "atlas.items",
|
||||
"texture_data": {
|
||||
"my_sword": {
|
||||
// Make sure you have put an icon texture called my_sword.png here
|
||||
// 确保已添加名为my_sword.png的纹理
|
||||
"textures": "textures/items/my_sword"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
Here is an example texture if you do not have your own to use, just `Save As` and plop it in the `RP/textures/items` directory.
|
||||
若需示例纹理，可将下方图片另存为`my_sword.png`并放入`RP/textures/items`目录。
|
||||
|
||||
|
||||
|
||||
<BButton link="https://raw.githubusercontent.com/Bedrock-OSS/bedrock-wiki/wiki/docs/public/assets/images/tutorials/custom-weapons/my_sword.png">Download texture here</BButton>
|
||||
<BButton link="https://raw.githubusercontent.com/Bedrock-OSS/bedrock-wiki/wiki/docs/public/assets/images/tutorials/custom-weapons/my_sword.png">点击此处下载纹理</BButton>
|
||||
|
||||
## In-game
|
||||
## 游戏内效果
|
||||
|
||||
So now we have a BP containing our items json data and an RP containing the texture, we can make a new level, and make sure we include our BP/RP, however we **also need to enable the Holiday Creator Features** under experimental gameplay.
|
||||
完成BP物品配置和RP纹理添加后，创建新世界时需加载这两个包，并**在实验性玩法中启用假日创作者功能**。
|
||||
|
||||
Once you have done all the above, go into creative mode and you should be able to find your sword by its name, or under the sword category as shown.
|
||||
进入创造模式后，可通过名称搜索或剑类物品栏找到您的自定义武器。
|
||||
|
||||
|
||||
|
||||
Then if you put it in your hands you should see it in the game like this.
|
||||
手持时效果如下：
|
||||
|
||||
|
||||
|
||||
Now that wasn't too hard was it! and you can make as many custom swords as you want now, however there is far more fun stuff you can do from here if you feel up for it.
|
||||
## 工具类功能扩展
|
||||
|
||||
## Tool-like Functionality
|
||||
可通过添加`minecraft:digger`等组件实现特殊挖掘功能：
|
||||
|
||||
You can also mix and match other components like `minecraft:digger` to allow you to go through web or bamboo quicker like this:
|
||||
|
||||
<CodeHeader>BP/items/my_sword.json#components</CodeHeader>
|
||||
|
||||
```json
|
||||
::: code-group
|
||||
```json [BP/items/my_sword.json#components]
|
||||
"minecraft:digger": {
|
||||
"use_efficiency": true,
|
||||
"destroy_speeds": [
|
||||
@@ -127,51 +124,36 @@ You can also mix and match other components like `minecraft:digger` to allow you
|
||||
],
|
||||
"on_dig":{
|
||||
"event": "wiki:my_sword.on_dig_damage"
|
||||
//Needed to change sword durability
|
||||
// 用于改变武器耐久度
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Also add an event:
|
||||
|
||||
<CodeHeader>BP/items/my_sword.json</CodeHeader>
|
||||
|
||||
```json
|
||||
```json [BP/items/my_sword.json]
|
||||
"events": {
|
||||
"wiki:my_sword.on_dig_damage": {
|
||||
"damage":{
|
||||
//This part of event will make sword take damage when it was used to dig block
|
||||
// 该事件会使武器在挖掘时损耗耐久
|
||||
"type":"durability",
|
||||
"target":"self",
|
||||
//By using "self" you define item as target to take damage
|
||||
// 使用"self"指定物品自身承受损耗
|
||||
"amount":1
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
You can also give it a default mining speed by adding `"minecraft:mining_speed": 1.5`, which would give it a generic mining speed letting you use your weapon like a pickaxe.
|
||||
(It is currently broken)
|
||||
## 伤害数值显示
|
||||
|
||||
## Damage Tooltip
|
||||
添加`"minecraft:weapon": {}`组件可在物品提示中显示攻击伤害值。
|
||||
|
||||
The above was a bare bones approach, but you probably want to be able to show the damage a sword does when the user hovers over it.
|
||||
## 特殊能力与耐久系统
|
||||
|
||||
To do this you need to add the `"minecraft:weapon": {}` component, even if its just empty this is enough to MC to know internally to treat your popup like a weapon popup when mouse over-ing.
|
||||
通过武器组件触发事件实现特殊效果：
|
||||
|
||||
So if you add the above component to your item json file when you mouse over your sword you will now see **+10 Attack Damage** listed in its tooltip.
|
||||
|
||||
> You may be thinking "why didn't you just add this above?" and the answer is because we will build off this component to add more cool stuff in the next section, so I wanted to keep it separate.
|
||||
|
||||
## Unique ability & durability
|
||||
|
||||
At this point you could call it a day, but what if you wanted to make a sword that could inflict status effects, or teleport an enemy when they attacked you?
|
||||
|
||||
Assuming you wanted to do something like this we will need to build off the `minecraft:weapon` component and raise an event when the weapon hits an entity.
|
||||
|
||||
<CodeHeader>BP/items/my_sword.json#components</CodeHeader>
|
||||
|
||||
```json
|
||||
::: code-group
|
||||
```json [BP/items/my_sword.json#components]
|
||||
"minecraft:weapon": {
|
||||
"on_hurt_entity": {
|
||||
"event": "wiki:my_sword.hurt_entity"
|
||||
@@ -179,49 +161,35 @@ Assuming you wanted to do something like this we will need to build off the `min
|
||||
}
|
||||
```
|
||||
|
||||
Once we add that then every time you hurt an entity it will raise the event `wiki:my_sword.hurt_entity`. You can name this whatever you want, but if you end up with lots of events its recommended to have some level of namespacing, so in this scenario `example` is my main namespace, `my_sword` is the item I want it to apply on and `hurt_entity` is the related event on that item.
|
||||
|
||||
> I could just as easily call the event **"space-noodle"** and it would work fine, but you want it to be easily searchable and self explaining, so keep that in mind
|
||||
|
||||
Now that we have an event being raised we can do what we want with it. In this example I am going to do 3 things:
|
||||
1. Teleport the player with 25% chance.
|
||||
2. Output a message letting the player know that something happened.
|
||||
3. Damage the sword.
|
||||
|
||||
So if you go back into your my_sword.json and after your `components` section add a new section like so.
|
||||
|
||||
<CodeHeader>BP/items/my_sword.json</CodeHeader>
|
||||
|
||||
```json
|
||||
```json [BP/items/my_sword.json]
|
||||
"events": {
|
||||
"wiki:my_sword.hurt_entity": {
|
||||
"sequence":[
|
||||
//Sequence is needed to run two or more parts of event
|
||||
{
|
||||
"randomize": [
|
||||
{
|
||||
// Weights are relative, so this has 1
|
||||
// 权重值为1
|
||||
"weight": 1,
|
||||
// Teleport the HOLDER (you) within an 8x8x8 range
|
||||
// 在8x8x8范围内传送持有者
|
||||
"teleport": {
|
||||
"target": "holder",
|
||||
"max_range": [8,8,8]
|
||||
},
|
||||
// Then tell some green text
|
||||
// 显示提示文本
|
||||
"run_command":{
|
||||
"command":[
|
||||
"tellraw @s{\"rawtext\":[{\"text\":\"§aYour Sword Glows§r\"}]}"
|
||||
"tellraw @s{\"rawtext\":[{\"text\":\"§a剑身发出光芒§r\"}]}"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
// We have another dummy random element here which contains the max weight
|
||||
// 占位权重值
|
||||
"weight": 3
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
// I think you haven't forgot what this do
|
||||
// 损耗武器耐久度
|
||||
"damage":{
|
||||
"type":"durability",
|
||||
"target":"self",
|
||||
@@ -232,20 +200,12 @@ So if you go back into your my_sword.json and after your `components` section ad
|
||||
}
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
That was a bit to bite off, but as explained above this lets us randomly **1/4** of the time trigger a teleportation of the sword holder and show a text command when it happens.
|
||||
## 合成配方示例
|
||||
|
||||
You can do whatever you want here and get super creative, set enemies on fire, or spawn enemies or blocks etc. There is so much you can do with this basic approach to creating weapons!
|
||||
|
||||
> It's worth noting here that the dummy element is needed to scale the weightings, so we have one element with a weight of **1** and a 2nd one with a weight of **4** so this gives us the **1 in 4** chance of it proccing. If we were to have gone with the dummy element having a weight of **100** then we would have a **1 in 100** chance of proccing. If we didn't have a 2nd dummy element then the first weight would be ignored and it would happen 100% of the time.
|
||||
|
||||
## Anything Else?
|
||||
|
||||
You should probably make a recipe for it, which is covered in previous chapters, as there isn't anything really new in there, but incase you are unsure here is an example one to make the sword with ender eyes and ender pearls.
|
||||
|
||||
<CodeHeader>BP/recipes/my_sword.json</CodeHeader>
|
||||
|
||||
```json
|
||||
::: code-group
|
||||
```json [BP/recipes/my_sword.json]
|
||||
{
|
||||
"format_version": "1.12.0",
|
||||
"minecraft:recipe_shaped": {
|
||||
@@ -271,7 +231,8 @@ You should probably make a recipe for it, which is covered in previous chapters,
|
||||
}
|
||||
}
|
||||
```
|
||||
:::
|
||||
|
||||
|
||||
|
||||
If you whack that in then you can now craft your sword in the game and hopefully go off and make any other custom swords you fancy or even bows or tridents.
|
||||
现在您已掌握制作自定义武器的基本方法，可以尝试扩展更多创意功能！
|
||||
Reference in New Issue
Block a user