Minecraft Wiki
Don't have an account?
Register
Advertisement
Register
Minecraft Wiki
Minecraft Wiki
8,971
pages
in: Java Edition, In development, Minecraft stubs,
and 2 more
English

Custom

Revision as of 16:56, 21 June 2020 by ContronThePanda (talk | contribs) (Added expanded default settings)
Sign in to edit
Information icon
This feature is exclusive to Java Edition. 
Crafting Table
This article describes content that may be included in a future update. 
This content has appeared in development versions, but the full update containing it has not been released yet.
Gear (item)
This article is a work in progress. 
Please help in the expansion or creation of this article by expanding or improving it. The talk page may contain suggestions.
This article is about the world type. For the Easter egg dimension in 20w14∞, see Java Edition 20w14∞ § World generation.
For the world type before Java Edition 1.13, see Old Customized.

Custom is a world type that allow users to change the generation of the Overworld, Nether, and End dimensions as well as the ability to create custom dimensions. It is edited using a JSON file that is imported on the world creation screen.

Access

Custom world generation works using JSON files, which need to be imported before world creation.

In the world creation menu, go to more options and select the "Import World" option. Then, select a world generation JSON file. A screen will pop up, warning users that custom worlds are experimental. Click "Yes" to continue.

The only way to access added dimensions is through commands, such as /execute in <dimension name> run tp @s ~ ~ ~, which will teleport the player to the specified dimension (see § JSON format).

JSON format

Dark Oak Sapling
This article is a stub. 
You can help by expanding it.
Instructions: Needs expansion. Useful sources: [1], [2]

Custom generation files take the following format:

  • The root tag.
    •  bonus_chest (Boolean): Whether the world has a bonus chest or not (equivalent to the "Bonus chest" option).
    •  generate_features (Boolean): Whether structures should be generated or not (equivalent to the "Generate structures" option).
    •  seed (integer): The numerical seed of the world.
    •  legacy_custom_options (string): The custom world preset that was used to generate the world when it was an old customized world. Only exists for old customized worlds.
    •  dimensions: A list of the dimensions in this world where the key is the namespace ID of the dimension.
      • A dimension. The dimensions minecraft:overworld, minecraft:the_nether and minecraft:the_end are required for a well functioning world. Any other namespaced ID is allowed for custom dimensions.
        •  generator: Generation settings used for that dimension.
          •  type (string): The ID of the generator. minecraft: followed by flat, noise or debug.
          • Other compounds (see below)'
        •  type: This can be a list of options for the dimensions or the namespaced ID of one of the default dimensions as a string, the dimensions will the use the settings of the specified dimension. Note: if the same namespace ID of a default dimension is used in multiple dimensions, the game will crash upon generation.
          • Dimension/Data

Generator types

Dimension/Generator

Defaults

Noise generator preset defaults

These are the settings used by the 6 presets available for the minecraft:noise generator.

Property minecraft:overworld minecraft:amplified minecraft:nether minecraft:caves minecraft:end minecraft:floating_islands
bedrock_roof_position -10 0 -10
bedrock_floor_position 0 0 -10
sea_level 63 32 0
disable_mob_generation false false true false
default_block minecraft:stone minecraft:netherrack minecraft:stone minecraft:end_stone minecraft:stone
default_fluid minecraft:water minecraft:lava minecraft:water minecraft:air minecraft:water
structures stronghold distance 32 Tag not included Tag not included
count 1
spread 3
structures See below
noise top_slide target -10 120 -3000
size 3 3 64
offset 0 0 -46
bottom_slide target -30 320 -30
size 0 4 7
offset 0 -1 1
sampling xz_scale 0.9999999814507745 1 2
xz_factor 80 80 80
y_scale 0.9999999814507745 3 1
y_factor 160 60 160
size_vertical 2 2 1
size_horizontal 1 1 2
height 256 128 128
density_factor 1 0 0
density_offset -0.46875 0.019921875 0
random_density_offset true false false
simplex_surface_noise true false true
island_noise_override false false true false
amplified false true false false

