Skip to main content

Minecraft Beta & Preview - 1.21.80.25

Script API​

  • Moved enum Difficulty from beta to v1.19.0

  • World

    • Move getDifficulty(): Difficulty from beta to v1.19.0

    • Move setDifficulty(difficulty: Difficulty): void from beta to v1.19.0

  • Moved the following Player methods from beta to v1.19.0

  • Renamed BoundingBox to BlockBoundingBox and released from beta to v1.19.0.

  • Renamed BoundingBoxUtils to BlockBoundingBoxUtils.

  • Moved dimension.placeFeature and dimension.placeFeatureRule from beta to v1.19.0

Biomes​

  • Removed remainder of support for unused "minecraft:consolidated_features" and "minecraft:legacy_world_generation_rules" JSON components

Blocks​

  • New render_method type available for minecraft:material_instances. They are meant to support the same behavior of block turning opaque in the far rendering like Leaves in contrast to other disappearing like Bamboo Stalk.

    • "render_method": "blend_to_opaque"
    • "render_method": "alpha_test_to_opaque"
    • "render_method": "alpha_test_single_sided_to_opaque"

  • The field "tint_method" in the "minecraft:map_color" component no longer requires the "upcoming creator features" toggle

  • The field "tint_method" in the "minecraft:destruction_particles" component no longer requires the "upcoming creator features" toggle

  • The field "tint_method" in the "minecraft:material_instances" component no longer requires the "upcoming creator features" toggle

Components​

  • Fixed a bug where incorrect Json errors would appear for valid item texture references

  • Introduced a "drop_item_y_offset" parameter to the "minecraft:interact" component

    • Defines a custom y-axis offset for when an item is dropped
    • Requires "drop_item_slot" to be specified

  • The "minecraft:leashable" component's "on_unleash" trigger triggers on the leash breaking with format version 1.21.80 and later

    • The old behavior is still available to opt in to by setting "on_unleash_interact_only" to true

Editor​

  • Added unbound keybindings for Trim and Remove Air from Selection

  • Fixed an issue with Freehand select near or outside of dimension bounds that could cause selection to become unusable

  • Fixed issues with selection volumes being able to translate or resize past world bounds. This also fixes using large brush shapes with freehand selection (and magic select) close to a world boundary

  • Fixed a bug that caused Extrude Axis options to be incorrect for Pyramid brush shape

  • Fixed an issue related to files and folders being permanently deleted when deleting structures in the structure panel

Entity Filters​

  • Added new entity filter "has_equipment_tag", works like "has_equipment" but takes an item tag instead of an item name

Graphical​

  • Added support for multiple locators for use with leashes for rendering multiple ropes between two entities.
    • "multi_lead_n":
      • where n = {1, 2, 3, 4} defines locators when the entity is leashed to a different entity.
      • Used if and only if it has a corresponding "multi_lead_hold_n" and the number n is equal on the two entites.
    • "multi_lead_hold_n"
      • Where n = {1, 2, 3, 4} defines locators where the entity is leashing a different entity.
      • Used if and only if it has a corresponding "multi_lead_n" and the number n is equal on the two entites.
    • "lead"
      • is set to origin if it is not defined in the geo.
    • "lead_hold"
      • is set to origin if it is not defined in the geo.

Items​

  • Bundles' open icons are now specified via IconItemComponent. This addresses the issue where a missing texture would appear for an opened custom Bundle. Bundle icon paths have also now be separated into unique keys in item_texture.json.

Molang​

  • Added 'query.has_any_leashed_entity_of_type' which takes a list of entity identities and checks if the actor has any of the listed entities leashed. Available on both the client and the server.
    • Usage: "query.has_any_leashed_entity_of_type( 'minecraft:sheep', 'minecraft:creeper' )"

实验性特性

Script API​

@minecraft/server 2.0.0-beta​

  • Added CustomCommandOrigin to custom command script callback.
  • Added CustomCommandSource enum.
  • Renamed CustomCommandPermissionLevel to CommandPermissionLevel.
  • Renamed CustomCommandParamType.Position to CustomCommandParamType.Location
  • BlockCustomComponent now take an optional CustomComponentParameters object for Custom Components V2 experiment as a second argument to event callbacks in 2.0.0-beta
  • CustomComponentParameters added to 2.0.0-beta
    • params property added to CustomComponentparameters to 2.0.0-beta
  • ItemCustomComponent now take an optional CustomComponentParameters object for Custom Components V2 experiment as a second argument to event callbacks in 2.0.0-beta
  • EntityFrictionModifierComponent has been changed to read-only in version 2.0.0-beta

@mincraft/server-admin​

  • Added AsyncPlayerJoinBeforeEvent
    • Added beforeEvents.asyncPlayerJoin, AsyncPlayerJoinBeforeEvent, and AsyncPlayerJoinBeforeEventSignal to allow creators to delay players joining the world.
    • AsyncPlayerJoinBeforeEventSignal.subscribe is different than other events because the callback it accepts returns a promise. Once the promise is resolved, the player will join the world, or if the promise is rejected the player will be disconnected without joining the server. The player will be at the loading screen while the promise is pending.

Blocks​

  • When Custom Components V2 experiment is enabled, minecraft:custom_components component is deprecated in 1.21.80 and higher format versions

  • When Custom Components V2 experiment is enabled, custom components are flattened inline with other components and allow parameters in 1.21.80 and higher format versions. Example:

    "components": { "example_namespace:example_component": { "someParam": 3, "anotherParam": "test" }}

Cameras​

  • Changed approach for the easing between moving targets under the Experimental Creator Camera Features toggle

Experiments​

  • Added Custom Components V2 experiment

Graphical​

  • Added a new lighting model for clouds in the Deferred Technical Preview. The lighting parameters can not be configured at this time.

  • Increased the range of cloud rendering in the Deferred Technical Preview.

  • Added pixelated reflections to the Deferred Technical Preview. This new effect will cause reflections to align to the texel grid of textures in the world.

  • Added pixelated shadows to the Deferred Technical Preview.
    This new effect can be controlled with the new shadows JSON schema, "shadows/global.json". This file adds new settings that control the style of shadows in the game. Available parameters are "shadow_stlye", which can be "soft_shadows" or "blocky_shadows", and "texel_size". "soft_shadows" are the default style, while "blocky_shadows" results in shadows that are pixelated in appearance. When "blocky_shadows" are enabled, "texel_size" controls the size of the pixelation effect. "texel_size" should be equivalent to the block texture size in order to achieve a one to one mapping between the pixels in a texture and the pixelated effect created by enabling "blocky_shadows", but this is not required. An example version of what "shadows/global.json" could look like is as follows:

    { "format_version": "1.21.80", "minecraft:shadow_settings": { "shadow_style": "blocky_shadows", "texel_size": 16 }}

Items​

  • When Custom Components V2 experiment is enabled, minecraft:custom_components component is deprecated in 1.21.80 and higher format versions

  • When Custom Components V2 experiment is enabled, custom components are flattened inline with other components and allow parameters in 1.21.80 and higher format versions. Example:

    "components": { "example_namespace:example_component": { "someParam": 3, "anotherParam": "test" }}