Client Entity Documentation

Client entity definitions are contained within a Resource Pack and contain all of the information necessary to describe how an entity should look (model, texture, animation) and sound. To create your own, start by navigating to the "entity" folder inside the root of the Resource Pack. In the entity folder create a JSON file and give it a name. The JSON file needs a format version and minecraft:client_entity information.

The minecraft:client_entity section contains the description for the entity. Under description there are a number of things that you can set about an entity.

Example client entity definition JSON for the prismarine item drop:

{
  "format_version": "1.10.0",
  "minecraft:client_entity": {
    "components": {
      "badger:rendering": {
        "definition": "badger:item_prismarine",
        "static": true
      },
      "badger:presentation_event": {
        "on_item_collected": {
          "audio": "BAE_hero_pickup_prismarine"
        },
        "on_item_collected_arrived": {
          "audio": "BAE_hero_pickup_prismarine_stop"
        }
      },
      "badger:template": ["badger:template_item_orb"]
    },
    "description": {
      "enable_attachables": false,
      "geometry": {
        "default": "geometry.item_prismarine"
      },
      "identifier": "badger:item_prismarine",
      "materials": {
        "default": "entity_model",
        "mat_item_prismarine": "mat_item_prismarine"
      },
      "render_controllers": ["controller.render.item_prismarine"]
    }
  }
}

Entity Description Properties

badger:animal_interaction

Handles animal interaction information.

Type	Name	Description
Decimal	duration	How long the animal interaction should last in seconds
String	molang_variable	The molang variable to toggle the pat pat animation on both the animal and the player
String	trigger_event	The presentation event to trigger when the interaction occurs

badger:animation_variation

Settings to determine which animation is played based on which interval an action occurs within

Type	Name	Default Value	Description
Array	intervals		The set of intervals used to determine the molang index based on the last time an action was performed.
String	molang_index_name		The name of the molang used by animation for a given set of intervals.

badger:area_overlays

Defines any visual overlay effects applied to this entity, such as auras and attack range circles.

Area Overlays:

Type	Name	Description
List	auras	Defines a list of aura-type overlays.
List	circles	Defines a list of circle-type overlays.

Attributes	Description	Default Value	Valid Values
filter_team	When true, the overlay is only visible to allied players.	Unknown	true, false
views	Defines when the overlay should be visible.	gameplay	gameplay, placement
layer	Defines what layer the aura is rendered to.	aura	zone, aoi, aura, overlay
size	Size of the overlay, in blocks.		Any positive integer
type	Defines the type of overlay, which affects when and how it will be rendered.	default	default, aura, buff, culture, tower, highlight
uses_zone_size	When true, the overlay expands to match the entity's zone of effect.	unknown	true, false

badger:attacker_damage_prediction

Defines presentation behaviour for when the entity anticipates performing an attack that deals damage of a certain hit reaction threshold.

Type	Name	Default Value	Description
String	apply_buff		The buff applied to the entity about to perform an attack that deals damage of a certain hit reaction threshold.
String	hit_reaction_type		The hit reaction threshold which applies the buff.

badger:audio_beat_sync

This component allows an entity to trigger presentation events based on beats or marker triggers from the music.

Type	Name	Default Value	Description
Boolean	receive_only_markers		If this is true, this entity will not be sent any Beat callbacks, only Marker callbacks.

badger:audio_block_scanning

This component provides information for the block scanning system for which biomes to look for and which audio events to play when it finds it.

Type	Name	Description
Array	biomes	Array of all the biomes this block scan will look for.
	biome_name	The name of the biome the block scan is looking for. Type: string
	fmod_event	The name of the FMOD Event that will start when the biome is found. It's recommended to use a looping sound. Type: string
	liquid_only	When this boolean is true, only liquid-type blocks will be valid when detecting a biome type. Type: boolean
Integer	max_step_dist	The maximum distance in blocks that this block scanner will go.
Integer	min_step_dist	The minimum distance in blocks that this block scanner will go.

badger:audio_interactable

This flags an entity to apply attributes about the audio event that should be played when the player comes into interaction range with this interactable entity and is prompted to interact with it.

Type	Name	Default Value	Description
String	enter_range_audio_event		The name of the audio event that should be played when the player comes into interaction range.

badger:audio_molang_to_fmod

This flag component indicates that the entity will update any specified Molang to FMOD audio parameters, these molang parameters are not data driven due to expensive molang calls.

badger:audio_time_of_day

This flags an entity to apply an FMOD event parameter for 'time_of_day'.

badger:audio_update_FMOD_projectile_velocity

This flags an entity so its velocity will be sent to FMOD for all of the audio events it triggers.

badger:audio_vo_sequence_speaker_tag

This flags an entity to apply attributes about a tag that will allow the VO Sequence System to play 3D audio at it's position.

Type	Name	Default Value	Description
String	speaker_tag		A tag for this entity so that VO sequence audio may be positioned on it.

badger:beacon_render_info

Provides a beacon on a village entity

Type	Name	Description
List	states	A list of beacon states this entity can have. By default, the first state is active.
	beacon_color	Base color to be multiplied onto the beacon texture. (String)
	beacon_width	Width of the beacon. (Integer)
	emissive_scale	Flat value to scale the emissiveness of the beacon - Default is tuned for near-camera beacons. (Float)
	max_distance	Maximum distance after which this beacon is no longer rendered. (Integer)
	meta_material	Meta material name used to render the beacon. (String)
	min_distance	Minimum distance before this beacon is no longer rendered. (Integer)

badger:block_source_cull_distance_override

Adds a distance override for the block source culling distance for this entity

Type	Name	Default Value	Description
Decimal	distance		Override to the maximum distance from the player at which the block source culling occurs

badger:block_source_info

Allows the entity to track the block source information for the current block it's on. This is to detect things like, biome data, water, on the ground, etc...

badger:block_source_removal

Remove the BlockSourceComponent on the client because this entity doesn't need one.

badger:boom_camera

Badger's boom camera.

Type	Name	Description
Decimal	boom_length	Length of the camera boom.
Decimal	control_react_spring	How quickly the camera reacts when the target starts moving.
Decimal	control_stop_spring	How quickly the camera reacts to the target stopping.
Decimal	follow_spring	The amount of spring the camera has when following the target.
Decimal	max_follow_distance	Maximum distance the camera can be from the follow target.
Decimal	max_pitch	Maximum pitch of the boom camera.
Decimal	min_pitch	Minimum pitch of the boom camera.
Decimal	starting_pitch	The initial pitch of the boom camera.
Decimal	starting_relative_yaw	The initial yaw of the boom camera.
Decimal	target_vertical_offset	Vertical offset from the camera's follow target.

badger:cam_overrides_look_orientation

Attach to a camera to indicate whether a camera overrides the direction the player looks when they move

badger:cam_overrides_move_orientation

Attach to a camera to indicate whether a camera inhibits the player from moving

badger:camera_avoidance

Badger's main camera avoidance logic.

Type	Name	Description
Decimal	camera_disk_radius	Camera disk radius to use to move camera for avoidance.
Decimal	camera_in_geometry_radius	Radius of sphere around camera to determine if it is in world geometry.
Decimal	distance_from_obstacle	Distance from object impeding the camera when avoidance is triggered
Decimal	ease	Easing lerp to get camera back to normal non-avoidance position
Decimal	min_distance_from_target	Minimum distance camera is allowed to be within of target when avoiding.
Decimal	snap	Snapping lerp to get camera to avoidance position
Decimal	target_disk_radius	Target disk radius to use to move camera for avoidance.
Decimal	target_vertical_offset	Vertical offset from target that should use as anchor avoidance/follow point.

badger:camera_bounds

Describes how and when a camera makes rotational and/or positional changes

Type	Name	Description
Decimal	hard_bounds_cone_angle	Angle for the spherical cone that will determine the width of non-movement of the camera.
Decimal	look_priority	Priority percentage given to the look target in comparison to the follow target when there is a follow target. If there is no follow target, the look target takes full priority. Value between [0.0f, 1.0f], inclusive. If 0.5f priority given camera will focus on a spot halfway between the look and follow target. If 1.0f priority given camera will focus on the look target.
Decimal	look_smoothing_spring	Smoothing Spring constant determining how long the spring takes to get the camera to the appropriate orientation.
Decimal	position_smoothing_spring	Smoothing Spring constant determining how long the spring takes to get the camera to the appropriate position.
Decimal	soft_bounds_scale	Scale applied to the spherical cone used to recenter the camera IF the hard bounds spherical cone angle has been broken.

badger:camera_distance_activation

Describes the range this camera can activate in.

Type	Name	Default Value	Description
Decimal	distance		The distance from the camera to it's look target. This determines the range this camera will try to activate in.

badger:camera_input_layout_override

Defines how cameras can override an existing input layout.

Type	Name	Default Value	Description
String	layout_name		The name of the input layout.

badger:camera_locomotion

Alters the camera position based on follow target's locomotion

Type	Name	Description
Decimal	default_seconds_ahead	Default amount of seconds to multiply the follow target's average velocity with to position the camera ahead of the follow target.
List	pitch_modifiers	List of pitch angle modifiers [0, 360] written in ascending order. These modifiers identify which yaw modifiers should be applied for camera positioning. Note: This angle is the difference in pitch between the player's velocity vector and the camera look pitch.
	angle	Angle boundary in degrees [0, 360]. Interpolation occurs between these boundaries. (Float)
	yaw_modifiers	List of yaw angle modifiers [0, 360] written in ascending order. These modifiers identify which additive changes should be applied to our seconds ahead and camera positioning calculation. This angle is the difference in yaw between the player's velocity vector and the camera look yaw. (List)
	seconds_ahead_delta	Additive change in seconds ahead amount if the modifier is met. (Decimal)
List	speed_modifiers	List of possible speed modifiers.
	seconds_ahead_multiplier	Multiplying change in seconds ahead amount if the modifier is met. (Decimal)
	speed	Speed boundary. Interpolation occurs between these boundaries. (Decimal)
Integer	ticks_to_average_velocity_over	Amount of ticks used to create the average velocity. A larger value results in smoother camera positioning changes relative to velocity. A value of 10 is a good baseline.

badger:camera_show_indicators

Describes whether or not the camera is able to see circular indicators under mobs.

badger:camera_show_zone

Describes whether or not the camera be able to see zones.

Type	Name	Default Value	Description
Boolean	show_all_zones		When set to true, this camera will display all zones in preview
Decimal	zone_distance		The distance that this camera should show zones at

badger:cinematic_camera

Attach to a camera to indicate that it's used in the cinematic system as a camera.

badger:clamp_camera

Badger's boom camera.

Type	Name	Default Value	Description
Decimal	horizontal_clamp		Horizontal clamp for the camera.
Decimal	vertical_clamp		Vertical clamp for the camera.

badger:decal_visualization

Optional parameters to control how decals are rendered.

Type	Name	Description
Decimal	alpha	Sets the opacity of the decal.
Integer	animation_frame_count	Number of frames in the decal's animation
Integer	animation_framerate	Framerate of the decal's animation
Boolean	apply_to_owned	Bitwise flag for checking if rendered object entity is in a valid team.
Boolean	apply_to_unowned	Bitwise flag for checking if rendered object entity is not in a team.
String	bin	Name of the group to organize the decal.
Vector [a, b, c]	decal_size	Size of the decal in blocks. May be overridden by code.
String	decal_textures	When set, will use the stated textures for this decal, defaulting to the first. Textures after the first can be switched to via code
Decimal	fade_out_start	Duration in seconds to begin fading out the decal.
Vector [a, b, c, d]	fill_color	A vector 4 of the color of the fill [R,G,B,A].
Boolean	height_fade	Bitwise flag for enabling height fade.
Decimal	height_fade_center	Vertical position of the decal to center the opacity fade.
Decimal	height_fade_height	Vertical offset from HeightFadeCenter to lower opacity.
Boolean	is_symmetric_texture	Bitwise flag for mirroring the texture vertically and horizontally.
Decimal	lifetime	When set and > 0, the decal disappears after this many seconds.
Boolean	linear_pulse_mode	Bitwise flag for selecting whether to use the shape of the distance function or object z position for the pulse size.
Boolean	mask_entities	Bitwise flag for checking if rendered object is an entity.
Boolean	normal_mapped	Boolean for whether a normal map for the decal texture exists.
Vector [a, b, c, d]	outline_color	A vector 4 of the color of the outline [R,G,B,A].
Decimal	outline_softness	Size of the edge gradient of the outline.
Decimal	outline_thickness	Size of the outline of the decal.
Vector [a, b, c, d]	pulse_color	A vector 4 of the color of the pulse [R,G,B,A].
Decimal	pulse_count	Number of times to repeat the pulse.
Decimal	pulse_softness	Size of the edge gradient of the pulse.
Decimal	pulse_speed	Speed over global time the pulse increases in size.
Decimal	pulse_thickness	Size of the pulse decal.
Vector [a, b, c]	rotation_center	Local vector 3 position for the pivot point of rotation.
String	shape	Shape type of the decal.
Boolean	sliced_texture	Bitwise flag for slicing the texture atlas correctly if symmetric.
Integer	sort_key	Sorting index.
Decimal	sparkle_blink_speed	Frequency of the sparkles blinking.
Decimal	sparkle_density	Density of the sparkles.
Decimal	sparkle_movement_speed	Speed of the sparkles moving about the decal.
Decimal	sparkle_size	Size of the sparkles.
Decimal	sparkle_strength	Opacity of additive sparkles.
Boolean	start_enabled	When true, this decal will be enabled and visible when spawned. When false, it will not render unless code is in place to cause it to do so.
Decimal	texture_slice_corner_size	Amount from [0.0-1.0] to trim the corner of the square texture.
Decimal	yaw	Sets the yaw rotation of the decal.

badger:decoration_collider_request

Define the decoration collider to be attached to an entity.

Type	Name	Default Value	Description
String	name		Archetype name of the decoration collider.

badger:entity_age

Enables the age timer.

badger:face_animation

Defines facial animation properties for the entity.

Type	Name	Description
Positive Integer	anim_columns	The number of columns in the animation texture page.
Positive Integer	anim_rows	The number of rows in the animation texture page.
Positive Integer	blink_frame	Frame index for blinks.
Array	blink_time_closed	Range (in seconds) to hold blink frame.
Array	blink_time_open	Range (in seconds) to hold non-blink frame.
Positive Integer	default_frame	Default frame index.

badger:fast_travel_presentation

Defines the entity's presentation event & molang variable names for fast travel.

Type	Name	Description
String	cooldown	The name of the cooldown presentation event & molang variable.
Decimal	cooldown_event_time	The time, in seconds, when the fast travel end trigger event is triggered after initiating fast travel.
JSON Object	fade_to_black	The data containing a fade to black screen transition
String	windup	The name of the windup presentation event & molang variable.
Decimal	windup_event_time	The time, in seconds, when the fast travel start trigger event is triggered after initiating fast travel.

badger:hero_lure_presentation

Defines the entity's presentation event names for hero lure.

Type	Name	Default Value	Description
String	start_trigger		The name of the start presentation event.
String	stop_trigger		The name of the stop presentation event.

badger:hit_reaction_threshold

Defines this entity as a hit reaction threshold prototype.

Type	Name	Default Value	Description
Decimal	activation_percent		The percentage of target's max health that attacking damage will do, on the range [0,1].

badger:hud_message_interaction_failed

This describes HUD messages to show if we have a failed interaction that requires a resource/unlock cost.

Type	Name	Description
JSON Object	resource_cost_failed_message	Defines the HUD message displayed when the player lacks the resources for the interaction cost.
	hud_message_args	Arguments to pass into the HUD message; the message must support these arguments.
	hud_message_id	HUD message ID sourced from `hud_text_messages.json`.
JSON Object	unlock_cost_failed_message	Defines the HUD message displayed when the player lacks the resources to unlock an item or feature.
	hud_message_args	Arguments to pass into the HUD message; the message must support these arguments.
	hud_message_id	HUD message ID sourced from `hud_text_messages.json`.

badger:input_actions

Defines the entity's input mapping of possible actions.

Type	Name	Description
String	action_name	The name of the action.
String	action_targeting_type	The targeting type of the action. Can be set to "none", "directional" or "target"
String	input_action_mode	Controls the action's effect, whether it is instant or sustained over time. Can be set to "trigger" or "sustain"
String	input_id	The button id from the input overlay. e.g. button.charge.
String	target_facing	The relative direction to shoot in e.g. player_facing (only valid when action type is set to target)
Decimal	target_range	The range of the target (only valid when action type is set to target)

badger:interaction_presentation

Defines toggles to enable or disable certain interaction presentation events from firing when interacting with this entity.

