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_effectdescription:object- UNDOCUMENTED: description.
descriptionidentifier:identifier- UNDOCUMENTED: identifier.
basic_render_parameters:object- UNDOCUMENTED: basic render parameters.
basic_render_parametersmaterial: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.
componentsminecraft: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_effecteffect: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_effectevent_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.