# CustomWorldHeight<\/p>\n
**CustomWorldHeight** is a plugin for Paper that allows you to modify the height of the Minecraft world. It provides an easy and efficient way to extend or limit the vertical dimensions of your world for creative builds, gameplay tweaks, or server optimization.<\/p>\n
Github page: https:\/\/github.com\/Lumine1909\/CustomWorldHeight<\/p>\n
# Important<\/p>\n
> This plugin is similar to the vanilla datapack, so there will be some similar issues as the datapack one.
\n>
\n> Once you set the height of a certain world, it will be VERY DANGEROUS to shirk the world height, all the data will lose.
\n>
\n> Expand the height is relatively unharmful, but if you decrease the min-Y, new chunks will be different from already generated chunks.
\n>
\n> Increasing the height will only cause the chunk’s height map to be recalculated, and all the data will be properly preserved.<\/p>\n
## Features<\/p>\n
– Customize the height of your Minecraft world.
\n– Seamless integration with Paper.
\n– Easy-to-configure settings for server administrators.<\/p>\n
## Installation<\/p>\n
Follow these steps to install the plugin:<\/p>\n
1. Download the latest release of **CustomWorldHeight** from the Releases page.
\n2. Place the downloaded `.jar` file into your server’s `plugins` folder, start the server.
\n3. After plugin generated the config template it will automatically disable, please finish the config.
\n4. Restart your Minecraft server, and the configured world’s height will be modified.<\/p>\n
## API Usage
\n“`kotlin
\nrepositories {
\n mavenCentral()
\n}
\ndependencies {
\n compileOnly(“io.github.lumine1909:CustomWorldHeight-API:0.0.1”)
\n}
\n“`
\n“`java
\npublic void modifyHeight() {
\n \/*
\n All of these works only if the world is not loaded yet!
\n This is not a permanent modification! If you want to set permanently,
\n store the height data with your plugin and SET IT ON EACH STARTUP!
\n *\/<\/p>\n
\/\/ Set the height of overworld
\n WorldHeightService.get().registerWorld(
\n Identifier.of(“demo”, “height1”), “world”,
\n new Height(1088, -64, 512, Height.CloudHeight.DEFAULT),
\n BaseDimensionType.OVERWORLD
\n );
\n \/\/ Set the height of all worlds start with “test_”
\n WorldHeightService.get().registerRegex(
\n Identifier.of(“demo”, “height2”), “test_\\w+”,
\n new Height(1088, -64, 512, Height.CloudHeight.DEFAULT),
\n BaseDimensionType.CUSTOM
\n );
\n}
\n“`<\/p>\n
## Configuration<\/p>\n
“`yaml
\n# You can set to anything you want, will be used to generate Identifier (ResourceLocation)
\nexample-namespace:<\/p>\n
# Set the name for certain world
\n world: ‘example-world-name’<\/p>\n
# Min Y position
\n min-y: -64<\/p>\n
# Height (max Y position = min-y + height – 1)
\n height: 1024<\/p>\n
# Height for Chorus Fruit teleport and etc. See wiki for details
\n logical-height: 512<\/p>\n
# Height for the cloud (empty -> do not have cloud, default -> use default height)
\n # This feature is only for 1.21.6+
\n cloud-height: ‘default’<\/p>\n
# This will let the plugin process registration data when world load
\n dimension-type: ‘custom’<\/p>\n
# You can set to anything you want, will be used to generate Identifier (ResourceLocation)
\nexample-regex:<\/p>\n
# This plugin also support Regex matching
\n regex: ‘^test_w+’<\/p>\n
# Min Y position
\n min-y: -64<\/p>\n
# Height (max Y position = min-y + height – 1)
\n height: 1024<\/p>\n
# Height for Chorus Fruit teleport and etc. See wiki for details
\n logical-height: 512<\/p>\n
# Height for the cloud (empty -> do not have cloud, default -> use default height)
\n # This feature is only for 1.21.6+
\n cloud-height: 256<\/p>\n
# For ‘overworld’, ‘the_nether’, ‘the_end’, ‘overworld_cave’, this will use built in data to generate before world is initializing
\n dimension-type: ‘overworld’
\n“`<\/p>\n
## License<\/p>\n
This project is licensed under the GPL 3.0 License.
\nThe API part is licensed under the LGPL 3.0 License.<\/p>\n
## Support<\/p>\n
If you encounter any issues or have questions, feel free to open an issue.<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
A plugin for Paper that allows you to modify the height of the Minecraft world<\/p>\n","protected":false},"featured_media":53260,"template":"","meta":{"_minecraft_slug":"customworldheight","_minecraft_project_id":"UF11NNft","_minecraft_author":"Lumine1909","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":2837,"_minecraft_follows":14,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"customworldheight.zip","_minecraft_size_bytes":599673,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T05:20:08.581684Z","_minecraft_date_created":"2025-06-09T08:00:34.914168Z","_minecraft_date_modified":"2026-04-05T06:37:25.377853Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/customworldheight","_minecraft_icon_attachment_id":53260,"_minecraft_imported_at":"2026-06-02T23:13:15+00:00","_minecraft_import_hash":"eb61c73375150c1075fcdc2f52f7a195","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,92,159],"mod_loader":[130,131,132,133],"minecraft_version":[101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-53259","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_category-worldgen","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n