Type	Name	Default Value	Description
Boolean	trigger_generic_events	true	When true, will trigger generic presentation events when interacted with (archetype doesn't matter). Can be combined with specific events.
Boolean	trigger_specific_events	false	When true, will trigger archetype specific presentation events when interacted with. Can be combined with generic events.

badger:interpolation

Defines the entity's interpolation parameters.

Type	Name	Description
Decimal	orientation_interpolation_steps	How many fixed update ticks (there are 20 per second) an interpolation of an orientation change takes. Default is 1, the value can be greater then 1 but also be a fraction (for example 0.5f).
Decimal	position_interpolation_steps	How many fixed update ticks (there are 20 per second) an interpolation of an position change takes. Default is 1, the value can be greater then 1 but also be a fraction (for example 0.5f).
Decimal	position_interpolation_steps_y_down	How many fixed update ticks (there are 20 per second) an interpolation of an position change while falling downwards takes. Default is 1, the value can be greater then 1 but also be a fraction (for example 0.5f).

badger:invasion_icon

The colour for the backing of the healthbar icon during invasions

Type	Name	Default Value	Description
Array	icon_color		The The RGBA value of the icon colour. Formatted as an array

badger:invulnerability_heartbeat_view

This component provides which audio events to play when the invulnerability heartbeat pulses.

Type	Name	Default Value	Description
String	audio_bae_event		This is the name of the Audio BAE Event that will start when the invulnerability render pulse occurs. It's recommended to not use a looping sound.

badger:keep_alive_timer

Defines the settings for keeping client-side entities alive after they have died.

Type	Name	Default Value	Description
Decimal	time		How much time, in seconds, the entity will stay alive for after it has died, before being unloaded.
Decimal	time_if_refunded		How much time, in seconds, the entity will stay alive for after it has died, before being unloaded IF it dies due to refund.
Boolean	trigger_event_only_on_death	false	If true, the on_death event will only be triggered if the entity died due to reaching zero health.

badger:knockback_reaction_threshold

Defines this entity as a knockback reaction threshold prototype.

Type	Name	Default Value	Description
Decimal	activation_value		The amount of knockback force that an attacking entity needs to do.

badger:locator

This flags an entity that it is used as a locator for vfx

badger:locator_effect

Defines how effects are spawned at given locators.

Type	Name	Description
String	effect_file	The name of the effect file to use.
String	locator	The name of the locator to bind the particle effect to.
Array	particle_effects	The container that holds the data for each tyep of particle effect.
Decimal	removal_time	The time delay between when the effect is disabled and when to remove it.

badger:lookat

Defines the ability for an entity to look at other things.

Type	Name	Description
String	joint	Defines the joint to adjust for the look at.
String	look_at_axis	The axis of the look joint that should be rotated, defaults to y
Decimal	max_angle	Defines the max angle a head can turn.
Decimal	max_range	Defines the max range that this entity will look at.
Decimal	min_range	Defines the min range that this entity will look at.
Decimal	turning_delta	Defines how many degrees per frame the head will turn to target.

badger:map3_child_offset

Used on a Map Entity (for World Map 3), defines a relative offset another Map Entity can use (like a VFX entity).

Type	Name	Description
Decimal	x	X offset.
Decimal	y	Y offset.
Decimal	z	Z offset.

badger:map3_copy_local_camera_orientation

Map entity will inherit the local camera's orientation.

badger:map3_copy_orientation

Map entity will inherit the icon entity's (and game entity) orientation.

badger:map_entity_3d_icon

Map Entity (for World Map 3) will have an icon on the map screen

badger:map_icon_offset

Adds an offset to an map source entity.

Type	Name	Description
Decimal	x	X offset.
Decimal	y	Y offset.
Decimal	z	Z offset.

badger:mount_molang

Defines the molang variable name to be used when this entity is mounted.

Type	Name	Default Value	Description
String	mount_variable		The molang variable name that is set when this entity is mounted.

badger:music_2d_emitter

Defines the 2D Music emitter component. Attaching this to an entity allows it to interface with the music system and determine what music to play.

Type	Name	Description
Array	audio_parameters	An array of FMOD parameters to set when this emitter activates. "param_name": <int_value>
String	heatmap_influence_global_music_parameter	Name of the global music parameter in FMOD where the heatmap influence should be sent if this music emitter is spawned by a heatmap.
Decimal	max_distance	How far away the local player is before the emitter activates
Array	music_states	An array of different states this emitter can be in. Active state is determined by the music_emitter_states component
String	on_enter_bae	The name of the audio event to request when this emitter activates
Integer	priority	Determines which emitter to choose when more than one is active. Higher is more priority.
String	state_name	Name of the state for Debugging

badger:music_emitter_states

Defines the current state of this music emitter entity.

Type	Name	Default Value	Description
List	badger:music_emitter_states		A list of the current states this emitter can be in. This must match the resource_pack music_states for badger:music_2d_emitter.

badger:on_destruction

This flags an entity to apply attributes with the details about the entity to spawn when the applied-to entity is destroyed.

Type	Name	Default Value	Description
String	locator		The locator at the position where the new entity should be spawned
String	spawn_entity		The archetype name for the entity that should be spawned

badger:orbital_arm

Settings that define how a camera orbits a follow target while focusing on a look target.

Type	Name	Description
Decimal	end_arm_height	Minimum amount the camera can zoom in along the height arm.
Decimal	end_arm_length	Minimum amount the camera can zoom in along the length arm.
Decimal	horizontal_lerp	How smoothly the orbital arm follows its targets on the horizontal plane, on the range (0,1].
Decimal	start_arm_height	The height offset of the arm, measured from the follow target.
Decimal	start_arm_length	The length of the arm, measured from the follow target.
Vector [a, b, c]	target_offset	The offset from the follow target to rotate around.
Decimal	vertical_lerp	How smoothly the orbital arm follows its targets on the vertical plane, on the range (0,1].
Decimal	zoom_cursor_multiplier	A multiplier to drive the amount of zoom relative to cursor distance. Larger numbers means greater cursor distance change is needed for same amount of zoom
Decimal	zoom_lerp	How smoothly the orbital camera zooms in and out, on the range [0,1].

badger:placement_molang

Defines the molang string sent for structure placement

Type	Name	Default Value	Description
String	name		Defines the tag string

badger:point_lights

Defines point lights possibly attached to entity locators.

Type	Name	Description
Vector [a, b, c]	color	Color of light (can also be a Molang expression per channel).
Decimal	enabled	Is the light enabled (can also be a Molang expression).
Decimal	falloff_power	Power of rate of falloff for light (can also be a Molang expression).
Decimal	intensity	Intensity of light (can also be a Molang expression).
Array	lights	Container for the list of lights.
String	locator	The name of the locator to bind the light to (optional).
Vector [a, b, c]	offset	Offset for light, in local space (can also be a Molang expression per channel).
Decimal	radius	Radius of light (can also be a Molang expression).

badger:presentation_event

Defines the presentation triggers this entity can respond to, and the animation events to play.

Type	Name	Description
JSON Object	animation	Descriptor for an animation object.
String	attachment	Descriptor for an attachment object.
JSON Object	audio	Descriptor for an audio effect object.
JSON Object	beacon	Descriptor for a beacon effect object.
JSON Object	distance_curve	Details on how the duration curve is affected by the distance between the event sender and the client player.
	min_range	Minimum distance; any distance smaller than or equal to this will be treated as a 1.0f multiplier.
	multiplier_function	Multiplier curve used to process the distance curve.
	range	Maximum distance; any distance greater than or equal to this will be treated as a 0.0f multiplier.
JSON Object	duration_curve	Details for configuring the appearance of the duration curve.
	duration	Total duration of the rumble in seconds. Note: If there is a start delay, this duration begins after that delay.
	in_duration	Time taken to transition from minimum to maximum rumble strength.
	in_easing_function	Function used to ease into the rumble (i.e., at the start of the rumble).
	minimum_strength	Minimum strength of the curve; this will be the initial amount set at the start of the rumble, towards which the easing-out function will move.
	out_duration	Time taken to transition from maximum rumble strength to minimum.
	out_easing_function	Function used to ease out of the rumble (i.e., at the end of the rumble).
	pulse_duration	Duration of each pulse in seconds. The number of pulses is calculated as total duration divided by pulse duration, requiring the total duration to be divisible by pulse duration for an integer result.
	start_delay	Time delay before initiating the initial rumble.
	strength	Maximum strength of the rumble that the in-easing function will approach.
JSON Object	invulnerability_decal	Descriptor for a visual-only invulnerability decal.
String	outline	Descriptor for an outline object.
Boolean	override	Determines whether this type of rumble can override other rumble events (true/false).
JSON Object	particles	Descriptor for a particle effect object.
Integer	priority	Priority of this rumble event; lower integer values indicate higher priority.
String	script	Descriptor for the script name to execute upon trigger.
String	spawn_entity	If the handler is a single string, it indicates that a single entity is spawned with a 100% chance of success.
String	visual_state	Descriptor for a visual state object.

badger:projectile_trail_request

Determine a projectile trail from projectile trail collection.

badger:removal_time (duplicate?)

destroys an entity after a given period of time

Type	Name	Description
String	presentation_event	Name of the presentation event to fire when the timer triggers
Boolean	sync_presentation_event	Whether or not the event should be synced over the server, or if it should be local only
Decimal	time	Amount of time in seconds before the entity is destroyed

badger:rendering

The rendering parameters for the entity.

Type	Name	Default Value	Description
String	definition		The name of the rendering definition to use.
Integer	limit	1024	Setting sets a maximum limit to number of instances for an entity
Boolean	render_controllers_are_constant		Flag to indicate if the render controllers should be reprocessed each frame.
Boolean	static		Flag to indicate the entity type requires a static intitialization render pass.

badger:respawn_trigger

The trigger that occurs when an entity is respawned

Type	Name	Default Value	Description
String	trigger		The trigger event to send when an entity respawns

badger:rig_operations

Specifies a list of rig operations to apply.

badger:rotation_presentation

Defines clientside presentation-related tunings for rotation.

Type	Name	Default Value	Description
String	rotation_stop_presentation_event_delay		Defines the delay after rotation ends before the stop presentation event is sent. This can be used to avoid excessive event triggering when rapidly starting and stopping rotation.

badger:skin

Defines the entity with this data as a clientside skin archetype

Type	Name	Default Value	Description
String	archetype		The name of the base archetype that this clientside skin is for. Gameplay behaviour will be inherited from this base archetype..

badger:smooth_look_at

Settings for smoothing camera look.

Type	Name	Default Value	Description
Decimal	focus_radius		The radius around the look target that will trigger smoothing if the target moves beyond it.

badger:speed_data_to_fmod

This component allows an entity to send data related to its speed to FMOD. It sends its speed and it's Y velocity to the FMOD parameters specified in data.

Type	Name	Description
String	fmod_speed_param	This is the name of the FMOD Parameter we're converting the entity's speed parameter to.
String	fmod_velocity_y_param	This is the name of the FMOD Parameter we're converting the entity's Y velocity parameter to.
Decimal	max_speed	The maximum value we want to track for the entity's speed parameter. Setting this will normalize the parameter value between the min and max.
Decimal	max_velocity_y	The maximum value we want to track for the entity's Y velocity parameter. Setting this will normalize the parameter value between the min and max.
Decimal	min_speed	The minimum value we want to track for the entity's speed parameter. Setting this will normalize the parameter value between the min and max.
Decimal	min_velocity_y	The minimum value we want to track for the entity's Y velocity parameter. Setting this will normalize the parameter value between the min and max.

badger:terrain_type_molang

Specify that an entity should define and update the 'variable.terrain_type' molang variable

badger:threat_owner

Defines this entity as a host for music threat level.

Type	Name	Description
Decimal	decay_rate	How fast threat value interpolates when decaying towards base value.
Decimal	grow_rate	How fast threat value interpolates when increasing towards base value.
Decimal	influence_distance	How far away will this host broadcast it's threat level.
Decimal	max_threat	Max possible threat value for this host.
Decimal	min_threat	Min threat value for this host.

badger:threat_source

Defines this entity as a contributor to threat level for an owning source village/base.

Type	Name	Description
Decimal	base_value	How much threat this entity contributes after the transition time has passed.
Decimal	spawn_value	How much threat this entity contributes when spawned.
Decimal	transition_time	Time in seconds it takes for this entity to transition in threat value from the spawn value to the base value.

badger:toggleable_decorative_child

Defines an entity archetype to add as a child of this entity, that will be destroyed and recreated as necessary to hide and display it.

Type	Name	Description
String	child_entity_id	Defines the name of the entity archetype to use.
Integer	molang_variant_id	Sets the molang parameter 'variable.variant_id' on the child when it is created. This is used to create visual variants of the child entity using things like material swaps.
Boolean	start_enabled	Defines whether the child should be enabled by default.

badger:variable_propagation

Allows specification of what variables propagate from a parent to a parented entity

badger:verlet_dynamics

Specifies a list of verlet dynamics to apply.

badger:visual_only_invulnerability_decal

Triggers invulnerability decal on entity along with offsets for modifying the bounds of the AABB stored by the decal

Type	Name	Description
Vector [a, b, c]	max_aabb_subtractive_offset	Offset vector to subtract from max AABB bound of the decal
Vector [a, b, c]	min_aabb_additive_offset	Offset vector to add to min AABB bound of the decal
List	states	A list of invulnerability states this entity can have. By default the first state is active.

badger:visualize_local_player_allegiance

This flags an entity to apply a molang variable encoding allegiance to the local player for visual purposes.

minecraft:camera

Defines Badger functionality to the existing Bedrock camera.

Type	Name	Description
Decimal	far_plane	The far clipping plane distance.
Decimal	field_of_view	The angle in degrees that determines the visible area from the camera's perspective
Decimal	max_shadow_range	Constrains the range of the shadow cascades by overriding the max shadow distance.
Decimal	min_shadow_range	Constrains the range of the shadow cascades by moving the starting point further from the camera.
String	name	Identifies the type of camera.
Decimal	near_plane	The near clipping plane distance.
Vector [a, b, c]	orientation	In degrees: The pitch around the x axis, yaw around the y axis, and roll around the z axis.
Vector [a, b, c]	position	The location of the camera in world coordinates.
Integer	priority	The priority of this camera relative to other cameras. This is used to resolve conflicts when multiple cameras can activate.
Boolean	render_player_model	Determines if the player's model should render while this camera is active.
Integer	sensitivity_input_option	Identifies which user camera sensitivity slider to refer to.
Decimal	shadow_depth_bias	Overrides the depth bias used for shadow cascades.
Decimal	shadow_slope_bias	Overrides the slope bias used for shadow cascades.

minecraft:camera_attach

Describes how a camera entity should attach to another entity.

Type	Name	Description
String	locator	The name of the locator where the camera will be attached.
Vector [a, b, c]	offset	The offset from the locator/entity where the camera will be attached.
Boolean	use_locator_orientation	True if the camera should use the locator's orientation as it's view orientation.

minecraft:camera_avoidance

Describes how cameras that orbit a target should avoid collision and occlusion.

Type	Name	Default Value	Description
String	relax_distance_smoothing_spring		How quickly the camera will return to it's desired distance once a collison or occulsion is cleared.

minecraft:camera_blend_in_default

Describes how a camera can pitch around the x axis and yaw around the y axis.

Type	Name	Description
Decimal	blend_time	The duration of the blend in seconds.
Boolean	camera_to_accepts_input	Determines if the camera being blended to will accept input during the blend.
String	ease	The type of easing function used to control the blend.
Decimal	input_dampening_coefficient	Dampens the input on the camera to if the camera to is accepting input during the blend.

minecraft:camera_fly

Describes how a camera flies around.

Type	Name	Description
Decimal	speed	The speed of the camera when flying.
Decimal	speed_alt	The alternative speed of the camera when flying.
Decimal	sprint_multiplier	The multiplier set by /sprint of the speed of the camera when flying.

minecraft:camera_look_at

Describes how a camera frames it's look target.

Type	Name	Description
Vector [a, b]	hard_bounds_max	The top right coordinates of the hard bounds.
Vector [a, b]	hard_bounds_min	The bottom left coordinates of the hard bounds.
Vector [a, b, c]	look_at_offset	Offsets the point that the camera looks at in look target relative space.
Decimal	look_target_vertical_offset	Offsets the point that the camera looks at up or down in world space.
Vector [a, b]	soft_bounds_max	The top right coordinates of the soft bounds.
Vector [a, b]	soft_bounds_min	The bottom left coordinates of the soft bounds.
Decimal	soft_bounds_smoothing_spring	How quickly the camera's orientation will correct to keep it's look target within the soft bounds.

minecraft:camera_orbit

Describes how a camera orbits around it's follow target.

Type	Name	Description
Decimal	azimuth_smoothing_spring	How quickly the camera's azimuth will correct to match the desired azimuth.
Decimal	distance_smoothing_spring	How quickly the camera's distance will correct to match the desired distance.
Decimal	pivot_point_vertical_offset	Offsets the point that the camera orbits around up or down.
Decimal	polar_angle_max	Maximum polar angle.
Decimal	polar_angle_min	Minimum polar angle.
Decimal	polar_smoothing_spring	How quickly the camera's polar angle will correct to match the desired azimuth.
Decimal	radius	The ideal distance the camera will keep from it's follow target.

minecraft:camera_speed_modifier

Used as a multiplier for the fly camera / first person camera.

Type	Name	Description
Decimal	look_at_speed_modifier	Multiplier for the look at speed.
Boolean	slow_mode_modified_by_sprint	Boolean for whether or not slow mode speed is affected by sprint multiplier.
Decimal	translation_speed_modifier	Multiplier for the translation speed.

minecraft:first_person_look

Describes how a camera can pitch around the x axis and yaw around the y axis.

Type	Name	Default Value	Description
Decimal	pitch_max		The maximum pitch angle in degrees that the camera can have.
Decimal	pitch_min		The minimum pitch angle in degrees that the camera can have.

minecraft:follow_target

A target to follow.

minecraft:look_target

A target to look at.

identifier

The identifier is used to register the entity with the server. In the Client Entity Definitions JSON the identifier sets the appearance of the entity(materials, textures, geometry, etc.) The matching identifier in the Entity Behavior JSON in the Behavior Pack is what gives the entity its behaviors.

materials, textures, animations

Players can set the materials, texture and geometry used for the entity in this section. Players can set one or more materials, textures, and geometries that can be used by the mob. Players must set user defined names for them. These names are used in the Render Controllers JSON. Players can reference materials, textures, and geometry from the vanilla Minecraft Resource Pack or create their own. Custom materials, textures, and geometry should be in the corresponding folder at the root of the Resource Pack.

scripts

Scripts allow players to use MoLang to compute calculations once and store that value. This value than can be used over and over again without the need to constantly recompute the calculations. Scripts currently support pre - animation and scale.More script types will be added later. -Pre-animation scripts are evaluated immediately before animations are processed. -Scale sets the scale of the mob's geometry.

NOTE: This section is to be completely rewritten as it is thoroughly inaccurate. FISH and a BAT in LEGENDS? Imagine Example pre-animation script for cod

"scripts": {
  "pre_animation": [
    "variable.ZRot = !query.is_in_water ? Math.cos((query.time_stamp + global.frame_alpha) * 14.32) * 90 : 0.0;",
    "variable.AnimationAmountBlend = Math.lerp(variable.AnimationAmountPrev, variable.AnimationAmount, global.frame_alpha);"
  ]
},

Example scale script for the bat:

"scripts": {
  "scale": "0.35"
},

animations

Allows the player to assign names to reference the long name for animations. These names are used by the animation controller JSON. Players can reference animations from the vanilla Minecraft Resource Pack or create their own. Custom animations should be in the animation folder at the root of the Resource Pack.

render_controllers

Specifies the names of render controllers. This name needs to match the name of a corresponding JSON located in the Render Controllers folder. Players can reference Render Controllers from the vanilla Minecraft Resource Pack or create their own. Custom Render Controllers should be in the textures folder at the root of the Resource Pack.

enable_attachables

Legacy, not used.

Filters

Filters allow data objects to specify test criteria which allows their use.

For example, a model that includes a filter will only be used when the filter criteria is true.

A typical filter consists of four parameters:

name: the name of the test to apply.

domain: the domain the test should be performed in. An armor slot, for example. This parameter is only used by a few tests.

operator: the comparison to apply with the value, such as 'equal' or 'greater'.

value: the value being compared with the test.

A typical filter looks like the following:

{ "test" : "moon_intensity", "subject" : "self", "operator" : "greater", "value" : "0.5" }

Which results in the calling entity (self) calculating the moon_intensity at its location and returning true if the result is greater than 0.5.

Tests can be combined into groups using the collections 'all_of', 'any_of', or 'none_of'.

All tests in an 'all_of' group must pass in order for the group to pass.

One or more tests in an 'any_of' group must pass in order for the group to pass.

All tests in a 'none_of' group must fail in order for the group to pass.

has_biome_tag

Tests whether the biome the subject is in has the specified tag.

Type	Name	Default	Description
String	operator	equals	(Optional) The comparison to apply with 'value'. Possible options include:
			- `!=` : Test for inequality.
			- `<` : Test for less-than the value.
			- `<=` : Test for less-than or equal to the value.
			- `<>` : Test for inequality.
			- `=` : Test for equality.
			- `==` : Test for equality.
			- `>` : Test for greater-than the value.
			- `>=` : Test for greater-than or equal to the value.
			- `equals` : Test for equality.
			- `not` : Test for inequality.
String	subject	self	(Optional) The subject of this filter test. Possible options include:
			- `block` : The block involved with the interaction.
			- `damager` : The damaging actor involved with the interaction.
			- `other` : The other member of an interaction, not the caller.
			- `parent` : The caller's current parent.
			- `player` : The player involved with the interaction.
			- `self` : The entity or object calling the test.
			- `target` : The caller's current target.
String	value		(Required) The tag to look for.

Examples

Full..

{ "test": "has_biome_tag", "subject": "self", "operator": "equals", "value": " " }

Short (using Defaults)..

{ "test": "has_biome_tag", "value": " " }

Server Entity Documentation

Server entity definitions are contained within a Behaviour Pack and contain all of the information necessary to describe how an entity should behave. To create your own, start by navigating to the "entity" folder inside the root of the Behaviour Pack. In the entity folder create a JSON file and give it a name. The JSON file needs a format version and minecraft:entity information.

The minecraft:entity section contains the description for the entity. Under description there are a number of things that you can set about an entity.

Example server entity definition JSON for the prismarine item drop:

{
  "format_version": "1.8.0",
  "minecraft:entity": {
    "description": {
      "identifier": "badger:item_prismarine",
      "is_summonable": true,
      "runtime_identifier": "badger:badger_mob"
    },
    "components": {
      "badger:aabb": {
        "height": 0.562500076294,
        "length": 0.0625,
        "width": 0.15625
      },
      "badger:template": "badger:template_item_orb",
      "badger:tags": {
        "tags": [
          "item",
          "xp_common",
          "ghostTriggerFriendly"
        ]
      }
    }
  }
}

Server Entity Description Properties

badger:aabb

Dimensions of this entities bounding box

Type	Name	Description
Decimal	height	The height of the entity.
Decimal	length	The length of the entity (optional if not specified the width is used).
Decimal	width	The width of the entity.

badger:action_tickets

Defines the action tickets that this entity has

Type	Name	Description
JSON Object	action_tickets	Defines the number of "action tickets" this entity has, which limits how many entities can target it simultaneously. Separated by category of action:
	- cc	Close combat tickets.
	- ct	Creeper-target tickets.
	- ht	Heal-target tickets.
	- rc	Ranged combat tickets.
	- sc	Secondary combat tickets.

badger:advanced_direct_reticle

Defines the entity archetype applied to the advanced direct reticle on the clientside.

Type	Name	Default Value	Description
String	reticle_entity_id		Defines the name of the entity archetype to use.
Decimal	reticle_radius		Defines the size of the advanced direct targeting reticle.

badger:aimable

Defines the ability to be aimed at a target location.

Type	Name	Description
Decimal	aim_speed	Defines the speed multiplier for the aiming reticle when using the mouse.
Boolean	exit_aim_on_shoot	Default is true, setting to false will not cancel the aim upon shooting
Decimal	gamepad_aim_speed	Defines the speed multiplier for the aiming reticle when using the thumb stick.
Decimal	max_range	Defines the max range that this entity can be aimed at.
Decimal	min_range	Defines the min range that this entity can be aimed at.
String	reticle_entity_id	Defines the name of the reticle entity to use.
Boolean	reticle_inherits_movement	When true, causes the aimable reticle to follow this entity when it moves.
String	shoot_action	Defines the name of the shoot action that this aimable is related to.
Decimal	starting_range	Defines the starting range that this entity will be aimed at when first interacted with.
Boolean	uses_move_stick	Sets whether this aimable should be controlled by the move stick, rather than the aim stick, when using a controller.

badger:aimable_turret

Flags an entity as a turret for an aimable entity.

badger:allay

Handles allay movement information.

Type	Name	Description
Decimal	between_blocks_travel_time	How many seconds it takes to move between blocks when working.
Decimal	bounce_scale	How frequently the allay bobs up and down.
Decimal	bounce_speed	How fast the allay bobs up and down.
Vector [a, b, c]	landed_position	Where the allay goes when it is working (offset from its target).
Decimal	max_range	Maximum distance the allay with travel to/from the player. When exceeded it disappears instead.
Decimal	radius_scale	How wide of a circle the allay makes around the target. Value of 1 should be just touching the corners.
Vector [a, b, c]	spawn_offset	Where the allay spawns/despawns in relation to the player
Decimal	spin_speed	How fast the allay rotates around its target
Decimal	travel_time	How many seconds it takes to move between destinations.

badger:allay_panic

sends a panicked allay home after a given time, destroying the gather order

Type	Name	Description
String	panicked_path	Icon name representing the panicked version of the allay.
Decimal	return_timer	Duration in seconds after being scared before the allay returns home. Leave undeclared for an infinite return time.
Decimal	scare_delay	Duration in seconds before the allay becomes scared.
JSON Object	scare_filter	Configuration for the allay's panic filtering criteria.
	alliance_rule_filter	Name of the alliance rule filter applied to the allay's panic behavior.
	exclude_tags	List of tags to be excluded when filtering potential threats.
	include_tags	List of tags to be included when filtering potential threats.

badger:aoe

Defines the settings used to spawn an AoE entity

Type	Name	Description
Array	damage_effects	Defines the damage effects applied within the AoE.
	damage	The amount of damage dealt to entities inside this AoE.
	exclude_tags	The tags required for an entity to not be influenced by this AoE.
	include_tags	The tags required for an entity to be influenced by this AoE.
	requires_los	Indicates whether the AoE requires line of sight (LoS) from the shape pivot to the target to apply damage.
JSON Object	shape	Specifies the shape used for the AoE.
JSON Object	timer	Defines the timing for applying the effects of the AoE.
	interval	The time, in seconds, between applying the effect(s) of the AoE.
	jitter	An array of ticks that modifies the intervals, providing pseudo-randomness to ease performance strain on the AoE.

badger:applies_buffs

Defines this entity's ability to confer buffs to nearby entities.

Type	Name	Description
String	apply_buff_cancel_trigger	The trigger event to send when a buff candidate that started having a buff applied to it is instead interrupted and does not receive a buff.
String	apply_buff_complete_trigger	The trigger event to send when a buff candidate finishes having a buff applied to it.
String	apply_buff_start_trigger	The trigger event to send when a buff candidate starts having a buff applied to it
Integer	available_charges	How many times can this entity dispense a buff. After charges are spent the entity destroys itself. -1 means infinite charges.
String	charge_used_trigger	The trigger event to send when a charge is used.
String	charges_molang_name	The name of the molang variable representing the number of charges.
Array	preset_buffs	The preset buffs to be applied by this entity. Use this if the buffs applied by this entity should not be modifiable.
Boolean	wipe_buffs	Whether this buff applicator wipes existing buffs on the receiving entity before applying its own buffs

badger:apply_damage

Defines the settings for applying damage.

Type	Name	Default Value	Description
JSON Object	damage		The damage to apply.

badger:apply_status

Defines the settings for applying status effects.

Type	Name	Default Value	Description
JSON Object	apply_status		The list of status effects to apply.

badger:atomic_village_exempt

Dictates whether this entity can cause its owning village to force suspension.

Type	Name	Default Value	Description
Boolean	exempt_from_requests		This entity won't cause its owning village to force suspension.
Boolean	exempt_from_requests_and_suspension		This entity won't cause its owning village to force suspension nor will it forcefully be suspended when it's owning village is.

badger:audio_ignore_vo_reminder

This flags an entity to ignore VO reminders if the player is near this entity. Used for entities like villages

badger:aura_applicator

When applied to a structure, provides a buffing aura to entities within its zone of control.

Type	Name	Description
Array	auras	A list of buff auras used by this entity.
	alliance_rule_filter	The rule that determines which types of entities will be buffed (friendly, enemy, etc.).
	apply_to_build_previews	Indicates whether this buff applies to build previews (e.g., area overlay buffs).
	buff_id	The identifier of the buff to be applied by this entity.
	can_apply_to_self	Specifies whether this buff can be applied to the aura applicator itself.
	exclude_tags	Entities with any of these tags will not receive a buff.
	include_tags	Entities must have all these tags to receive a buff.
	load_affected_entities_on_construction_completion	If true, the entity will load all suspended entities affected by the aura.
	only_apply_to_construction_completed	Specifies whether this buff only applies to structures that have completed construction.
	only_apply_to_damaged	Specifies whether this buff only applies to damaged entities.
	persistent	Indicates whether this buff should persist after the aura applicator is gone.
	search_mode	Defines what entities this aura affects. Valid values include `zone`, `village`, and `spawner_controller`.
	unlock_condition	Enables or disables this aura depending on the presence of a given unlock resource.
	has_unlock	If true, this aura will only be active when the specified resource is acquired; if false, it will only be active if the resource is not acquired.
	resource	The name of the resource used to enable or disable this aura.
JSON Object	buff_queue	Optional data to add if the aura should be applied to entities in a queue.
	limit_concurrent_applications	The number of entities to which the aura is applied per unit of time.
	time_interval	The time interval for applying the aura.

badger:auto_deconstruction

Values used to tune the trigger points for auto deconstruction

Type	Name	Default Value	Description
Integer	distance		The minimum block distance the player has to be from this entity to trigger deconstruction
Boolean	team_owned	true	If true, will not deconstruct as long as in range of at least 1 team member. If false, deconstructs based on distance to constructing player.
Integer	warning_distance		The minimum block distance at which the player receives a warning that their structures will be deconstructed

badger:auto_despawn

Makes this entity be despawned when its too far from any player.

Type	Name	Default Value	Description
Integer	distance		Distance from players at which this entity will despawn.

badger:auto_fire

Settings to determine how auto firing behaves.

Type	Name	Description
Decimal	confirm_cooldown_time	amount of time in seconds before another round of auto firing can begin.
String	cooldown_molang_name	The name of the molang variable representing the cooldown state.
String	cooldown_start_event	The name of the presentation event fired when entering the cooldown state.
String	cooldown_stop_event	The name of the presentation event fired when exiting the cooldown state.
Decimal	shot_cooldown_time	amount of time in seconds in between auto fired shots.
String	shots_molang_name	The name of the molang variable representing the number of shots.
Integer	total_shots	number of shots to auto fire before needing to cool down.

badger:auto_lure

Controls if this spawner will automatically lure units on spawn/recall and which lures to apply

Type	Name	Default Value	Description
String	lure_action_id		The action ID triggered on the player if the player does not already have an active lure of the defined archetype. This should be the action that spawns the desired lure on the player.
String	lure_archetype		The lure Archetype to apply when this spawner creates a unit (Between it and the player that triggered it)

badger:auto_teleport

Attributes required for auto teleport lured distant entities to their luring entities

Type	Name	Description
Decimal	auto_teleport_distance	Minimum distance required between a lured entity and the luring entity for the lured entity to be auto-teleported.
Decimal	auto_teleport_offset_behind_camera	Distance from the camera to the auto-teleport destination, measured in the opposite direction of the camera's orientation.
JSON Object	auto_teleport_tag_filter	Tag filter to determine if a lured entity is eligible for auto-teleportation.
	exclude_tags	Tags that a lured entity must not possess to be considered for auto-teleportation to its luring entity.
	include_tags	Tags that a lured entity must have to qualify for auto-teleportation to its luring entity.

badger:background_loading

Dictates how a village entity is loaded in the background.

Type	Name	Default Value	Description
Integer	priority		Villages with a lower priority value will be planned and loaded first. The default value is 0.

badger:becomes_lost

Signifies that this entity can become lost, and gives the configuration for the lost state

Type	Name	Description
Array	alone_exclude_filters	A list of criteria specifying which units cannot be nearby for the entity to be considered lost.
	alliance_rule_filter	The alliance rule filter for this type of unit.
	exclude_tags	Tags that units must not have to be considered in this filter.
	exclusion_radius	The minimum distance that this type of unit must maintain from the entity to be considered lost.
	include_tags	Tags that units must have to be included in this filter.
String	lost_unit_pacing_buff_id	The buff applied to the unit when it is pacing.
Boolean	must_be_player_spawned	Indicates whether the unit must be spawned by the player to be considered lost.
Decimal	pace_destination_radius	The radius within which the unit will choose destinations to pace toward from the initial lost location.
Decimal	pace_frequency	The average frequency (in times per second) with which the unit changes direction while pacing.
String	return_to_player_alliance_rule	The alliance rule determining which player the unit will return to.
Decimal	time_alone_to_become_lost	The duration for which a unit must be 'alone' (as defined by the filter) before it is considered lost.
Decimal	time_pacing_before_returning	The duration a lost unit will pace before returning to the nearest friendly player.
Decimal	time_suspended_to_become_lost	The duration for which a unit must be suspended before it is considered lost.

badger:behavior_offline_traits

The component allows behaviors to change offline trait phase on behaviour swaps.

Type	Name	Default Value	Description
Enumerator	traits_phase		Defines which offline phase will be applied by the behaviour swap. List of valid values: PRECONSTRUCTION, CONSTRUCTING, BUILT, DECONSTRUCTING, DISABLED

badger:behavior_swap_interaction

Enables the use of an interaction to trigger behavior swap.

Type	Name	Default Value	Description
String	behavior		The behavior name to swap to upon interacting

badger:block_conversion

Converts any listed blocks to a modified version

Type	Name	Description
Decimal	duration_percentage	What percentage of the build time this conversion process should take
Array	exclude	The block types to exclude from this block conversion
Array	include	The block types to affect with this block conversion
JSON Object	modifiers	Key value pairs that describe which keywords should be replaced with other strings in block names
Boolean	top_to_bottom	Changes the order of block conversion to top to bottom

badger:block_damage

states what is required to place a buildable.

Type	Name	Description
List	phases	An array of damage phase descriptions, each containing the following properties:
	damage_level	The normalized damage level applied to the phase, ranging from 0.0 (no damage) to the maximum defined damage.
	max_clamp	The normalized position that represents the minimum damage applied.
	max_damage	The maximum damage level that can be applied during this phase.
	min_clamp	The normalized position that represents the maximum damage applied.
	min_damage	The minimum damage level that can be applied during this phase.

badger:block_reversal

Reverts any changed blocks to the original version

Type	Name	Default Value	Description
Decimal	duration_percentage		What percentage of the time this block revert process should take

badger:bsharp_interact_cost

states what is required to perform a B# interaction with this entity.

Type	Name	Default Value	Description
Array	resource_cost		An array of items and amounts.
Array	unlock		These are the unlocks needed to use this interaction. An array of items with an amount.

badger:bsharp_lifetime

Defines which global variable controls the lifetime of an entity.

Type	Name	Default Value	Description
Integer	value		Defines the value of the global variable that causes the entity to despawn.
String	variable		Defines name of the bSharp global variable.

badger:bsharp_teleport_presentation

Defines the entity's presentation event for teleportation.

Type	Name	Description
String	arrived_event	The name of the presentation event fired after the entity teleports
String	engaged_event	The name of the presentation event fired before/during the entity's teleportation
Decimal	windup_time	The time, in seconds, the entity waits after it and the teleport engaged presentation event is triggered before teleporting.

badger:buff

Defines a buff

Type	Name	Description
Decimal	application_time_seconds	The time in seconds an entity is required to wait before the buff is applied.
String	buff_category	A category for the buff. Only for organizational grouping purposes and has no effect on gameplay.
Array	ingredients	The resources which will be spent / consumed to apply this buff. A buff must have costs to be placeable on a slotted buff applicator.
Boolean	propagates_to_projectiles	Whether this buff is propagated to projectiles created by the entity this buff is applied on.

badger:build_speed_change_on_damage

Temporarily change the build speed of a buildable structure when being damaged

Type	Name	Default Value	Description
Decimal	build_speed_multiplier		the multiplier that will be used to adjust the build speed
Integer	duration		the time in seconds for which the adjustment will be applied

badger:buildable_controller_spawner

will spawn Mobs from components position.

Type	Name	Description
String	biome	Title of the the Biome Selector
Array	biome_set	The set of valid Biomes
Array	claimed_area	List of Spawners to spawn based on claimed areas
String	claimed_by	Max mobs spawned that are still alive. -1 indicates there is no cap
String	generic_BSharp	Title of the B-Sharp Selector
Array	global_active	List of Spawners to spawn based on global variables
String	horde_name	Name Of Global Horde
String	horde_variant	Set the horde variant to spawn (only for Biome / BSharp), the others will auto pick
Boolean	match_any	If we should force all conditions to check
Array	spawn	Names of Spawners to Place
String	static	Names of spawners to always place
Integer	ticks_between_checks	How many ticks to wait between checking conditions
Array	times	List of Times we want this option to be valid
Array	valid_value_set	The set of valid values of the watch B-Sharp Value
String	variable_name	The Gobal B-Sharp Variable to Watch
Integer	weight	The weight to pick this choice

badger:buildable_creation_influence_source

Provides a list of sources of additive or substractive influence upon building creation for this AI.

Type	Name	Description
List	sensors	List of building creation sources.
	building_start_or_complete	Designate whether building creation will be tracked at the start or upon completion of placement.
	damage_receiver_filter	Specify particular types of structures to track based on damage received.
	alliance_rule_filter	Define team alliance rules for tracking.
	exclude_tags	Tags to exclude for building structures.
	include_tags	Tags to include for building structures.
	multiplier	The weight of the heat stamp for this building creation source, affecting how significant the heat impact is.
	propagation_decay	The propagation or spread decay of the heat stamp for this building creation source, determining how quickly the heat impact diminishes over time.

badger:buildable_destruction

states what is required to animate a building's destruction.

Type	Name	Default Value	Description
String	particle_effect		The name of the particle effect that will be played when the structure is removed.

badger:buildable_destruction_influence_source

Provides a list of sources of additive or substractive influence upon building destruction for this AI.

Type	Name	Description
List	sensors	List of building creation sources.
	damage_receiver_filter	Tracks particular types of structures.
	alliance_rule_filter	Defines team alliance rules for tracking.
	exclude_tags	Tags to exclude for building structures.
	include_tags	Tags to include for building structures.
	multiplier	The weight of the heat stamp for this building destruction source.
	propagation_decay	The decay rate of the propagation/spread of the heat stamp for this building destruction source.

badger:buildable_foundation

Dictates what to place as the foundation.

Type	Name	Description
String	custom_block	The full name of the block to be used on the foundation
String	nbt_file	Name of the nbt file to place as the foundation.
Integer	offset	Number of blocks downwards to offset the placement of this foundation.
String	pillar_height	The height of the pillar-style foundation
Boolean	place_instant_block_by_block	Whether to override the instant placement behavior of this foundation.
String	placement_rule	The rule that dictates when to place this foundation: always, instant_only
String	style	Style of foundation to generate: inverted_pyramid, pillar, bowl, dome, supports

badger:buildable_health_generation

Parameters used to calculate the normalized initial health of structures upon initial constructing.

Type	Name	Default Value	Description
Decimal	initial_health_percentage		The initial health of the entity normalized. Calculated by a percent of their max health

badger:buildable_intangible

When applied to a buildable, it prevents it from blocking the placement of other buildings.

badger:buildable_presentation

Structure information to display in the UI.

Type	Name	Default Value	Description
Boolean	allow_stacking	false	Does this entity support stacking
String	buildable_category		Which hotbar category this placeable belongs in.
Boolean	force_hide_when_locked	false	will hide even if show_locked_recipes is true.
Boolean	has_alternate_icon	false	Does this entity have an aulternate icon
Integer	height_offset		The height above or bellow the ground the cursor will sit when actively placing.
String	icon		What thumbnail image to display in the UI.
String	ping_message		The message that appears to teammates when pinging the structure from build preview. Can accept a parameter for the pinging player's name.
Integer	segment_offset		The height above or bellow the multisegment placement line this segment should be placed.
Integer	sort_order		value for the sorting order within the ui.
String	tactical_description		The structure tactical description to display in the UI.
String	tooltip_description		The structure tooltip description to display in the UI.
String	tooltip_title		The structure tooltip title to display in the UI.

badger:buildable_replaceable

Flag Attribute that indicates if the structure can be replaced by other structures

badger:buildable_requirement

states what is required to place a buildable.

Type	Name	Description
JSON Object	blocker_entities	The entities that must not collide with this structure for it to be built.
	alliance_rule_filter	Alliance filter rule that applies to this structure.
	exclude_tags	List of tags for entities that are excluded from colliding with this structure.
	include_tags	List of tags for entities that are included as blockers for this structure.
String	exclusive_zone_alliance_rule	Alliance rule that defines the restrictions for this exclusive zone.
Boolean	invalid_block_snaptoground	Determines whether to snap to ground blocks below the building when checking for invalid blocks.
Array	invalid_block_tags	List of block tag types that this buildable cannot be placed on.
Array	invalid_blocks	List of block types (e.g., dirt, air, water, lava) that this structure cannot be built upon.
Array	recipe	An array of items and their corresponding amounts needed for crafting this structure.
Array	ticket_cost	An array representing the cost in tickets and their respective amounts required for this structure.
Array	unlock	List of items and amounts required to unlock certain buildings.
String	zone_alliance_rule	Alliance rule filter that determines the zones in which this structure can be placed (e.g., any_team, enemy, friendly, etc.).

badger:buildable_snap_point

When applied to a buildable, it flags it as being a position snapping target for previews.

Type	Name	Default Value	Description
Integer	top_snap_offset		This adjusts the height which previews snap to, when they snap to the top of this structure.

badger:buildable_spawner

will spawn Mobs from components position.

Type	Name	Description
JSON Object	blocker_entities	The entities that must not collide with this structure for it to be built.
	alliance_rule_filter	Alliance filter rule that applies to this structure.
	exclude_tags	List of tags for entities that are excluded from colliding with this structure.
	include_tags	List of tags for entities that are included as blockers for this structure.
String	exclusive_zone_alliance_rule	Alliance rule that defines the restrictions for this exclusive zone.
Boolean	invalid_block_snaptoground	Determines whether to snap to ground blocks below the building when checking for invalid blocks.
Array	invalid_block_tags	List of block tag types that this buildable cannot be placed on.
Array	invalid_blocks	List of block types (e.g., dirt, air, water, lava) that this structure cannot be built upon.
Array	recipe	An array of items and their corresponding amounts needed for crafting this structure.
Array	ticket_cost	An array representing the cost in tickets and their respective amounts required for this structure.
Array	unlock	List of items and amounts required to unlock certain buildings.
String	zone_alliance_rule	Alliance rule filter that determines the zones in which this structure can be placed (e.g., any_team, enemy, friendly, etc.).

badger:buildable_structure

Dictates what to place as the structure.

Type	Name	Description
Decimal	build_time	How long it takes for the buildable to be constructed in the world in seconds.
String	buildable_placed_player_trigger	The name of the Presentation Trigger to fire on the PLAYER when placing this structure.
String	construction_end_trigger	The name of the Presentation Trigger to fire when construction ends.
String	construction_start_trigger	The name of the Presentation Trigger to fire when construction starts.
JSON Object	faction_variations	Alternative NBT file to place for a given faction name.
String	nbt_file	Name of the nbt file to place as the structure.
Boolean	silence_destroyed_trigger_when_killed	Whether the on_building_destroyed trigger should be silenced when the building is killed.

badger:campaign_team

Some general attributes that describe a faction.

Type	Name	Default Value	Description
String	team_tag		Name of the team to put this entity on.

badger:causes_fear

Defines this entity as a status effect that causes its target to fear the status inflictor.

badger:chunk_reload_indestructible_flag

Used to exclude a buildable from a destructive world reload

badger:cinematic_death

The entity should play a cinematic on death. This encodes which cinematic plays. Note there is a 60 second failsafe to ensure the entity dies.

Type	Name	Default Value	Description
List	cine_id		The IDs of the cinematic that plays when this entity dies.

badger:claimed_area_excluded

For entities that should always be excluded from ClaimedAreaSystem. This is only in regards to bases being assigned to claimed areas.

badger:clear_from_zone_of_control

Flags this entity to be removed if it overlaps with a Zone of Control of an entity that passes the tag filter

Type	Name	Description
Array	exclude_tags	The tags to be excluded in when filtering
Array	filter_tag_set	Tags that filters out entities with ZOC
Array	include_tags	The tags to be included in when filtering

badger:collision_weight

Defines the weight of an entity.

Type	Name	Default Value	Description
Decimal	weight		Defines weight of this entity for the purposes of collision with other entities.

badger:conditionally_solid_blocks

Defines which extra blocks will be considered solid during pathfinding & collision checks.

Type	Name	Default Value	Description
Array	exclude_tags		Defines the exclude set of block tags to consider conditionally solid.
Array	include_tags		Defines the include set of block tags to consider conditionally solid.

badger:conflict_config

Configuration data if this entity has special overrides when managed by a conflict coordinator.

Type	Name	Default Value	Description
String	invulnerable_behavior		Behaviour to use when this entity is invulnerable via a conflict coordinator. Reverted to default when vulnerable.

badger:conflict_coordinator

Declares a (spawn controller) entity to be a conflict coordinator, prolonging spawned mob conflict until player interaction.

Type	Name	Default Value	Description
String	activated_tag		Tag added/removed from the coordinator when activated.
Decimal	player_engagement_distance		Distance from the coordinator a player needs to be, to be considered as engaged.

badger:core_resource_consumer

Dictates resource consumer behaviour.

Type	Name	Description
JSON Object	blocker_entities	The entities that must not collide with this structure for it to be built.
	alliance_rule_filter	Alliance filter rule that applies to this structure.
	exclude_tags	List of tags for entities that are excluded from colliding with this structure.
	include_tags	List of tags for entities that are included as blockers for this structure.
String	exclusive_zone_alliance_rule	Alliance rule that defines the restrictions for this exclusive zone.
Boolean	invalid_block_snaptoground	Determines whether to snap to ground blocks below the building when checking for invalid blocks.
Array	invalid_block_tags	List of block tag types that this buildable cannot be placed on.
Array	invalid_blocks	List of block types (e.g., dirt, air, water, lava) that this structure cannot be built upon.
Array	recipe	An array of items and their corresponding amounts needed for crafting this structure.
Array	ticket_cost	An array representing the cost in tickets and their respective amounts required for this structure.
Array	unlock	List of items and amounts required to unlock certain buildings.
String	zone_alliance_rule	Alliance rule filter that determines the zones in which this structure can be placed (e.g., any_team, enemy, friendly, etc.).

badger:counterattacker

Defines counterattacks that are performed when the entity is attacked by others.

Type	Name	Default Value	Description
List	counterattacks		List of counterattacks.

badger:culture

Base culture values for entity

Type	Name	Description
Decimal	base_culture_a	Base culture Score_A value intended for scoring buildings. Todo: Can later be improved to do dynamic culture modifiers based on upgrades.
Decimal	base_culture_b	Base culture Score_A value intended for scoring buildings. Todo: Can later be improved to do dynamic culture modifiers based on upgrades.
Decimal	base_culture_c	Base culture Score_A value intended for scoring buildings. Todo: Can later be improved to do dynamic culture modifiers based on upgrades.
Boolean	is_hq	Does this culture count as an HQ (used for determining new buildings culture type, for now)

badger:culture_status

Data related to the accumulation of culture.

Type	Name	Description
Integer	thresholdA	Reward threshold for culture value A.
Integer	thresholdB	Reward threshold for culture value B.
Integer	thresholdC	Reward threshold for culture value C.
Array	thresholds	Array of culture reward thresholds.

badger:damage_influence_source

Provides a list of sources of additive or substractive damage influence for this AI.

Type	Name	Description
List	sensors	A collection of damage sources with specific filters and settings.
	damage_receiver_filter	Tracks particular types of units or structures that receive damage.
	alliance_rule_filter	Specifies team alliance rules for tracking damage sources.
	exclude_tags	Tags for units that should be excluded from receiving damage.
	include_tags	Tags for units that should be included in damage tracking.
	damage_type_filter	Tracks specific types of damage relevant to the sensors.
	exclude_any	Excludes any tags of damage from being considered.
	include_all	Includes all tags of damage for tracking purposes.
	inflictor_or_receiver_position	Designates whether the tracking occurs at the inflictor (source of damage) or receiver (recipient of damage) position.
	multiplier	The weight or intensity of the heat stamp applied to this damage source.
	propagation_decay	The rate at which the heat stamp decays or spreads over time for this damage source.

badger:damage_over_time

Makes a status effect apply damage over time to its host.

Type	Name	Description
JSON Object	damage	Contains the damage data applied by this effect.
	damage_amount	Specifies the amount of damage inflicted.
	damage_types	A list of damage type names, represented as strings.
Decimal	interval	Defines the time interval, in seconds, at which damage is applied.

badger:damage_receiver

Allows entities to be damaged by attacks.

Type	Name	Description
Boolean	attack_slots	Specifies whether this damage receiver generates specified attack spots for attackers
String	auto_generate_shape	Set this to 'capsule', 'cylinder' or 'aabb' to auto generate the damage receiver shape using the entity's collision aabb.
JSON Object	damage_resistances	Specifies the damage resistance values
String	shape	Defines the shape of the damage receiver (the shape tested as the recipient for damage during an attack) to be used for collision against damage applicators (weapons' collision shapes).

badger:damage_receiver_material

Defines the material tag to use when an entity is hit with an action.

Type	Name	Default Value	Description
String	material		Defines the material to be used for presentation events when this entity is hit by an appropriate damage applicator.

badger:damage_source_telemetry_tracker

Determines whether or not the latest damage source is tracked for telemetry by this entity

badger:death_telemetry_tracking

Defines the settings used when tracking telemetry for killed entities.

badger:deconstruction

Scalar values to tune the amount of resources refunded and the time to deconstruct structures

Type	Name	Description
Boolean	clear_siblings	Set to true if you wish all sibling (multistep) entities should be removed on deconstruction
Decimal	deconstruct_time_percent	The scalar to speed up/slow down deconstruction of the entity
Boolean	isIndestructable	A flag used to determine if the entity cannot be deconstructed
Array	resource_cost	The list of resources required to apply this deconstruction action.
Decimal	resource_refund_percent	The scalar to refund more/less of the resources that was required to construct the entity
Array	ticket_cost	The list of tickets required to apply this deconstruction action.
Array	unlock	The list of unlocks required to apply this deconstruction action.

badger:delayed_jump

An entity with this component is able to jump after leaving the group for a set amount of time.

Type	Name	Default Value	Description
Decimal	delay_time		The time that the player will still be able to jump after no longer touching the ground.

badger:destroy_on_village_destruction

Determines if this entity has custom destruction behaviour when its owner village is destroyed.

Type	Name	Default Value	Description
Boolean	group		The special destruction behaviour to use (eg. staggered destruction). Correlates to what is defined in badger:village_heart_destruction on the village entity.
Boolean	ignore	false	If this entity should not be destroyed when the village is destroyed.

badger:destruction_vfx

Customized VFX behaviour upon being destroyed.

Type	Name	Default Value	Description
Boolean	always_play_vfx		Whether or not to force the destruction VFX.

`badger:difficulty_modifier_accuracy_min_range` & `badger:difficulty_modifier_accuracy_max_range`

Modifiers for min and max accuracy range based on difficulty.

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.
wave_post_multiply	Multiplied by the Wave Level, then added after all other modifiers. Applied only if the `WAVE_SCALING_DIFFICULTY` game rule is true.

badger:difficulty_modifier_build_speed

Modifiers for build speed based on difficulty and custom game options

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_building_cost

Modifier for building costs based on difficulty or custom game setting.

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_damage

Modifiers for damage based on difficulty

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.
wave_post_multiply	Multiplied by the Wave Level, then added after all other modifiers. Applied only if the `WAVE_SCALING_DIFFICULTY` game rule is true.

badger:difficulty_modifier_fall_damage

Modifiers for fall damage on difficulty and custom game option

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_fall_damage_distance

Modifiers for fall damage distance based on difficulty and custom game option

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_gravity

Modifiers for gravity based on difficulty and custom game options

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_health_regeneration

Modifier for health regeneration based on difficulty or custom game setting.

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_jump_gravity

Modifiers for jump gravity based on difficulty and custom game options

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_jump_height

Modifiers for jump height based on difficulty and custom game options

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_knockback

Modifiers for knockback based on difficulty and custom game option

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_knockback_resistance

Modifiers for knockback resistance based on difficulty and custom game options

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_max_health

Modifiers for max health based on difficulty

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.
wave_post_multiply	Multiplied by the Wave Level, then added after all other modifiers. Applied only if the `WAVE_SCALING_DIFFICULTY` game rule is true.

badger:difficulty_modifier_resistance

Modifiers for damage resistances based on difficulty

Custom Game Settings

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings affect the numeric modifier.
	numeric_modifier_type	What type of modifier the named custom game setting will apply to this entity. Valid values are: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding 'post_' counterparts. Effects of multiple game settings set to the same modifier WILL stack.
	scaling_factor	A multiplier that changes how much the custom game setting will affect the numeric modifier. This is useful for scaling when multiple numeric modifiers need to use the same custom game setting differently. Formula: '((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0'
	setting_name	Name of the custom game setting to read from.

Damage Types

Type	Name	Description
Array	damage_types	Modifiers for specified damage types as JSON key names. Modifiers not specified in this array will affect damage resistance across all types.
	append_resistance_to_entities	Boolean to append the resistance to entities if absent from the mob data.
	custom_game_settings	Defines which custom game settings affect this numeric modifier.
	numeric_modifier_type	What type of modifier the named custom game setting will apply to this entity. Valid values are: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding 'post_' counterparts. Effects of multiple game settings set to the same modifier WILL stack.
	scaling_factor	A multiplier that changes how much the custom game setting will affect the numeric modifier. This is useful for scaling when multiple numeric modifiers need to use the same custom game setting differently. Formula: '((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0'
	setting_name	Name of the custom game setting to read from.
	difficulties	The settings for each difficulty level.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:difficulty_modifier_spawning_cost

Modifier for mob spawning costs based on difficulty or custom game setting.

Custom Game Settings:

Type	Name	Description
JSON Object	custom_game_settings	Defines which custom game settings impact this numeric modifier.
	numeric_modifier_type	Type of modifier for the named custom game setting. Valid values include: `pre_multiply`, `pre_add`, `pre_subtract`, `pre_divide`, and their corresponding `post_` counterparts. Multiple settings with the same modifier will stack.
	scaling_factor	Multiplier that adjusts how much the custom game setting affects this numeric modifier. The formula used is: `((CustomGameSettingValue - 1.0) * ScalingFactor) + 1.0`. Useful for scaling modifiers differently.
	setting_name	Name of the custom game setting to read from.

Difficulty Settings:

Type	Difficulty	Modifiers
JSON Object	difficulties	Settings for each difficulty level.
	Custom	Custom difficulty modifiers.
	Easy	Easy difficulty modifiers.
	Normal	Normal difficulty modifiers.
	Hard	Hard difficulty modifiers.
	Peaceful	Peaceful difficulty modifiers.

For each difficulty, the following modifiers are applicable:

Modifier	Description
post_add	Amount added after all other modifier values.
post_multiply	Percentage multiplied after all pre-modifier values are applied.
pre_add	Amount added after pre-multiply values, but before any other modifiers.
pre_multiply	Percentage multiplied before any other modifier values are applied.

badger:disable_by_health

Converts any listed blocks to a modified version

Type	Name	Description
Decimal	block_conversion_cinematic_delay	The delay in seconds before block conversion starts if a cinematic is played (default: 0).
JSON Object	block_conversion_states	Block conversion data for when the structure is disabled or enabled by health.
	disabled_state	Data used when the entity is disabled.
	enabled_state	Data used when the entity is enabled.
String	cine_id	The cinematic ID to play when the entity is disabled. This field is optional.
Decimal	health_disabled_percent	The percentage of health that determines when the entity is disabled.
Decimal	health_enabled_percent	The percentage of health that determines when the entity is enabled.

badger:disables_actions

Defines this entity as a status effect that disables actions/attacks.

badger:disables_influence

Defines this entity as a status effect that disables influence on its receiver entity.

Type	Name	Description
JSON Object	tag_filter	The tag filter determines whether influence should be disabled on the receiver entity.
	exclude_tags	Tags that the receiver entity must not possess for influence to be disabled.
	include_tags	Tags that the receiver entity must possess for influence to be disabled.

badger:disables_movement

Defines this entity as a status effect that disables movement.

badger:disables_sprint

Defines this entity as a status effect that disables sprint.

badger:distant_stimulus_movement

Attribute that defines how entity moves to pursue the attacker after being attacked by a distant damage source

Type	Name	Description
Decimal	max_movement_duration	The maximum amount of time in seconds which the movement is allowed to take
Decimal	max_movement_range	The maximum distance allowed for the movement
Integer	min_distant_stimulus_distance	The minimum distance between the damage source and damage taker for the damage to be considered a distant stimulus
Decimal	nearby_ally_propagation_range	The radius around the attacked entity where nearby allies will also be alerted.
String	propagation_exclude_tags	Tags that nearby mobs must NOT have in order to be alerted when this entity is attacked.
String	propagation_include_tags	Tags that nearby mobs must have in order to be alerted when this entity is attacked.

badger:do_not_replace_buildables

Flag Attribute that indicates if the structure can replace existing structures.

badger:dynamic_scale_interpolate

Component that enables interpolation and specifies an interpolation speed when this entity is dynamically scaled

Type	Name	Default Value	Description
Decimal	interpolate_time		The interpolation time in seconds

badger:enable_respawn_when_discovered

Adds a flag component that we want to enable features when an entity is discovered

badger:engineer

Defines this entity as an engineer.

Type	Name	Description
String	building_behaviour	The behaviour name to use when building.
Decimal	max_travel_timeout	Maximum duration in seconds for engineer to travel to build zone (will be teleported afterwards).
Decimal	travel_timeout	Duration in seconds for engineer to travel to build zone (a buff will be applied afterwards).
String	travel_timeout_buff	The buff to apply when the engineer times out.

badger:engineer_station

Makes this village use engineers.

Type	Name	Default Value	Description
Boolean	destroy_buildable_on_engineer_destroyed		If buildables should be destroyed if assigned engineer dies before completion.
Decimal	reassignment_delay		The cooldown time before a build request can be reassigned to another engineer if the current one died.

badger:entity_collision

Defines the entity's entity collision properties.

badger:entity_leap

Enables the leaping functionality for the entity and defines the leap properties.

Type	Name	Description
Decimal	downward	The maximum vertical distance the entity will leap from.
Decimal	height_selection_bias	0 to 1 value to control how much to bias height proximity over horizontal distance. Defaults to 0.5.
Decimal	max_height	The maximum vertical distance the entity will leap from.
Decimal	max_range	The maximum horizontal distance the entity will leap from.
Decimal	max_target_dist_to_destination	The maximum horizontal distance allowed from a target location to a leap destination.
Decimal	max_target_height_to_destination	The maximum vertical distance allowed from a target location to a leap destination.
Decimal	min_height	The minimum vertical distance the entity will leap from.
Decimal	min_range	The minimum horizontal distance the entity will leap from.
Decimal	prep	The maximum vertical distance the entity will leap from.
Decimal	upward	The maximum vertical distance the entity will leap from.

badger:exclude_from_spatial_partition

Controls if this entity should be excluded from spatial queries.

badger:faction

Some general attributes that describe a faction.

Type	Name	Description
String	appearance_index	The appearance index used for faction variation.
String	appearance_name	The appearance name use for faction variation. If not set this faction will not be registered to have an appearance variation.
String	description	Brief description of the faction.
String	id	The unique internal identifier of this faction.
Boolean	is_default_appearance	The default appearance all factions should fallback to. Only one faction is allowed to be the default.
String	name	Name of this faction.

badger:fall_damage

Defines the settings used to calculate falling damage.

Type	Name	Description
Decimal	damage_per_block	Defines the damage per block distance fallen past the min damage distance.
Decimal	min_damage	Defines the minimum damage received by an entity that falls the minimum distance.
Integer	min_damage_distance	Defines the minimum distance the entity needs fall to get damaged. Measured in meters.
String	trigger_event	Optional trigger event to be used when fall damage occurs for this entity.

badger:fast_travel

Defines parameters for when this entity fast travels

Type	Name	Default Value	Description
Decimal	cooldown_time		The amount of time the entity waits after fast travelling.
Decimal	windup_time		The amount of time the entity waits before fast travelling.

badger:fast_travel_point

Indicates that this entity supports fast travel functionality

Type	Name	Description
String	incoming_alliance_rule_filter	The rule that determines which team's players can arrive at this fast travel point.
String	outgoing_alliance_rule_filter	The rule that determines which types of entities will be considered candidates for fast travel (e.g., friendly, enemy, etc.).
JSON Object	outgoing_tag_filter	Determines the tag filters and alliance rule for outgoing entities.
	exclude_tags	Entities with any of these tags are excluded from being candidates for fast travel when lured.
	include_tags	Entities with these tags are considered candidates for fast travel when lured.
String	spawn_point_archetype	The name of the archetype for the destination spawn point entity.

badger:fast_traveller

Indicates that this entity can fast travel.

Type	Name	Description
String	outgoing_alliance_rule_filter	The rule that determines which types of entities will be considered candidates for fast travel (e.g., friendly, enemy).
JSON Object	outgoing_tag_filter	Determines the tag filters and alliance rules for outgoing entities.
	exclude_tags	A list of tags; entities with any of these tags are not candidates for fast travel when lured.
	include_tags	A list of tags; entities with these tags are considered candidates for fast travel when lured.

badger:gatherable_resources

Contains the most commonly available resources to gather at this entity

Type	Name	Default Value	Description
Array	gatherable_resource_names		A list of resources names the entity drops

badger:generate_player_village

An entity that creates a village when placed in world

Type	Name	Description
String	factionId	Faction ID name
String	ownership_alliance_rule	Alliance of structures that can become owned by this structure's 'bagder:owned_territory' when it is placed.
String	villageId	Village ID name

badger:generate_ruins

With this component entities that contained ownedBlocks will leave behind a portion of their blocks when destroyed.

Type	Name	Default Value	Description
Integer	max		maximum block height of columns left behind
Integer	min		minimum block height of columns left behind

badger:glide

An entity with this component is capable of gliding.

Type	Name	Default Value	Description
Decimal	drag		The amount of drag to apply to vertical velocity while gliding, in the range (0, 1]

badger:glide_telemetry_tracking

Defines the settings used when tracking telemetry for mounts that are gliding.

badger:granted_actions

Defines the actions that are given to another entity that this buff entity is applying to.

Type	Name	Default Value	Description
List	actions		List of actions.

badger:has_saddle

Granted as a buff to indicated when an entity is seeking out mounts or riders

Type	Name	Default Value	Description
Boolean	despawn_if_dismounted	false	Whether or not this entity despawns if it has no rider
Decimal	mount_range	1.0	The minimum distance that an entity with a Saddle buff must be before activating a mount action
Decimal	search_range	10.0	The maximum distance that an entity with a Saddle buff will search for a mount or rider

badger:health

Amount of Max health for entity

Type	Name	Default Value	Description
Decimal	max_health		How much health this entity has. Entity dies or is destroyed when health reaches zero.

badger:health_regeneration

The amount of health that regenerates per second

Type	Name	Description
Decimal	attack_cooldown_seconds	The cooldown before the entity can regenerate health again after attacks
Decimal	health_regen_amount	The amount of HP (per second) the entity can regenerate
Decimal	regen_cooldown_seconds	The cooldown between each health regeneration
Boolean	regen_while_suspended	Whether or not the entity regens health while suspended

badger:heartbeat

An entity with this component will despawn after the timer runs out. The timer is reset by specific (hard coded) interactions related to combat and control.

Type	Name	Default Value	Description
Decimal	min_expire_time		How much time in seconds before this entity expires if not interacting.

badger:hit_effect

Defines a hit effect

Type	Name	Default Value	Description
String	on_hit_target_trigger		The name of the trigger event to send on the target being hit when this hit effect is applied.
String	trigger		The name of the trigger event to send on the entity applying the hit effect when this hit effect is applied.

badger:hud_message_proximity

A list of Hud messages. Each are triggered when player is in proximity

Type	Name	Description
List	messages	A collection of different HUD messages.
	cooldown_seconds	The cooldown period (in seconds) between sending the HUD message.
	filter	Tags used to define which type of entity can trigger the HUD message.
	alliance_rule_filter	The alliance rule used to determine which type of entity should trigger the HUD message.
	exclude	Tags that are excluded from filtering when determining which entities can trigger the HUD message.
	include	Tags that are included when filtering for entities that can trigger the HUD message.
	hud_message_args	A list of arguments that will be used in the HUD message.
	hud_message_id	The string ID associated with the HUD message.
	range	The effective range within which an entity must be to trigger the HUD message.

badger:hurtbox

Adding this description to an entity will indicate it is a hurtbox child entity.

Type	Name	Description
Boolean	default_hurtbox	Designates this as the primary hurtbox. The parent may have either zero or one of these. Used as the default hurtbox to redirect to, when things are targeting redirector hurtboxes.
Boolean	no_tickets	Decides whether or not this entity opts out of inheriting parent's tickets. If set to true this hurtbox will provide no action/attack tickets.
Boolean	target_assigner_redirect_to_default	When true, this will redirect target assigner targeting to the default hurtbox of the parent.

badger:hurtbox_tags

Designer prescribed tags that will be transferred to any hurtboxes this entity may have.

Type	Name	Default Value	Description
Array	tags		The tags to add to this entity's hurtboxes.

badger:influence_map_ai

Denotes this entity as an influence map AI. It will create and manag influence maps.

Type	Name	Description
Decimal	map_decay	Rate of decay of heat wiith regards to time persists in world
Decimal	map_resolution	Resolution of this map
Decimal	perception_radius	Perception range of the map for any influence sources
String	query_name	Query Name for any units assigned to this AI
Boolean	sensing_when_idle	Boolean on whether this AI should be tracking sensor information even when idle (no units/entities currently following this AI). Default set to NOT sense when idle.

badger:influencer_coordinator

Defines this entity as a coordinator of one or more (child) influencer entities. A coordinator can be an influencer itself.

Type	Name	Description
Boolean	create_follow_path	Whether or not to create a follow path.
Boolean	despawn_if_empty	Whether or not the coordinator despawns as soon as there is no entity being influenced by it.
Decimal	formation_aspect_ratio	The aspect ratio of columns to rows for the box formation.
Decimal	formation_jitter	The jitter applied to each position in the box formation.
Decimal	formation_separation	The separation distance between the lure entity and the entities in the box formation.
Integer	max_follower_count	Directly sets the max number of units influenced at once by this entity. If max_followers_resource is also specified it will use the smaller of the two.
String	max_followers_resource	The name of the resource corresponding to the maximum number of entities that can be influenced at once. Unlimited if unspecified. If max_follower_count is also specified it will use the smaller of the two.
Decimal	trigger_formation_update_radius	When the player stops the formation will not update until the player leaves the radius positioned at the players last stationary position

badger:interactable

Defines the entity's ability to be interacted with by other entities, and the interactions that can be performed on it.

Type	Name	Description
Array	interactions	Entries defining what interactions can be performed on the entity.
	alliance_rule_filter	Alliance rule that filters which teams can interact with this entity; typically set to "friendly."
	camera	Camera mode to switch to when interacting with this entity; intended for use with "badger:aimable."
	default_disabled	When true, this entity cannot be interacted with by default until another condition enables it.
	delay	Delay, in seconds, before the interact UI appears after highlighting the interactable.
	exclude_tags	Tags that the interactor must not have in order to interact with this entity.
	exclusive_interactor	When true, only one interactor can interact with this entity at a time.
	include_tags	Tags that the interactor must have in order to interact with this entity.
	input_layout_override	Input layout to use when highlighting this interactable, setting the buttons and UI needed for the interaction.
	input_layout_under_construction	Same purpose as `input_layout_override`, but applies during the construction phase of a buildable entity.
	interaction_priority	Defines which interactions take precedence over others when several are in range; zero is the default, with higher values taking priority.
	name	Name of the interaction.
	only_restrict_angle_while_luring	When true, the angle restriction defined by `restricted_interact_angle` will only apply if the interactor is luring mobs; this helps reduce input conflicts.
	range	The interactor must be within this distance for the interaction to appear.
	restricted_interact_angle	When set, players must aim their cameras at the target within this many degrees to interact with it; when not set, players can interact without aiming at the target.

badger:interactor

Defines the entity's ability to interact with other entities, and filters what entities it may interact with.

Type	Name	Description
String	alliance_rule_filter	Determines what team an entity must be on for this interactor to interact with it. Set to any_team by default.
Array	exclude_tags	Determines what tags an entity must NOT have for this interactor to interact with it.
Array	include_tags	Determines what tags an entity must have for this interactor to interact with it.

badger:interacts_with_blocks

Defines that this entity can interact with world blocks

badger:invader

For entities that will contribute to the invasion.

badger:invasion_defense_value

Defines the defensive value of this entity. Used for protecting culture villages.

Type	Name	Default Value	Description
Decimal	defense_multiplier		Defines this structure's ability to boost all the active defenses of it's village.
Integer	defense_value		Defines this structure's ability to actively defend it's village.

badger:inventory

Defines the inventory for this entity.

Type	Name	Default Value	Description
Decimal	drop_force		The force with which the items are dropped.
Decimal	drop_percentage		The percentage of the inventory that is dropped upon death.

badger:item_collection

Defines the rules which regulate which items are able to be collected by players.

Type	Name	Description
String	alliance_rule_filter	The alliance rule filter defining whether or not items can be collected by players on a given team.
Boolean	allow_failed_collections	If true, the item will be collected and dissapear even if it adds no resources to the collector's inventory.
Decimal	collection_delay	The time in seconds after dropping before this item can be picked up.

badger:jump

An entity with this component is capable of jumping

Type	Name	Description
Decimal	hold_duration	How long the button will be held down before a full jump is performed.
JSON Object	hold_velocity	The interpolated velocity applied to the entity from the beginning of the jump being held down (start) to the end (end). This is optional, and by default just ignores gravity
Decimal	initial_height	Approx. how high the entity will jump (on a possessed entity, when tapping the jump button)
Boolean	jump_from_water	Whether or not the entity can jump while in deep water.
Integer	number_of_midair_jumps	Number of midair jumps (double jumps) the entity may make without touching the ground.
Array	trigger_event_status_filter	If one or more status effect specified in this array is active when the entity jumps, trigger the event defined by trigger_event_with_status
String	trigger_event_with_status	If one or more status effect specified in trigger_event_status_filter is active when the entity jumps, this event will be triggered

badger:knockback

Defines the settings applying knockback.

Type	Name	Default Value	Description
JSON Object	knockback		Defines an offset, which defines the center point of falloff calculations. (Optional)

badger:knockback_resistance

Defines the settings for knock back resistance.

Type	Name	Default Value	Description
Decimal	affected_scale		Defines how much a mob is affected by knock back.

badger:labelled_offsets

A set of labelled positional offsets relative to the entity with this description. Used to define and identify specific points on the entity.

badger:leap_destination

Marks the entity as a potential destination for entities to leap to.

badger:leash

Prevents the entity from getting too far from its spawn point.

Type	Name	Default Value	Description
Decimal	leash_range		The maximum range that the entity can be from its tether point (spawn point).
Decimal	return_range		The range at which the entity will move to once it leaves its leash range.

badger:leash_on_stop

Prevents the entity from getting too far from where it last stopped.

Type	Name	Description
Decimal	leash_range	The maximum range that the entity can be from its tether point (where it last stopped).
Decimal	return_range	The range at which the entity will move to once it leaves its leash range.
Boolean	return_when_not_targeting	If true, leashed entity will return when it is not targeting.

badger:loot

Dictates the loot drops to spawn when the entity is destroyed.

Type	Name	Description
Array	overrides	The overridable loot tables supported by this entity.
	name	The name of the override used to select the loot table.
	table	The specific loot table to use if selected.
String	table	The loot table that determines the default potential rewards for this entity.

badger:loot_collector

Enables this entity to collect loot.

Type	Name	Description
String	alliance_rule_filter	The alliance rule filter determining if the collector can see inventory drops on other teams
Decimal	collect_time	The loot collection time in seconds.
Vector [a, b, c]	offset	The loot collection destination offset.
Decimal	radius	The loot collection radius.

badger:lost_entity_recall_point

Attribute that specify the minimum distance between an entity and a recall structure for the entity to be considered lost

Type	Name	Description
String	alliance_rule_filter	The alliance rule that an entity must match for the recall point to potentially recall this entity.
Integer	arrival_max_height_difference	Maximum height difference between a recalled entity's arrival location and the recall point's location.
Decimal	arrival_max_radius	Maximum radius within which a recalled entity will arrive.
Decimal	arrival_min_radius	Minimum radius within which a recalled entity will arrive.
Boolean	disable_influencing_during_channel	If true, entities being recalled by this recall point will not be influenced during the channel.
Boolean	include_in_combat	If true, the recall point can recall entities that are engaged in combat.
Decimal	min_entity_distance_from_hero	The minimum distance between an entity and a hero (the hero should match the alliance rule) for the entity to be considered lost.
Decimal	min_recall_radius	The minimum distance between an entity and this recall point for the entity to be considered lost.
String	recall_zone_requirement	Specifies a zone requirement for recall; recalling from structures outside that zone will no longer work.
JSON Object	tag_filter	The tag filter used to determine if an entity could potentially be recalled to this recall point.
	exclude_tags	Tags that an entity must not have for the recall point to potentially recall this entity.
	include_tags	Tags that an entity must have for the recall point to potentially recall this entity.

badger:lure

Defines how the entity can lure other entities.

Type	Name	Description
Decimal	active_timer	The number of seconds this lure will actively influence new entities, after which it will become dormant (unless reactivated otherwise). Set to 0 for an instantaneous lure.
String	alliance_rule_filter	The rule that determines which types of entities that will be lured (friendly, enemy, etc.).
Boolean	applies_strict_ownership	When true, this lure will retain "strict ownership" of any influenced mobs, preventing other players from controlling them as long as they are lured.
Boolean	can_attack_along_line	If true, mobs can attack any targets they can reach within the bounds of the linear leash. Requires 'leash_to_line' to be true.
Boolean	center_effect_on_owner	If true, the lure will affect an area around the lure's owner, rather than the lure itself. Lured entities will still move toward the lure itself.
String	chained_preceding_lure_archetype	Spawns the defined lure archetype to act as a precursor to this lure. Mobs that complete the "preceding" lure will then be redirected to move to this lure.
String	config_id	The config name used by lured entities when determining whether to use a non-default lured config.
Array	exclude_tags	The tags required to NOT be on an entity for an effect to trigger.
Array	include_tags	The tags required to be on an entity for an effect to trigger.
Integer	influenced_priority	The priority threshold assigned to entities influenced by this lure. Determines whether the entities it influences can be overridden by other influencers.
Decimal	influenced_reprioritization_timer	The number of seconds this lure need to settle for before reprioritization occurs.
Integer	influencer_priority	The priority of this lure's influence. Determines whether it can influence already-influenced entities.
Boolean	leash_to_line	If true, affected mobs will be leashed to a line from the owner to the lure, rather than just the single point of the lure. Allows for attack-move behaviour.
Decimal	lure_range	The range at which entities can start to be lured.
Decimal	max_speed_distance	The distance from the entity's destination at which the maximum speed factor is applied.
Decimal	max_speed_factor	The multiplier applied to the speed of the lured units based on the distance from the entity's destination.
String	on_apply_target_trigger	The trigger event to send on an entity when it's influenced by this lure.
Boolean	release_on_arrival	If true, entities that reach the lure position will become unlured. Arrival range is defined per entity in the lured attributes
Decimal	release_range	The range at which entities will no longer be influenced by the lure.
Integer	reprioritized_influenced_priority	The influenced priority that entities influenced by this lure are switched to when the reprioritization timer elapses.
Boolean	show_influence_direction_line	Set to true to visualize a dashed line pointing in the direction of movement.
Boolean	show_influence_range	Set to true to visualize influence range.
Boolean	sticky_assignment	If true, entities influenced by this lure will remain assigned even when out of range.
String	visual_alliance_rule_filter	The alliance rule filter defining whether or not to the visualized influence range can seen by players on a given team.

badger:lured

Defines settings for when this entity is lured.

Type	Name	Description
JSON Object	configurations	Array of configuration overrides used based on the lure's configuration ID.
	arrive_range	The range within which entities will be unlured if the lure is set to release entities upon arrival.
	attack_move_range	The maximum distance from the lure within which the lured entity can attack move to targets.
	config_id	The configuration name that matches with a lure for this specific configuration to be applied.
	leash_range	The distance from the lure that the lured entity is allowed to be before it must return to the lure.
	return_range	The distance from the lure that the lured entity must move to when initially lured or whenever it exits the leash range before attacking again.
JSON Object	default_configuration	Default settings applied when this entity is lured.
	arrive_range	The range within which entities will be unlured if the lure is set to release entities upon arrival.
	attack_move_range	The maximum distance from the lure within which the lured entity can attack move to targets.
	leash_range	The distance from the lure that the lured entity is allowed to be before it must return to the lure.
	return_range	The distance from the lure that the lured entity must move to when initially lured or whenever it exits the leash range before attacking again.
String	resource_requirement	The optional unlock required by the influencer to lure this entity.

badger:map3_selectable

Map Entity (for World Map 3) icon on the map screen will be selectable by the cursor

badger:map3_solo_play_hidden

Map Entity (for World Map 3) will be hidden when in a solo play game

badger:map3_tooltip

Entity will have an icon on the map screen

Type	Name	Description
String	banner	banner for map tooltip
String	description	description for map tooltip
Boolean	is_persistent	persistent flag for map tooltip
String	title	title for map tooltip

badger:map3_tooltip_action

Entity will have an icon on the map screen

Type	Name	Default Value	Description
String	action		id for the action performed on the tooltip

badger:map3_tooltip_audio

audio for detailed map icon tooltip

Type	Name	Description
Decimal	cooldown_time	[Optional] How long before this audio event can trigger again (resets on map close)
String	event_id	Audio for map tooltip
String	event_type	Audio type for the event. Can be 'Narrative' or 'Music'
Decimal	selection_time	[Optional] How long the icon must be selected for the audio event to trigger

badger:map3_tooltip_extended

text for further detailed map icon tooltip

Type	Name	Description
String	description	extended description for map tooltip
String	icon	additional info icon for map tooltip
String	priority	dictate order that extended tooltips appear

badger:map_controller

Entity will have a map entity on the world map

Type	Name	Default Value	Description
List	initial_key_values		The initial key/values this map controller will have.
List	initial_team_key_values		The initial team-specific key/values this map controller will have.

badger:map_icon_revealed

Entity will have an icon that is visible on the map screen

Type	Name	Default Value	Description
Boolean	teammates_only		restrict visibility to team

badger:meta_aabb

Adding this description to an archetype will indicate to our structure editor it has an editable AABB.

badger:mob_alliance

Defines whether or not the village entity is a mob alliance village.

badger:modifier_accuracy_max_range

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_accuracy_min_range

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_aimable_range

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_area_overlays_range

Buffs an area overlay's range.

Type	Name	Description
Array	modifiers	List of modifications to apply to area overlays.
	post_add	Amount to add after all other modifier values.
	post_multiply	Percentage to multiply the value by after all pre-modifier values are applied.
	pre_add	Amount to add after pre-multiply values but before any other modifier values.
	pre_multiply	Percentage to multiply the value by before any other modifier values are applied.
	shape	The shape of the area overlay to buff.
	type	The type of the area overlay to buff.

badger:modifier_autostep

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_block_revert

Reverts any changed blocks to the original version

Type	Name	Default Value	Description
Decimal	duration_percentage		What percentage of the time this block revert process should take

badger:modifier_block_swap

Converts any listed blocks to a modified version

Type	Name	Description
Decimal	duration_percentage	What percentage of the build time this conversion process should take
Array	exclude	The block types to exclude from this block conversion
Array	include	The block types to affect with this block conversion
JSON Object	modifiers	Key value pairs that describe which keywords should be replaced with other strings in block names
Boolean	top_to_bottom	Changes the order of block conversion to top to bottom

badger:modifier_build_speed

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_cooldown

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_damage

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_damage_type

Buffs an entity's damage types.

Type	Name	Default Value	Description
Array	types		List of the damage types to add.

badger:modifier_deconstruction_speed

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_fall_distance

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_gravity

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_health_regen

The amount of health that regenerates per second

Type	Name	Description
Decimal	attack_cooldown_seconds	The cooldown before the entity can regenerate health again after attacks
Decimal	health_regen_amount	The amount of HP (per second) the entity can regenerate
Decimal	regen_cooldown_seconds	The cooldown between each health regeneration
Boolean	regen_while_suspended	Whether or not the entity regens health while suspended

badger:modifier_jump_height

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_knockback_force

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_knockback_resistance

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_max_health

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_movement_speed

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_projectile_payload

Defines a list of entities to spawn for a projectile.

Type	Name	Default Value	Description
List	entity_ids		The list of entities to spawn.

badger:modifier_resistance

Buffs an entity's damage resistances.

Type	Name	Default Value	Description
Array	resistances		List of the damage resistances to add.

badger:modifier_saddle

Granted as a buff to indicated when an entity is seeking out mounts or riders

Type	Name	Default Value	Description
Boolean	despawn_if_dismounted	false	Whether or not this entity despawns if it has no rider
Decimal	mount_range	1.0	The minimum distance that an entity with a Saddle buff must be before activating a mount action
Decimal	search_range	10.0	The maximum distance that an entity with a Saddle buff will search for a mount or rider

badger:modifier_size

Controls the size of this entity

Type	Name	Default Value	Description
Decimal	scale		The scaling factor for the size of this entity

badger:modifier_stamina_depletion

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_stamina_regen

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_stamina_regen_cooldown

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_targeting_range

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_wind_up

Buffs an entity's stats.

Type	Name	Description
Decimal	post_add	Amount to add after all other buff values.
Decimal	post_multiply	Percentage to multiply the value by after all pre buff values are applied.
Decimal	pre_add	Amount to add after pre multiply values, but before any other buff values.
Decimal	pre_multiply	Percentage to multiply the value by before any buff values are applied.
Boolean	scalable	More performance costly, but allows this modifier's effect to be scaled up or down. An example would be ramping-down a status effect as it ends.

badger:modifier_zone_size

Controls the zone size of this entity

Type	Name	Default Value	Description
Decimal	scale		The scaling factor for the zone size of this entity

badger:mount

Indicates that an entity can be mounted

Type	Name	Description
String	base_skin	Archetype name of the default skin for this mount type.
Array	exclude_tags	The tags required to NOT be on an entity for an effect to trigger.
Array	include_tags	The tags required to be on an entity for an effect to trigger.
String	unlock_requirement	Name of the unlock resource needed to unlock this as a player mount. If not defined, the mount will not appear as a player mount.

badger:move_on_spawn

Makes the entity move after spawn

Type	Name	Default Value	Description
Boolean	destroy_on_arrival		When set to true, the entity will destroy itself after it has travelled to the maximum move distance
Decimal	movement_distance		How far forward the entity will travel after spawn

badger:movement

Behavior modifications for movement

Type	Name	Description
Decimal	air_control_factor	The amount of control authority the entity will have while in air (between 0-1).
Boolean	enable_air_control_on_knockback	Bool to enable air control while being knocked back.
Decimal	move_speed	How fast this entity moves in meters (cubes) per second.
Decimal	swim_speed	How fast this entity moves in meters (cubes) per second while touching water. If left undefined, will default to matching move_speed.
Decimal	turn_rate	Speed at which the entity will rotate to face a new direction, in degrees per second.

badger:movement_speed_camera_effects

Defines FOV and camera distance effects that scale off of player move speed.

Type	Name	Description
JSON Object	camera_distance	Defines effects on the camera follow distance caused by movement speed bonuses.
	effect_strength	Strength of effect. With a value of 1, adds 1% effect for every 1% of move speed above default.
	enter_easing_function	Easing function for transitions away from the default. Options include: linear, spring, quad, cubic, quart, quint, sine, expo, circ, bounce, or back. Prefix with in_, out_, or in_out_ (e.g., 'in_out_sine').
	enter_time	Duration of the transition when moving away from the default (e.g., 1.0x).
	exit_easing_function	Easing function for transitions returning to default, with the same options as the enter easing function.
	exit_time	Duration of the transition when moving towards the default (e.g., 1.0x).
	max_multiplier	Maximum multiplier value due to lower than standard move speed. Recommended value [>= 1].
	min_multiplier	Minimum multiplier value due to lower than standard move speed. Recommended value [0-1].

Field of View Effects

Type	Name	Description
JSON Object	field_of_view	Defines effects on the field of view caused by movement speed bonuses. Effects are a multiplier on the base value.
	effect_strength	Strength of effect. With a value of 1, adds 1% effect for every 1% of move speed above default.
	enter_easing_function	Easing function for transitions away from the default. Options include: linear, spring, quad, cubic, quart, quint, sine, expo, circ, bounce, or back. Prefix with in_, out_, or in_out_ (e.g., 'in_out_sine').
	enter_time	Duration of the transition when moving away from the default (e.g., 1.0x).
	exit_easing_function	Easing function for transitions returning to default, with the same options as the enter easing function.
	exit_time	Duration of the transition when moving towards the default (e.g., 1.0x).
	max_multiplier	Maximum multiplier value due to lower than standard move speed. Recommended value [>= 1].
	min_multiplier	Minimum multiplier value due to lower than standard move speed. Recommended value [0-1].

FOV Safeguards

Type	Name	Description
Decimal	max_fov_degrees	Extra safeguard parameter to account for variation in FOV due to user settings. The FOV will be clamped within this range regardless of multiplier.
Decimal	min_fov_degrees	Extra safeguard parameter to account for variation in FOV due to user settings. The FOV will be clamped within this range regardless of multiplier.

badger:multistep_buildable

Defines the entity as a multi segmented buildable.

Type	Name	Description
Boolean	allow_segments_above_endpoints	Controls whether segments of this multistep are able to be built above both the end and starting segments.
String	apex_name	(Optional) Name of apex mid section archetype, in case of a sharp peak.
Boolean	auto_place_start	Should the start segment be automatically placed in front of the player?
Boolean	cap_fill_around_structures	(Optional) Set true for cap model to fill around previously place buildings.
Boolean	cap_fill_around_terrain	(Optional) Set true for cap model to only fill around terrain and not replace it.
Boolean	cap_piece_at_end	(Optional) Set true if end of stretch selection gets custom model
Boolean	cap_piece_at_start	(Optional) Set true if start of stretch selection gets custom model
String	cap_piece_fill_name	(Optional) Name of archetype connecting normal section to the end cap. Should be made croppable.
String	cap_piece_flat_name	(Optional) Name of flat end cap archetype
Integer	cap_piece_horizontal_offset	(Optional) horizontal offset of cap piece.
String	cap_piece_name	(Optional) Name of step-up end cap archetype
Decimal	end_segment_offset	How far in front of the start segment does the end segment start at (after placing the start segment)?
Boolean	fill_around_terrain	(Optional) Set true for section model to only fill around terrain and not replace it.
Decimal	max_height	What is the max height variance of placement
Integer	max_segments	The maximum length limit, counted in segments.
Decimal	max_slope	What is the max slope angle of placement
Integer	mid_segment_count	How many mid segments to place between end points.
Integer	placement_cursor_range	When placing this buildable how far can the players cursor extend behond the player
String	placement_end_cursor_mode	The cursor bias for the starting segment. Can be max_height, min_height, or player_height.
String	placement_start_cursor_mode	The cursor bias for the starting segment. Can be max_height, min_height, or player_height.
JSON Object	segments	List of midsection parts to use, along with their selection probability.
Integer	shared_health_group_size	Controls how many segments share one health value. Divides the structure into groups of this many segments.
Decimal	start_segment_offset	How far in front of the player does the start segment go (if automatically placed)?
String	stepup_name	(Optional) Name of step-up mid section archetype
String	style	How is this multipart laid out 'floating' or 'grounded'? 'floating_follow_terrain' can be used for a connected multistep buildable that attempts to avoid intersecting terrain.

badger:music_emitter_states (BP)

Defines the current state of this music emitter entity.

Type	Name	Default Value	Description
List	badger:music_emitter_states		A list of the current states this emitter can be in. This must match the resource_pack music_states for badger:music_2d_emitter.

badger:navigation

Description of how this entity can navigate.

Type	Name	Description
Boolean	avoid_block_damage	Whether or not the entity will avoid block damage while navigating
Decimal	avoidance_lookahead	The distance to look ahead for obstacles while navigating.
Boolean	disable_space_occupancy	Enables or disables crowd avoidance
Decimal	fall_distance	The maximum distance this entity will be willing to step down hills
String	ignore_solids_rule	The alliance rule that specifies if this entity should ignore tagged solid blocks while pathfinding
Decimal	max_distance_to_ignore_space_occupancy	The max distance to ignore crowd avoidance
Decimal	max_height_to_ignore_space_occupancy	The max height to ignore crowd avoidance

badger:nbt_decorator

Defines an NBT to place into the world.

Type	Name	Default Value	Description
String	nbt_file		Name of the nbt file to place.

badger:nbt_parts

Defines NBTs to place in a certain location on a structure.

Type	Name	Description
String	block	Name of the block to place (Note: you can't use both a block and an nbt file).
String	locator	Name of the locator at which the nbt is to be placed.
String	nbt_file	Name of the nbt file to place.

badger:near_death_telemetry_tracking

Defines the settings used when tracking telemetry for near death experiences.

badger:negate_status

Defines a set of status that this status will negate.

Type	Name	Default Value	Description
Array	negated_status		List of negated status names (strings).

badger:netherrack_spreading

Describes how far netherrack and denether spreaders will travel from the source entity.

Type	Name	Default Value	Description
Decimal	denether_spreader_distance		Manhattan distance that denether spreaders will travel from the outer edges of the source entity.
Decimal	nether_spreader_distance		Manhattan distance that netherrack spreaders will travel from the outer edges of the source entity.

badger:objective_health_bar

Causes the entity's health to appear on a dedicated health bar on the player's sceen.

Type	Name	Description
Decimal	max_visible_range	Max range from the player to show healthbar.
Integer	priority	Higher priority will occupy the healthbar over lower priority entities.
Boolean	show_at_full_health	Whether the health bar should always be show neven if it's at 100%.
String	type	The type of the health bar. This affects the icon and the text of the healthbar.

badger:offline_traits

This allows an entity to be turned offline, and determines what components get disabled when it is offline/constructing.

Type	Name	Default Value	Description
Array	construction_disabled_components		The components to disable when this entity is constructing.
Array	deconstruction_disabled_components		The components to disable when this entity is deconstructing.
Array	disabled_by_health_components		The components to disable when this entity is disablied.
Array	offline_disabled_components		The components to disable when this entity goes offline.
Array	pre_construction_disabled_components		The components to disable until this entity begins constructing.
Boolean	visualize_constructing	true	When true, constructing structures will be visualized with a yellow box around them.
Array	visualize_offline	false	When true, offline structures will be visualized with a yellow box around them.

badger:omit_blocks_outline

This flags a buildable entity to not render with an outline.

badger:omit_team_id

This flags a buildable entity to not render with a team ID, which makes it appear like normal terrain.

badger:owned_territory

the zone of owned territory created by building this structure

Category	Type	Name	Description
🏷️ Localization	Array	override_localization_for_prevent_overlap_tags	Overrides for localization strings per tag to show building error messages for overlapped zone types.
		localizationId	The localized error message ID.
		tag	The tag to override the error message.
🚫 Overlap Prevention	Array	prevent_overlap_tag_set	Tags that prevent an entity's zone of control (ZoC) from overlapping.
📏 Zone Control Score	Decimal	village_gen_zone_control_score_threshold	This threshold is subtracted from the zone control score (0.0 to 1.0) when scoring buildable options during village generation.
🏡 Ownership	Boolean	village_zone	Determines if structures placed in this zone are owned by the same village that owns this structure.
🔲 Zone Dimensions	Integer	zone	Side length in blocks of the owned zone area created by building this structure.

badger:persistent_entity_influence_source

Provides a list of sources of additive or subtractive PERSISTENT influence for an entity.

Type	Name	Description
List	sensors	List of persistent influences for entity sources.
	damage_receiver_filter	Track particular types of entities.
	alliance_rule_filter	Team alliance rules for this tracking.
	exclude_tags	Exclude tags for entities.
	include_tags	Include tags for entities.
	multiplier	The weight of the heat stamp for this entity will persist at.
	propagation_decay	The propagation/spread decay of the heat stamp for this entity source.

badger:physics

Defines whether the entity has physics properties.

Type	Name	Default Value	Description
Decimal	buoyancy	2.0	An inverse multiplier of the entity's gravity. Zero means no buoyancy and the object falls deeper and deeper into water, 1.0 means the object is stationary in water, values higher than 1.0 make the object float toward the surface.
Decimal	friction		The amount of friction experienced when doing physics-based movement.
Decimal	gravity		The intensity of gravity on an entity. Use a negative value (for instance -9.8) to have an entity fall toward the ground.
Decimal	water_drag	0.1	Slows down an object velocity.
Decimal	water_submerged_ratio	0.75	How deep a character is submerged when floating in deep water (0.0 means not submerged at all, 0.5 is roughly waist height, 1.0 is completely sumberged).

badger:pop_cap_anchor

This allows an entity to be used as a frame of reference for heuristic calculations when determining which pop capped entities to cull. Can also define a number of units nearby that will not be culled by the pop cap system.

Type	Name	Default Value	Description
String	alliance_rule_filter		Alliance filter for the exempted entities.
Boolean	greedy	false	If true, the units that this anchor exempts will not overlap with units exempted by any other greedy anchor.
Positive Integer	min_pop_cap		The number of units near the anchor that will be exempt from pop cap culling.
Positive Integer	min_pop_cap_range		The maximum range for cull exemption.

badger:pop_capped

Whether or not this entity counts for team popcap.

badger:presentation_event (unsure if good)

Defines the triggers this entity can respond to, and the entities to spawn (with optional probabilities for success).

Type	Name	Default Value	Description
String	spawn_entity		If the handler is a single string, then it's spawning only a single entity with 100% chance of success.

badger:preview_snapping

Causes a buildable preview to snap to nearby snap-point structures.

Type	Name	Description
Decimal	gamepad_snap_range	How far away the structure will snap from using a gamepad.
Decimal	mouse_snap_range	How far away the structure will snap from using a mouse.
Decimal	snap_to_top	When true, snaps the structure to the tops of other structures rather than the bottom.

badger:projectile

Defines the entity's projectile properties.

Type	Name	Default Value	Description
Decimal	horizontal_speed		The projectiles speed in meters per second across the terrain.
Decimal	min_flight_time		The minimum time in seconds that a projectile should take to reach it's target. This will lower the ground speed in order to make the timing match.

badger:projectile_physics

Defines the entity's projectile physics properties.

Type	Name	Default Value	Description
Decimal	gravity		The projectile gravity in meters per second squared.

badger:pvp_win_condition

Flag used to track victory-critical entities. Currently used in PvP to mark the player's main base.

badger:queueing

Defines this entity's ability to queue up entities.

Type	Name	Description
String	alliance_rule_filter	The rule that determines which types of entities that will be queued (friendly, enemy, etc.).
Array	exclude_tags	Entities with any of these tags will not enter the queue.
Array	include_tags	Entities must have all these tags to enter the queue.
Decimal	influence_range	Range within which entities will enter the queue.
Array	queue_heads	The labelled positions (relative to this entity) where influenced entities will go and wait. The number of positions determines the number of entities that can simultaneously be at the head of the queue.
Integer	queue_size	The number of entities that can queue up. -1 means infinite queue size.

badger:quick_direct_aim

Defines any parameters used to spawn a quick direct order.

Type	Name	Default Value	Description
Decimal	distance		Defines the distance ahead of the player to place the destination.

badger:ranged_target

Defines where on the entity ranged attacks should aim for

Type	Name	Default Value	Description
Array	target_positions		The list of local positions where ranged attacks should land on this entity

badger:recall_prevention

Tunable timers for entities to be prevent being recalled by other players during actions.

Type	Name	Default Value	Description
Decimal	on_lured_disabled_duration		Duration in seconds for the mob to be unrecallable after being directed.

badger:recallable_entity

Flag component that marks entity as recallable

badger:refundable

Marks this unit as refundable, and gives their priority

Type	Name	Default Value	Description
Integer	priority		Refund priority. Lower values will be refunded first
Decimal	refund_multiplier		How much of the units cost is refunded

badger:refunding_spawner

A spawner that can be used to refund mobs

Type	Name	Description
String	alliance_rule	The alliance rule to filter which players can use this spawner to refund mobs.
Boolean	can_refund_in_combat	Whether or not this spawner can refund mobs that are currently in combat.
Array	exclude_tags	Forbidden tags on entities to refund.
Array	include_tags	Required tags on entities to refund.

badger:removal_time (possible Duplicate)

destroys an entity after a given period of time

Type	Name	Description
String	presentation_event	Name of the presentation event to fire when the timer triggers
Boolean	sync_presentation_event	Whether or not the event should be synced over the server, or if it should be local only
Decimal	time	Amount of time in seconds before the entity is destroyed

badger:reports_buildable_state

Defines the settings for what state is reported when placing buildables.

Type	Name	Default Value	Description
Decimal	reports_state		Defines the state to report.

badger:reports_hit_reaction

Whether or not this entity reports hit reactions for visual feedback.

badger:reset_heartbeat_in_range

An entity with this component will prevent other entities in range of it from despawning due to their heartbeat expiring.

Type	Name	Default Value	Description
Decimal	range		The range that prevents entities from despawning due to heartbeat.

badger:resist_status

Defines entity's ability to resist being affected by status effects.

Type	Name	Description
JSON Object	status_effect_name	Defines the name of the status effect and its associated properties.
	resistance_persist_time	Specifies the duration (in seconds) that the status effect is blocked from reactivating after it ends. A value of -1 allows the status effect to be refreshed before the current effect ends.
	resisted	Indicates whether this status effect is completely resisted.
	time	Sets the duration (in seconds) for how long this status effect will last.

badger:resource_cost_multiplier

This value scales resource costs for the player it is attached to, including building placement and mob spawning costs.

Type	Name	Default Value	Description
String	building_cost_multiplier		The multiplier that is applied to all building costs, increasing it or lowering it. Default value 1.0.
String	spawning_cost_multiplier		The multiplier that is applied to all mob spawn costs, increasing it or lowering it. Default value 1.0.

badger:resource_modifier

Modify the Pop Cap for a list of resources

Type	Name	Description
Array	modifiers	Key-value pairs that describe which resources are being modified.
	amount	The amount by which to modify the resource cap.
	resource	The name of the resource to be modified.

badger:resource_trader

Marks this entity as a place to exchange resources for other resources.

Type	Name	Default Value	Description
String	successful_resource_trade_trigger		The trigger event to send when a successful resource trade is made using the resource trader

badger:respawn_point

Makes this entity act as a respawn point for players.

Type	Name	Description
String	alliance_rule	The tag name that defines the alliance rule.
String	player_respawned_trigger	The event trigger to send when a player respawns at a respawn point.
JSON Object	spawn_blocking	Settings that control what blocks a respawn point.
	blocking_alliance_rule	The alliance rule tag name used to check for respawn blocking.
	blocking_radius	The radius around the respawn point used to check for entities that may block respawning.
	tag_filter	The tag filter used to determine whether an entity should block a respawn point.
	exclude_tags	An array of tags to exclude from entities that block respawn points.
	include_tags	An array of tags that must be present for entities to block respawn points.

badger:rewards

states what rewards will be granted when this entity is created.

Type	Name	Default Value	Description
Array	reward		The items that will be awarded to player when entity is created.

badger:rider

Marks an entity as one that can ride on mounts.

Type	Name	Default Value	Description
Array	exclude_tags		The tags required to NOT be on an entity for an effect to trigger.
Array	include_tags		The tags required to be on an entity for an effect to trigger.

badger:scriptable_buildable_spawner

Denotes whether or not this entity can have its spawner settings overwritten by scripts.

badger:server_block_source_removal

Remove the BlockSourceComponent because this entity doesn't need one.

badger:show_debug_health

Show the Debug Health of the entity

badger:spawn_costs

In cases where it could cost to use this entity this will be cost.

Type	Name	Default Value	Description
Array	costs		The items that will be deducted from the player when this entity is spawned.
Array	tickets		The ticket type that will be deducted from the player or team when this entity is spawned.

badger:spawn_tracking

Dictates whether this entity has its spawning tracked.

badger:spawner_add_loot_override

Units spawned from this spawner will utilize an override loot table.

Type	Name	Default Value	Description
List	name		The override type name (NOT a loot table ID). This should resolve to a loot table on the entity.

badger:spawner_add_tags

Tags added on top of entities existing tags spawned by this spawner.

Type	Name	Default Value	Description
Array	tags		Additional tags to be added to the spawned entity.

badger:spawner_rules

Defines the rules for when or where to spawn entities.

Type	Name	Description
JSON Object	block_type_rule	Defines an optional block type spawner rule.
	valid_types (Array)	List of valid block type names that the spawner can use for spawning entities.
JSON Object	bsharp_rule	Defines an optional `bSharp` global variable spawner rule.
	value (Number)	Value of the global variable that causes the spawner to stop spawning.
	variable (String)	Name of the `bSharp` global variable used in this rule.
JSON Object	distance_rule	Defines an optional distance spawner rule.
	distance_data (Object)	Specifies the optional entity distance rule.
	alliance_rule (String)	Defines an entity's alliance rule, determining whether the spawner should prevent spawning based on the entity’s alliance.
	max_distance (Number)	Maximum distance that entities have to be within for the spawner to start spawning.
	min_distance (Number)	Minimum distance that entities cannot be within for the spawner to start spawning.
	tag_filter (Object)	Filter object defining conditions based on tags.
	exclude_tags (Array)	List of tags that must be excluded from the spawning process.
	include_tags (Array)	List of tags that must be included for spawning to occur.
	village_bounds_distance_data (Object)	Specifies village bounds distance-based rules for spawning.
	destruction_spawn_delay (Number)	Duration of time (in seconds) waited after the destruction of a village before applying the "isDestroyed" rule.
	horde_names (Array)	Defines the hordes to check. If not defined, all villages of any horde are checked.
	is_destroyed (Boolean)	Determines whether this rule applies only to destroyed villages. If not defined, the rule checks both alive and destroyed villages.
Boolean	spawn_if_village_occupied	Specifies whether this spawner should spawn when a village is occupied. Omitting this option allows spawning regardless of the occupation state.
JSON Object	time_of_day_rule	Defines an optional time-of-day-based spawner rule.
	times (Array)	Defines the specific times of day during which the spawner is allowed to spawn entities.

badger:sprint

Defines the settings required for an entity to sprint.

Type	Name	Description
String	exhausted_negate_status	The name of the status effect to apply to negate the exhausted effect.
String	exhausted_status	The name of the status effect to apply when exhausted.
Decimal	idle_time_to_deactivate	Amount of time the player must be stopped/walking before sprint ends automatically. A value of -1 disables this feature.
String	sprint_negate_status	The name of the status effect to apply to negate the sprinting effect.
String	sprint_status	The name of the status effect to apply when sprinting.

badger:stamina

Defines the settings required for stamina depletion.

Type	Name	Description
Decimal	can_regen_during_exhausted	Allows regeneration while exhausted.
Decimal	depletion_rate	Defines the rate at which stamina is depleted (per tick).
Decimal	exhaust_restore_threshold	Exhausted state will end once stamina is above this % threshold. [0-1]. A value of -1 disables this feature.
Decimal	exhausted_cooldown	Defines how long an entity will be exhausted for once stamina is depleted.
Decimal	max_stamina	Defines the maximum amount of stamina for an entity.
Decimal	regen_cooldown	Defines how long it will take to start regenerating stamina, NOT from exhaustion.
Decimal	regen_rate	Defines the rate at which stamina will regenerate (per tick).
Decimal	stamina_replenish_audio_threshold	Stamina must drop below this value in order for the stamina replenished audio event to trigger when it refills.

badger:state_reporting

Defines the settings for game state reporting.

Type	Name	Description
Decimal	report_duration	Defines how long a state will be reported for.
Decimal	states	Defines the list of states that can be reported.
Decimal	tag	Defines the tag for this state.

badger:static_entity

Controls if this entity should only be partitioned on demand.

badger:status

Defines this entity as a status effect prototype.

Type	Name	Description
String	applied_name	The name assigned to this status effect.
JSON Object	default_resistance	Sets the default resistance parameters, used if the entity does not have a specific resistance for this status effect (refer to `badger:resist_status`).
	resistance_persist_time	Duration (in seconds) for which the status effect is blocked from reactivating after it ends. A value of `-1` allows the effect to refresh before ending.
	resisted	Determines if this status effect is completely resisted by default.
	time	Specifies the default duration (in seconds) for which this status effect lasts.

badger:status_effect_ramp_off

Causes a gradual reduction of numerical effects, leading up to the expiry of the status effect.

Type	Name	Default Value	Description
Decimal	transition_duration		Time, in seconds, over which the status effect will ramp down (before the standard end time).

badger:status_effect_telemetry_tracking

Defines the settings used when tracking telemetry for certain status effects.

Type	Name	Description
Array	track	List of status effect names to track.
	status_effect_applied_name	The name of the status effect that has been applied and is being tracked.
	telemetry_id	The name of the telemetry event associated with the tracking of the status effect.

badger:sub_objective_health_bar

Causes the entity to display sub-objective information on the dedicated objective health bar on the player's screen.

badger:suppress_target_action

suppresses target actions for a period of time.

Type	Name	Default Value	Description
Decimal	max_time		max amount of time in seconds to suppress target actions for.
Decimal	min_time		(optional) min amount of time in seconds to suppress target actions for. If specified, a random value between min and max will be chosen.

badger:swaps_mounts

Indicates that this entity allows an interactor to swap their mount.

badger:swaps_team

Defines this entity as a status effect that causes its host to temporary switch teams.

Type	Name	Default Value	Description
Boolean	swap_to_inflictor		If true, swaps the host to the inflicting entity's team.
String	team		The name of the team to specifically swap to (when not swapping to the inflicting entity's team).

badger:tag_modifier_source

Modifies the tags of entities within a certain radius, for as long as they are in that radius

Type	Name	Description
String	alliance_rule_filter	Alliance rule filter to determine who to apply tags to.
Decimal	radius	Range to apply tag modifications to.
JSON Object	tag_filter	Tag filter to determine who to apply tags to.
	exclude_tags	Tags to exclude from the filter.
	include_tags	Tags to include in the filter.
Array	tags_to_add	Tags to add.
Array	tags_to_remove	Tags to remove.

badger:tags

Designer prescribed tags that can be used to filter or discern this entity from others in a general sense. Main use is targeting rules.

Type	Name	Default Value	Description
Array	tags		Add as many different tags to allow to filter this entity by having or not having certain tasks.

badger:take_block_space

This description means this entity takes the space of a block and should be removed if a new block want the space

badger:target_actions

Defines the actions that get carried out when a target is selected by a targeting priority enabling these actions.

Type	Name	Default Value	Description
List	actions		List of actions.

badger:target_assigner

Defines this entity as a target assigner which pushes priority targets to influenced entities.

Type	Name	Description
String	alliance_rule_filter	Alliance rule used to filter the target by.
Boolean	despawn_on_target_lost	When true, the entire order ends when the target is destroyed, cancelling movement.
Decimal	drop_target_range	The distance a selected target must be from the assigner before it is dropped.
Decimal	find_target_range	The distance the assigner will search for a target to select or assign.
Boolean	force_move	If true, this command is a force move command, adjusting enemy highlighting to match the action.
Decimal	force_target_range	Within this range, mobs will directly attack the target, ignoring any secondary targets that are closer.
Boolean	parent_self_to_target	When true, the target assigner entity will parent itself to the targeted entity.
JSON Object	pre_redirect_target_filter	Early phase alliance and tag filter before redirection. Redirector hurtboxes found in this phase will redirect to target the default hurtbox, which will be further filtered by the main tag filter. Changes require coder approval.
	exclude_tags	Array of tags to exclude (any of) when filtering targets.
	include_tags	Array of tags to require (all of) when filtering targets.
Boolean	single_target	When true, the target assigner will stop searching for targets after its first selected target is destroyed.
JSON Object	target_filter	Alliance and tag filter used by this assigner to filter targets.
	exclude_tags	Array of tags to exclude (any of) when filtering targets.
	include_tags	Array of tags to require (all of) when filtering targets.

badger:targeting

Defines the entity's targeting behaviour. Used to drive what the entity can target and which actions to use against qualifying targets.

Type	Name	Default Value	Description
Array	targeting_priorities		Entries defining what the entity can target at a specified range. Entries are in order of high-to-low priority.
Boolean	update_targeting_every_tick		When true, the entity checks for targets constantly, instead of a couple of times per second. Doing so is more costly for performance and should be avoided outside of special cases.

badger:telemetry_category

Settings used when reporting telemetry info.

Type	Name	Default Value	Description
String	category_name		Defines the category name used when reporting telemetry.

badger:telemetry_game_zone

Determines if a village will trigger game zone telemetry and additional information regarding it.

Type	Name	Description
Boolean	add_details_in_pvp	Should a GameZoneDetail be added in PVP
Integer	alt_id	An alternate game zone ID to use if the main id isn't sufficient.
Integer	id	The game zone ID/index to use when entering the area.

badger:telemetry_lure_direct

Determines if a village will trigger game zone telemetry and additional information regarding it.

Type	Name	Default Value	Description
Boolean	is_advanced		for directors specifically, is it a simple or targeted director?
String	order_type		Is this a lure or director?

badger:telemetry_track_banner_order

Determines if a mob should be tracked when given a banner order for telemetry purposes.

Type	Name	Default Value	Description
Boolean	enabled		Is this entity being tracked for banner order

badger:text_markup_icon_name

Defines the name of the icon to be used in HUD error messages.

Type	Name	Default Value	Description
String	name		Full name of icon.

badger:ticket_cap_modifier

Modify the cap for a list of tickets

Type	Name	Description
Decimal	amount	The amount to modify the ticket cap by.
String	ticket	The name of the ticket cap to modifying
Array	ticket_modifiers	Key value pairs that describe which ticket cap we are modifying

badger:track_damage

Dictates whether this entity will track damage it receives or delivers.

Type	Name	Default Value	Description
Boolean	dealt		Whether the village should track the damage it deals.
Boolean	taken		Whether the village should track the damage it takes.

badger:track_influenced_group_position

Flags a lure or director to track the centroid of its group of influenced entities.

badger:tracks_health_change

Enables tracking of client-side changes in health. Useful for interrupting certain player actions.

badger:trigger_criteria

Flag Attribute that indicates this entity is used as a trigger section.

Type	Name	Default Value	Description
List	filters		List of filter include and exclude tags

badger:unit_direct_tags

Tags that are used to filter entities for advanced direct groups.

Type	Name	Default Value	Description
Array	tags		Tags to add to this entity for advanced direct groupings.

badger:unlockable_buffs

When applied to an entity, buffs itself under certain unlock conditions.

Type	Name	Description
Array	buffs	The list of unlockable buffs used by this entity.
	buff_id	The specific buff to be applied to this entity.
	has_unlock	If true, this buff is active only when the specified resource is acquired. If false, the buff is active only when the resource is not acquired.
	resource	The name of the resource used to enable or disable this buff.

badger:village

Some general attributes that describe a village.

Type	Name	Default Value	Description
Integer	generation_priority		Villages with a higher generation priority will be planned and built first. If no priority is provided, 0 is the default.
String	name		Identifies the type of village.

badger:village_bounds_trigger_volume_size

Defines the size of the village bounds trigger volume. This is also the size which village trigger volumes are relative to.

Type	Name	Default Value	Description
Decimal	padding		The distance in blocks to expand the trigger volume beyond the village bounds.

badger:village_bridge

Determines how villages build bridges.

Type	Name	Description
Decimal	bridge_cost_per_meter	Used to compare with the alternative path without a bridge.
Decimal	bridge_horizontal_distance_max	The largest XZ difference allowed between the start and end of the bridge.
Decimal	bridge_horizontal_distance_min	The smallest XZ difference allowed between the start and end of the bridge.
String	bridge_id	The entity identifier for the bridge that should be placed.
Decimal	bridge_vertical_distance_max	The largest Y difference allowed between the start and end of the bridge.
Decimal	diagonal_bridge_degree_tolerance	The number of degrees a bridge can deviate from right angles before being considered diagonal.

badger:village_building_path

Determines how villages build paths from buildings.

Type	Name	Description
Boolean	can_place_bridge_for_height_changes	Toggles whether bridges can be used as stairs between zones with prohibitively steep height changes.
Boolean	can_place_under_buildables	Setting this to false will force paths to generate around buildables instead of underneath them.
Decimal	diagonal_path_degree_tolerance	The number of degrees a building path can deviate from right angles before being considered diagonal.
Array	edge_blocks	The names of the blocks to be used for the outer edges of paths.
Array	edge_decoration_blocks	The names of the blocks to be used on top of the outer edges of paths.
Decimal	edge_noise_amplitude	How far noise can extend past the path's edge in meters.
Decimal	edge_width	The width of the path's edge on either side in meters.
Decimal	height_change_needs_bridge	If the height change between zones is larger than this, a bridge must be placed to cross them.
Array	inner_blocks	Optionally specify the names of the blocks to be used on the inner part of the path, edge, or edge_deco.
Array	outer_blocks	Optionally specify the names of the blocks to be used on the outer part of the path, edge, or edge_deco.
Decimal	outer_edge_threshold	The width of the path's edge on either side in meters.
Decimal	outer_path_threshold	The width of the path in meters.
Decimal	path_block_noise_scale_factor	A smaller scale factor will cause varied path blocks to alternate less frequently.
Array	path_blocks	The names of the blocks to be used for paths.
Decimal	path_deco_noise_scale_factor	A smaller scale factor will cause varied path edge decorations to alternate less frequently.
Decimal	path_edge_block_noise_scale_factor	A smaller scale factor will cause varied path edge blocks to alternate less frequently.
Decimal	path_noise_amplitude	The noise amplitude affects the severity of a path's weathering.
Decimal	path_noise_scale_factor	A smaller scale factor will produce more gradual changes in a path's weathering.
Decimal	path_width	The width of the path in meters.
Decimal	prevent_buildable_placement	Setting this to false will allow buildable to be placed on top of paths.

badger:village_building_placement

Settings for placing buildings inside of village zones.

Type	Name	Description
Boolean	is_placement_jitter_bell_curve	The generation of jitter values between the min and max will have a probability distribution that approximates a normal distribution.
Integer	max_placement_attempts_with_jitter	The maximum number of times that a placement will try placing with jitter, per village zone.
Decimal	minimum_distance_between_buildings	Buildings cannot place closer than this distance.
Decimal	placement_jitter_max	The maximum distance that the placement will can be offset from a village zone face site. This value will be clamped if it's large enough to push the placement outside of a zone.
Decimal	placement_jitter_min	The minimum distance that the placement will can be offset from a village zone face site. This value will be clamped if it's large enough to push the placement outside of a zone.

badger:village_construction

Determines which buildings will be placed during village generation.

Type	Name	Default Value	Description
String	start_logic		The deck logic to run on startup

badger:village_district_path

Determines how villages build paths from districts.

Type	Name	Description
Boolean	can_place_bridge_for_height_changes	Toggles whether bridges can be used as stairs between zones with prohibitively steep height changes.
Boolean	can_place_under_buildables	Setting this to false will force paths to generate around buildables instead of underneath them.
Decimal	diagonal_path_degree_tolerance	The number of degrees a building path can deviate from right angles before being considered diagonal.
Array	edge_blocks	The names of the blocks to be used for the outer edges of paths.
Array	edge_decoration_blocks	The names of the blocks to be used on top of the outer edges of paths.
Decimal	edge_noise_amplitude	How far noise can extend past the path's edge in meters.
Decimal	edge_width	The width of the path's edge on either side in meters.
Decimal	height_change_needs_bridge	If the height change between zones is larger than this, a bridge must be placed to cross them.
Array	inner_blocks	Optionally specify the names of the blocks to be used on the inner part of the path, edge, or edge_deco.
Array	outer_blocks	Optionally specify the names of the blocks to be used on the outer part of the path, edge, or edge_deco.
Decimal	outer_edge_threshold	The width of the path's edge on either side in meters.
Decimal	outer_path_threshold	The width of the path in meters.
Decimal	path_block_noise_scale_factor	A smaller scale factor will cause varied path blocks to alternate less frequently.
Array	path_blocks	The names of the blocks to be used for paths.
Decimal	path_deco_noise_scale_factor	A smaller scale factor will cause varied path edge decorations to alternate less frequently.
Decimal	path_edge_block_noise_scale_factor	A smaller scale factor will cause varied path edge blocks to alternate less frequently.
Decimal	path_noise_amplitude	The noise amplitude affects the severity of a path's weathering.
Decimal	path_noise_scale_factor	A smaller scale factor will produce more gradual changes in a path's weathering.
Decimal	path_width	The width of the path in meters.
Decimal	prevent_buildable_placement	Setting this to false will allow buildable to be placed on top of paths.

badger:village_do_not_clear_on_slot_overlap

If this attribute is present, then if any village will generate on the same slot, then this village will not be despawned.

badger:village_hanging_decoration_placement

Settings for placing hanging decorations between village zones.

Type	Name	Default Value	Description
Decimal	minimum_edge_width		The minimum shared edge width between two zone considered for placement.
Decimal	minimum_height_delta		The minimum height difference between two zone considered for placement.

badger:village_heart

A structure that must remain for the village to continue existing.

Type	Name	Default Value	Description
	badger:village_heart

badger:village_heart_destruction

Customized destruction behaviour when all Village Hearts are destroyed in a village.

Type	Name	Description
List	groups	A list containing various group configurations.
	delay (Decimal)	The delay before the group effect starts.
	interval (Decimal)	The interval between successive group effects.
	disable_vfx (Boolean)	A flag that determines whether visual effects should be disabled for this group.

badger:village_heart_disabled_actions

Actions that will occur to village structures when the village heart is disabled by health

Type	Name	Default Value	Description
String	village_structures_action		The action that will occur to the structures of the village

badger:village_height_change

Influences the village height changes.

Type	Name	Default Value	Description
Decimal	clamp_size		The number of blocks above a height change that are not changed to air.

badger:village_influence

This gives an entity an influence with which it can apply to a portion of the map. This influence can be used for things such as placing buildings in areas of high or low influence.

Type	Name	Default Value	Description
Decimal	amount		The amount of influence exerted by this entity.

badger:village_moat

Determines how villages build paths from districts.

Type	Name	Default Value	Description
Decimal	edge_noise_amplitude		The noise amplitude determines the maximum distance that moat zone edges can shifted inward.
Decimal	edge_noise_scale_factor		A smaller scale factor will produce a more gradual change along the moat zone edges.

badger:village_wall

Determines which buildings will be placed during village generation.

Type	Name	Default Value	Description
Decimal	wall_offset		How far to move the walls away from their zone edges.

badger:village_weathering

Determines how villages apply weathering effects to terraformed zone edges.

Type	Name	Description
Decimal	gradient_2d_noise_scale	The magnitude of vertical noise applied to the particular gradient pass.
Decimal	gradient_3d_noise_scale	The magnitude of horizontal noise applied to the particular gradient pass.
Boolean	gradient_affected_by_wave	Sets whether or not the particular gradient pass is affected by the sawtooth wave.
Array	gradient_depths	How many blocks deep the gradient stops being applied for each gradient pass.
Array	gradient_passes	Array of gradient passes.
Array	gradient_weight_heights	The average height of the weather effect for the particular gradient pass. Higher is steeper.
Boolean	is_overhanging_edge	Determines if the weathering effect will taper up or down.
Decimal	position_noise_scale	Lower values will apply smoother xz jitter to weathering effects.
Decimal	wave_depth_max	The maximum distance in blocks, before noise, that the weathering wave can remove blocks from an edge.
Decimal	wave_depth_min	The minimum distance in blocks, before noise, that the weathering wave can remove blocks from an edge.
Decimal	wave_noise_scale	The magnitude of noise used to soften the wave function.
Decimal	wave_period_scale	A smaller scale factor will reduce the frequency of the weathering wave for a smoother effect.

badger:village_zone

Influences the villages topology.

Type	Name	Description
Decimal	expansion_distance	The maximum distance that villages can expand from their center position.
Boolean	is_hexagonal_grid_enabled	False will use standard square grid. True will change the square grid to hexagonal.
Boolean	is_zone_jitter_bell_curve_enabled	The generation of jitter values between the min and max will have a probability distribution that approximates a normal distribution.
Decimal	minimum_loz_connection_width	The minimum edge width between zones in a layer request before padding is added.
Decimal	water_search_resolution	The distance between each check for water while scanning the expansion area for bodies of water.
Decimal	zone_jitter_max	The maximum amount that a village zone will be offset in world units.
Decimal	zone_jitter_min	The maximum amount that a village zone will be offset in world units.
Decimal	zone_spacing	The default distance between village zones before jitter is applied.

badger:village_zone_scoring

Describes how village zones are prioritized during building placement.

Type	Name	Description
String	close_to_easing	The type of easing function used to control the attenuation of score provided to nearby zones.
String	close_to_wall_easing	The type of easing function used to control the attenuation of score provided to zones nearby walls.
Decimal	close_to_wall_weight	The weight applied to the score provided to zones nearby walls.
Decimal	close_to_weight	The weight applied to the score provided to zones nearby the close to position.
String	direction_easing	The type of easing function used to control the attenuation of score provided to zones in this direction.
Decimal	direction_weight	The weight applied to the score provided to zones nearby in the desired direction.
String	distance_from_easing	The type of easing function used to control the attenuation of score provided to zones that are some distance away from a district starting position.
Decimal	distance_from_weight	The weight applied to the score provided to zones that are some distance away from a district starting position.
String	elevation_easing	The type of easing function used to control the attenuation of score provided to zones near the specified elevation.
Decimal	elevation_weight	The weight applied to the score provided to zones near the specified elevation.
String	far_from_easing	The type of easing function used to control the attenuation of score provided to nearby zones.
Decimal	far_from_weight	The weight applied to the score provided to zones nearby the far from position.
Decimal	random_weight	The weight applied to the random score (between 0 and 1) provided to zones.

badger:wander

Dictates entity's idle behaviour.

Type	Name	Default Value	Description
Decimal	wander_frequency		How many times per second on average this entity will idle wander, instead of remaining still.
Decimal	wander_radius		How far will this entity wander around a fixed point.

badger:waypoint_marker

Entity will have a waypoint marker on the HUD

Type	Name	Description
String	alliance_path	Icon name for an alliance-based icon override. Optional
String	alliance_rule_filter	Type of team alliance for which ALLIANCE_PATH should become active. Optional
String	label	Waypoint label
String	local_player_facing_path	Icon name for a local player owner icon override. Local player must 'own' the icon. Optional
String	path	Icon name
Integer	priority	An integer to specify compass bar sorting importance (higher numbers take precedence); any positive value also 'pins' the marker in strategic view.
Vector [a, b]	screen_position_offset	Waypoint marker screen position offset. Value is in % of screen size. Range:(-100,100)
Boolean	use_faction_name	If true, the waypoint's text will be the name of its faction.
Vector [a, b, c]	world_position_offset	Waypoint marker world position offset.

badger:waypoint_marker_visibility

Entity will have a waypoint marker on the HUD

Type	Name	Description
Integer	compass_level	Determines the compass level where a non-team icon is displayed. Values: -1 (onscreen and bottom), 0 (bottom), 1 (top).
String	compass_max_range	Maximum range value to be displayed on the compass (options: short, medium, long).
Array	filter_tagsets	Array of paired include and exclude tag arrays for determining when this icon can appear.
	exclude_tags	Array of tags to exclude (any of) when filtering compass icons.
	include_tags	Array of tags to require (any of) when filtering compass icons.
Boolean	hide_from_non_alliance	Determines if the waypoint should be hidden from opponents.
Decimal	waypoint_max_range	Maximum range value for the waypoint.
Decimal	waypoint_max_range_alliance	Maximum range value for opponent waypoints.
Decimal	waypoint_min_range	Minimum range value for the waypoint.
Decimal	waypoint_min_range_alliance	Minimum range value for opponent waypoints.

badger:world_collision

Defines the entity's world collision properties.

Type	Name	Default Value	Description
Decimal	auto_step		The maximum height of an object that an entity can automatically step on while walking.
Decimal	interpolation_speed		The speed at which the auto speed will interpolate.

badger:world_request

World request information associated with a particular entity archetype.

Type	Name	Default Value	Description
String	world_request_type		Determines the priority of the world requests dispatched.

badger:world_single_spawn

Used to place a single unique entity during world gen, that won't get double placed when saveloading/reloading chunks

Type	Name	Default Value	Description
String	entity		The name of the entity to spawn

badger:zone_type

Specifies the type of zone that this buildable provides.

Type	Name	Default Value	Description
Boolean	non_blocking		When true, this zone will be used for 'must be in zone' checks but not 'must NOT be in zone' checks. Useful for not blocking placement of enemy structures.
String	zone_type		This is the type of zone that this buildable provides. Ex. Utopia, Village, etc.

badger:zone_type_requirement

Defines the different types of zones of control which allows this building to be constructed/online.

Type	Name	Description
Array	exclude_tags	The zone types that cannot overlap for this placement.
Array	include_tags	The different types of zones of control that allow this building to be constructed or come online.
JSON Object	invalid_zone_block_conversion	Block conversion data for when the structure is no longer in the required zone.
	duration_percentage	The percentage of build time required to perform block conversion.
	modifiers	A list of block conversion modifiers.
	reversal_duration_percentage	The percentage of build time required to reverse block conversion.
	top_to_bottom	If true, block conversion occurs from top to bottom, rather than bottom to top.
Boolean	set_offline_when_no_zone	If set to true, this structure will be set offline instead of being destroyed if it is no longer in the required zone at any point.

badger:zone_visualization

Specifies which types of zones are displayed when previewing the building.

Type	Name	Default Value	Description
String	group		The zone group name (one of the zone groups from the zone group service)
String	zone_alliance_rule		The alliance rule that specifies which zone(s) should be displayed

capped_spawner

If this entity spawns entities, it will be bound by the cap of the type specified here.

Type	Name	Description
String	cap_type	The cap type that entities shot or spawned by this spawner contribute towards.
Integer	individual_cap	If the total cap type is not reached, how many entities can any one instance of this spawner spawn individually.
Array	toggled_actions	List of action names on this entity that are disabled when either the cap type limit or the individual limit are reached.

Files

Entities.md

Latest commit

History

Entities.md

File metadata and controls

Client Entity Documentation

Entity Description Properties

badger:animal_interaction

badger:animation_variation

badger:area_overlays

badger:attacker_damage_prediction

badger:audio_beat_sync

badger:audio_block_scanning

badger:audio_interactable

badger:audio_molang_to_fmod

badger:audio_time_of_day

badger:audio_update_FMOD_projectile_velocity

badger:audio_vo_sequence_speaker_tag

badger:beacon_render_info

badger:block_source_cull_distance_override

badger:block_source_info

badger:block_source_removal

badger:boom_camera

badger:cam_overrides_look_orientation

badger:cam_overrides_move_orientation

badger:camera_avoidance

badger:camera_bounds

badger:camera_distance_activation

badger:camera_input_layout_override

badger:camera_locomotion

badger:camera_show_indicators

badger:camera_show_zone

badger:cinematic_camera

badger:clamp_camera

badger:decal_visualization

badger:decoration_collider_request

badger:entity_age

badger:face_animation

badger:fast_travel_presentation

badger:hero_lure_presentation

badger:hit_reaction_threshold

badger:hud_message_interaction_failed

badger:input_actions

badger:interaction_presentation

badger:interpolation

badger:invasion_icon

badger:invulnerability_heartbeat_view

badger:keep_alive_timer

badger:knockback_reaction_threshold

badger:locator

badger:locator_effect

badger:lookat

badger:map3_child_offset

badger:map3_copy_local_camera_orientation

badger:map3_copy_orientation

badger:map_entity_3d_icon

badger:map_icon_offset

badger:mount_molang

badger:music_2d_emitter

badger:music_emitter_states

badger:on_destruction

badger:orbital_arm

badger:placement_molang

badger:point_lights

badger:presentation_event

badger:projectile_trail_request

badger:removal_time (duplicate?)

badger:rendering

badger:respawn_trigger

badger:rig_operations

badger:rotation_presentation

badger:skin

badger:smooth_look_at

badger:speed_data_to_fmod

badger:terrain_type_molang

badger:threat_owner

badger:threat_source

badger:toggleable_decorative_child

badger:variable_propagation