Minecraft(我的世界)中文论坛

 找回密码
 注册(register)

!header_login!

只需一步,立刻登录

查看: 4616|回复: 77

[转载插件] [网页|信息][PCD]BlueMap —— 更高级的3D网页地图![1.12-1.16]

[复制链接]
上杉夏相 当前离线
积分
3720
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-7-6
查看详细资料
发表于 2021-2-17 09:26:36 | 显示全部楼层 |阅读模式
服务端插件
英文名称: BlueMap
中文名称:
插件来源: 转载
适用服务端: CraftBukkit Spigot Sponge |其它| 
插件类型: 信息 
语言支持: English 非官方汉化 
适用版本: 1.16.X 1.15.X 1.14.X 1.13.X 1.12 
前置Mod|插件: 无前置插件
下载地址: https://github.com/BlueMap-Minecraft/BlueMap
原帖地址: https://github.com/BlueMap-Minecraft/BlueMap
插件Logo: -
插件简介: -

您尚未登录,立即登录享受更好的浏览体验!

您需要 登录 才可以下载或查看,没有帐号?注册(register)

x
本帖最后由 上杉夏相 于 2021-3-2 12:01 编辑



概述

授权:GitHub issue Or MIT开源协议
示例:W C M C 服务器 Or Tis服务器
Wiki:站内翻译贴 Or GitHub原文
BlueMap是一个可以将服务器地图渲染成3D网页的一个工具(TIS同款¿),现在支持原版加载、bukkit插件加载(craftbukkit、spigot、paper)、Sponge模组加载、forge/fabric模组加载;如果使用Web服务器(可选),这个插件设置起来非常容易,几乎即插即用。

一旦您服务器的地形地图发生改变,这个插件/模组将会立刻处理渲染任务并将网页地图刷新,呈现出新的地图。



下载

您可以在此插件的GitHub仓库下载最新的构建

请遵循插件相应的开源协议!

如果您在使用中有任何问题,您可以查阅wiki文档!

使用

如果您有Spigot或paper服务器,则可以将bluemap用作服务器插件。然后,插件会渲染以及在发生某些更改时主动更新您的地图。如果服务器关闭/重新启动,则渲染任务将暂停并恢复。
以下为作为Bukkit插件的使用方法:
1. 首先,您要下载bluemap-jar。您可以从此处选择并下载版本。确保它和服务器的SpigotAPI版本相同!
2. 将下载的jar放在服务器的plugins文件夹中,然后重新启动服务器。
3. BlueMap现在将在 ./plugins/BlueMap/ 生成配置文件,使用您喜欢的编辑器打开这些配置,并阅读配置一章以了解如何配置bluemap。
4. 编辑配置后,请使用 /bluemap reload 重新启动插件。
5. /bluemap render <world> 命令以启动整个世界的初始渲染。

配置文件


BlueMap的配置文件都是使用[HOCON](<a href="https://github.com/lightbend/config/blob/master/HOCON.md" target="_blank">https://github.com/lightbend/config/blob/master/HOCON.md</a>)(译者注:一种基于json的文档格式,采用键值对)格式化,请确保您对如何使用此语法格式化有一定的基础,可以参阅它的GitHub自述文件!
如果在启动时插件没有检索到配置文件,则会为您生成示例配置文档,在这些配置文档中,每个键值对上面都会有一个注释项来解释它的功能以及它的默认值(如果有的话)。


核心配置:core.conf


这个配置文件包含了插件的基本功能和核心设置


accept-download: false
renderThreadCount: -2
metrics: true
data: "bluemap"



  • accept-download默认为false,需要使用BlueMap插件的相关功能则需要设置为true,但是在此之前,您需要仔细阅读以下内容:


    > 更改此选项,意味着已接受mojang的[EULA],且确认您拥有Minecraft(Java版)的许可证。这样BlueMap将从mojang的服务器下载并使用minecraft-client-jar,由于下载的文件包含属于mojang的资源,所以您不得重新分发该文件或执行与mojang的EULA不兼容的其他事情。BlueMap使用此文件中的资源来生成用于地图的3D模型并对其进行纹理处理。 (如果没有这些资源,BlueMap将无法使用。)




  • renderThreadCount 定义了BlueMap将使用多少个线程来进行渲染,将此值设置为0则可以最大程度的利用您的CPU进行渲染(BlueMap将使用和您的CPU内核一样多的线程)。如果将其设置为负值,则bluemap将获取可用核心数减去定义的数字。因此具有8个核心且设置renderThreadCount: -2则其可利用8 + (-2) = 6线程。




  • metrics 默认为true,此项决定了是否发送一些非常小的错误报告,该错误报告仅包含使用的插件类型和版本,这样可以使作者跟踪BlueMap的基本用法,并帮助作者保持动力,进一步开发该工具,请确保此项为打开状态:)(由于sponge拥有自己的指标控件,所以此选项不可用)




  • data 选项可以设置您希望插件在运行时用于保存其所需文件或保存其他数据的文件夹,例如下载的minecraft-client-jar文件、其他默认资源以及渲染任务的状态等等




