Java Edition Flattening

"Flattening" redirects here. For the Bedrock Edition equivalent, see Bedrock Edition Flattening.
This feature is exclusive to Java Edition.
 

In Java Edition 1.13, the change known as "The Flattening" was performed, which modified the IDs of many blocks, items, biomes, particles, paintings, entities, statistics and sound events, removed numeric IDs, added and removed some block states, and changed NBT tags and display names.[1]

Later changes to IDs and display names, e.g. water cauldrons being split from cauldrons in 1.17, are not counted here.

Block and item IDs

Blocks and items that change their ID in any way also affect their statistics.

  1. a b c d e f g h i j k l m n o p q r s t u v w x y z aa ab ac ad ae af ag ah ai aj ak al am an ao ap aq ar as at au av aw ax ay az ba bb bc bd be bf bg bh bi bj bk bl bm bn bo bp bq br bs bt bu bv bw bx by bz ca cb cc cd ce cf cg ch ci cj ck This block has no item form.

Entity IDs

Entities that change their ID in any way also affect their statistics.

Biome IDs

Particle IDs

This section is missing information about: Using the /particle command in 17w45a displays a number in chat - are these the numeric particle IDs? Can they be included here?.
 
Please expand the section to include this information. Further details may exist on the talk page.

Particle IDs started using resource locations (minecraft: in front) as well as changed the ID.

  1. The ID was made unavailable through commands and the particle still exists in current versions of Java Edition

Sound events

Some sound events were modified.

Block states

Some block states were modified.


Painting motifs

Painting motifs started using resource locations (minecraft in front) as well as changed the ID to be uncapitalised and separated with underscores.

Names

The names of some blocks and items were changed.

  1. a b This is actually the melon stem, it used the same translation string as pumpkin stems.
  2. a b c d e f g h i j k l m n o p These translation strings were originally missing, see MC-122579; now they use the same translation strings as standing banners (rather than their own), see MC-124142

Statistics

Statistics received the following changes:

  • Merged the blocks and items tabs.
  • Changed to use resource locations.

NBT data

Chunk format was modified.

Items

Changes to item structure:

  • Damage in the root of the item data removed.
  • Damage added in the tag tag, only used for durability.
  • map integer added in the tag tag, for maps.
  • Base of shields has the colors in the opposite order for consistency.
  • ench for enchantments got renamed to Enchantments.
  • Enchantment Ids in Enchantments and StoredEnchantments now use the string ids.

Entities

Changes to entity format:

Blocks

Changes to block entity format:

Prior specifications

Note block
  • [NBT Compound / JSON Object] Block entity data
    • Tags common to all block entities see Template:Nbt inherit/blockentity/template
    • [Byte] note: Pitch (number of uses).
    • [Byte] powered: 1 or 0 (true/false) - if true, the noteblock is being provided a redstone signal.
Flower pot
  • [NBT Compound / JSON Object] Block entity data
    • Tags common to all block entities see Template:Nbt inherit/blockentity/template
    • [String] Item: The Block ID of the plant in the pot. Known valid blocks are minecraft:sapling (6), minecraft:tallgrass (31), minecraft:deadbush (32), minecraft:yellow_flower (37), minecraft:red_flower (38), minecraft:brown_mushroom (39), minecraft:red_mushroom (40), minecraft:cactus (81). Other block and item IDs may be used, but not all will render. Together with Data, this determines the item dropped by the pot when destroyed.
    • [Int] Data: The data value to use in conjunction with the above Block ID. For example if Item is 6 (a sapling block), the Data is used to indicate the type of sapling.
  1. a b c d e This tag will change to a compound format with {Name:"block_id",Properties:{state:"value"}}

Commands

Some commands were changed.

  1. a b c See nbt section for what happens to other data values. See also 1.13's Items section
  2. a b c d See also 1.13's Blocks section

Advancements

Two changes were made to advancements:

  • icon's data removed.
  • item condition's data removed.

Loot tables

The set_data function was removed from loot tables.

Game assets

  • Models
    • Renamed to use the new IDs.
  • Block state files
    • Renamed to use the new IDs.
    • "normal" for blocks without block states changed to an empty string ("").
    • Item frames now have "map=false" instead of "normal" and "map=true"instead of "map".
    • Model references no longer start at the models/block/ folder, but instead at models/.
  • Textures
  • Recipes
    • Renamed to use the new IDs.
  • Advancements
    • Recipe advancements renamed to use the new IDs.
  • Language files

Block translation strings

Item translation strings

History

