准备工作
1. 确保您用有一个支持插件或者模组的服务器
2. 从https://www.dynmap.cn/downloads下载的合适的jar文件
3. 您拥有服务端plugin目录或mod目录的读写权限
4. 您拥有重启服务器或者重载插件/模组命令的权限
5. 您为服主/管理或者服主/管理授权您安装此插件
6. 如果Minecraft服务器运行在VPS上(比如阿里云,腾讯云等),确保您已经打开8123端口(或其他或使用web服务器进行转发)
    如果Minecraft服务器运行在面板服上(卖家给你一个后台网址、账号等,您可以通过该面板重启服务器,修改设置等),请咨询卖家是否可以开放新端口
    注意即使卖家拒绝了您开放新端口的请求,您仍旧可以尝试,万一呢?
    如果服务器运行在本机上,Linux系统可能需要开放端口
基础使用

1.下载dynmap


下载链接:https://www.dynmap.cn/downloads,Linux系统可以使用命令
 wegt https://dynmap.us/releases/Dynmap-3.0-beta-10-spigot.jar

//如果您不熟悉命令的话,请注意空格的问题
下载dynmap(模组版由于Minecraft版本不同链接不同,请自行复制)

2.安装dynmap


将下载的文件(我们假设叫做dynmap.jar,实际名字内包括版本号等,比较长)移动到"Minecraft服务器\plugin"目录下(模组版需要移动到"mods"目录下)
第二步,复制文件
如果有旧版本的dynmap,请将其删除,但无需删除"Minecraft服务器/plugin/dynmap"目录(模组版是mods目录)及其内容
Linux系统可以使用命令
 mv dynmap.jar ....../Minecraft服务器/plugin/dynmap.jar

//如果您使用的是面板服务器,直接在网页的“FTP管理”中上传dynmap.jar到指定目录或者使用FTP软件上传即可
//如果您不熟悉命令的话,请注意空格的问题以及路径的正确与否,我们推荐您使用一款可视化的文件管理软件来移动文件

3.加载dynmap


重启Minecraft服务器
在Minecraft服务器控制台内输入
 restart

如果重启后直到控制台输出"...Done!..."没有任何关于dynmap的报错信息,可以使用浏览器检查安装

A:如果您的服务器在本机(即正在使用的电脑),可以使用浏览器访问(或直接点击下面的链接)
http://localhost:8123
http://127.0.0.1:8123
//以上两个网址结果是一样的

B:如果您的服务器是VPS服务器,请在安全组(或类似)和防火墙中放行8123端口,并访问http://您的服务器IP(X.X.X.X):8123
//注意网址中的“:”是在英文半角下输入的,不是“:” 示例:阿里云放行端口阿里云放行端口的页面(其它也大同小异)

C:如果您的服务器是面板服,请联系服务商开通另外一个端口,不过您仍然可以尝试访问http://您的服务器IP(X.X.X.X):8123,如果成功访问则服务商没有封堵8123端口,您可以直接使用,但是我们不推荐(因为如果有其它用户安装dynmap并且尝试使用8123端口,可能在您重启服务器后显示别人服务器的dynmap页面)
插件设置

1.下载配置文件


//此部分为可选内容,如果您希望使用中文注释的配置文件请执行此步骤!
访问 https://www.dynmap.cn/downloads.html ,点击按钮下载最新版本的配置文件
//当前仅有插件的不完全汉化,随着工作的进行最终我们会汉化全部文件的
重命名原配置文件(位于您的服务器\plugin(或mods)\dynmap\configuration.txt)为"backup.txt"
将下载的文件(可能为"configuration_zh-cn_v1.8.txt")复制到dynmap目录,并重命名为"configuration.txt"
如果您曾经使用过dynmap,可以打开configuration.txt和backup.txt,将已经设置好的选项从backup.txt复制到configuration.txt并替换默认值
注意,我们建议使用Notepad++、VSCode等专业软件编辑配置文件,以防Windows自带记事本改变编码引起服务端乱码

