-
-
Notifications
You must be signed in to change notification settings - Fork 31
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
adding custom worldtypes round 2 #84
Merged
Merged
Changes from all commits
Commits
Show all changes
46 commits
Select commit
Hold shift + click to select a range
abab008
trying again
woodiertexas a3b730b
metadata
woodiertexas 9e15a24
metadata pt2
woodiertexas 6dca3d2
metadata pt3
woodiertexas d16107a
so linebreaks using </br> cause issues apparently
woodiertexas 620148a
this preview feature is irritating me to no ends
woodiertexas b799cb2
fix typo
woodiertexas 063ff9c
no draft
woodiertexas 9411986
get the world types page to show in preview once and for all
woodiertexas 8189f02
linebreaks except they actually work this time
woodiertexas 41e429f
linebreaks except they actually work this time... again because they …
woodiertexas b06654b
linkebreaks round 3
woodiertexas e30ab1e
update file paths
woodiertexas 1884ebc
add missing `{}` + bonus indentation edit
woodiertexas dd69a38
reword section about dimensions and dimension types
woodiertexas 009f5b2
linebreak update
woodiertexas 625c1c6
linebreak update 2: electric boogaloo
woodiertexas 5a64b31
linebreak update 3: revenge of the line breaks
woodiertexas 364083d
Update wiki/misc/world_types/en.md
woodiertexas 92c62e7
Update wiki/misc/world_types/en.md
woodiertexas 2dee30b
add world type examples
woodiertexas e0473c6
rework dimension explanation
woodiertexas d7d48ac
less repetition
woodiertexas a9b940b
add section headers
woodiertexas 76b262e
Update wiki/misc/world_types/en.md
woodiertexas 766c0dd
Update wiki/misc/world_types/en.md
woodiertexas e84dede
Update wiki/misc/world_types/en.md
woodiertexas 3edd1c2
Update wiki/misc/world_types/en.md
woodiertexas b19642e
Update wiki/misc/world_types/en.md
woodiertexas 39c490b
Update wiki/misc/world_types/en.md
woodiertexas 89ebdb3
Update en.md
woodiertexas bd4db3a
Update en.md
woodiertexas 4fd339c
rephrasing
woodiertexas 553b8cd
Update en.md
woodiertexas dcde6e8
Update wiki/misc/world_types/en.md
woodiertexas ab57572
more stuff
woodiertexas b76dfd4
github and wonky formatting lol
woodiertexas 6af94eb
yeefpineapple
woodiertexas 253afbb
reformatting
woodiertexas bc1419d
fix link description
woodiertexas 3daa209
reformatting 2: electric boogaloo
woodiertexas 17a2d3d
rephrasing
woodiertexas 581ed30
error fix and reformatting
woodiertexas 863e45e
Update en.md
woodiertexas d69049a
Update wiki/misc/world_types/en.md
woodiertexas ae85731
Merge branch 'main' into main
OroArmor File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
title: wiki.misc.world_types.title | ||
index: 0 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,81 @@ | ||
--- | ||
title: Adding a Custom World Type | ||
index: 0 | ||
--- | ||
|
||
# Adding custom world types | ||
If your mod completely overhauls Minecraft's worldgen, you'll likely want to create a custom worldtype to offer users the option to use your worldgen or vanilla Minecraft's world generation. | ||
Now, what is a custom world type you may ask? *World types*, also called *world presets*, define world generation options for Minecraft worlds. They let you change the make-up of your Minecraft worlds by configuring how world generation behaves. | ||
|
||
Some examples of world types already built into Minecraft are "Amplified", "Super Flat", "Single Biome", and "Large Biomes". | ||
|
||
## Specifying which dimensions your world type applies to | ||
|
||
The following block shows how to specify which dimensions your world type will apply to. In `dimensions`, a `minecraft:overworld` object is required. | ||
The dimension `type` can be a built-in preset or a custom dimension preset you implement in your mod. | ||
|
||
|
||
`src/main/resources/data/minecraft/example_mod/worldgen/world_preset`: | ||
```json | ||
{ | ||
"dimensions": { | ||
"minecraft:overworld": { | ||
"type": "example_mod:example_mod_dimension_type" | ||
} | ||
} | ||
} | ||
``` | ||
|
||
## Configuring how the worldgen works in your worldtype | ||
|
||
`generator` is where you specify how the worldgen in your world type behaves. The `type` is a "generator ID" and the following are valid generator IDs: | ||
- `noise` | ||
- `flat`: Creates a superflat world (not really applicable here) | ||
- `debug`: Creates a debug world (not really applicable here) | ||
|
||
In `biome_source`, you specify how biomes generate. The `type` parameter here is what kind of biome generation will be used. | ||
Valid generation types: | ||
- `multi_noise`: Similar to overworld generation | ||
- `fixed`: Like selecting "Single Biome" in world creation | ||
- `the_end`: This is the generation the end dimension uses (not really applicable here) | ||
- `checkerboard`: Places biomes in a checkerboard style | ||
|
||
If the biome source `type` is `minecraft:multi_noise`, Minecraft will use 3D biomes in the overworld and the nether. | ||
The `preset` can be `minecraft:overworld` or `minecraft:nether`. More info about this can be found [in the article about custom dimensions in the Minecraft wiki](https://minecraft.wiki/w/Custom_dimension#Multi-noise_biome_source_parameter_list). | ||
|
||
`src/main/resources/data/minecraft/example_mod/worldgen/world_preset/example_mod_preset.json`: | ||
```json | ||
{ | ||
"dimensions": { | ||
"minecraft:overworld": { | ||
"type": "minecraft:overworld", | ||
"generator": { | ||
"type": "minecraft:noise", | ||
"biome_source": { | ||
"type": "minecraft:multi_noise", | ||
"preset": "minecraft:overworld" | ||
} | ||
} | ||
} | ||
} | ||
} | ||
``` | ||
This will generate a world relatively similar to that of 's default overworld generation. | ||
|
||
On a dedicated server, you navigate to your `server.properties` file and find the `level-type` field. By default, the value is `minecraft:normal`. Changing this to the ID for your world type (`example_mod:example_mod_preset`) will use that instead. | ||
|
||
## Making your worldtype accessible | ||
|
||
In order for your world type to show in the "create a new world" screen, you will need to make a file called `normal.json` in `resources/data/minecraft/tags/worldgen/world_preset` and populate it with the following. | ||
|
||
`src/main/resources/data/minecraft/tags/worldgen/world_preset/normal.json`: | ||
```json | ||
{ | ||
"values": [ | ||
"example_mod:example_mod_preset" | ||
] | ||
} | ||
``` | ||
This will make your world type show up in the world creation screen. | ||
|
||
Alternatively, if you want your world type to only show as an option while the user is holding down ALT, make a file called `extended.json` in the same directory as your `normal.json` file. |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This section could use a note about how to select custom world types on a dedicated server (
server.properties
)There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
was this fixed? i dont see any reference to this