Java Edition
1.1317w45aCommand format changed to no longer use meta data and damage values; making the items differing by damage not possible to be given with commands.
17w47aThe item and block IDs got merged, deleted, separated and renamed.
The block state changes got applied.
Removed damage from items, added damage in the tag tag for tools and armor and added map for maps.
Trapped chests now got their own block entity id trapped_chest.
Metadata completely removed.
Particle IDs now use resource locations and got renamed.
Statistics now use resource locations, and entity statistics got removed.
Translation strings now follow the ID for items, blocks and statistics.
17w47bTrapped chests now use the chest block entity id again.
17w48aEntity statistics re-added and now apply to all entities.
18w02aPainting motives now use resource locations and got renamed.
Wall banners now use the same translation key as their standing variant banners.
The translation keys for entities are now entity.<namespace>.<id> instead of entity.<title>.name.
18w07bRenamed turtle_shell_piece to scute.
18w10bSeparated dead_coral into one for each color.
18w10cMerged water and flowing_water.
Merged lava and flowing_lava.
18w14bRenamed <color>_dead_coral to dead_<variant>_coral_block.
Renamed <color>_coral to <variant>_coral_block.
Renamed <color>_coral_plant to <variant>_coral.
Renamed <color>_coral_fan to <variant>_coral_fan.
18w19aRenamed (tall_)sea_grass to (tall_)seagrass.
Renamed the entity puffer_fish to pufferfish.
Changed the name of "Clownfish" to "Tropical Fish".
18w20aRenamed kelp_top to kelp.
Renamed kelp to kelp_plant.
Renamed prismarine_bricks_slab to prismarine_brick_slab.
Renamed prismarine_bricks_stairs to prismarine_brick_stairs.
Renamed cod_mob_spawn_egg to cod_spawn_egg.
Renamed salmon_mob_spawn_egg to salmon_spawn_egg.
Renamed cod_mob to cod.
Renamed salmon_mob to salmon.
Changed the name of "Weighted Pressure Plate (Heavy)" to "Heavy Weighted Pressure Plate".
Changed the name of "Weighted Pressure Plate (Light") to" Light Weighted Pressure Plate".
Changed the name of "Gold Horse Armor" to "Golden Horse Armor".
Changed the name of "Chain Armor" to "Chainmail Armor".
Changed the name of "Milk" to "Milk Bucket".
Changed the name of "Seeds" to "Wheat Seeds".
Changed the name of "Spawn <mob>" to "<mob> Spawn Egg".
Renamed several block textures.
Renamed several structure files.
18w20bRenamed melon_block to melon.
Renamed melon to melon_slice.
Renamed speckled_melon to glistering_melon_slice.
Changed the entity name "Ender Crystal" to "End Crystal".
Changed the entity name Block of TNT to "Primed TNT".
18w21aThe ench NBT tag is now called Enchantments, and no longer has number IDs in each compound.
18w22aThe block state for leaves changed from check_decay and decayable Booleans to distance (ranging from 1 to 7) and a persistent Boolean.
18w22bBark now has axis=x|y|z block states.
pre3textures/blocks/ changed to textures/block/.
textures/items/ changed to textures/item/.
Block state files now use "" rather than "normal" to specify no block states.
Block state files now reference models starting in models/ rather than models/block/.
pre5Renamed xp_orb to experience_orb.
Renamed xp_bottle to experience_bottle.
Renamed eye_of_ender_signal to eye_of_ender.
Renamed ender_crystal to end_crystal.
Renamed the entity fireworks_rocket to firework_rocket.
Renamed commandblock_minecart to command_block_minecart.
Renamed villager_golem to iron_golem.
Renamed evocation_fangs to evoker_fangs.
Renamed evocation_illager to evoker.
Renamed vindication_illager to vindicator.
Renamed illusion_illager to illusioner.
Renamed evocation_illager_spawn_egg to evoker_spawn_egg.
Renamed vindication_illager_spawn_egg to vindicator_spawn_egg.
Renamed mob_spawner to spawner.
Renamed portal to nether_portal.
Renamed clownfish to tropical_fish.
Renamed clownfish_bucket to tropical_fish_bucket.
Renamed chorus_fruit_popped to popped_chorus_fruit.
Renamed <type>_bark to <type>_wood.
The sound event changes got applied.
The biome ID changes got applied.
The translation keys for enchantments are now enchantment.<namespace>.<id> instead of enchantment.<name>
The translation keys for effects are now effect.<namespace>.<id> instead of effect.<name>

References