Skip to content

Getting Started

Jump to bottom
Jeremy edited this page Sep 18, 2026 · 1 revision

How to set up your first preset and set basic world creation settings.

File Structure

Presets are defined in config/worldpresets/presets/ as JSON5 files. Example file structure:

config/
└── worldpresets/
    ├── presets/
    │   ├── hardcore_island.json5
    │   ├── hardcore_island.png
    │   ├── lush_mansion_island.json5
    │   ├── lush_mansion_island.png
    │   ├── nether_start.json5
    │   ├── nether_start.png
    │   ├── nosy_neighbors.json5
    │   ├── nosy_neighbors.png
    │   ├── skyblock.json5
    │   └── skyblock.png
    └── worlds/
        └── skyblock/
            ├── region
            └── level.dat

Upon loading the mod for the first time, an example preset will be placed in the presets folder. This preset demonstrates each of the available preset settings and is hidden so it won't show in-game. Whenever the Create World screen opens, all presets are reloaded from disk so they can be modified without restarting.

File Format

Presets are stored as JSON5 files, which means they follow a JSON syntax, but allow comments and unquoted keys. Commas are still required, and trailing commas will throw errors.

All preset settings are optional, and a preset is considered valid even if the only contents of the file is {}.

Images

Cover images for a preset can be placed in the preset folder as well. They must have the same name as the preset itself and must be either a PNG or JPG image.

Cover images will be displayed in a 3:2 frame, 96 GUI pixels wide (scaled up based on configured GUI size). Any images that don't already have a 3:2 aspect ratio will be cropped to fit. (I recommend an image size of 768×512, which will render nicely at all GUI scales from 1x to 8x.)

Preset Settings

The following settings are available to configure how the preset appears in the list.

Field Type Default Description
title string filename The preset's name.
description string "" The preset's description, shown under the title. Can be up to 5 lines long and supports formatting codes and \n for new lines.
order integer 0 Sort order, with the lowest numbers appearing first in the list. Presets set with the same value sort alphabetically.
hidden boolean false Whether the preset is visible in the list or not.
translate_title boolean false If true, the title is used as a translation key instead of normal text.
translate_description boolean false If true, the description is used as a translation key instead of normal text.

World Settings

The world section will pre-fill basic world settings. All of these options can still be modified by a player while creating the world if they choose to.

Field Type Default Description
name string "" The world's name.
gamemode string "survival" The world's gamemode, one of "survival", "hardcore", or "creative".
difficulty string "normal" The world's difficulty, one of "peaceful", "easy", "normal", or "hard".
allow_cheats boolean false If cheats are enabled.
world_type string "minecraft:normal" The world type, which can be "minecraft:normal", "minecraft:flat", "minecraft:amplified", "minecraft:large_biomes", "minecraft:single_biome_surface", or a modded world type.
seed string "" The world's seed.

Example

{
    title: "Example Preset",
    description: "A brief description, up to 5 lines long.\nUse \\n for a new line.\nSupports \u00A7f\u00A7oformatting codes\u00A7r. Find more information at minecraft.wiki/w/Formatting_codes",
    order: 1,

    world: {
        name: "Example Preset World",
        gamemode: "survival",
        difficulty: "normal",
        allow_cheats: false,
        world_type: "minecraft:normal",
        seed: "01189998819991197253"
    }
}

More Options

Clone this wiki locally