Structure defaults

These are the default values for all namespaced structures. Every preset uses the same values for all of these structures, with the exception of minecraft:ruined_portal.

Structure Spacing Separation Salt
village 32 8 10387312
desert_pyramid 32 8 14357617
igloo 32 8 14357618
jungle_pyramid 32 8 14357619
swamp_hut 32 8 14357620
pillager_outpost 32 8 165745296
stronghold* 1 0 0
monument 32 5 10387313
endcity 20 11 10387313
mansion 80 20 10387319
buried_treasure 1 0 0
mineshaft 1 0 0
ruined_portal nether and caves 25 10 34222645
All other presets 40 15 34222645
shipwreck 24 4 165745295
ocean_ruin 20 8 14357621
bastion_remnant 27 4 30084232
fortress 27 4 30084232
nether_fossil 2 1 14357921

*Placeholder values, have no effect

Biome parameter defaults

These are the default values used for each biome in the multi_noise biome_source. Interestingly, although only the values for nether biomes are accessible through a preset, several overworld biomes have default values as well.

Biome Temperature Humidity Altitude Weirdness Offset
badlands -0.25 -0.5 0.5 0.2 1
badlands_plateau -0.25 -0.5 0.65 0.2 1
bamboo_jungle 0.5 0.5 0 0.2 1
bamboo_jungle_hills 0.5 0.5 0.25 0.2 1
basalt_deltas -0.5 0 0 0 0.175
beach 0 0 -0.1 0 0.9935
birch_forest -0.1 0.2 0 0 1
birch_forest_hills -0.1 0.2 0.25 0 1
crimson_forest 0.4 0 0 0 0
desert 0.5 -0.5 0 0 1
jungle 0.5 0.5 0 0 1
nether_wastes 0 0 0 0 0
ocean 0 0 -0.5 0 1
plains 0 0 0 0 1
snowy_tundra -0.5 -0.5 0 0 1
soul_sand_valley 0 -0.5 0 0 0
warm_ocean 0 0 -0.25 0 1
warped_forest 0 0.5 0 0 0.375

Type defaults

Dimension/Defaults

Examples

Dark Oak Sapling
This article is a stub. 
You can help by expanding it.
Instructions: Add more examples. Also add the actual info for what the default generator uses.

Default settings

The following is the settings for an exported default Minecraft world.

Expanded default settings

This file contains the same settings used to produce a default world, but with all of the presets expanded to their default values. Note that there is a bug which makes it impossible to create the Ender Dragon fight without using the dimension type preset minecraft:the_end, as the flag that creates the fight is hardcoded and not accessible through JSON. However, it is otherwise identical to the default world.

Custom superflat dimension

Custom superflat dimension

An overview of a world made with the adjacent settings.

This dimension is a Superflat world with a layer of grass on four layers of coarse dirt on top of five layers of basalt. The entire world is full of village houses as spacing is set to 3 (default: 32) and separation is set to 1 (default: 8). The words starts by default at time 1000.

History

Upcoming Java Edition
1.16
{{Extension DPL}}<ul><li>[[Raw Gold|Raw Gold]]<br/>{{Item
| image = Raw Gold.png
| renewable = No
| stackable = Yes (64)
}}
'''Raw gold''' is a raw metal resource obtained from mining [[gold ore]].

== Obtaining ==
=== Mining ===
[[Gold ore]] and [[deepslate gold ore]] mined with an [[iron pickaxe]] or higher drops 1 unit of raw gold. If the pickaxe is enchanted with [[Fortune]], it can drop an extra unit per level of Fortune, allowing for a maximum of 4 with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops the ore block instead.

=== Crafting ===
{{Crafting
|showname=1
|Block of Raw Gold
|Output=Raw Gold,9
|type=Material
|foot=1
}}

== Usage ==
The primary usage of raw gold is smelting it into [[gold ingot]]s.

=== Crafting ===
{{crafting usage|Raw Gold}}