渲染配置: render.conf


在渲染配置中,您可以确切的定义BlueMap应该使用什么方式渲染以及怎么渲染


webroot: "bluemap/web"
useCookies: true
maps: [
  {
    id: "world"
    name: "World"
    world: "world"

    # Advanced map optional config fields:
    # 高级地图可以选则配置的选项
    startPos: [500, -820]
    skyColor: "#7dabff"
    ambientLight: 0
    renderCaves: false
    minX: -4000
    maxX: 4000
    minZ: -4000
    maxZ: 4000
    minY: 50
    maxY: 126
    renderEdges: true
    useCompression: true
    ignoreMissingLightData: false
  },
  {
    # ... more maps
    # ... 更多地图
  }
]


  • webroot字段定义了保存渲染地图数据并且生成Web项目结构的文件夹。(译者注:反代理路径需要设置为这个文件目录,位于服务器根文件夹)

  • useCookies决定是否在网页上使用Cookie,cookie仅用于保存访问者的设置,以便他们无需重新访问时再次进行设置

  • maps中,您可以自定义任意数量的地图,已经在此声明并且配置的地图将会显示在网站的下拉菜单中,可以在菜单中进行切换;作为示例,生成的默认配置中具有三个预配置的映射,如果您不想使用它们,请务必将其删除!maps字段是拥有一个[]和多个{}的列表,每个{}所包含的对象将代表一个世界的地图,您可以渲染多个地图,每个地图应该拥有以下选项:

    • id:定义了地图的ID,此ID只能包含字母a-z、数字和下划线,并且必须唯一;它将作为地图的文件夹名称保存渲染的地图数据

    • name:定义地图的显示名称,亦是在网页中更换世界所显示的名称

    • world:定义地图的游戏内名称,即地图所在的文件夹名称

      如果有需要,您可以进一步更改地图的渲染方式

    • startPos选项可以控制默认显示地图的未xz坐标,默认会居中显示

    • skyColor选项使用CSS样式的十六进制颜色码控制天空的颜色

    • ambientLight定义每个方块接收的环境光强度,与阳光/自发光无关。如果世界上没有任何阳光,例如下界和末地,这将很有用。

    • renderCaves字段控制渲染范围,如果为false则不会渲染任何自然光为0的区块范围,这样就会消除了很多不必要的几何形状,并且提高渲染速度,最重要的是,Web客户端的性能提高了很多!但是,有时候他可能会去除您从上帝视角看到的外观,例如,海底或大型天空建筑下面的区块,如果您的区块不像下界或者末地那样没有自然光,则必须启用此选项。

    • 字段minXminYminZmaxXmaxYmaxZ定义了所呈现的世界的“界限”。因此,如果您只想渲染世界的特定区域,则可以在此处进行设置。通过使用y字段数值,您还可以仅渲染某些高度的块。例如,您可以使用它来移除地狱的上层基岩,以便能够看到渲染中的下部区域。

    • 如果使用上面的选项限制地图的边界,则可以使用该选项renderEdges定义如何渲染地图的“边缘”。如果是该值true,则将渲染边缘的块,否则边缘块将透明。

    • useCompression选项可用于控制数据压缩(通常使用gZip压缩图块);压缩通常会将文件大小减少到80%及以上,因此不推荐关闭此选项

    • 通常,BlueMap会检测某个区块是否生成光照数据,并忽略渲染没有生成的块。如果选项ignoreMissingLightData设置为true,即使没有光照数据,BlueMap也会渲染方块!例如,如果某些mod阻止正确保存光照数据,则此功能很有用。但是,这也有一些缺点:
      >对于那些方块,每个方块将始终被完全照亮
      夜间模式可能无法正常工作
      洞穴将始终被渲染(即忽略“ renderCaves”设置)



