Edit

Entity Documentation - minecraft:conditional_bandwidth_optimization

  • Article

minecraft:conditional_bandwidth_optimization defines the Conditional Spatial Update Bandwidth Optimizations of the entity.

Parameters

Name Default Value Type Description
conditional_values not set List The object containing the conditional bandwidth optimization values.
default_values not set JSON Object The object containing the default bandwidth optimization values.

conditional_values

conditional_values is a list defined by three parameters. Each item has the following properties:

Name Default Value Type Description
max_dropped_ticks not set Integer In relation to the optimization value, determines the maximum ticks spatial update packets can be not sent.
max_optimized_distance not set Integer The maximum distance considered during bandwidth optimizations. Any value below the max is interpolated to find optimization, and any value greater than or equal to the max results in max optimization.
use_motion_prediction_hints false Boolean When set to true, smaller motion packets will be sent during drop packet intervals, resulting in the same amount of packets being sent as without optimizations but with less data being sent. This should be used to prevent visual oddities when entities are traveling quickly or teleporting.

default_values

default_values is a JSON object defined by two parameters. Each item has the following properties:

Name Default Value Type Description
max_dropped_ticks not set Integer In relation to the optimization value, determines the maximum ticks spatial update packets can be not sent.
max_optimized_distance not set Integer The maximum distance considered during bandwidth optimizations. Any value below the max is interpolated to find optimization, and any value greater than or equal to this max results in max optimization.
use_motion_prediction_hints false Boolean When set to true, smaller motion packets will be sent during drop packet intervals, resulting in the same amount of packets being sent as without optimizations but with less data being sent. This should be used to prevent visual oddities when entities are traveling quickly or teleporting.

Example

"minecraft:conditional_bandwidth_optimization":{
    "conditional_values" : {
        "max_dropped_ticks": 20,
        "max_optimized_distance": 200,
        "use_motion_prediction_hints": false
    },
    "default_values" : {
        "max_dropped_ticks": 10,
        "max_optimized_distance": 100,
        "use_motion_prediction_hints": false
    }
}

Vanilla entities examples

fireworks_rocket

"minecraft:conditional_bandwidth_optimization": {
    "default_values": {
        "max_optimized_distance": 80.0,
        "max_dropped_ticks": 10,
        "use_motion_prediction_hints": true
    }
}

Vanilla entities using minecraft:conditional_bandwidth_optimization