Particle¶
文档版本:1.21.50.25
A particle definition file.
架构¶
particle:
{
format_version "format_version"
object "particle_effect" : opt
{
object "description" : opt
{
identifier "identifier"
object "basic_render_parameters" : opt
{
string "material" : opt
string "texture" : opt
}
}
object "curves" : opt
{
object "^(v|variable)\.[a-zA-z0-9]+$" : opt
{
0 "input"
array "nodes" : opt
{
0 "<any array element>"
}
object "nodes" : opt
{
object "(^[\-0-9]+$|^[\-0-9]+\.[\-0-9]+$)" : opt
{
}
}
string "type" : opt
0 "horizontal_range"
}
}
object "components" : opt
{
emitter_initialization "minecraft:emitter_initialization"
emitter_lifetime_events "minecraft:emitter_lifetime_events"
emitter_rate_manual "minecraft:emitter_lifetime_expression"
emitter_lifetime_once "minecraft:emitter_lifetime_once"
emitter_lifetime_looping "minecraft:emitter_lifetime_looping"
emitter_local_space "minecraft:emitter_local_space"
emitter_rate_instant "minecraft:emitter_rate_instant"
emitter_rate_manual "minecraft:emitter_rate_manual"
emitter_rate_steady "minecraft:emitter_rate_steady"
emitter_shape_box "minecraft:emitter_shape_box"
emitter_shape_custom "minecraft:emitter_shape_custom"
emitter_shape_disc "minecraft:emitter_shape_disc"
emitter_shape_entity_aabb "minecraft:emitter_shape_entity_aabb"
emitter_shape_point "minecraft:emitter_shape_point"
emitter_shape_sphere "minecraft:emitter_shape_sphere"
particle_appearance_billboard "minecraft:particle_appearance_billboard"
particle_appearance_tinting "minecraft:particle_appearance_tinting"
particle_appearance_lighting "minecraft:particle_appearance_lighting"
particle_expire_if_not_in_blocks "minecraft:particle_expire_if_not_in_blocks"
particle_expire_if_in_blocks "minecraft:particle_expire_if_in_blocks"
particle_initialization "minecraft:particle_initialization"
particle_initial_speed "minecraft:particle_initial_speed"
particle_initial_spin "minecraft:particle_initial_spin"
particle_lifetime_expression "minecraft:particle_lifetime_expression"
particle_lifetime_events "minecraft:particle_lifetime_events"
particle_kill_plane "minecraft:particle_kill_plane"
particle_motion_collision "minecraft:particle_motion_collision"
particle_motion_dynamic "minecraft:particle_motion_dynamic"
particle_motion_parametric "minecraft:particle_motion_parametric"
}
object "events" : opt
{
object "<any object property>" : opt
{
array "sequence" : opt
{
"<any array element>" : opt
}
array "randomize" : opt
{
"<any array element>" : opt
}
object "particle_effect" : opt
{
string "effect" : opt
string "type" : opt
string "pre_effect_expression" : opt
}
object "sound_effect" : opt
{
string "event_name" : opt
}
string "expression" : opt
string "log" : opt
number "weight" : opt
}
}
}
}
format_version
:format_version
particle_effect
:object- UNDOCUMENTED: particle effect.
particle_effect
description
:object- UNDOCUMENTED: description.
description
identifier
:identifier- UNDOCUMENTED: identifier.
basic_render_parameters
:object- UNDOCUMENTED: basic render parameters.
basic_render_parameters
material
:string- Minecraft material to use for emitter.
texture
:string- Minecraft texture to use for emitter.
curves
:object- Curves are interpolation values, with inputs from 0 to 1, and outputs based on the curve. The result of the curve is a Molang variable of the same name that can be referenced in Molang in components. For each rendering frame for each particle, the curves are evaluated and the result is placed in a Molang variable of the name of the curve.
curves
^(v|variable)\.[a-zA-z0-9]+$
:object- The curve definitions, conists out of a couple of nodes.
^(v|variable)\.[a-zA-z0-9]+$
input
:0- What is the input value to use.
nodes
:array- Control nodes for curve. These are assumed to be equally, used Object for bezier_chain
nodes
<any array element>
:0
nodes
:object- Control nodes for curve. These are assumed to be equally, used Object for bezier_chain
nodes
(^[\-0-9]+$|^[\-0-9]+\.[\-0-9]+$)
:object
(^[\-0-9]+$|^[\-0-9]+\.[\-0-9]+$)
type
:string- The type of curve.
horizontal_range
:0- What is the range the input is mapped onto.
components
:object- The particle components.
components
minecraft:emitter_initialization
:emitter_initializationminecraft:emitter_initialization
组件。The particle components.
minecraft:emitter_lifetime_events
:emitter_lifetime_eventsminecraft:emitter_lifetime_events
组件。The particle components.
minecraft:emitter_lifetime_expression
:emitter_rate_manualminecraft:emitter_lifetime_expression
组件。The particle components.
minecraft:emitter_lifetime_once
:emitter_lifetime_onceminecraft:emitter_lifetime_once
组件。The particle components.
minecraft:emitter_lifetime_looping
:emitter_lifetime_loopingminecraft:emitter_lifetime_looping
组件。The particle components.
minecraft:emitter_local_space
:emitter_local_spaceminecraft:emitter_local_space
组件。The particle components.
minecraft:emitter_rate_instant
:emitter_rate_instantminecraft:emitter_rate_instant
组件。The particle components.
minecraft:emitter_rate_manual
:emitter_rate_manualminecraft:emitter_rate_manual
组件。The particle components.
minecraft:emitter_rate_steady
:emitter_rate_steadyminecraft:emitter_rate_steady
组件。The particle components.
minecraft:emitter_shape_box
:emitter_shape_boxminecraft:emitter_shape_box
组件。The particle components.
minecraft:emitter_shape_custom
:emitter_shape_customminecraft:emitter_shape_custom
组件。The particle components.
minecraft:emitter_shape_disc
:emitter_shape_discminecraft:emitter_shape_disc
组件。The particle components.
minecraft:emitter_shape_entity_aabb
:emitter_shape_entity_aabbminecraft:emitter_shape_entity_aabb
组件。The particle components.
minecraft:emitter_shape_point
:emitter_shape_pointminecraft:emitter_shape_point
组件。The particle components.
minecraft:emitter_shape_sphere
:emitter_shape_sphereminecraft:emitter_shape_sphere
组件。The particle components.
minecraft:particle_appearance_billboard
:particle_appearance_billboardminecraft:particle_appearance_billboard
组件。The particle components.
minecraft:particle_appearance_tinting
:particle_appearance_tintingminecraft:particle_appearance_tinting
组件。The particle components.
minecraft:particle_appearance_lighting
:particle_appearance_lightingminecraft:particle_appearance_lighting
组件。The particle components.
minecraft:particle_expire_if_not_in_blocks
:particle_expire_if_not_in_blocksminecraft:particle_expire_if_not_in_blocks
组件。The particle components.
minecraft:particle_expire_if_in_blocks
:particle_expire_if_in_blocksminecraft:particle_expire_if_in_blocks
组件。The particle components.
minecraft:particle_initialization
:particle_initializationminecraft:particle_initialization
组件。The particle components.
minecraft:particle_initial_speed
:particle_initial_speedminecraft:particle_initial_speed
组件。The particle components.
minecraft:particle_initial_spin
:particle_initial_spinminecraft:particle_initial_spin
组件。The particle components.
minecraft:particle_lifetime_expression
:particle_lifetime_expressionminecraft:particle_lifetime_expression
组件。The particle components.
minecraft:particle_lifetime_events
:particle_lifetime_eventsminecraft:particle_lifetime_events
组件。The particle components.
minecraft:particle_kill_plane
:particle_kill_planeminecraft:particle_kill_plane
组件。The particle components.
minecraft:particle_motion_collision
:particle_motion_collisionminecraft:particle_motion_collision
组件。The particle components.
minecraft:particle_motion_dynamic
:particle_motion_dynamicminecraft:particle_motion_dynamic
组件。The particle components.
minecraft:particle_motion_parametric
:particle_motion_parametricminecraft:particle_motion_parametric
组件。The particle components.
events
:object- UNDOCUMENTED: events.
events
<any object property>
:object- The particle event.
<any object property>
sequence
:array- A sequence of elements to execute.
sequence
<any array element>
- The particle event.
randomize
:array- A list of elements to execute one of.
randomize
<any array element>
- The particle event.
particle_effect
:object- Particle effect action.
particle_effect
effect
:string- Identifier of the effect.
type
:string- UNDOCUMENTED: type.
pre_effect_expression
:string- Molang expression to run on the new emitter.
sound_effect
:object- Sound effect action.
sound_effect
event_name
:string- Name of the level sound event.
expression
:string- Molang expression to run on the event-firing emitter.
log
:string- Message to log, along with the firing effect's name and event position.
weight
:number- The weight of the element.