{"id":25620628,"url":"https://github.com/lumine1909/customworldheight","last_synced_at":"2026-05-23T03:11:06.183Z","repository":{"id":231636397,"uuid":"782286348","full_name":"Lumine1909/CustomWorldHeight","owner":"Lumine1909","description":"A paper plugin that help you customize the height of world","archived":false,"fork":false,"pushed_at":"2025-07-01T06:04:38.000Z","size":126,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-07T10:38:01.683Z","etag":null,"topics":["custom-height","minecraft","paper","plugin","world"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Lumine1909.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-04-05T01:57:24.000Z","updated_at":"2025-07-14T06:27:23.000Z","dependencies_parsed_at":"2024-04-05T03:22:16.363Z","dependency_job_id":"04324f5e-ae99-4ff0-b94f-29a4fb2f83b8","html_url":"https://github.com/Lumine1909/CustomWorldHeight","commit_stats":null,"previous_names":["lumine1909/customworldheight"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/Lumine1909/CustomWorldHeight","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lumine1909%2FCustomWorldHeight","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lumine1909%2FCustomWorldHeight/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lumine1909%2FCustomWorldHeight/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lumine1909%2FCustomWorldHeight/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lumine1909","download_url":"https://codeload.github.com/Lumine1909/CustomWorldHeight/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lumine1909%2FCustomWorldHeight/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274026705,"owners_count":25209739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-07T02:00:09.463Z","response_time":67,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["custom-height","minecraft","paper","plugin","world"],"created_at":"2025-02-22T07:19:36.780Z","updated_at":"2026-05-23T03:11:06.178Z","avatar_url":"https://github.com/Lumine1909.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CustomWorldHeight\n\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.\n\n# Important\n\n\u003e [!CAUTION]\n\u003e \n\u003e This plugin is similar to the vanilla datapack, so there will be some similar issues as the datapack one.\n\u003e \n\u003e 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\u003e \n\u003e Expand the height is relatively unharmful, but if you decrease the min-Y, new chunks will be different from already generated chunks.\n\u003e \n\u003e Increasing the height will only cause the chunk's height map to be recalculated, and all the data will be properly preserved.\n\n\n## Features\n\n- Customize the height of your Minecraft world.\n- Seamless integration with Paper.\n- Easy-to-configure settings for server administrators.\n\n## Installation\n\nFollow these steps to install the plugin:\n\n1. Download the latest release of **CustomWorldHeight** from the [Releases](https://github.com/Lumine1909/CustomWorldHeight/releases/latest) 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.\n\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    */\n\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```\n\n## Configuration\n\n```yaml\n# You can set to anything you want, will be used to generate Identifier (ResourceLocation)\nexample-namespace:\n\n  # Set the name for certain world\n  world: 'example-world-name'\n\n  # Min Y position\n  min-y: -64\n\n  # Height (max Y position = min-y + height - 1)\n  height: 1024\n\n  # Height for Chorus Fruit teleport and etc. See wiki for details\n  logical-height: 512\n\n  # Height for the cloud (empty -\u003e do not have cloud, default -\u003e use default height)\n  # This feature is only for 1.21.6+\n  cloud-height: 'default'\n\n  # This will let the plugin process registration data when world load\n  dimension-type: 'custom'\n\n# You can set to anything you want, will be used to generate Identifier (ResourceLocation)\nexample-regex:\n\n  # This plugin also support Regex matching\n  regex: '^test_\\w+'\n\n  # Min Y position\n  min-y: -64\n\n  # Height (max Y position = min-y + height - 1)\n  height: 1024\n\n  # Height for Chorus Fruit teleport and etc. See wiki for details\n  logical-height: 512\n\n  # Height for the cloud (empty -\u003e do not have cloud, default -\u003e use default height)\n  # This feature is only for 1.21.6+\n  cloud-height: 256\n\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```\n\n## License\n\nThis project is licensed under the [GPL 3.0 License](LICENSE).\nThe [API](api) part is licensed under the [LGPL 3.0 License](api/LICENSE).\n\n## Support\n\nIf you encounter any issues or have questions, feel free to open an [issue](https://github.com/Lumine1909/CustomWorldHeight/issues).\n\n---","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flumine1909%2Fcustomworldheight","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flumine1909%2Fcustomworldheight","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flumine1909%2Fcustomworldheight/lists"}