Web服务器配置:webserver.conf


插件集成的Web服务器是将地图托管到Web界面的最简单的方法,这样你就可以在浏览器中查看它了。如果启用此项功能,它将使用http协议在ip:port上托管位于webroot文件夹定义里面的所有文件。


enabled: true
webroot: "bluemap/web"
ip: "123.45.6.78"
port: 8100
maxConnectionCount: 100


  • enabled字段负责控制内置Web服务器的启停(true/false)

  • webroot字段定义了Web服务器将代理的Web界面文件夹,通常这个文件夹应该设置为和render.conf中的webroot字段相同的值

  • ip字段定义了允许访问的IP地址,如果您忽略此字段,则插件将允许所有网络接口0.0.0.0访问;当然,如果您只想本地访问,则可以设置为localhost或者127.0.0.1。

  • port设置了服务器的监听端口,默认监听端口为8100

  • maxConnectionCount字段定义了最大活动连接数量,默认为100


插件配置:plugin.conf


这一节是关于玩家和服务器交互的,但是当前,它主要控制如何处理如何显示玩家。


liveUpdates: true
skinDownload: true
hiddenGameModes: [
  "spectator"
]
hideInvisible: true
hideSneaking: false


  • 如果您不想使用任何实时数据,请设置liveUpdatesfalse。这将禁用完整的实时更新模块。

  • 如果skinDownload设置为true,BlueMap将下载并更新每个玩家的皮肤,并在Web界面中加载。

  • hiddenGameModes可以控制哪些游戏模式是在地图上是不可见的。默认情况下,除了观察者模式的玩家之外每个人都是可见的。

  • 如果hideInvisibletrue,则具有隐形效果的玩家将不会显示在地图上。

  • hideSneaking 控制处于潜行状态的玩家是否在地图上可见。




指令&权限
image.png



来自群组: PluginsCDTribe

评分

参与人数 2人气 +3 收起 理由
大薯宽片 + 2 MCBBS有你更精彩~
没名字. + 1 神乎其技!6的飞起!

查看全部评分

名副其实 当前离线
积分
12370
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2016-8-31
查看详细资料
发表于 2021-2-17 16:24:39 | 显示全部楼层
本帖最后由 名副其实 于 2021-2-17 16:36 编辑

https://www.spigotmc.org/resources/bluemap.83557/
这个插件实际上是有 SpigotMC 链接的,推荐还是把GitHub的链接放下面 XD
其次,这个插件有两个附属

BlueMap-Essentials
https://www.spigotmc.org/resources/bluemap-essentials.84365/
(Require EssentialsX and BlueMap installed)
作用: 显示EssentialsX设置的家,传送点以及地标

MCG BlueMap Essentials
https://www.spigotmc.org/resources/mcg-bluemap-essentials.88940/
(Require Bluemap)
(Factions UUID and Ultimate Claims / WorldGuard are required if you need)
作用: 显示 UltimateClaims 领地详细信息, WorldGuard 的 region 详细信息以及 Factions UUID 的 各个派系位置,战争区,安全区以及派系占地


回复

使用道具 举报

ahdg 当前离线
积分
1165
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2018-7-15
查看详细资料
发表于 2021-4-16 14:05:19 | 显示全部楼层
YisaKu 发表于 2021-4-2 18:56
比较想知道和dynamp比起来哪个更加吃性能

