Lidocaine
本帖最后由 上杉夏相 于 2022-9-13 10:42 编辑


BlueMap —— 逼格极高的网页3D地图






这是什么？
3.3版本强势归来，首次支持MySQL和1.19版本！
BlueMap是一个可以把你的Minecraft世界转变为网页版的3D地图，你可以在你的Web浏览器中像游戏一样查看你的世界或者从高处俯瞰获得地形概况。现在已经支持原版使用命令行加载、Bukkit插件加载（Spigot、Paper）、Sponge模组加载、Forge/Fabric模组加载的全平台通用，作者也在正常维护且已支持最新版本，支持MySQL存储数据。
如果把BlueMap作为插件或者模组进行安装，该程序应用会使用异步渲染我的世界服务器进程，这就意味着它在任何时刻都不会影响你的服务器主线程！同时，只要你的CPU尚未达到满载情况，服务器就不会在BlueMap渲染地图时造成游戏卡顿。

如何使用？
需要准备
- Java11或更高版本
- 我的世界JE版，不支持BE！
- Spigot/Paper服务端
- 除外游戏端口的放行端口
- SQL服务器（非必须）

安装步骤
1，下载插件Jar文件，在插件Release选择正确的版本
2，把插件Jar文件放置在plugins文件夹中并重启你的服务器
3，BlueMap会生成一分新的配置文件以及预生成一分地图
4，正确修改配置，参考下一节内容

SQL服务
1，正确安装配置BlueMap
2，修改sql.conf配置文件以链接数据库
3，修改世界地图配置文件将存储方式改为SQL
4，重启服务器或使用/bluemap reload
配置文件！
这里仅介绍几个必须的配置文件选项，且并不确保时效性。如果想更深入的配置此插件或者发现配置文件已过时，也可移步至我的Wiki汉化贴查看，Wiki贴时效性优于本贴！
BlueMap的配置文件都是使用HOCON（译者注：一种基于json的文档格式，采用键值对）格式化，请确保您对如何使用此语法格式化有一定的基础，可以参阅它的GitHub自述文件！
如果在启动时插件没有检索到配置文件，则会为您生成示例配置文档，在这些配置文档中，每个键值对上面都会有一个注释项来解释它的功能以及它的默认值（如果有的话）。

核心配置：core.conf
这个配置文件包含了插件的基本功能和核心设置
  1. accept-download: false
  2. renderThreadCount: -2
  3. metrics: true
  4. 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应该使用什么方式渲染以及怎么渲染
  1. webroot: "bluemap/web"
  2. useCookies: true
  3. maps: [
  4.   {
  5.     id: "world"
  6.     name: "World"
  7.     world: "world"

  9.     # Advanced map optional config fields:
  10.     # 高级地图可以选则配置的选项
  11.     startPos: [500, -820]
  12.     skyColor: "#7dabff"
  13.     ambientLight: 0
  14.     renderCaves: false
  15.     minX: -4000
  16.     maxX: 4000
  17.     minZ: -4000
  18.     maxZ: 4000
  19.     minY: 50
  20.     maxY: 126
  21.     renderEdges: true
  22.     useCompression: true
  23.     ignoreMissingLightData: false
  24.   },
  25.   {
  26.     # ... more maps
  27.     # ... 更多地图
  28.   }
  29. ]
复制代码

