HereSkyReign
一款面向 Paper 的精品 Minecraft 插件,用于创建浮空岛维度(Sky Reign),具备无缝垂直传送、自定义云方块地形以及基于 HereEngy Blueprint API 的自然程序化结构生成。
功能特性
- 无缝垂直传送 — 自动在主世界与 Sky Reign 维度之间进行垂直传送:
- 主世界 → Sky Reign: 当在主世界达到 Y > 320 时,玩家将被传送到 Sky Reign 维度的 Y = 2 处,并保持水平坐标和动量。
- Sky Reign → 主世界: 当在 Sky Reign 中低于 Y < 0 时,玩家将被传送到主世界的 Y = 320 处,并从天空中坠落。
- 防循环冷却: 提供 100 tick(5秒)的传送冷却时间,防止玩家陷入无限垂直循环。
- 自定义云方块地形 — 使用 2D Simplex Noise 生成扁平有机浮空岛屿。
- 云方块技巧: 岛屿由
BROWN_MUSHROOM_BLOCK(棕色蘑菇块)构成,所有 6 个方向的面属性均设置为 false(这意味着内侧孔洞纹理会显示在所有侧面),通过服务器的资源包将其作为自定义的云方块使用。
- 程序化结构生成 — 集成
HereEngy Blueprint API,在岛屿上填充 Sky Villages(天空村庄)和 Coliseums(竞技场):
- 自然变换: 随机应用旋转和镜像,使结构动态生成。
- 防卡顿: 利用
LimitedRegion 约束和确定性噪声检查,确保零级联区块生成卡顿。
- 防虚空: 检查结构原点处的地形高度噪声,防止结构生成在半空中的虚空里。
- BlueMap 集成 — 在启动时自动生成并更新 BlueMap 地图渲染配置文件,以渲染 Sky Reign 维度。
配置
可在 plugins/HereSkyReign/config.yml 中自定义设置:
world-name: "sky_reign"
teleportation:
overworld-to-skyreign-y: 320.0
skyreign-to-overworld-y: 0.0
cooldown-ticks: 100
generation:
island-noise-scale: 0.015
island-noise-threshold: 0.1
island-min-y: 60
island-max-y: 64
structures:
village-chance: 0.005
coliseum-chance: 0.002
bluemap-integration:
enabled: true
依赖要求
- Paper / Spigot 1.21.4 或更高版本。
- Java 21 或更高版本。
- 服务器上已安装 HereEngy (Blueprint Plugin)。
资源包设置
为了正确渲染自定义的云方块而非默认的棕色蘑菇块纹理,需要安装资源包。
首次启动时,HereSkyReign 会自动解压一个预配置的资源包文件至:
plugins/HereSkyReign/cloud_block_resourcepack.zip
使用方法:
- 合并/应用: 解压该文件,并将其
assets/ 文件夹与服务器现有的资源包合并。
- 服务器分发: 将
cloud_block_resourcepack.zip 上传至公共 Web 主机,并将下载 URL 添加到服务器 server.properties 中的 resource-pack 设置项。
许可证
本项目遵循 GPLv3 许可证授权 - 详见 LICENSE 文件。
HereSkyReign
A premium Paper Minecraft plugin that creates a floating-island dimension (Sky Reign) with seamless vertical teleportation, custom cloud block terrain, and organic procedural structure spawning using the HereEngy Blueprint API.
Features
- Seamless Vertical Teleportation — Teleports players vertically between the Overworld and the Sky Reign dimension automatically:
- Overworld → Sky Reign: Reaching Y > 320 in the Overworld teleports players to Y = 2 in the Sky Reign dimension, maintaining horizontal coordinates and momentum.
- Sky Reign → Overworld: Falling below Y < 0 in Sky Reign teleports players to Y = 320 in the Overworld, sending them falling out of the sky.
- Anti-Loop Cooldown: A 100-tick (5-second) teleportation cooldown protects players from getting stuck in an infinite vertical loop.
- Custom Cloud Block Terrain — Features flat-plane organic floating islands generated using 2D Simplex Noise.
- Cloud Block Trick: The islands are constructed out of
BROWN_MUSHROOM_BLOCK with all 6 directional face properties set to false (meaning the inner pore texture is shown on all sides), which serves as a custom Cloud Block via your server's resource pack.
- Procedural Structure Spawning — Integrates with the
HereEngy Blueprint API to populate islands with Sky Villages and Coliseums:
- Organic Transformations: Randomly applies rotation and mirroring to structures so they spawn dynamically.
- Lag Prevention: Utilizes
LimitedRegion constraints and deterministic noise checks to guarantee zero cascading chunk generation lag.
- Void Prevention: Checks the terrain height noise at the structure's origin to prevent structures from spawning floating in mid-air voids.
- BlueMap Integration — Automatically generates and updates BlueMap map rendering configuration files on startup to render the Sky Reign dimension.
Configuration
Settings can be customized in plugins/HereSkyReign/config.yml:
world-name: "sky_reign"
teleportation:
overworld-to-skyreign-y: 320.0
skyreign-to-overworld-y: 0.0
cooldown-ticks: 100
generation:
island-noise-scale: 0.015
island-noise-threshold: 0.1
island-min-y: 60
island-max-y: 64
structures:
village-chance: 0.005
coliseum-chance: 0.002
bluemap-integration:
enabled: true
Requirements
- Paper / Spigot 1.21.4 or higher.
- Java 21 or higher.
- HereEngy (Blueprint Plugin) installed on the server.
Resource Pack Setup
To render the custom Cloud Block correctly instead of the default brown mushroom block texture, a resource pack is required.
Upon the first startup, HereSkyReign automatically extracts a pre-configured resource pack file to:
plugins/HereSkyReign/cloud_block_resourcepack.zip
How to use:
- Merge/Apply: Unzip this file and merge its
assets/ folder with your server's existing resource pack.
- Server Distribution: Upload the
cloud_block_resourcepack.zip to a public web host, and add the download URL to the resource-pack setting in your server's server.properties.
License
This project is licensed under the GPLv3 License - see the LICENSE file for details.
评论 0
登录后参与评分
还没有评论,来抢沙发吧