BiomeMap

插件

· 作者 Sukikui

轻量级 PaperMC 插件,将选定区域的主导生物群系导出为 JSON

0 本站下载 0 关注 更新于 5 个月前

最新 0.1.5+mc26.1.2 · 26.1.2 · Paper / Purpur

一键开服(送7天)

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 调色板

? 安装

  1. 安装带有 Java 25+ 的 PaperMC 服务器
  2. 从发布页面下载最新的 biomemap-x.x.x+mcx.x.x.jar
  3. 将 jar 文件放入服务器的 plugins/ 文件夹中
  4. 重启服务器或运行 /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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源