- webroot字段定义了保存渲染地图数据并且生成Web项目结构的文件夹。（译者注：反代理路径需要设置为这个文件目录，位于服务器根文件夹）
- useCookies决定是否在网页上使用Cookie，cookie仅用于保存访问者的设置，以便他们无需重新访问时再次进行设置
- 在maps中，您可以自定义任意数量的地图，已经在此声明并且配置的地图将会显示在网站的下拉菜单中，可以在菜单中进行切换；作为示例，生成的默认配置中具有三个预配置的映射，如果您不想使用它们，请务必将其删除！maps字段是拥有一个[]和多个{}的列表，每个{}所包含的对象将代表一个世界的地图，您可以渲染多个地图，每个地图应该拥有以下选项：
    - id：定义了地图的ID，此ID只能包含字母a-z、数字和下划线，并且必须唯一；它将作为地图的文件夹名称保存渲染的地图数据
    - name：定义地图的显示名称，亦是在网页中更换世界所显示的名称
    - world：定义地图的游戏内名称，即地图所在的文件夹名称  
    如果有需要，您可以进一步更改地图的渲染方式
    - startPos选项可以控制默认显示地图的未xz坐标，默认会居中显示
    - skyColor选项使用CSS样式的十六进制颜色码控制天空的颜色
    - ambientLight定义每个方块接收的环境光强度，与阳光/自发光无关。如果世界上没有任何阳光，例如下界和末地，这将很有用。
    - renderCaves字段控制渲染范围，如果为false则不会渲染任何自然光为0的区块范围，这样就会消除了很多不必要的几何形状，并且提高渲染速度，最重要的是，Web客户端的性能提高了很多！但是，有时候他可能会去除您从上帝视角看到的外观，例如，海底或大型天空建筑下面的区块，如果您的区块不像下界或者末地那样没有自然光，则必须启用此选项。
    - 字段minX，minY，minZ；maxX，maxY和maxZ定义了所呈现的世界的“界限”。因此，如果您只想渲染世界的特定区域，则可以在此处进行设置。通过使用y字段数值，您还可以仅渲染某些高度的块。例如，您可以使用它来移除地狱的上层基岩，以便能够看到渲染中的下部区域。
    - 如果使用上面的选项限制地图的边界，则可以使用该选项renderEdges定义如何渲染地图的“边缘”。如果是该值true，则将渲染边缘的块，否则边缘块将透明。
    - useCompression选项可用于控制数据压缩（通常使用gZip压缩图块）；压缩通常会将文件大小减少到80%及以上，因此不推荐关闭此选项
    - 通常，BlueMap会检测某个区块是否生成光照数据，并忽略渲染没有生成的块。如果选项ignoreMissingLightData设置为true，即使没有光照数据，BlueMap也会渲染方块！例如，如果某些mod阻止正确保存光照数据，则此功能很有用。但是，这也有一些缺点：对于那些方块，每个方块将始终被完全照亮、夜间模式可能无法正常工作、洞穴将始终被渲染（即忽略“ renderCaves”设置）

Web服务器配置：webserver.conf
插件集成的Web服务器是将地图托管到Web界面的最简单的方法，这样你就可以在浏览器中查看它了。如果启用此项功能，它将使用http协议在ip:port上托管位于webroot文件夹定义里面的所有文件。
  1. enabled: true
  2. webroot: "bluemap/web"
  3. ip: "123.45.6.78"
  4. port: 8100
  5. 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
这一节是关于玩家和服务器交互的，但是当前，它主要控制如何处理如何显示玩家。
  1. liveUpdates: true
  2. skinDownload: true
  3. hiddenGameModes: [
  4.   "spectator"
  5. ]
  6. hideInvisible: true
  7. hideSneaking: false
复制代码

- 如果您不想使用任何实时数据，请设置liveUpdates为false。这将禁用完整的实时更新模块。
- 如果skinDownload设置为true，BlueMap将下载并更新每个玩家的皮肤，并在Web界面中加载。
- hiddenGameModes可以控制哪些游戏模式是在地图上是不可见的。默认情况下，除了观察者模式的玩家之外每个人都是可见的。
- 如果hideInvisible为true，则具有隐形效果的玩家将不会显示在地图上。
- hideSneaking 控制处于潜行状态的玩家是否在地图上可见。

指令、权限
同上，该内容可能存在过时现象，请谨慎复刻！

以及，更多

排版为PCD组内模版，插件转载由残叶基金会支持
本贴最后更新时间：2022/09/13 UTC+8


来自群组: PluginsCDTribe
玄锐暮
wiki挂了QAQ
玉麟解说
6516698489
玉麟解说
498656523
玉麟解说
9819526
891
玉麟解说
915987655
玉麟解说
9456986563
玉麟解说
+52984985629
玉麟解说
66666666666666666666666666666666
Lidocaine
玄锐暮 发表于 2021-2-17 09:38
wiki挂了QAQ