=== Smelting ingredient ===
{{Smelting
|showname=2
|Raw Gold
|Gold Ingot
|1.0
}}

=== Piglins ===
{{EntityLink|Piglin|Piglins}} are attracted to raw gold. They run toward any raw gold on the ground, and inspect it for 6 to 8 seconds before putting it in their inventory.

== Advancements ==
{{load advancements|Oh Shiny}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Raw Gold
|spritetype=item
|nameid=raw_gold
|itemtags=piglin_loved
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Gold
|spritetype=item
|nameid=raw_gold
|form=item
|id=506
|foot=1}}

== History ==
{{History|java}}
{{History||1.17|snap=21w14a|[[File:Raw Gold JE1.png|32px]] Added raw gold.}}
{{History|||snap=April 13, 2021|slink={{Tweet|JasperBoerstra|1381991999952277513}}|[[File:Raw Gold JE2.png|32px]] [[JAPPA]] shows a new raw gold texture.}}
{{History|||snap=21w15a|[[File:Raw Gold JE2.png|32px]] The texture of raw gold has been changed.
|Raw gold can now be used to craft [[block of raw gold]].}}
{{History|||snap=April 16, 2021|slink={{Tweet|JasperBoerstra|1383047666037325829}}|[[File:Raw Gold (pre-release).png|32px]] [[JAPPA]] shows a new raw gold texture again.}}
{{History|||snap=21w16a|[[File:Raw Gold JE3.png|32px]] The texture of raw gold has been changed.}}

{{History|Bedrock}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Raw Gold JE2.png|32px]] Added raw gold.}}
{{History|||snap=beta 1.17.0.52|Raw gold are now available without enabling [[experimental gameplay]].}}
{{History|||snap=beta 1.17.0.54|[[File:Raw Gold JE3.png|32px]] The texture of raw gold has been changed.}}
{{History|foot}}

== Issues ==
{{Issue list}}

==Gallery==
<gallery>
JE 1.17 Dev Raw Metals.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 1.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 2.png|Jappa shows raw ore textures.
Jappa Raw Ores 3.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 4.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 5.jpg|Jappa shows raw ore textures.
</gallery>

{{Items}}

[[Category:Non-renewable resources]]

[[de:Rohgold]]
[[es:Oro en bruto]]
[[fr:Or brut]]
[[ja:金の原石]]
[[pl:Surowe złoto]]
[[pt:Ouro bruto]]
[[ru:Необработанное золото]]
[[uk:Необроблене золото]]
[[zh:粗金]]</li><li>[[Bookshelf|Bookshelf]]<br/>{{About|the bookshelf used with an enchanting table|the bookshelf that can hold books|Chiseled Bookshelf}}
{{Block
|image=Bookshelf.png
|transparent=No
|light=No
|tool=Axe
|renewable=Yes
|stackable=Yes (64)
|flammable=Yes (30)
|lavasusceptible=Yes
}}
'''Bookshelves''' are [[blocks]] that improve [[enchanting|enchantments]] applied with an [[enchanting table]] when placed around one, up to a maximum of fifteen bookshelves, at the expense of [[Enchanting/Levels|level]] requirement.

== Obtaining ==
=== Natural generation ===
Bookshelves can generate in village libraries and sometimes village houses.

[[Stronghold]]s may contain up to two libraries, each of which may be single-level or have an upper balcony. These feature some bookshelves arranged in pillars, and more bookshelves arranged in pillars in the walls. Single-level libraries contain 161 bookshelves, while libraries with balconies contain 233.

Bookshelves also naturally generate in certain [[woodland mansion]] rooms.

=== Breaking ===
Bookshelves can be broken fairly easily by hand, but can be broken faster by using an [[axe]]. In either case, they drop 3 books when broken, allowing the reconstruction of the bookshelf with the addition of six wood planks. When broken by an item that is [[enchanted]] with [[Silk Touch]], a bookshelf drops itself.
{{breaking row|horizontal=1|Bookshelf|Axe}}

