Minecraft:Java Edition 1.20.3

Template:Dangerous version Template:Infobox version Template:Relevant guide

1.20.3, retroactively named Minecraft:Bats and Pots,<ref>Template:Tweet</ref><ref>Template:Tweet</ref> is a Minecraft:game drop for Minecraft:Java Edition released on December 5, 2023.<ref>Template:Mcnet</ref> It improves Minecraft:shields, adds new functionality for Minecraft:decorated pots, changes the appearance of bats, adds the Template:Cmd command, changes chat component serialization, and fixes bugs, alongside an experimental toggle for features that would later be included in Tricky Trials.<ref>Template:Snap</ref><ref>Template:Snap</ref>

Additions

Command format

Template:Cmd

A new administrative and debugging command which allows the player to control the ticking flow and measure the performance of the game.
- Requires elevated permissions (admins and above), and so it is not by default available in Minecraft:command blocks and Minecraft:data packs.
- Syntaxes:
  - Template:Cmd
    - Outputs the current target ticking rate, with information about the tick times performance.
  - Template:Cmd
    - Sets a custom target ticking rate to the specified value. The value rate must be greater than 1.0 and lower than 10000.0.
  - Template:Cmd
    - Freezes all gameplay elements, except for Minecraft:players and any Minecraft:entity a player is Minecraft:riding.
  - Template:Cmd
    - Only works when the game is frozen. It runs the game for the specified number of ticks and then freezes the game again.This allows to step through the game a set amount of ticks at a time.
    - The parameter is optional. The default value is 1.
  - Template:Cmd
    - Stops the current stepping process, and re-freezes the game.
  - Template:Cmd
    - Unfreezes the game and resumes all gameplay elements.
  - Template:Cmd
    - Runs the game while ignoring the set ticking target rate for the specified number of ticks. At the end of the sprint, the game resumes the previous ticking target and displays performance information about the tick times while sprinting.
  - Template:Cmd
    - Stops the current Template:Cmd, and resumes the previous ticking target.

General

Minecraft:Experiments

Added the "Update 1.21" experimental toggle (update_1_21 data pack).

Minecraft:Game rule

Added maxCommandForkCount, to control the maximum number of forks (contexts) that can be created during one tick. Applies to command blocks and functions. Defaults to 65536.
Added playersNetherPortalDefaultDelay, to control time (in Minecraft:game ticks) that a player needs to stand in a Minecraft:nether portal before changing dimensions, while in Survival and Adventure mode. Defaults to 80.
Added playersNetherPortalCreativeDelay, to control time (in game ticks) that a player needs to stand in a nether portal before changing dimensions, while in Creative mode. Defaults to 1.
Added projectilesCanBreakBlocks, to control whether impact projectiles destroy blocks that are destructible by them (i.e. Minecraft:chorus flowers, Minecraft:pointed dripstone and Minecraft:decorated pots). Defaults to true.

Minecraft:Loading screen

Added a new screen for handling corrupted level files.
- It gives the player the option to restore a backup, and a quick link to the bug tracker for reporting a bug about it.

Minecraft:Options

Added "Hide Splash Texts" in accessibility options, which allows the Minecraft:splash in the main menu to be hidden.

[[Minecraft:options.txt|Template:Mono]]

Added hideSplashTexts, defaults to false.

Minecraft:Particles

Added new dust_plume, gust, gust_dust, trial_spawner_detection and white_smoke particle types.

Minecraft:Tags

Added following damage type tag:
- Template:Cd: contains Template:Cd.
  - Used for damage types that can incrementally knock down armor stands.
Added following entity tags:
- Template:Cd: contains Template:Cd.
  - Used to disable drowning.
- Template:Cd: contains Template:Cd.
- Template:Cd: contains Template:Cd.

Changes

Blocks

Minecraft:Decorated pot

Now can store up to a single stack of items.
- Minecraft:Hoppers, Minecraft:minecart with hoppers and Minecraft:droppers can now insert and/or extract items from them.
- Minecraft:Comparators can now read the number of items in them.
- Minecraft:Players can interact with them and insert items into them.
  - Player interactions with them cause them to wobble and trigger a vibration frequency of 11.
