BiomeMap
生成一个轻量级的 JSON 文件,将每个世界区域映射到其主要生物群系。非常适合在外部 Web 应用中创建风格化的生物群系地图。
? 概览
BiomeMap 导出矩形选择区域内的主要生物群系。
你选择一个世界和两个角点(x/z),插件会在该区域上构建一个单元格网格。
然后它会采样生物群系并写入:
- 一个 JSON 文件
- 可选的 PNG 预览图(
1 像素 = 1 个单元格)
✨ 功能
- 由两个坐标定义的矩形选择区域(
/biomemap world x1 z1 x2 z2 [cellSize] [preview]) - 与区块对齐的单元格大小(
4、8、16、32、...) - 基于区块的采样以平滑生物群系过渡
- 异步处理并频繁更新进度(无服务器卡顿)
- 同时只允许一次导出(全局锁)
- 停止命令可干净地取消正在运行的导出
- 结构化的 JSON 输出,包含每个单元格的 min/max 边界及命名空间生物群系 ID
- 可选的 PNG 预览输出(
1 像素 = 1 个单元格),使用生物群系 RGB 调色板
? 安装
- 安装带有 Java 25+ 的 PaperMC 服务器
- 从发布页面下载最新的
biomemap-x.x.x+mcx.x.x.jar - 将 jar 文件放入服务器的
plugins/文件夹中 - 重启服务器或运行
/reload confirm
? 命令用法
同一时间只能运行一个导出任务。
命令
| 命令 | 描述 |
|---|---|
/biomemap <world> <x1> <z1> <x2> <z2> [cellSize] [preview] |
开始生物群系导出(JSON + 可选 PNG)。 |
/biomemap status [map] |
显示当前进度、预计剩余时间 (ETA) 和输出文件。添加 map 参数可查看紧凑的 ASCII 完成度地图。 |
/biomemap stop |
停止当前的导出任务,并从 exports/ 目录中移除该次运行产生的文件。 |
参数
| 参数 | 必需 | 描述 |
|---|---|---|
<world> |
是 | 世界名称,例如 world 或 world_nether。 |
<x1> <z1> |
是 | 区域的第一个角点。 |
<x2> <z2> |
是 | 区域的对角点。 |
[cellSize] |
否 | 单元格大小(方块单位)。默认为 16(常用值:4、8、16、32、64、...)。 |
[preview] |
否 | 添加 preview 以生成 PNG 图片(1 像素 = 1 个单元格)。 |
? 输出文件
所有文件均写入 plugins/BiomeMap/exports/ 目录。
| 文件 | 模式 | 创建时机 |
|---|---|---|
| JSON | <world>_<cellSize>_<index>.json |
始终 |
| PNG | <world>_<cellSize>_<index>.png |
仅在使用 preview 时 |
规则:
index从1开始,如果文件名已存在则递增。- 如果你运行
/biomemap stop,被取消的导出所产生的文件将被移除。
⚙️ 配置
config.yml 提供了性能节流设置。
| 键 | 默认值 | 描述 |
|---|---|---|
performance.chunks-per-tick |
1 |
每个刻启动多少个新的区块作业。数值越低越安全,但速度越慢。 |
performance.max-in-flight |
4 |
当前在管道中(排队/运行中)的最大 BiomeMap 作业数量。 |
performance.max-concurrent-chunks |
64 |
同时加载的真实最大区块数(主要的服务器压力调节旋钮)。 |
快速调整指南:
- 如果玩家感到卡顿,首先降低
max-concurrent-chunks。 - 如果导出感觉太慢但服务器稳定,可以稍微增加
chunks-per-tick。 - 保持
max-in-flight >= chunks-per-tick。
? JSON 格式
{
"cellSize": 16,
"selectionMin": { "x": -200, "z": -200 },
"selectionMax": { "x": -50, "z": -20 },
"gridOrigin": { "x": -208, "z": -208 },
"width": 10,
"height": 12,
"cells": [
{
"i": 0,
"j": 0,
"bounds": {
"min": { "x": -208, "z": -208 },
"max": { "x": -193, "z": -193 }
},
"biome": "minecraft:plains"
},
{
"i": 1,
"j": 0,
"bounds": {
"min": { "x": -192, "z": -208 },
"max": { "x": -177, "z": -193 }
},
"biome": "minecraft:forest"
}
]
}
| 字段 | 类型 | 描述 |
|---|---|---|
cellSize |
number |
单元格大小(方块单位)(最小值为 4;高于此的值会与区块网格对齐)。 |
selectionMin/Max |
object |
命令中提供的原始坐标。 |
gridOrigin |
object |
网格的西北角(最小 X,最小 Z)。 |
width, height |
number |
X 轴和 Z 轴上的单元格数量。 |
cells[].bounds.min/max |
object |
界定单元格的包含边界的坐标。 |
cells[].biome |
string |
命名空间生物群系 ID(例如 minecraft:savanna)。 |
Crafted by
Sukikui
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