=== Crafting ===
{{Crafting
|A1=Any Planks
|B1=Any Planks
|C1=Any Planks
|A2=Book
|B2=Book
|C2=Book
|A3=Any Planks
|B3=Any Planks
|C3=Any Planks
|Output=Bookshelf
|type=Building block
}}

=== Trading ===
Novice-level librarian [[Villager|villagers]] have a 50% chance to sell 1 bookshelf for 9 [[Emerald|emeralds]] as part of their trades.{{only|bedrock}}

Novice-level librarian villagers have a {{frac|2|3}} chance to sell 1 bookshelf for 9 emeralds.{{only|java}}

== Usage ==
=== Enchanting ===
{{main|Enchantment mechanics#Bookshelf placement}}

If an [[enchanting table]] is placed near a bookshelf, glyph [[particles]] fly from the bookshelf toward the enchanting table. Having bookshelves in the proper position near the table allows the table to apply higher-level enchantments.

=== Crafting ingredient ===
{{crafting usage}}

=== Fuel ===
Bookshelves can be used as a [[fuel]] in [[furnace]]s, smelting 1.5 items per block.

=== Villager ===
Librarian [[villager]]s can interact with bookshelves.

=== Note Blocks ===
Bookshelf can be placed under [[note block]]s to produce "bass" sounds.

== Sounds ==
{{Sound table/Block/Wood}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Bookshelf
|spritetype=block
|nameid=bookshelf
|showblocktags=y|blocktags=mineable/axe
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Bookshelf
|spritetype=block
|nameid=bookshelf
|id=47
|foot=1}}

== Achievements ==
{{load achievements|Librarian}}

== History ==
{{History|java classic}}
{{History||October 24, 2009|link=https://notch.tumblr.com/post/221308991/the-new-block-types-and-new-graphics-for-the-gold|Bookshelves were teased by [[Notch]].}}
{{History||0.26 SURVIVAL TEST|[[File:Bookshelf JE1.png|32px]] Added bookshelves.
|Bookshelves are currently impossible to obtain without loading a pre-edited map.
|Bookshelves are currently destroyed in [[explosion]]s.
|When bookshelves are broken, they currently do not drop anything.}}
{{History||0.28|Bookshelves can now be freely placed.}}
{{History|java alpha}}
{{History||v1.0.11|Bookshelves can now be [[crafting|crafted]] from 3 [[book]]s and 6 [[planks]].}}
{{History|java beta}}
{{History||1.8|snap=Pre-release|Bookshelves can now be found generated in libraries in [[village]]s, and libraries in [[stronghold]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Bookshelves now drop 3 [[book]]s when broken by a non-[[Silk Touch]] [[item]].
|They are now necessary to [[enchanting|enchant]] with higher levels for better enchanted items.
|The number of bookshelves required to reach the maximum enchantment level is 30.}}
{{History|||snap=Beta 1.9 Prerelease 5|[[File:Bookshelf JE2 BE1.png|32px]] The top texture of bookshelves have now been updated as a result of the [[planks]] texture update.}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft bookshelves.}}
{{History||1.3.1|snap=12w21a|Librarian [[villager]]s now [[trading|sell]] 1 bookshelf for 3 [[emerald]]s.}}
{{History|||snap=12w22a|The number of bookshelves required to reach the maximum enchantment level has been now decreased to 15.}}
{{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft bookshelves.}}
{{History||1.8|snap=14w02a|Librarian villagers now sell 1 bookshelf for 3–4 [[emerald]]s.}}
{{History||1.11|snap=16w39a|Bookshelves now generate in [[woodland mansion]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 47.}}
{{History||1.14|snap=18w43a|[[File:Bookshelf JE3.png|32px]] The texture of bookshelves has now been changed.}}
{{History|||snap=18w47a|[[File:Bookshelf JE4 BE2.png|32px]] The texture of bookshelves has now been changed, once again.}}
{{History|||snap=19w02a|Bookshelves can now be used to craft [[lectern]]s.}}
{{History||1.16|snap=20w06a|[[Crimson planks]] and [[warped planks]] can now be used to craft bookshelves.}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft bookshelves.}}

{{History|pocket alpha}}
{{History||v0.2.1|[[File:Bookshelf JE2 BE1.png|32px]] Added bookshelves.|Bookshelves are currently obtainable only in [[Creative]] mode.}}
{{History||v0.3.0|Bookshelves are now obtainable in [[Survival]] mode.}}
{{History||v0.9.0|snap=build 1|Bookshelves now naturally spawn in [[stronghold]]s and [[village]]s.}}
{{History||v0.12.1|snap=build 1|Bookshelves can now be used to increase [[enchantment table]] levels.|Bookshelves can now be obtained by using a [[tool]] with the [[Silk Touch]] enchantment.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Librarian [[villager]]s now [[trading|sell]] 1 bookshelf for 3-4 [[emerald]]s as their second tier trade.}} 
{{History||1.1.0|snap=alpha 1.1.0.0|Bookshelves now generate in [[woodland mansion]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|Bookshelves can now be used to craft [[lectern]]s.|Bookshelves now get inspected by librarian [[villager]]s.|[[File:Bookshelf JE4 BE2.png|32px]] The texture of bookshelves has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has now been changed, librarian villagers now have a 50% chance to sell a bookshelf for 6 [[emerald]]s as part of their first trade.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Bookshelf JE2 BE1.png|32px]] Added bookshelves. Whether they actually used this texture is unknown.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Bookshelf JE4 BE2.png|32px]] The texture of bookshelves has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Bookshelf JE2 BE1.png|32px]] Added bookshelves.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==
* Bookshelves' top and bottom textures by default use the same texture as [[oak planks]].
* It takes 90 planks, 45 [[leather]] and 135 [[paper]] to make 15 bookshelves in order to get a level 30 [[enchantment]].
* A bookshelf is the icon for [[Education Edition]].