- They have no GUI, and need to be broken to retrieve their content by players.
Now can be smashed by projectiles, which cause them to shatter and drop their contents.
Now has new sounds for breaking, shattering and being stepped on.
Now can stack up to 64.
Now appears in the "Redstone" tab of the Minecraft:Creative inventory.
Now, when blockstate cracked set to true, decorated pots always shatter when broken.
Now can utilize loot tables and read from the LootTable tag key.

Minecraft:Grass

Renamed "Grass" to "Short Grass".
The ID has been changed from Template:Cd to Template:Cd.

Minecraft:Jigsaw block

Added two new input fields in the edit screen.
- Selection priority
  - When the parent piece is being processed for connections, this controls the order in which this jigsaw block attempts to connect to its target piece.
  - Jigsaws are processed in descending priority order and randomly within the same priority.
- Placement priority
  - When this jigsaw block connects to a piece, this is the order in which that piece is processed for connections in the wider structure.
  - Pieces are processed in descending priority order with the default insertion order breaking ties within the same priority.
- This functionality has been added to support the ability for jigsaw structures to generate branches in a depth-first order, as well as give finer control over ordering of connections.
- All existing jigsaw blocks default their selection and placement priority to 0, resulting in the same behavior as before these two configurable values were introduced.
Increased maximum value of structure variable size from 7 to 20.

Minecraft:Monster spawner

Now renders their inner faces when looking inside.

Items

Minecraft:Arrows

Now keep their CustomName after being shot and picked up.
Special arrows, such as Minecraft:spectral arrows, no longer revert to regular arrows when shot and picked up.

Minecraft:Ender pearl

Thrown ender pearls produce a teleportation sound on impact.

Minecraft:Shield

When a player is blocking with a shield, the arm with the shield now follows the direction the player is looking at, when viewed from third person perspective.
Now blocks damage while the player faces straight up.

Mobs

Minecraft:Bat

Their model, animations, and texture have been updated.

Non-mob entities

General

The name of them is now shown if looked at and a CustomName is set, or always displayed if CustomNameVisible is set, similar to living entities.

Command format

Function

Template:Cmd command has been changed to better accommodate new Template:Cmd command.
Functions no longer have any result unless they use Template:Cmd or there was an error during lookup or instantiation.
- That means Template:Cmd command no longer returns (or even displays) the number of commands run during execution.
- Error conditions:
  - Calling non-existent function.
  - Calling empty function tag.
  - Macro instantiation failure.
"Result" in this context means values that would be stored with Template:Cmd.
The previous behavior where every command in a function would perform store if a function was called with Template:Cmd is removed.
- That means that a single call to function stores at most once (zero times if Template:Cmd was not called).
- For function tags with multiple entries, function results are accumulated, but partial results are stored at the end of every function.
Existing limits for functions have been refined to accommodate new execution rules and prevent a wider range of exploits:
- Limits apply even if run from command line (so it now always behaves as if they were placed in a function).
  - For example, all functions called by Template:Cmd count towards the same limit.
  - Executions from command blocks still count as separate ones.
- Limit maxCommandChainLength for functions now counts "operations" like:
  - Execution of command for a single context.
  - Execution of a stage in Template:Cmd (no matter how many contexts were modified).
  - Invocation of function.
- A new limit with game rule maxCommandForkCount now restricts the total amount of context that can be created by single state of functions like Template:Cmd.
  - Example: if there are 5 entities in world, Template:Cmd creates 5 contexts, while Template:Cmd creates 5*5 = 25 contexts.

Template:Cmd

Re-added (if|unless) function subcommand.
- A new execute sub-command that runs a function or function tag and matches the return value(s). If a tag is given, all functions run regardless of the results of prior functions.
- Syntax: Template:Cmd
- Arguments:
  - function: The function or tag to run.
- The matching of the result value of the function(s) that run:
  - At least one of the functions must succeed for the match to succeed.
  - A successful call is defined as a function that:
    - Uses the Template:Cmd command to return a value.
    - The return value is not 0.
  - If no functions exited with Template:Cmd, neither if nor unless runs.
