跳转至

Particle

文档版本:1.21.0.24

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_versionformat_version
format_version:
string
particle_effectobject
UNDOCUMENTED: particle effect.
particle_effect
descriptionobject
UNDOCUMENTED: description.
description
identifieridentifier
UNDOCUMENTED: identifier.
identifier:
string
basic_render_parametersobject
UNDOCUMENTED: basic render parameters.
basic_render_parameters
materialstring
Minecraft material to use for emitter.
texturestring
Minecraft texture to use for emitter.
curvesobject
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]+$
input0
What is the input value to use.
0:
string
0:
number
nodesarray
Control nodes for curve. These are assumed to be equally, used Object for bezier_chain
nodes
<any array element>0
nodesobject
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]+$)
typestring
The type of curve.
horizontal_range0
What is the range the input is mapped onto.
componentsobject
The particle components.
components
minecraft:emitter_initializationemitter_initialization
minecraft:emitter_initialization组件。The particle components.
minecraft:emitter_lifetime_eventsemitter_lifetime_events
minecraft:emitter_lifetime_events组件。The particle components.
minecraft:emitter_lifetime_expressionemitter_rate_manual
minecraft:emitter_lifetime_expression组件。The particle components.
minecraft:emitter_lifetime_onceemitter_lifetime_once
minecraft:emitter_lifetime_once组件。The particle components.
minecraft:emitter_lifetime_loopingemitter_lifetime_looping
minecraft:emitter_lifetime_looping组件。The particle components.
minecraft:emitter_local_spaceemitter_local_space
minecraft:emitter_local_space组件。The particle components.
minecraft:emitter_rate_instantemitter_rate_instant
minecraft:emitter_rate_instant组件。The particle components.
minecraft:emitter_rate_manualemitter_rate_manual
minecraft:emitter_rate_manual组件。The particle components.
minecraft:emitter_rate_steadyemitter_rate_steady
minecraft:emitter_rate_steady组件。The particle components.
minecraft:emitter_shape_boxemitter_shape_box
minecraft:emitter_shape_box组件。The particle components.
minecraft:emitter_shape_customemitter_shape_custom
minecraft:emitter_shape_custom组件。The particle components.
minecraft:emitter_shape_discemitter_shape_disc
minecraft:emitter_shape_disc组件。The particle components.
minecraft:emitter_shape_entity_aabbemitter_shape_entity_aabb
minecraft:emitter_shape_entity_aabb组件。The particle components.
minecraft:emitter_shape_pointemitter_shape_point
minecraft:emitter_shape_point组件。The particle components.
minecraft:emitter_shape_sphereemitter_shape_sphere
minecraft:emitter_shape_sphere组件。The particle components.
minecraft:particle_appearance_billboardparticle_appearance_billboard
minecraft:particle_appearance_billboard组件。The particle components.
minecraft:particle_appearance_tintingparticle_appearance_tinting
minecraft:particle_appearance_tinting组件。The particle components.
minecraft:particle_appearance_lightingparticle_appearance_lighting
minecraft:particle_appearance_lighting组件。The particle components.
minecraft:particle_expire_if_not_in_blocksparticle_expire_if_not_in_blocks
minecraft:particle_expire_if_not_in_blocks组件。The particle components.
minecraft:particle_expire_if_in_blocksparticle_expire_if_in_blocks
minecraft:particle_expire_if_in_blocks组件。The particle components.
minecraft:particle_initializationparticle_initialization
minecraft:particle_initialization组件。The particle components.
minecraft:particle_initial_speedparticle_initial_speed
minecraft:particle_initial_speed组件。The particle components.
minecraft:particle_initial_spinparticle_initial_spin
minecraft:particle_initial_spin组件。The particle components.
minecraft:particle_lifetime_expressionparticle_lifetime_expression
minecraft:particle_lifetime_expression组件。The particle components.
minecraft:particle_lifetime_eventsparticle_lifetime_events
minecraft:particle_lifetime_events组件。The particle components.
minecraft:particle_kill_planeparticle_kill_plane
minecraft:particle_kill_plane组件。The particle components.
minecraft:particle_motion_collisionparticle_motion_collision
minecraft:particle_motion_collision组件。The particle components.
minecraft:particle_motion_dynamicparticle_motion_dynamic
minecraft:particle_motion_dynamic组件。The particle components.
minecraft:particle_motion_parametricparticle_motion_parametric
minecraft:particle_motion_parametric组件。The particle components.
eventsobject
UNDOCUMENTED: events.
events
<any object property>object
The particle event.
<any object property>
sequencearray
A sequence of elements to execute.
sequence
<any array element>
The particle event.
randomizearray
A list of elements to execute one of.
randomize
<any array element>
The particle event.
particle_effectobject
Particle effect action.
particle_effect
effectstring
Identifier of the effect.
typestring
UNDOCUMENTED: type.
pre_effect_expressionstring
Molang expression to run on the new emitter.
sound_effectobject
Sound effect action.
sound_effect
event_namestring
Name of the level sound event.
expressionstring
Molang expression to run on the event-firing emitter.
logstring
Message to log, along with the firing effect's name and event position.
weightnumber
The weight of the element.