2.修改端口


打开配置文件"configuration.txt",找到第325行(不同版本可能有差别,如果无法找到请使用搜索功能(快捷键一般是Ctrl+H)搜索"webserver-port"(输入的时候不带引号))
6.9日之后开始编写本部分,还请谅解
性能优化
说明 本块内容转载自MCBBS
授权:
可以转载,注明本帖地址即可,感谢支持 :) ——原作者Akkariin回复内容(#26)

1.多核渲染优化


Dynmap 默认是使用单核心 CPU 进行渲染的,除非你的 CPU 是 i9 9900K 那种级别的 CPU,否则渲染速度是相当的慢,一张稍微大点的地图渲染一个晚上都是常事。如何让它渲染的更快呢?一起来看看。
  1. 1.找到 plugins/dynmap/configuration.txt 这个文件,用 Notepad++ 等专业编辑器打开它。
  2. 2.搜索 parallelrendercnt 这个配置项,如果前面有 # 注释,请将注释删除
  3. 3.将 parallelrendercnt: 后面的数字改为你的 CPU 核心数,比如你的 CPU 是 8 核就改成 8,可以超过这个数字,但是可能会给你的系统带来更大负担
  4. 4.执行命令 /dynmap reload 重载,这时候你应该会看到 CPU 占用率狂飙,但是渲染速度超快
实测在 E5-2698 v3 双路(32 核心 64 线程)服务器上,三分钟内 Dynmap 就完成了全图渲染,CPU 的性能也完全发挥了出来。 CPU 几乎所有核心都用上了

2.自定义材质包


默认的材质包不好看?你可以通过简单的几个设置实现自定义材质包。
  1. 1.准备一个你需要用于 Dynmap 的材质包,不推荐太高分辨率的,一般 256x256 以下就可以了,不然的话渲染速度超级慢(除非你用天河二号开服那我没话说 23333)
  2. 2.将这个材质包复制到 plugins/dynmap/texturepacks/ 目录中,注意文件名不要有中文、特殊符号以及空格
  3. 3.用 Notepad++ 等专业编辑器打开 plugins/dynmap/custom-shaders.txt 这个文件,删除里面所有内容并重新写入以下内容:
  4.   shaders:
          - class: org.dynmap.hdmap.TexturePackHDShader
              name: stdtexture
              texturepack: 你的材质包名字.zip
  5. 4.执行命令 /dynmap reload 重载,然后执行 /dynmap cancelrender 取消正在进行的渲染(如果有的话),最后执行 /dynmap fullrender 重新开始渲染整张地图
材质图片

3.减少宽带使用率



如果你的服务器宽带比较小,那么大量的图片会急剧增大你的网络流量,导致玩家正常游戏受到影响。
因此你可以通过以下步骤进行优化,减少网络流量。
  1. 1.使用 Notepad++ 等专业编辑器打开 plugins/dynmap/configuration.txt 这个文件
  2. 2.使用搜索功能找到 image-format: 这个配置项
  3. 3.将默认的 png 改为 jpg 或 jpg-q95、jpg-q90、jpg-q85(q 后面代表画质,数字越大画质越好,但是文件体积也越大),数值只能是 100/95/90/85/80/75 其中一个
  4. 4.执行 /dynmap reload 重载配置,然后 /dynmap fullrender 进行全图渲染

4.防止 Dynmap 拖累服务器


如果你的 Dynmap 渲染使用的 CPU 核心数过多,可能会拖累服务器,因此可以通过以下配置防止服务器假死。
  1. 还是打开 plugins/dynmap/configuration.txt 这个文件
  2. 找到 fullrender-min-tps: 这个选项
  3. 后面的数字就是最小 TPS,当服务器 TPS 低于这个数值的时候就会临时暂停 dynmap 渲染地图
  4. 执行 /dynmap reload 重载插件

5.禁止玩家通过网页发送消息


建议开启登陆系统而不是直接一刀切!
有些游客(非玩家)喜欢跑到网页上往游戏里发垃圾消息,刷屏等等,因此我个人是建议禁用网页聊天功能的。 禁用方法很简单,修改 configuration.txt 文件中的 allowwebchat: 这个配置项,设置为 false 即可。

6.通过 Nginx 反代为 Dynmap 增加 HTTPS 支持


这部分内容仅适用于对 Linux 有使用基础的服主,并且你的服务器也需要使用 Linux。
Dynmap 自身并不支持 HTTPS,如果你想要把 Dynmap 嵌入到你的其他 HTTPS 网页中,又不想让谷歌浏览器左上角报不安全的标记,那么为 Dynmap 增加 HTTPS 就很重要了。
首先,确保你的服务器已经安装了 Nginx,如果没有,可以按照下面的步骤安装:
  1. 1.打开 OneinStack:https://oneinstack.com/auto/
  2. 2.将 Nginx 的开关打开,其他的所有开关关闭,所有复选框取消勾选(当然你也可以根据自己需要选择安装,例如 PHP)
  3. 3.将最底下的命令复制,然后在你的 SSH 终端中粘贴运行
确认 Nginx 安装完成后,为 Nginx 新增一个 Vhost 配置文件,如果你使用的是 OneinStack,那么目录应该在 /usr/local/nginx/conf/
如果你使用的是 yum install nginx 这样安装的 Nginx,配置文件应该在 /etc/nginx/
配置文件内容:
  server {
    listen 80;
    listen 443 ssl http2 ;
    ssl_certificate /证书位置.crt;
    ssl_certificate_key /密钥位置.key;
    ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3;
    ssl_ciphers TLS13-AES-256-GCM-SHA384:TLS13-CHACHA20-POLY1305-SHA256:TLS13-AES-128-GCM-SHA256:TLS13-AES-128-CCM-8-SHA256:TLS13-AES-128-CCM-SHA256:EECDH+CHACHA20:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;
    ssl_prefer_server_ciphers on;
    ssl_session_timeout 10m;
    ssl_session_cache builtin:1000 shared:SSL:10m;
    ssl_buffer_size 1400;
    add_header Strict-Transport-Security max-age=15768000;
    ssl_stapling on;
    ssl_stapling_verify on;
    server_name 你的域名;
    access_log /data/wwwlogs/你的域名_nginx.log combined;
    if ($ssl_protocol = "") { return 301 https://$host$request_uri; }
    location / {
      # 服务器内网一般都是 127.0.0.1,如果你的 MC 服务器和 Nginx 服务器不在同一台机器,那么这里就填 MC 服务器的 IP
      proxy_pass http://服务器内网IP:Dynmap端口$request_uri;
      proxy_redirect off;
      proxy_set_header Host $host;
      proxy_set_header X-Real-IP $remote_addr;
      proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
      client_max_body_size 1024m;
      client_body_buffer_size 128k;
      proxy_connect_timeout 300;
      proxy_send_timeout 300;
      proxy_read_timeout 300;
      proxy_buffer_size 4k;
      proxy_buffers 4 32k;
      proxy_busy_buffers_size 64k;
      proxy_temp_file_write_size 64k;
    }
  }
完成之后,输入命令 nginx -s reload 重载 Nginx,接着浏览器访问你的域名,应该就可以看到 Dynmap 了,并且是有 HTTPS 的,此时你就可以把 Dynmap 通过 iframe 等方式嵌入到你的官网而不用担心谷歌浏览器会报不安全警告了。
个性化页面
6.9日之后开始编写本部分,还请谅解
端口转发
6.9日之后开始编写本部分,还请谅解
开发者API
6.9日之后开始编写本部分,还请谅解

Power by Layui

dynmap中文网

Click there to go to Dynmap US official site