- It doesn't always fail if all functions had no return.
  - If there were no Template:Cmds in called functions, if fails and unless passes.
  - First Template:Cmd in any of called functions returns (for a single context).

Template:Cmd

If Template:Cmd runs multiple functions in combination with Template:Cmd, execution stops after first Template:Cmd in any of the functions.
A single call to the Template:Cmd command will always have return when run with Template:Cmd.
- For example, Template:Cmd always returns after processing the first context.

Template:Cmd

Re-added run subcommand: Template:Cmd.
- This takes the result value from running the specified command and returns that as the return value of the function.
  - If command did not return any value (like, for example, call to a function without Template:Cmd), Template:Cmd does not execute and function continues execution.
  - If the given command fails, the return value is 0.
  - In all other aspects, it works like Template:Cmd with a specified return value.
  - In case of fork (for example Template:Cmd), the first execution of the command returns.
    - If there are no executions (for example in Template:Cmd), function does not return and continues execution.
- It always returns.
  - If there are no valid results from returned command, function containing Template:Cmd fails (i.e. success=0 and result=0).
- It propagates success value together with results value.
- It also allows storing values, which means Template:Cmd both stores value and returns it outside function.
Added new subcommand Template:Cmd, to make whole function fail (i.e. return success=0 and result=0).

Template:Cmd

New subcommands for changing the display of specific scoreboard entries in the sidebar:
- Template:Cmd
  - Determines whether the objective should automatically update on every score update (disabled by default)
- Template:Cmd
  - Changes the display name of the given scoreboard entries.
- Template:Cmd
  - Resets the display name of the given scoreboard entries to their default.
- Template:Cmd
  - Changes the number format of the given scoreboard entries (see below for more information).
- Template:Cmd
  - Resets the number format of the given scoreboard entries.
- Template:Cmd
  - Changes the default number format of the given objective (see below for more information).
- Template:Cmd
  - Resets the default number format of the given objective.
