Entity Documentation - minecraft:conditional_bandwidth_optimization

2025-02-21

Defines the Conditional Spatial Update Bandwidth Optimizations of this entity.

Conditional Bandwidth Optimization Properties

Name	Default Value	Type	Description	Example Values
conditional_values	not set	Array of Conditional Values items	The object containing the conditional bandwidth optimization values.	Boat: `[{"max_optimized_distance":0,"max_dropped_ticks":0,"use_motion_prediction_hints":true,"conditional_values":[{"test":"is_moving","subject":"self"}]}]`
default_values	not set	Array of Default Values items	The object containing the default bandwidth optimization values.

Conditional Values item type

The object containing the conditional bandwidth optimization values.

Conditional Values Properties

Name	Default Value	Type	Description
conditional_values	not set	Minecraft filter	Conditions that must be met for these optimization values to be used.
max_dropped_ticks	10	Integer number	In relation to the optimization value, determines the maximum ticks spatial update packets can be not sent. Value must be >= 0.
max_optimized_distance	80	Decimal number	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 true/false	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 much less data being sent. This should be used when actors are travelling very quickly or teleporting to prevent visual oddities.

Default Values item type

The object containing the default bandwidth optimization values.

Default Values Properties

Name	Default Value	Type	Description
max_dropped_ticks	10	Integer number	In relation to the optimization value, determines the maximum ticks spatial update packets can be not sent. Value must be >= 0.
max_optimized_distance	80	Decimal number	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 true/false	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 much less data being sent. This should be used when actors are travelling very quickly or teleporting to prevent visual oddities.

Samples

Allay

"minecraft:conditional_bandwidth_optimization": {}

Arrow

"minecraft:conditional_bandwidth_optimization": {
  "default_values": {
    "max_optimized_distance": 80,
    "max_dropped_ticks": 7,
    "use_motion_prediction_hints": true
  }
}

Boat

"minecraft:conditional_bandwidth_optimization": {
  "default_values": {
    "max_optimized_distance": 60,
    "max_dropped_ticks": 20,
    "use_motion_prediction_hints": true
  },
  "conditional_values": [
    {
      "max_optimized_distance": 0,
      "max_dropped_ticks": 0,
      "use_motion_prediction_hints": true,
      "conditional_values": [
        {
          "test": "is_moving",
          "subject": "self"
        }
      ]
    }
  ]
}

Chest Minecart

"minecraft:conditional_bandwidth_optimization": {
  "default_values": {
    "max_optimized_distance": 60,
    "max_dropped_ticks": 20,
    "use_motion_prediction_hints": true
  },
  "conditional_values": [
    {
      "max_optimized_distance": 0,
      "max_dropped_ticks": 0,
      "conditional_values": [
        {
          "test": "is_moving",
          "subject": "self",
          "operator": "==",
          "value": true
        }
      ]
    }
  ]
}

Enderman

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

Lingering Potion

"minecraft:conditional_bandwidth_optimization": {
  "default_values": {
    "max_optimized_distance": 80,
    "max_dropped_ticks": 5,
    "use_motion_prediction_hints": true
  }
}

Snowball

"minecraft:conditional_bandwidth_optimization": {
  "default_values": {
    "max_optimized_distance": 100,
    "max_dropped_ticks": 7,
    "use_motion_prediction_hints": true
  }
}

通过