== Gallery ==
<gallery>
File:Library in Village.png|Naturally occurring bookshelves in a [[village]]. (Before Village & Pillage).
File:Large Stronghold Library.png|Naturally occurring bookshelves in a [[stronghold]].
File:Achievement get! Trading emeralds for bookshelves.png|Bookshelves obtained by [[trading]] with a [[villager]].
File:Enchanting-Table.png|Bookshelves powering an [[enchanting table]].
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/block-week-bookshelf Block of the Week: Bookshelf] – Minecraft.net on December 16, 2016

{{Blocks|Building}}

[[Category:Manufactured blocks]]
[[Category:Natural blocks]]
[[Category:Generated structure blocks]]
[[Category:Utility blocks]]
[[Category:Bedrock Edition]]
[[Category:Java Edition]]
[[Category:Items]]
[[Category:Flammable blocks]]

[[cs:Knihovna]]
[[de:Bücherregal]]
[[es:Librería]]
[[fr:Bibliothèque]]
[[hu:Könyvespolc]]
[[it:Libreria]]
[[ja:本棚]]
[[ko:책장]]
[[nl:Boekenkast]]
[[pl:Biblioteczka]]
[[pt:Estante de livros]]
[[ru:Книжные полки]]
[[th:ชั้นหนังสือ]]
[[uk:Книжкова полиця]]
[[zh:书架]]</li></ul>
20w21aAdded custom worlds.
Custom worlds are JSON-driven.
Custom dimensions can be added and vanilla dimensions can be modified.
There is currently no in-game menu to modify worlds; custom worlds can only be generated by importing a JSON file.
pre1The "temparature" biome parameter is now spelled "temperature".
Dimensions and dimension settings can be created through data packs.

Issues

Issues relating to "Custom" are maintained on the bug tracker. Report issues there.

External links


Environment 

View at: Template:Environment/content [edit]
Deutsch Français Polski Русский 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms
Advertisement

Fan Feed

More Minecraft Wiki