Number formats:
- Template:Cd
  - The score is displayed with the selected style (e.g. Template:Cd.
- Template:Cd
  - The score is replaced by the given text component.
- Template:Cd
  - The score is not shown.

General

Minecraft:Custom structure

Changes to structure type definitions (data/minecraft/worldgen/structure):
- Added optional pool_aliases list to jigsaw structures.
- Aliases represent the possibility to rewire jigsaw pool connections by redirecting pool references on individual structure instances.
- Alias variants are represented in type and is one of:
  - direct: 1:1 mapping from an alias to a new pool.
    - alias: Pool to replace.
    - target: Pool to replace with.
  - random: 1:n mapping where a pool from n is randomly selected for the structure instance.
    - alias: Pool to replace.
    - targets: Randomized list of candidate pools to replace alias with.
  - random_group
    - groups: Each group is a randomized list of above alias types.
    - Only one group is selected per structure instance.
    - This enables modelling selections such as "if pool X is replaced with X1, also replace pool Y with Y1".

Minecraft:Data pack

The Minecraft:pack format version is now 26.

Minecraft:Entity format

In NBT format for entity type tnt:
- Added block_state.
  - This field allows replacement of rendered block model.
- Renamed Fuse to fuse.
In NBT format for entity type Template:Cd:
- Added item.
  - This field is the item that will be picked up.
In NBT format for entity type trident:
- Renamed Trident to item.

Minecraft:Processor list

Added trial_chambers_copper_bulb_degradation.

Minecraft:Raw JSON text format

Plain-text chat components (text, no sibilings, no stylings) are now always serialized as string instead of {"text": "your text"}.
Chat components now serialize to NBT when sent over network.
- Components of type nbt now have source field with allowed values: Template:Cd.
Chat components now have an optional type value (allowed values: Template:Cd) to speed up parsing and improve error checking.
id field in show_entity hoverEvent style now also accepts UUID as an array of 4 integers.
Numeric and boolean arguments for translate component are no longer converted to string.
The following JSON component representations are no longer accepted:
- null
- []
Errors in following style fields are no longer silently ignored:
- color
- clickEvent
- hoverEvent
- hoverEvent[action=show_entity].contents.name
- hoverEvent[action=show_item].contents.tag

Minecraft:Realms

Realms are now available in snapshots, pre-releases, and release candidates.
- Any player who has an active Realms subscription is eligible to create a free Snapshot Realm.
- Snapshot Realms are separate from the regular Realms to prevent any issues from impacting regular Realms.
The version of the last played world on a Realm is displayed in the Realms list.
Experiments are available for newly created worlds.

Minecraft:Resource pack

The Minecraft:pack format version is now 22.
Added block model, item model and block state definitions for crafter.
Added GUI container texture and sprites for crafter.
Added white_smoke particle definition.
bat.png has been updated for the new bat model.
Added block models, items models and block state definitions for the following blocks:
- Template:Cd.
Added unique sprites for the following blocks:
- Template:Cd.
uniform font has been updated to use Unifont 15.1.04 (from 15.0.06).
The only supported texture format is now .png.
Changes to downloaded/world resource pack handling.
- Changes apply to world resource packs (Template:Mono), Realms resource packs and resource packs controlled by dedicated servers.
UI Download screen has been replaced with a toast.
World resource pack application start together with chunk loading.
Downloaded packs are now stored in downloads directory (with different file organization than old Template:Cd)
- Files in this directory are no longer automatically cleaned (previously only up to 10 packs were kept).
- Additionally, inside this directory there is also log file Template:Mono that stores information about downloaded files for debug purposes.
Downloaded packs now have unique id (GUID/UUID) that can be used to differentiate them.
- This value for dedicated server pack can be configured with the Template:Cd option in Template:Mono.
- If the value is missing, it is generated based on URL.
- If hash of a pack is not set, this pack is redownloaded before every application.
- Previously, if hash was missing, the latest downloaded version of a pack was applied.
In local storage, only up to 20 server resource packs are cached.
Client now sends additional updates about packs (like download success).

Minecraft:Tags

Added Template:Cd into the Template:Cd entity tag.
Added Template:Cd into Template:Cd entity tag.

Minecraft:Telemetry

Small tweaks to the telemetry data collection screen, such as a box for allowing or denying collection of optional data.

General

Some additional options are added for 3rd-party servers software:
- Client can now accept multiple server resource packs.
- New packet was added to un-apply server resource packs.
- Resource packs are no longer cleaned when entering configuration phase.

Experimental

These additions and changes only take effect when the Minecraft:Update 1.21 experimental data pack is enabled.

Additions

Template:Additions table

Blocks

Template:Animate Minecraft:Chiseled copper

Have 8 variants in 4 oxidation levels, waxed or not waxed.
Can be crafted both in Minecraft:crafting table and Minecraft:stonecutter:
- When in crafting table, consume 2 Minecraft:cut copper slabs from the same type, resulting in 1 chiseled copper with the same type.
- When in stonecutter, consume 1 Minecraft:block of copper, resulting in 4 chiseled copper, or 1 Minecraft:cut copper, resulting in 1 chiseled copper; all from the same type.

Template:Animate Template:Animate Minecraft:Copper bulb

A light-emitting block that can toggle its light emission through redstone pulses.
Have 8 variants in 4 oxidation levels, waxed or not waxed.
Can be crafted in crafting table with a cross pattern, by 3 blocks of copper from the same type, 1 Minecraft:blaze rod in the center slot, and 1 Minecraft:redstone dust in the bottom slot, resulting in 1 copper bulb with the same type.
They emit less light the more oxidized they are. From less oxidized to most oxidized, they emit block light levels of 15, 12, 8, and 4, respectively.
While powered by a redstone signal, a redstone crystal in the center of them glows.
They have following properties:
- Only toggle their light on or off when receiving a redstone pulse. Their state doesn't change if the source of the redstone pulse is removed.
- When the light is on, redstone comparators read a redstone signal strength of 15.
- Don't conduct redstone power.

Template:Animate Template:Animate Minecraft:Copper door and Minecraft:copper trapdoor

Have 8 variants in 4 oxidation levels, waxed or not waxed.
Works like wooden doors in that they can be opened and closed by the player as well as redstone.
Can be crafted as other doors, with blocks of copper from the same type (instead of ingots, as in Minecraft:iron doors).

Template:Animate Minecraft:Copper grate

A new type of decorative block unique to the copper family.
Have 8 variants in 4 oxidation levels, waxed or not waxed.
Can be crafted both in crafting table and stonecutter:
- When in crafting table, consume 4 blocks of copper from the same type in rhombic pattern, resulting in 1 copper grate with the same type.
- When in stonecutter, consume 1 block of copper, resulting in 4 copper grate from the same type.
They are transparent, so they allow light to pass through and cannot conduct redstone, prevent mob spawning on top of them, and do not suffocate mobs who end up with their head inside them.
Can be Minecraft:waterlogged.
- Acts similarly to waterlogged Minecraft:mangrove roots; water doesn't flow out of any of the block's faces.

Template:Animate Minecraft:Crafter

A variant of Minecraft:crafting table, can be crafted with five Minecraft:iron ingots, a crafting table, two Minecraft:redstone dusts, and a Minecraft:dropper in the crafting table.
Crafters can be oriented in any direction when placed.
A Minecraft:pickaxe can increase the speed of mining them.
Have a user interface similar to crafting table.
- Have 3×3 interactable crafting grid.
- Their crafting grid slots are toggleable, meaning that the player can change the behavior of a slot by clicking or pressing on a slot with an empty hand.
  - A toggled slot cannot hold any items and therefore cannot have items placed into it by other blocks such as Minecraft:hoppers and droppers.
  - A toggled slot can be toggled off by player, whether clicked directly or holding item(s), pressing slot keys associated with an empty or a not empty hotbar slot.
- Unlike the crafting table, the slots display a preview of the crafted item which will be crafted and ejected on the next redstone pulse, but cannot be manually taken out by the player.
- The user interface is shared between all players interacting with them, meaning that multiple players can interact with them at the same time, similar to Minecraft:chests and hoppers.
- The user interface does not have a Minecraft:recipe book to provide help, so the player must know the recipes.
The crafter ejects one crafted item at a time when powered by a new redstone pulse, a redstone signal that is not a continuous signal.
- Upon receiving this new signal, crafters eject the recipe result from the front face.
- All the result items are ejected together when the output result has multiple type of items.
They can interact with hoppers and droppers, to input/output automatically.
- Hoppers can be used to both insert and pull items out of them.
- Droppers can be used to insert items into them.
- Moving items in from another block with a hopper or a dropper prioritizes filling items into slots, by following these rules:
  - If there is a toggled slot, skipped.
  - If there is not a toggled slot, crafters prioritize the first empty slot from left-to-right and top-to-bottom.
  - If there is not a toggled slot, and there are no empty slots, crafters prioritize the smallest stack of the same item. If there are multiple possible stacks, pick the first from left-to-right and top-to-bottom.
- If failed to select a slot, hoppers and droppers don't take any action.
When read by a Minecraft:redstone comparator, the redstone signal strength is 0 to 9, where each non-empty or toggled slot adds 1 strength.

Template:Animate Minecraft:Trial spawner

Trial spawner is a new variant of Minecraft:monster spawners that ejects rewards upon completion and can have variable levels of challenge in multiplayer.
The challenge level increases for each new player a trial spawner notices nearby.
- Challenge level doesn't decrease until it is reset during a trial spawner's cooldown.
Unlike normal spawners, a trial spawner spawns a limited number of mobs proportional to its current challenge level.
- It can only spawn a mob at positions that are within line of sight.
- It can spawn a mob regardless of any light level requirement the mob has.
- Spawned mobs are persistent and don't despawn.
Once all mobs are defeated, the trial spawner ejects a set of rewards proportional to the current challenge level.
- After the rewards have been ejected, the trial spawner goes into cooldown for 30 minutes during which it no longer spawns mobs.
Trial spawners cannot be crafted nor obtained by players in Survival - instead, they can be found naturally placed throughout trial chambers.
Trial spawners are extremely slow to mine and resistant to explosions, and don't drop even with Minecraft:Silk Touch.
When placed in Creative, trial spawners have no mob type set by default.
- The mob type can be set by interacting with it while holding a spawn egg.
Creative and Spectator players cannot be detected or noticed by trial spawners.

File:Tuff.png Minecraft:Tuff family

Items

Minecraft:Spawn egg

File:Breeze Spawn Egg JE1 BE1.png Minecraft:Breeze spawn egg

File:Trial Key JE2 BE2.png Minecraft:Trial key

An item that can only be obtained from trial spawners.
Currently doesn't have any functionality.

Mobs

File:Breeze JE1.webp Minecraft:Breeze

The breeze is a cunning, hostile mob that can spawn via trial spawner in some rooms within the trial chambers.
Has Template:Hp health points.
Cannot be hit by Minecraft:arrows or Minecraft:tridents.
The breeze moves primarily by leaping around the target, sometimes jumping quite long distances.
An aggressive adversary, the breeze shoots volatile wind energy in the form of wind charge projectiles at its target.
Wind charges deal a small amount of damage when colliding directly with an entity.
After colliding with an entity or a block, wind charge projectiles produce a wind burst, which knocks back entities in the area by several blocks.
Wind bursts also have the effect of 'activating' certain blocks:
- Non-iron doors and trapdoors are flipped.
- Fence gates are flipped.
- Buttons are pressed.
- Levers are flipped.
- Bells are rung and swung.
- Lit candles (both standalone and on cake) are extinguished.
Wind bursts do not have any effect on iron doors, iron trapdoors, or any block being held in its position by a redstone signal.
Currently does not drop any loot.

Non-mob entities

File:Wind Charge (item) JE1 BE1.png Minecraft:Wind charge

Fired by the Minecraft:breeze.
Explodes upon impact, emitting a large burst of plume Minecraft:particles and knocking entities back similar to a TNT explosion.
Its explosion interacts with certain blocks, including Minecraft:buttons and Minecraft:trapdoors.
Deals damage when colliding directly with a player or mob.
Wind charges break Minecraft:decorated pot and Minecraft:chorus flowers upon collision.
Can be deflected, just like shulker bullets.

World generation

File:Trial Chambers chamber 4.png Minecraft:Trial chambers

Trial chambers are a new structure in the Overworld where players can explore and take on combat challenges during the mid-game.
- Trial chambers are made out of a variety of copper and tuff blocks and can be found in different sizes from large to small.
- Trial chambers are a relatively common find throughout the deepslate layer of the underground, with the starting piece generating at a height between -40 and -20.
The layout of each trial chamber is procedurally generated, and can include traps, supply and reward chests, decorated pots, and a variety of combat spaces.
- Traps include dispensers containing different potential items, such as Minecraft:arrows or Minecraft:fire charges.
- Supply chests can be found between the different rooms, and give the player blocks and items which help them navigate their trials.
- Reward chests are guarded by challenges in each room, and can be a source of many high level enchanted books and equipment.
- Decorated pots found in hallways can contain supplies such as iron or arrows. Some pots are decorated and others are blank.
- The loot found in reward chests and decorated pots are still being iterated, and are absolutely not final as well as the loot from defeating mobs from a trial spawner.
Each trial chamber includes trial spawners with a melee, small melee, or ranged category:
- Melee
- Small melee
  - Minecraft:Spider
  - Minecraft:Cave spider
  - Baby zombie
  - Minecraft:Silverfish
- Ranged
  - Minecraft:Skeleton
  - Minecraft:Stray
  - Skeleton with Poison Minecraft:tipped arrows
Each trial spawner category only uses one mob for the entire structure when generated, and these mobs are randomized for each trial chamber.
- For example, one trial chamber might only spawn zombies, cave spiders and strays, while another might only spawn slimes, silverfish and skeletons.
- The exceptions to this are some trial spawners in unique rooms which always spawn breezes.
Regular mob spawning does not happen inside the bounding boxes of the trial chamber pieces.