追求极致性能的话用这个:https://github.com/pl3xgaming/Pl3xMap
追求美观 BlueMap 比  Dynmap 好
回复

使用道具 举报

玄锐暮 当前离线
积分
1944
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-7-18
查看详细资料
发表于 2021-2-17 09:38:34 | 显示全部楼层
wiki挂了QAQ
回复

使用道具 举报

玉麟解说 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-12-26
查看详细资料
发表于 2021-2-17 10:07:06 | 显示全部楼层
6516698489
回复

使用道具 举报

玉麟解说 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-12-26
查看详细资料
发表于 2021-2-17 10:07:30 | 显示全部楼层
498656523
回复

使用道具 举报

玉麟解说 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-12-26
查看详细资料
发表于 2021-2-17 10:07:59 | 显示全部楼层
9819526
891
回复

使用道具 举报

玉麟解说 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-12-26
查看详细资料
发表于 2021-2-17 10:08:17 | 显示全部楼层
915987655
回复

使用道具 举报

玉麟解说 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-12-26
查看详细资料
发表于 2021-2-17 10:08:49 | 显示全部楼层
9456986563
回复

使用道具 举报

玉麟解说 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-12-26
查看详细资料
发表于 2021-2-17 10:09:09 | 显示全部楼层
+52984985629
回复

使用道具 举报

玉麟解说 当前离线
积分
38
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2020-12-26
查看详细资料
发表于 2021-2-17 10:09:27 | 显示全部楼层
66666666666666666666666666666666
回复

使用道具 举报

上杉夏相 当前离线
积分
3720
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-7-6
查看详细资料
 楼主| 发表于 2021-2-17 10:16:50 | 显示全部楼层

url打错了,已修正,感谢支持!
回复

使用道具 举报

快乐小方 当前离线
积分
7529
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2016-10-21
查看详细资料
发表于 2021-2-17 10:31:21 | 显示全部楼层
这个插件会占用很大的磁盘空间吗
回复

使用道具 举报

上杉夏相 当前离线
积分
3720
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-7-6
查看详细资料
 楼主| 发表于 2021-2-17 10:43:01 | 显示全部楼层
快乐小方 发表于 2021-2-17 10:31
这个插件会占用很大的磁盘空间吗

目测也许会吧,我也没测试过,应该和dynmap差不多吧?
不过我看GitHub的issues里面有说这个事以后会采取MySQL存储
回复

使用道具 举报

RINNDA 当前离线
积分
5195
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2015-9-20
查看详细资料
发表于 2021-2-17 10:58:57 | 显示全部楼层
不知道与其他插件的联动怎么样
回复

使用道具 举报

上杉夏相 当前离线
积分
3720
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2019-7-6
查看详细资料
 楼主| 发表于 2021-2-17 11:05:19 | 显示全部楼层
RINNDA 发表于 2021-2-17 10:58
不知道与其他插件的联动怎么样

兼容性很强,甚至可以自定义资源包和配置模组物品
回复

使用道具 举报

吴富霖 当前离线
积分
1741
帖子
主题
精华
贡献
爱心
钻石
人气
下界之星
最后登录
1970-1-1
注册时间
2013-7-31
查看详细资料
发表于 2021-2-17 11:25:52 | 显示全部楼层
感谢楼主分享,这个地图插件爱了爱了
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 注册(register)

本版积分规则

Archiver|小黑屋|Mcbbs.net ( 京ICP备15023768号-1 ) | 京公网安备 11010502037624号 | 手机版

GMT+8, 2021-9-18 22:18 , Processed in 0.075964 second(s), Total 43, Slave 37 queries, Release: Build.2021.09.13 2028, Gzip On, Redis On.

"Minecraft"以及"我的世界"为Mojang Synergies AB的商标 本站与Mojang以及微软公司没有从属关系

© 2010-2020 我的世界中文论坛 版权所有 本站原创图文内容版权属于原创作者,未经许可不得转载

快速回复 返回顶部 返回列表