xiaokun/netease-modsdk-wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

完整版BedrockWiki镜像！

Browse Source
This commit is contained in:
boybook
2025-03-20 11:52:46 +08:00
parent 1994c41f01
commit bf9aa4b056
214 changed files with 9042 additions and 8867 deletions
Download Patch File Download Diff File Expand all files Collapse all files

29
docs/wiki/particles/disabling-particles.md
View File

@@ -1,21 +1,24 @@
---
title: Disabling Particles
category: Tutorials
title: 禁用粒子效果
category: 巧思案例
tags:
- beginner
- 新手
mentions:
- SirLich
- Joelant05
- MedicalJewel105
---
In the event that you want to disable a particle, it is recommended to do so from the particle file itself as opposed to simply making the particle texture transparent in `particles.png`. Additionally, disabling a particle might offer a slight performance boost compared to making it transparent, as transparent particles are still emitted (but not visible).
# 禁用粒子效果
The basic idea of disabling a particle from emitting is as follows:
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
<CodeHeader>RP/particles/some_vanilla_particle.json</CodeHeader>
当你需要禁用某个粒子效果时，建议直接在粒子文件中进行禁用，而不是简单地在 `particles.png` 中将粒子纹理设为透明。此外，与透明化处理相比，完全禁用粒子可能会带来小幅性能提升，因为透明粒子仍会被发射（只是不可见）。
```json
禁用粒子发射的基本原理如下：
::: code-group
```json [RP/particles/some_vanilla_particle.json]
{
"format_version": "1.10.0",
"particle_effect": {
@@ -28,13 +31,19 @@ The basic idea of disabling a particle from emitting is as follows:
},
"components": {
"minecraft:emitter_lifetime_expression": {
"activation_expression": 0,
"expiration_expression": 1
"activation_expression": 0, // 立即激活
"expiration_expression": 1 // 立即结束生命周期（单位：秒）
},
"minecraft:emitter_rate_manual": {
"max_particles": 0
"max_particles": 0 // 设置最大粒子生成数为0
}
}
}
}
```
:::
**实现原理说明：**
1. 通过 `emitter_lifetime_expression` 组件将粒子发射器的生命周期设为瞬时（0秒激活，1秒后过期）
2. 使用 `emitter_rate_manual` 组件将最大粒子数设为0，彻底阻止粒子生成
3. 保留原始渲染参数确保兼容性，但实际不会产生任何可见粒子

8
docs/wiki/particles/index.md
View File

@@ -1,10 +1,10 @@
---
title: Particles
title: 粒子 Particles
categories:
- title: General
- title: 基础
color: blue
- title: Tutorials
- title: 巧思案例
color: green
- title: Documentation
- title: 文档
color: red
---

176
docs/wiki/particles/particles-and-sounds.md
View File

@@ -1,8 +1,8 @@
---
title: 'Particles and Sounds'
category: General
title: '粒子与音效'
category: 基础
tags:
- outdated
- 已过时
mentions:
- SirLich
- Joelant05
@@ -12,69 +12,71 @@ mentions:
- solvedDev
---
# 粒子与音效
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
:::danger
Some information from this page was copied [here](/visuals/animation-effects)
本页部分信息已迁移至[动画效果文档](/wiki/visuals/animation-effects)
:::
## Particles in Animation
## 动画中的粒子效果
Minecraft Particles can be used in entity animations. For example, the phantom has an animation which emits the minecraft:phantom_trail particle constantly. Let's try to add a particle to our entity's attack animation.
Minecraft粒子效果可以应用于实体动画。例如，幻翼拥有持续释放minecraft:phantom_trail粒子的动画。让我们尝试在实体的攻击动画中添加粒子效果。
`part of RP/entity/description/`
`资源包/entity/description/ 目录下`
<CodeHeader></CodeHeader>
```json
::: code-group
```json [实体描述文件示例]
"particle_effects": {
"l_explosion": "minecraft:large_explosion"
},
```
:::
This piece of code is located in our resource entity file. Here we defined the shortname ("l_explosion") for the particle we are going to use, "minecraft:large_explosion".
这段代码位于资源包实体文件中。这里我们为将要使用的粒子"minecraft:large_explosion"定义了一个简称"l_explosion"。
You can test a particle in-game with the `/particle <namespace:particle_id> ~ ~2 ~` command. You can view the full list of Vanilla Particles [here](https://minecraft.wiki/w/Particles).
可以通过指令`/particle <命名空间:粒子ID> ~ ~2 ~`在游戏中测试粒子效果。完整原版粒子列表可参考[Minecraft Wiki](https://minecraft.wiki/w/Particles)。
Now for the Blockbench part.
现在进行Blockbench操作：
- Right click the bone were your particle will be emitted from, and choose 'Add Locator' with the anchor icon. Name it something distinct, like 'l_expl_emitter'. Now move the emitter to the desired location.
1. 右键点击要发射粒子的骨骼，选择锚点图标添加定位器，命名如"l_expl_emitter"，并移动到目标位置
![](/assets/images/guide/custom_particles_1.png)
_Note: you can also use locators to define where a lead will leash to, if you name your locator 'lead'._
_注：命名为'lead'的定位器可定义栓绳连接点_
- In the 'Animate' section, choose 'Animate Effects' on your timeline, then click on the '+' icon near the 'Particle' object.
2. 在动画时间轴中选择"Animate Effects"，点击粒子对象旁的+号
![](/assets/images/guide/custom_particles_2.png)
- You will see this menu on your left. 'Effect' asks for your particle's shortname, and 'Locator' asks for the name of your Locator/Emitter object.
3. 左侧面板中填写粒子简称和定位器名称
![](/assets/images/guide/custom_particles_3.png)
_Note: you can add sounds to animations in a similar way._
_注：音效添加方式类似_
![](/assets/images/guide/custom_particles_4.jpg)
Now you're good to go! Save the model and the animations. If you did everything correctly, the defined particle will spawn whenever the entity attacks. _Of course you could put another particle on the walking animation's timeline (for example, hooves making dust) in the same way._
完成保存后，实体攻击时将生成指定粒子效果。_同理可在行走动画中添加蹄印扬尘效果_
## Custom Particles
## 自定义粒子
Custom particles are defined in the `RP/particles` folder. As mentioned earlier on this page, you can summon particles using the '/particle' command (e.g in Behavior Animations) or using Resource Animation emitters. The best way to learn custom particles is to play around with the example files from the [Vanilla Example resource pack](https://www.minecraft.net/en-us/addons) and the Particle Example Pack, and of course, from the documentation on [bedrock.dev](http://bedrock.dev/r/Particles).
自定义粒子定义于`RP/particles`目录。可通过指令或动画发射器调用。建议通过[原版示例资源包](https://www.minecraft.net/en-us/addons)和[bedrock.dev粒子文档](http://bedrock.dev/r/Particles)学习。
_Note: Skip to the end of this section for a tool to generate particle files visually._
_提示：文末提供可视化粒子生成工具_
File structure:
- "identifier" is exactly what you'd expect: I'll use "wiki:curvy_particle" and "wiki_pink_hit" for the tutorial. File names do not matter.
- "texture" defines the texture file. Not that a single image file can hold textures for many particles.
- "material" is usually set to "particles_alpha" for particles.
文件结构说明：
- "identifier"：粒子标识符（示例使用"wiki:curvy_particle"）
- "texture"：支持多粒子共用纹理图集
- "material"：通常设为"particles_alpha"
![](/assets/images/guide/custom_particles_5.png)
That is the texture I'm going to use, it's size is `16x16`. (`RP/particles/wiki_particles.png`). As you can see, it has 4 different textures in it, each of them being a `8x8`. The upper row (_starting/top left corner at at 0, 0_) is the flipbook texture for "wiki:curvy*particle" and the bottom row (\_top left corner at/starting at 0, 8*). We'll define this in the "billboard_texture" component.
使用16x16纹理图集（路径：`RP/particles/wiki_particles.png`），包含4个8x8子纹理。上排（0,0起始）用于"wiki:curvy_particle"，下排（0,8起始）用于其他粒子。
<CodeHeader>RP/particles/curvy_particle.json</CodeHeader>
```json
::: code-group
```json [RP/particles/curvy_particle.json]
{
"format_version": "1.10.0",
"particle_effect": {
@@ -131,22 +133,17 @@ That is the texture I'm going to use, it's size is `16x16`. (`RP/particles/wiki_
}
}
```
:::
Here's the code for our first particle, "wiki:curvy_particle". Our texture file is defined.
参数解析：
- "texture_width/height"：纹理图尺寸
- "base_UV"：粒子起始坐标（示例下个粒子为[0,8]）
- "size_UV"：粒子纹理尺寸
- "step_UV"：帧切换步长
- "frames_per_second"：帧速率
The components are quite complicated here, but they're explained well on the [Particle doc](http://bedrock.dev/r/Particles). Let's move forward to the `"minecraft:particle_appearance_billboard"` component for now.
- "texture_width" and "texture_height" defines the size of the image file itself.
- "base_UV" in "flipbook" defines the top-left corner of the particle texture. For this particle it's at 0, 0, which is the upper left corner of the image itself. For the second particle, "wiki:pink_hit", "base_UV" will be at 0, 8, which is 8 pixels lower then the first location.
- "size_UV" defines the size of the particle's texture(8*8) on the image file(which is 16*16).
- "step_UV" is how far the flipbook needs to step in order to get the next particle texture. In this case it's 8, 0, which is 8 pixels to the right.
- "frames_per_second" is quite self-explainable. "max_frame" is the total number of frames for the particle.
The second particle, "wiki:pink_hit".
<CodeHeader>RP/particles/pink_hit.json</CodeHeader>
```json
::: code-group
```json [RP/particles/pink_hit.json]
{
"format_version": "1.10.0",
"particle_effect": {
@@ -220,10 +217,9 @@ The second particle, "wiki:pink_hit".
}
}
```
:::
Done! Now you have two custom particles that can be used in animations!
It's rather tiresome to create particles that way, comparable to creating models without Blockbench. Luckily, you can use [Snowstorm](https://jannisx11.github.io/snowstorm/), a Visual Particle Generator. It's especially convenient to download the [VSC Snowstorm Extension](https://marketplace.visualstudio.com/items?itemName=JannisX11.snowstorm), which is going to create an interactive UI in Visual Studio Code itself for `.particle.json` files.
建议使用可视化工具[Snowstorm](https://jannisx11.github.io/snowstorm/)或[VSC扩展](https://marketplace.visualstudio.com/items?itemName=JannisX11.snowstorm)简化粒子创建。
![](/assets/images/guide/custom_particles_6.jpg)
`/particle wiki:pink_hit ~ ~2 ~`
@@ -233,21 +229,19 @@ It's rather tiresome to create particles that way, comparable to creating models
---
## Defining Custom Sounds
## 自定义音效
_You can find a more in-depth tutorial on custom sounds on [wiki.bedrock.dev](/concepts/sounds)._
详细教程参见[Bedrock开发Wiki](/wiki/concepts/sounds)
Minecraft can read sound files in the `.ogg` (recommended) or `.wav` format. (You can look up an .mp3 to .ogg converter online). Personally, I usually get my sound effects from ZapSplat.com.
### 文件规范
- 格式：推荐.ogg，支持.wav
- 路径：`RP/sounds/`子目录（示例使用`RP/sounds/mob/`）
Sound files are located in subfolders of the `RP/sounds/` folder. My skele_yaklin sound files are located under `RP/sounds/mob/yaklin_moo.ogg` and `RP/sounds/mob/yaklin_moo_2.ogg`. (I don't have more sound effects currently, thus I will be using same ones over and over, but ideally one would need more of those).
### 音效定义
在`RP/sounds/sound_definitions.json`中注册：
### Sound Definition
Now to define the sound's shortnames! This process is similar to defining block texture shortnames. It's done in `RP/sounds/sound_definitions.json`.
<CodeHeader>RP/sounds/sound_definitions.json</CodeHeader>
```json
::: code-group
```json [RP/sounds/sound_definitions.json]
{
"format_version": "1.14.0",
"sound_definitions": {
@@ -269,30 +263,16 @@ Now to define the sound's shortnames! This process is similar to defining block
}
}
```
:::
We have 3 sound shortnames in total:
### 音效绑定
通过`RP/sounds.json`关联实体事件：
1. `mob.yaklin.idle`, which refers to a random sound file from the "sounds": [] array.
1. `mob.yaklin.death` can be heard from the distance of 12 blocks: `max_distance": 12.0`.
1. And, lastly, `mob.yaklin.hurt`.
### sounds.json
Now we are about to call our sounds. We can do it either through the `/playsound <>` slash command or automatically in `RP/sounds.json`. Once again, this resembles block resource definition.
![](/assets/images/guide/custom_particles_8.png)
^ the file's structure. I recommend checking out the same file in the Example Resource Pack.
<CodeHeader>RP/sounds.json/"entities": {}/"wiki:skele_yaklin": {}</CodeHeader>
```json
::: code-group
```json [实体音效配置示例]
"wiki:skele_yaklin": {
"volume": 1.0,
"pitch": [
1.0,
1.0
],
"pitch": [1.0, 1.0],
"events": {
"ambient": "mob.yaklin.idle",
"hurt": "mob.yaklin.hurt",
@@ -305,32 +285,24 @@ Now we are about to call our sounds. We can do it either through the `/playsound
}
}
```
:::
Let's see how the sounds of the skele_yaklin are called in the entity's object.
- The first "volume" and "pitch" are global, they are the starting point for every other of the entity's sounds. If you want the sounds to play exactly how they are, set both of them to 1;
- "events" include the automatic sounds to be played. There are a couple Vanilla events that will trigger automatically(you can see the whole list on the wiki.bedrock.dev page linked bove). All of the events call a sound's shortname.
- "ambient" plays occasionally, for example the sheep "baah" sound.
- "hurt" plays when the entity is hurt.
- "death" plays on death.
- "step" is the sound of the mob walking. I used the cow step sound, already included in the base game.
That's it! Turn up your Sound volume in Settings>Audio, spawn in your mobs, and listen to the melodic cacophony of their new voices!
事件类型说明：
- ambient：环境音（如生物呼吸声）
- hurt：受伤音效
- death：死亡音效
- step：移动音效
---
---
## 进度总结
## Your progress so far
**已完成：**
- 掌握动画粒子效果实现
- 创建两种自定义粒子
- 配置实体自定义音效
**What you've done:**
- Learned to include Particles in Animations
- Created two Custom Particles and learned to create more
- Defined custom Sounds for your custom entity;
**What are you to do next:**
- Create custom biomes
- Create custom generated Structures
- Be introduced to Scripting
**后续方向：**
- 自定义生物群系
- 创建生成结构
- 脚本系统入门

52
docs/wiki/particles/particles.md
View File

@@ -1,43 +1,47 @@
---
title: 'Intro to Particles'
category: General
title: '粒子系统入门'
category: 基础
tags:
- guide
- 指南
mentions:
- SirLich
- MedicalJewel105
- TheItsNameless
---
## Particle Systems
# 粒子系统入门
A [particle system](https://www.wikiwand.com/en/Particle_system) is a technique in game physics, motion graphics, and computer graphics that uses many small sprites to create convincing effects such as smoke, fire, or swarms of insects. You can create new particle systems in the Bedrock Edition of Minecraft by using your own custom textures, and your own movement logic. This makes particles extremely fun and powerful!
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
The Molang integration in particles is also extremely well developed, which allows you to pass data between different particles, or between an entity and a particle.
## 粒子系统
### Particles
[粒子系统](https://www.wikiwand.com/en/Particle_system)是游戏物理、动态图形和计算机图形学中的一种技术，通过大量小精灵图（sprite）来创建逼真的效果，如烟雾、火焰或昆虫群。在《我的世界》基岩版中，你可以使用自定义贴图和运动逻辑来创建新的粒子系统，这使得粒子效果既有趣又强大！
A 'particle', or a 'particle instance' is a single sprite (texture) which is placed in 3D space, and has its own logic for how to move about and change its appearance. Some examples of a particle could include:
粒子系统中Molang的集成非常完善，允许你在不同粒子之间，或在实体与粒子之间传递数据。
- A single snowflake
- A single raindrop
- A single wisp of smoke
### 粒子
### Emitters
"粒子"或"粒子实例"是放置在3D空间中的单个精灵图（纹理），具有独立的运动逻辑和外观变化规则。常见的粒子示例包括：
An 'emitter' or 'particle emitter' is a system that can spawn many particles, either all at once (explosion), or over time (steady). Emitters have their own logic for how to move, how many particles to spawn, and where. Some examples of emitters could include:
- 一片雪花
- 一滴雨水
- 一缕烟雾
- A snowstorm (creates snowflakes)
- A rainstorm (creates raindrops)
- A smokey chimney (creates smoke wisps)
### 发射器
## Creating your First Particle
"发射器"或"粒子发射器"是能够生成多个粒子的系统，可以瞬间生成（爆炸效果）或持续生成（稳定效果）。发射器拥有独立的移动逻辑、粒子生成数量和位置控制机制。常见的发射器示例包括：
To create a particle, you need a resource pack, a texture, and a particle definition file:
- 暴风雪（生成雪花）
- 暴雨（生成雨滴）
- 冒烟的烟囱（生成烟缕）
<FolderView
:paths="[
'RP/particles/snowflake.json',
'RP/textures/particles/snowflake.png'
]"
> </FolderView>
## 创建第一个粒子
创建粒子需要准备资源包、纹理贴图和粒子定义文件：
::: code-group
```txt [文件结构]
RP/particles/snowflake.json
RP/textures/particles/snowflake.png
```
:::

146
docs/wiki/particles/vanilla-particles.md
View File

@@ -1,21 +1,25 @@
---
title: Vanilla Particles
category: Documentation
title: 原版粒子效果
category: 文档
---
Here is the complete list of Bedrock particles from the vanilla resources. Please be aware that not all of these particles function properly, as many require molang context from their host entity.
# 原版粒子效果
:::tip Playing via /particle:
For some reason, Bedrock requires the leading `minecraft` namespace, and the coordinates in the `/particle` command.
<!--@include: @/wiki/bedrock-wiki-mirror.md-->
It doesn't have autocomplete for particles.
以下是基岩版原版资源中所有粒子效果的完整列表。请注意并非所有粒子都能正常运作，许多粒子需要宿主实体提供的Molang上下文才能正确运行。
:::tip 通过/particle命令使用：
由于某些原因，基岩版需要在`/particle`命令中使用带有`minecraft:`命名空间的完整粒子名称，并且需要指定坐标参数。
该命令不支持粒子的自动补全功能。
:::
### Working Particles
### 正常工作的粒子效果
These particles can be spawned directly in-world, without any issues.
这些粒子可以直接在游戏中生成，不会出现异常问题。
| Working Particles |
| 正常工作的粒子效果 |
| ------------------------------------------- |
| minecraft:basic_flame_particle |
| minecraft:basic_portal_particle |
@@ -79,12 +83,12 @@ These particles can be spawned directly in-world, without any issues.
| minecraft:water_evaporation_bucket_emitter |
| minecraft:water_splash_particle_manual |
### Particles with Issues
### 存在问题的粒子效果
The following particles can be spawned, but might spam you with content log errors because they rely on variables that `/particle` cannot set:
以下粒子可以生成，但可能因依赖`/particle`命令无法设置的变量而导致内容日志报错：
| Particles with issues |
| ----------------------------------------------- |
| 存在问题的粒子效果 |
| ------------------------------------------- |
| minecraft:arrow_spell_emitter |
| minecraft:balloon_gas_particle |
| minecraft:basic_crit_particle |
@@ -118,12 +122,12 @@ The following particles can be spawned, but might spam you with content log erro
| minecraft:wax_particle |
| minecraft:wither_boss_invulnerable |
### Bubble Particles
### 气泡类粒子效果
The following particles are various bubbles that only show up underwater. Some of them spam content log errors:
以下气泡类粒子仅在水下可见，部分会导致内容日志报错：
| Bubble particles |
| -------------------------------------- |
| 气泡类粒子效果 |
| ------------------------------------- |
| minecraft:basic_bubble_particle |
| minecraft:basic_bubble_particle_manual |
| minecraft:bubble_column_bubble |
@@ -144,23 +148,23 @@ The following particles are various bubbles that only show up underwater. Some o
| minecraft:squid_move_particle |
| minecraft:underwater_torch_particle |
### Permanent Particles
### 永久性粒子效果
The following particles are permanent and will not be removed once spawned until you exit the game:
以下粒子效果一旦生成将永久存在，除非退出游戏：
| Permanent particles |
| -------------------------------- |
| 永久性粒子效果 |
| ----------------------------- |
| minecraft:mobflame_emitter |
| minecraft:nectar_drip_particle |
| minecraft:phantom_trail_particle |
| minecraft:stunned_emitter |
## Broken Particles
## 无法正常使用的粒子效果
The following particles exist in-game but cannot be spawned because they require context that cannot be provided by `/particle` or are simply bugged:
以下粒子虽然存在于游戏中，但由于需要无法通过`/particle`提供的上下文或存在程序错误而无法生成：
| Broken particles |
| -------------------------------- |
| 无法正常使用的粒子效果 |
| ----------------------------- |
| minecraft:block_destruct |
| minecraft:block_slide |
| minecraft:breaking_item_icon |
@@ -174,52 +178,52 @@ The following particles exist in-game but cannot be spawned because they require
---
[Original Credit](https://www.reddit.com/r/MinecraftCommands/comments/cbd56p/i_need_a_list_of_bedrock_particles/etg8rt7/)
[原始作者致谢](https://www.reddit.com/r/MinecraftCommands/comments/cbd56p/i_need_a_list_of_bedrock_particles/etg8rt7/)
## Component Particles
## 组件专用粒子效果
The following is a list of pre-defined short names for Vanilla particles that can be used in certain components.
**These have all been proven to generally work. This may not be a full list.**
以下是可在某些组件中使用的原版粒子效果预设简称列表。
**已确认这些简称通常有效，可能未包含全部可用选项**
| Short names | Notes |
| --------------------- | ---------------------------------------------------------- |
| mobspellambient | Color determined by any present potion ID in the component |
| villagerangry | |
| bubble | Only shows underwater |
| evaporation | |
| crit | |
| dragonbreath | Only seems to work for the AoE component for Projectiles |
| driplava | |
| dripwater | |
| reddust | |
| enchantingtable | |
| endrod | |
| mobspell | Color determined by any present potion ID in the component |
| largeexplode | |
| hugeexplosion | |
| fallingdust | Color determined by any present potion ID in the component |
| waterwake | |
| flame | |
| villagerhappy | |
| heart | |
| mobspellinstantaneous | Color determined by any present potion ID in the component |
| iconcrack | |
| slime | |
| snowballpoof | |
| largesmoke | |
| lava | |
| mobflame | |
| townaura | |
| note | |
| explode | |
| portal | |
| rainsplash | |
| smoke | |
| watersplash | |
| ink | |
| terrain | Pulls texture from atlas.terrain |
| totem | |
| witchspell | |
| soul | |
| spit | |
| sneeze | |
| 简称 | 备注 |
| ---------------------- | ------------------------------------ |
| mobspellambient | 颜色由组件中存在的药水ID决定 |
| villagerangry | |
| bubble | 仅在水下显示 |
| evaporation | |
| crit | |
| dragonbreath | 仅对投射物的AoE组件有效 |
| driplava | |
| dripwater | |
| reddust | |
| enchantingtable | |
| endrod | |
| mobspell | 颜色由组件中存在的药水ID决定 |
| largeexplode | |
| hugeexplosion | |
| fallingdust | 颜色由组件中存在的药水ID决定 |
| waterwake | |
| flame | |
| villagerhappy | |
| heart | |
| mobspellinstantaneous | 颜色由组件中存在的药水ID决定 |
| iconcrack | |
| slime | |
| snowballpoof | |
| largesmoke | |
| lava | |
| mobflame | |
| townaura | |
| note | |
| explode | |
| portal | |
| rainsplash | |
| smoke | |
| watersplash | |
| ink | |
| terrain | 从atlas.terrain提取纹理 |
| totem | |
| witchspell | |
| soul | |
| spit | |
| sneeze | |