url打错了，已修正，感谢支持！
快乐小方
这个插件会占用很大的磁盘空间吗
Lidocaine
快乐小方 发表于 2021-2-17 10:31
这个插件会占用很大的磁盘空间吗

目测也许会吧，我也没测试过，应该和dynmap差不多吧？
不过我看GitHub的issues里面有说这个事以后会采取MySQL存储
RINNDA
不知道与其他插件的联动怎么样
Lidocaine
RINNDA 发表于 2021-2-17 10:58
不知道与其他插件的联动怎么样

兼容性很强，甚至可以自定义资源包和配置模组物品
吴富霖
感谢楼主分享，这个地图插件爱了爱了
二哈大魔王
这个好像更直观一些 之前sponge看到过这个地图插件 没想到居然支持这么多版本
名副其实
本帖最后由 名副其实 于 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 的 各个派系位置，战争区，安全区以及派系占地


Lidocaine
名副其实 发表于 2021-2-17 16:24
https://www.spigotmc.org/resources/bluemap.83557/
这个插件实际上是有 SpigotMC 链接的，推荐还是把GitH ...

我jio的如果把spigotmc的链接摆上去感觉更像是bukkit系插件一样，但是这东西是全能的（x），所以我就放了GitHub233333
Bai-Yu
建议增加一下本地打开地址，这样萌新更容易接受
Lidocaine
Bai-Yu 发表于 2021-3-2 17:17
建议增加一下本地打开地址，这样萌新更容易接受

抱歉，可以更详细的描述一下问题吗？
您说的是localhost:8100吗？
袁正
真的很厉害了+++++6666
SYxuan_xin
是否支持模组方块的材质呢？
另外渲染图里的三角切面看起来好厉害的样子，是为了降低服务端渲染的压力嘛？
Lidocaine
SYxuan_xin 发表于 2021-3-8 08:25
是否支持模组方块的材质呢？
另外渲染图里的三角切面看起来好厉害的样子，是为了降低服务端渲染的压力嘛？ ...

支持模组物品！
xxx754599345
插件很厉害 功能完善 很棒 我很需要他
北莫哒
谢谢楼主分享
春节里的走马灯
thank you
YisaKu
比较想知道和dynamp比起来哪个更加吃性能
幻影丶大大
插件真不戳
Overhearer
挺好用的qwq
Lidocaine
YisaKu 发表于 2021-4-2 18:56
比较想知道和dynamp比起来哪个更加吃性能

这一个更吃性能一点
因为他是3D的哦
ahdg
YisaKu 发表于 2021-4-2 18:56
比较想知道和dynamp比起来哪个更加吃性能

追求极致性能的话用这个:https://github.com/pl3xgaming/Pl3xMap
追求美观 BlueMap 比  Dynmap 好
咯咯哒37
这个厉害了
多捞啊_
感谢转载~
wghwghwgh
有种卫星的感觉
店长小鱿鱼
用着挺方便的，和卫星地图有的一拼
191257036
感谢分享
shouyoukefu
很不错的BlueMap插件
感谢楼主
2082359109
i了i了，周末拿去试试！
蛋黄黄
感谢楼主转载，下来研究研究先
a1661639091
6666666666
a1661639091
牛啊牛啊 请不要再野区踏青
Lidocaine
a1661639091 发表于 2021-4-22 09:38
牛啊牛啊 请不要再野区踏青

五级账号怎么还那么不懂事呢:(
mcbbsmcnc
非常厉害的插件 感谢楼主分享
shouyoukefu
很不错的BlueMap插件
感谢楼主
shouyoukefu
很不错的BlueMap插件
感谢楼主
支持一下
zws1314520
很好的BlueMap插件
感谢楼主
支持一下
a141242
卡吗？？？
Ye_Ling
支持一下  还算可以
gank烬
请问，为什么我的地图在web打开浏览时，总是大块漆黑，只有很小一部分的地图
加菲猫大帝
好活6666666666
下一页 最后一页