• 欢迎来到Minecraft插件百科!
  • 对百科编辑一脸懵逼?帮助:快速入门带您快速熟悉百科编辑!
  • 因近日遭受攻击,百科现已限制编辑,有意编辑请加入插件百科企鹅群:223812289

Dynmap:修订间差异

来自Minecraft插件百科
跳转到导航 跳转到搜索
无编辑摘要
 
(未显示4个用户的43个中间版本)
第1行: 第1行:
Dynmap 是一个像谷歌地图一样的、为 Minecraft 服务器设计的地图插件,让你可以在浏览器查看地图。
{{急需改进|缺少概述表|存在维基语法错误}}
Dynmap 是一个像谷歌地图一样的、为 Minecraft 服务器设计的地图插件,让你可以在浏览器查看服务器地图。


你可以使用 Dynmap 的集成的网络服务器立即上手,也可以将其部署到 Apache 等现有的网络服务器,易于使用。
你可以使用 Dynmap 的集成的网络服务器立即上手,也可以将其部署到 Apache 等现有的网络服务器,易于使用。
第7行: 第8行:
原始的项目是由 k-red 开发。
原始的项目是由 k-red 开发。


=联络方式=
==支持的基于Forge的Mod==
* [http://forums.bukkit.org/threads/misc-dynmap-v0-12-1-realtime-minecraft-maps-314.489/ Bukkit 论坛]
支持以下的Mod,尽管这些Mod的老版本可能不支持,当前版本的某些方块也可能不支持:
* [http://dev.bukkit.org/server-mods/dynmap/ BukkitDev 项目页面]
* IRC: irc://irc.esper.net/#dynmap ([http://webchat.esper.net/?nick=Webuser&channels=dynmap&prompt=0 在线])


=用户相关=
* Advanced Machines - IC2
==不使用内部服务器安装==
* Advanced Power Management - IC2
我们猜测
* Advanced Solar Panels - IC2
*你对你正在使用的独立Web服务器有相当的经验
* BetterWorlds
*你的Web服务器与CraftBukkit运行在同一台机器上
* BuildCraft
*你的Web服务器支持PHP (仅用于Web到Minecraft的聊天)
* Charging Bench - IC2
*如果你在使用Linux,你应该知道如何使用终端和chmod。
* Compact Solars - IC2
* ComputerCraft
* Equivalent Exchange 2
* Ender Storage
* ExtraBees
* Extrabiomes XL (v2.x and v3.x)
* Extrabiomes - Bunyan
* Forestry (updated in 1.4)
* Forgotten Nature
* Greg's Lighting
* IndustrialCraft 2
* Iron Chest
* LC Trees++
* Millenaire
* MystCraft
* Metallurgy 2
* NetherOres
* RailCraft
* Red Power 2
* SuperSlopes
* TerraFirmaCraft
* ThaumCraft
* Thermal Expansion
* Tubestuff
* Twilight Forest
* XyCraft


将以下信息:
==支持的服务端==
<pre>
Dynmap 包括了除了 CraftBukkit 的其他版本。其他的最新的版本可以在[http://www.minecraftforum.net/topic/1543523-dynmap-dynamic-web-based-maps-for-minecraft/ 这里]找到。目前有 3 个Dynmap主要的平台:
  - class: org.dynmap.InternalClientUpdateComponent
    sendhealth: true
    allowwebchat: true
    webchat-interval: 5
  #- class: org.dynmap.JsonFileClientUpdateComponent
  #  writeinterval: 1
  #  sendhealth: true
  #  allowwebchat: false
</pre>


更改为
*[https://github.com/webbukkit/dynmap/ Bukkit Dynmap]
<pre>
*[https://github.com/webbukkit/DynmapForge/ DynmapForge]
  #- class: org.dynmap.InternalClientUpdateComponent
*[https://github.com/webbukkit/DynmapSpout/ DynmapSpout]
  #  sendhealth: true
  #  allowwebchat: true
  #  webchat-interval: 5
  - class: org.dynmap.JsonFileClientUpdateComponent
    writeinterval: 1
    sendhealth: true
    allowwebchat: false
</pre>
关闭内部更新机制并开启json文件更新机制,这将在 writeinterval 的间隔后在你的web路径写入文件 standalone/dynmap_world.json。


将 plugins/dynmap/web 中的文件复制进你的Web服务器中的某个文件夹,将 configuration.txt 的指向 tilespath 和 webpath 更改至你放置Web文件的地方。
;Spigot


Spigot 通过 Bukkit Dynmap 被完全支持。


;MinecraftForge


Linux
很多版本的 MinecraftForge 都是支持的,可以使用 DynmapForge 项目。所有的 Forge 版本的 Dynmap 都需要特定的 Forge 版本,升级 Forge 版本也需要升级到对应的 DynmapForge 版本。你应该按照如下的方法来安装或者升级:
<pre>
# tile文件放置的路径
tilespath: /path/to/web/server/dynmap/web/tiles


# web文件放置的路径
*下载对应的 ZIP 文件,对应 MC 版本。
webpath: /path/to/web/server/dynmap/web
*解压整个 ZIP 文件,包括子目录,至服务器的根目录。
</pre>
*如果是升级,那么删除 'mods' 下老的 'Dynmap-x.y.zip'。
或 Windows
<pre>
# tile文件放置的路径
tilespath: c:\\path\\to\\web\\server\\dynmap\\web\\tiles


# web文件放置的路径
;MCPC+
webpath: c:\\path\\to\\web\\server\\dynmap\\web
</pre>
现在重启你的Minecraft服务器。加入你的服务器并(随机)放置一些方块来激活Dynmap给你的地图生成tiles。


你也可以输入 dynmap fullrender worldname 于你的服务器控制台来渲染整个 worldname 世界。
目前 MCPC+ 的版本(v1.4.7 或之后) 只被 DynmapForge mods 支持对应的 Forge 版本。CraftBukkit 版本不被支持。安装请按照以下步骤。 你可以使用 DynmapCBBridge 来兼容使用的 Bukkit 的插件的数据(可以在[http://www.minecraftforum.net/topic/1543523-dynmap-dynamic-web-based-maps-for-minecraft/ 这里]找到)。这是一个 Bukkit 插件,所以应该放在 'plugins' 目录,并且只支持那些基于 Forge 的 Bukkit 服务器上。


现在刷新你的浏览器,应该在 http://mywebserver/dynmap/ 显示你的在线人数,保持更新。
;BukkitForge


===故障排除===
BukkitForge mod,一个基于 Forge 的 Mod,添加了Bukkit 的 API,是不被 Dynmap 的 Bukkit 版本支持的。可以使用 DynmapForge 版本,并且搭配 DynmapCBBridge 插件。安装过程与上方的 MCPC+ 相同。
如果你没有在地图看见任何tiles,检查tiles目录来查看他们是否已经被生成。如果没有任何tiles,那么可能Minecraft没有在web路径写入tiles的权限,或者你没有正确填写 tilespath 。


如果你没有看见任何玩家或者他们没有移动,前往 http://mywebserver/standalone/dynmap_world.json ( world 是世界的名称)。你应该能看见一些代码,并且随着时间流逝刷新能看见代码的改变、 如果没有这个文件或者这个文件没有更新,那么你可能填写了错误的 webpath 。
;Tekkit Classic


在 Linux,如果web到Minecraft的聊天没有工作,你应该 chmod 'standalone' 文件夹到 775 或者 777:
Tekkit Classic,和更老的 MCPC (没有+ - v1.2.5),被 DynmapBukkit 支持。
<pre>
$ chmod -R 775 standalone
</pre>
这允许 sendmessage.php 创建json文件。这一步是必须的,因为是你的Web服务器创建文件而不是Minecraft服务器。


如果在IIS web到Minecraft的聊天没有运行,你可能要安装PHP。
;Tekkit-Lite


==在Linux下建立动态地图插件==
Tekkit-Lite 被 DynmapForge 支持,而不是 Bukkit Dynmap。按照上方 Forge 的安装方式安装 Dynmap。
我们猜测


*你的Minecraft服务器目录为 /opt/minecraft_server/
;Tekkit
*你安装了最新的CraftBukkit
[http://www.technicpack.net/tekkit/ Tekkit] 是一个将大量的 Minecraft Mods 整合在 Bukkit 服务器的服务端。Dynmap 支持 Tekkit,目前的 Dynmap 版本会自动检测 Mod,和他们的方块ID,渲染支持的方块。目前支持 Tekkit v3.1.3
*你的Minecraft服务器托管于 localhost。
安装并测试Dynmap:


*将文件 dynmap.jar 和文件夹 dynmap 复制到 /opt/minecraft_server/plugins/。
;Spout
*重启你的Minecraft服务器。
*加入你的Minecraft服务器。
*放置一些方块。
*开启浏览器。
*前往 http://localhost:8123/。
你应该在左上方看到了你的地图和名字。一旦你点击了名称,地图会平移到你的位置,你应该能看见一部分生成的地图。


发布
Spout 服务器被 DynmapSpout 的实验项目支持(Spout 进行的重构使对其进行支持不切实际)。安装至 Spout 与 Bukkit 相同(解压到 plugins 目录)。注意:这个项目是给 Spout 服务器使用而不是 Bukkit 上的 Spout 插件。Spout插件可以使用 Bukkit Dynmap。
如果你想让你的地图能被其他人访问,你需要做这两步:


*将 TCP 端口 8123 转发。
;从 Bukkit Dynmap 迁移到 Forge Dynmap
*将地图托管到大型Web服务器上,大型Web服务器必须能够访问Minecraft服务器,详细见下。


大型Web服务器
将 Bukkit Dynmap 迁移到 Forge Dynmap 可以按照以下方式进行:
如果你正在托管一个 Apache 或者 Lighttpd 服务器,你可能想要让Dynmap地图可以被网页相同的URL访问,像 http://www.yourwebsite.com/dynmap/ 而不是 http://www.yourwebsite.com:8123/。如果是这样,你可以在下方选择你的Web服务器。


*Debian/Ubuntu 上的 apache2: 在Debian下使用Apache建立Dynmap;
*将 <base>/plugins/dynmap 目录(包括所有数据和子目录)移动到 Forge 服务器上的 <base>/dynmap 目录。
*Arch Linux 上的 apache/httpd: 在Arch Linux下使用apache/https建立Dynmap;
*编辑 configuration.txt: 替换 'render-triggers' 为以下信息:
*Arch Linux 上的 lighttpd: 在Arch Linux下使用Lighttpd建立Dynmap;
*nginx 在Centos下使用Nginx建立Dynmap (由 LukeHandle 提供);
===Debian+Apache===
我们猜测:
 
*你安装了 Apache2。
*你的 www-root 目录在: /srv/http/。
*你应该可以通过 http://localhost:8123/ 成功访问Dynmap。
这个示例展示了如何将你的Dynmap部署在Apache的 http://mywebserver/dynmap/。
 
*先创建文件夹 /srv/http/dynmap/.
*将 web 目录下的文件复制到 /srv/http/dynmap/ 的zip包。
首先,我们需要开启需要的模组,输入以下命令:
<pre>
<pre>
     sudo a2enmod rewrite proxy_http
     render-triggers:
      - blockupdate
      #- blockupdate-with-id
      #- lightingupdate
      - chunkpopulate
      - chunkgenerate
      #- none
</pre>
</pre>
首先我们必须重定向 /dynmap/up/ 和 /dynmap/standalone/ 到Dynmap的内部Web服务器。
*删除 <base>/plugins/dynmap.jar
*按照安装对应 Forge 版本的方法安装。


请保证你在 /etc/apache2/sites-available/default 后有这一段内容:
==安装==
<pre>
见:[[Dynmap/安装]]
    ...
        Alias /dynmap/tiles /opt/minecraft_server/plugins/dynmap/web/tiles/


        RewriteEngine on
==配置==
        RewriteRule /dynmap/up/(.*) http://localhost:8123/up/$1 [P,L]
见:[[Dynmap/配置]]
        RewriteRule /dynmap/standalone/(.*) http://localhost:8123/standalone/$1 [P,L]
    </VirtualHost>


    <Directory /opt/minecraft_server/plugins/dynmap/web/tiles/>
==命令==
        Order allow,deny
见:[[Dynmap/命令]]
        Allow from all
    </Directory>


    <Proxy http://localhost:8123/*>
==权限==
        Order deny,allow
见:[[Dynmap/权限]]
        Allow from all
    </Proxy>
</pre>
重启Apache2 (sudo /etc/init.d/apache2 restart).


现在应该在 http://mywebserver/dynmap/ 显示在线玩家了。
==网页参数==
用于启动Web界面的URL可以有多个参数,可以用于改变发送给玩家的默认界面效果。这可以用来在加载WebUI时加载指定的世界或者地图,或者一个指定的缩放大小,或者将地图的中心设置为某个指定的世界坐标。


===Arch Linux+apache/httpd===
参数由一串属性-值组成,每个的参数格式就像这样:<code>attribute-id=value</code>
我们猜测:


*你安装了 apache-httpd。
基础的URL必须含有一个问号 (?) 在第一个参数之前,每个参数之间必须以这个符号间隔,所以,如果这是默认的dynmap网址:<code><nowiki>http://mygreatserver:8123/</nowiki></code>
*你的 www-root 目录在: /srv/http/
*你应该可以通过 http://localhost:8123/ 成功访问Dynmap。


这个示例展示了如何将你的Dynmap部署在apache-httpd的 http://mywebserver/dynmap/
那么,直接打开“fred”世界并且显示“surface”地图的网页,就可以像这样:<code><nowiki>http://mygreatserver:8123/?worldname=fred&mapname=surface</nowiki></code>


*先创建文件夹 /srv/http/dynmap/.
如果你想要使用一个外置的服务器,格式也是一样的 - 添加问号,使用 & 分隔参数:<code><nowiki>http://mycoolapacheserver.com/dynmap?worldname=fred&mapname=surface</nowiki></code>
*将 web 目录下的文件复制到 /srv/http/dynmap/ 的zip包。
在 /etc/httpd/conf/httpd.conf,保证你在有以下几段,注意,这些语句不必相邻。
<pre>
    LoadModule proxy_module modules/mod_proxy.so
    LoadModule proxy_http_module modules/mod_proxy_http.so
    LoadModule rewrite_module modules/mod_rewrite.so
</pre>
接下来,我们必须将 /dynmap/up/ 和 /dynmap/standalone 重定向到Dynmap的内部Web服务器。编辑以下内容到 /etc/httpd/conf/httpd.conf 的末尾:
<pre>
    ...
    Alias /dynmap/tiles /opt/minecraft_server/plugins/dynmap/web/tiles/


    RewriteEngine on
可用的参数如下:
    RewriteRule /dynmap/up/(.*) http://localhost:8123/up/$1 [P,L]
    RewriteRule /dynmap/standalone/(.*) http://localhost:8123/standalone/$1 [P,L]


    <Directory /opt/minecraft_server/plugins/dynmap/web/tiles/>
* worldname - 这个指定了世界的名称(不是标题)。如果没有定义,那么会显示第一个默认的世界(除非在 _configuration.txt里设置了显示哪个世界)。
        Order allow,deny
* mapname - 这个指定了显示的地图的名称(不是标题),如果没有指定,那么将会显示选中的世界的第一个地图!(除非在_configuration.txt中设置了显示哪张地图)。
        Allow from all
* zoom - 指定的缩放大小(0为最高的缩放),如果没有提供,。那么将会使用默认的缩放大小(除非在_configuration.txt中指定了默认的缩放大小)。
    </Directory>
* x - 这个指定了X坐标(展示的世界的坐标),如果没有指定,那么将会显示center定义的x坐标(一般为0)。
* y - 这个指定了Y坐标(展示的世界的坐标),如果没有指定,那么将会显示center定义的y坐标(一般为0)。
* z - 这个指定了Z坐标(展示的世界的坐标),如果没有指定,那么将会显示center定义的z坐标(一般为0)。
* nopanel - 如果设置为true,那么地图显示的侧边栏将会移除。
* chatname - 如果设置为一个字符串,WebUI将会将其转变为发送者发送的聊天消息使用的名称。这将只有在 'trustclientname' 设置为 true时才会生效,作为 'allowurlname' 的附加。在0.28及以后的版本中支持。
* playername - 如果定义了并将其设置为玩家的账户的名称,并且玩家在线或者开启WebUI后一会儿玩家加入了服务器,WebUI将会将地图初始化在给定玩家的位置。
* hidechat - 如果设置为 'true',那么WebUI将会关闭所有的聊天输入和输出模块(气泡,输入框,聊天栏)。
* nogui - 如果设置为 'true',那么WebUI将会关闭所有的控制面板,就像只显示地图层一样。
* nocompass - 如果设置为 'true',那么UI上的指南针将会隐藏。(v2.2-alpha-1)


    <Proxy http://localhost:8123/*>
==地图标记==
        Order deny,allow
见:[[Dynmap/地图标记]]
        Allow from all
    </Proxy>
</pre>
注意这会对所有的VirtualHost生效,如果你有多个虚拟主机,那么推荐你将这些代码放入。


重启Apache/httpd (sudo /etc/rc.d/httpd restart)
==自定义方块==
见:[[Dynmap/自定义方块]]


现在应该在 http://mywebserver/dynmap/ 显示在线玩家了。
==导出世界为WavefrontOBJ格式==
===Arch Linux+Lighttpd===
在 Dynmap v1.9.3 中,我们支持了将地图生成并导出为 Wavefront OBJ 格式的文件,这个特性由 jmc-2-obj 工具启发而来,允许管理员(或控制台)选择并导出他们的部分世界为模型文件,用于其他支持 Wavefront OBJ 格式的建模软件的导入 - 包括了 Blender(一个免费开源的渲染和动画套件),Cinema 4D,Maya,3D Studio Max 和其他的软件。这些导出的模型可以用于 Dynmap 不支持的高级渲染(保举哦了更高级的光照和反射)。由于 Dynmap 导出的 OBJ 格式文件与 jmc-2-obj 软件产生的非常相似,所以针对 jmc-2-obj 的模型的导入和处理与 Dynmap 的 OBJ 导出非常相似。
我们猜测:


*你安装了 lighttpd。
导出和处理使用新的 /dynmapexp 命令完成,此命令可以设置一些属性来控制导出:
*你的 www-root 目录在: /srv/http/。
*你应该可以通过 http://localhost:8123/ 成功访问Dynmap。
开始


*先创建文件夹 /srv/http/dynmap/.
* x0, y0, z0 : 这些是最小的 X, Y, 和 Z 轴的长方体/矩形棱柱的值
*将 web 目录下的文件复制到 /srv/http/dynmap/ 的zip包。
* x1, y1, z1 : 这些是最大的 X, Y, 和 Z 轴的长方体/矩形棱柱的值
这个示例展示了如何将你的Dynmap部署在lighthttpd的 http://mywebserver/dynmap/。
* world : 用于导出的世界的名称
* byChunk : 如果设置为 true,这将会生成整个区块的所有方块的对象
* byBlockID : 如果设置为 true,这将会生成所有给定方块ID的对象
* byBlockIDData : 如果设置为 true,这将会生成所有给定方块ID和方块元数据的对象
* byTexture : 如果设置为 true,这将会生成所有给定材质的方块的对象
* shader : 指定用于导出的使用的材质的着色器,默认情况下使用 stdtexture,只有基于材质包的着色器才支持


/etc/lighttpd/lighttpd.conf,保证以下模块开启:
/dynmapexp 的子命令包括了:
<pre>
    server.modules = ( "mod_access",
    "mod_rewrite",
    "mod_proxy",
    "mod_fastcgi"
    )
</pre>
现在我们需要让Web服务器的tiles可用,并且将代理 /dynmap/up/重定向至Dynmap的内部服务器。将以下内容添加至 /etc/lighttpd/lighttpd.conf 的末尾:
<pre>
alias.url += ( "/dynmap/tiles/" => "/home/minecraft/minecraft_server/plugins/dynmap/web/tiles/" )


url.rewrite-once += (
* /dynmapexp set : 允许设置导出的属性(如上),附加的属性可以在同一个命令使用,如 /dynmapexp set x0 0 y0 0 z0 100。
        "^/dynmap/up/(.*)" => "/up/$1",
* /dynmapexp radius : 只能由一个游戏中的玩家使用:此命令会指定导出的世界为玩家所在的世界,并设置半径为玩家所在位置的半径,Y 轴为 0-255 的所有方块。
        "^/dynmap/standalone/(.*)" => "/standalone/$1"
* /dynmapexp info : 显示当前导出的属性
)
* /dynmapexp pos0 : 此命令只能由玩家在游戏中使用:设置导出范围的第一个点
* /dynmapexp pos1 : 此命令只能由玩家在游戏中使用:设置导出范围的第二个点
* /dynmapexp reset : 重置导出属性为默认值
* /dynmapexp export : 初始化一个导出,创建一个叫 .zip 的文件(默认在 dynmap 文件夹下的 export 文件夹,可以在 exportpath 中设置)。导出是异步处理的,并且会耗费几分钟完成,用时取决于选区的大小
* /dynmapexp purge : 删除上一个导出


$HTTP["url"] =~ "^/up/" {
完成后,ZIP文件中将会包含以下内容:
        proxy.server = ( "" => (( "host" => "127.0.0.1", "port" => 8123 )) )
}
$HTTP["url"] =~ "^/standalone/" {
        proxy.server = ( "" => (( "host" => "127.0.0.1", "port" => 8123 )) )
}
</pre>
重启 lighttpd (sudo /etc/rc.d/lighttpd restart)


现在应该在 http://mywebserver/dynmap/ 显示在线玩家了。
* 一个 minecraft.obj 文件,包含导出的模型(可能非常大)
===Centos+Nginx===
* 一个 .mtl 文件,包含材质列表(对应每个minecraft材质)
在 CentOS 6.X 使用 Nginx 建立 Dynmap
* 一个 目录,包含使用的材质文件
====介绍====
之前我们介绍了使用Nginx(或者Apache)来建立你的Dynmap而不是内置的Jetty服务器,如果你正在托管你自己的网站(并且已经开放了80端口),那么这将允许你将你的地图建立在 http://map.example.com/ 而不是 http://map.example.com:8123/ (设置DNS记录超出了本文的讨论范围)。


注意:这篇文章猜测你的Web服务器与Minecraft服务器是分离的,这个例子里,我使用 192.168.1.2 建立Minecraft服务器而使用 192.168.1.3 建立Nginx服务器。
解压文件并将 minecraft.obj 导入到渲染/建模软件。


如果你选择在同一个服务器运行,那么请在配置里将192.168.1.2更改为127.0.0.1 - 只是记住这可能不是最好的解决方式(这时候代理可能有用?)。
==开发者==
Dynmap 项目包含了多个部分,可以支持多个服务器平台,也可以帮助我们清楚地发布API。用来构建 'dynmap'(Bukkit 的 Dynmap 插件)的有以下几部分(按照构建顺序):


====CentOS====
*[https://github.com/webbukkit/DynmapCoreAPI DynmapCoreAPI] - 这是无关平台的 Dynmap API:插件编写者可以使用这个接口来在任何平台使用 Dynmap(通过将插件转换为 org.dynmap.DynmapCoreAPI 示例)
为什么是 CentOS?


来自 Wikipedia:
*[https://github.com/webbukkit/DynmapCore DynmapCore] - 这个服务器平台的 Dynmap 核心:几乎所有的网页和渲染都在这里(我们尽可能多的往里放)。在这里构建的结果是不可运行的 - 他们被放入 dynmap 的其他部分(比如,DynmapSpout 支持 Spout 平台)。


CentOS(Community Enterprise Operating System)是Linux发行版之一,它是来自于Red Hat Enterprise Linux依照开放源代码规定发布的源代码所编译而成。
*[https://github.com/webbukkit/dynmap-api dynmap-api] - Dynmap 的 Bukkit 部分的 API - 定义了 org.dynmap.DynmapAPI 接口,包括了 Bukkit 的调用,通过配合 DynmapCoreAPI(DynmapAPI 继承),将插件实例转为 org.dynmap.DynmapAPI 来使用公布的接口。


由于出自同样的源代码,因此有些要求高度稳定性的服务器以CentOS替代商业版的Red Hat Enterprise Linux使用。
*[https://github.com/webbukkit/dynmap dynmap] - 真正的 Dynmap Bukkit 的部分,包括了那些与服务器无关的代码。


从安装的时候,我选择了'最小安装'的ISO,接着安装任何我可能需要的模块。
===如何编译Dynmap===
编译 Dynmap 使用 [http://maven.apache.org/ Maven]。使用 Maven 的 mvn install 命令你就可以将项目安装在你的 Maven 仓库,这样就可以用于编译其他需要用此项目作为依赖的项目。基本的方法为,使用 git clone 下载代码,使用 mvn install 编译代码。


我推荐安装尽可能少的东西,接着添加缺少的东西而不是一次性安装所有的东西。
Dynmap 的核心系统基本不需要依赖项,核心用于实现特殊的框架,比如 Bukkit 和 Spout。在你编译某平台的框架之前,你应该复制并按顺序编译这些项目:


CentOS ISO镜像都在这里。
*DynmapCoreAPI - git://github.com/webbukkit/DynmapCoreAPI.git
*DynmapCore - git://github.com/webbukkit/DynmapCore.git


x86_64 最小安装 ISO 在 /6.X/isos/x86\_64/CentOS-6.X-x86_64-minimal.iso,这与你使用的镜像相关(X替换为最近的版本 - 本文写作的时候 - 6.4 - 翻译的时候已经7.4了)。
;Dynmap for Bukkit


安装CentOS并在安装的时候设置好网络而不是启动时手动设置 /etc/sysconfig/network-scripts/ifcfg-eth0 来配置你的网络。
复制并按顺序编译这些项目来编译 Bukkit 的 Dynmap:


一个静态的IP地址是非常重要的,或者使用DHCP服务器(经常是路由器)。你可能需要配置SSHd,但这不是必须的。
*dynmap-api - git://github.com/webbukkit/dynmap-api.git
*dynmap - git://github.com/webbukkit/dynmap.git


====安装 Nginx, PHP 和 PHP-FPM====
或者将以下复制进你的终端:
按照这里或者网上的指示安装Nginx。这样如果你安装了 x86_64 CentOS 你就可以在root登陆下使用以下命令。
<pre>
<pre>
rpm -ivh http://mirror.yandex.ru/epel/6/x86_64/epel-release-6-7.noarch.rpm
git clone git://github.com/webbukkit/DynmapCoreAPI.git && (cd DynmapCoreAPI && mvn install)
 
git clone git://github.com/webbukkit/DynmapCore.git && (cd DynmapCore && mvn install)
rpm -Uvh http://rpms.famillecollet.com/enterprise/remi-release-6.rpm
git clone git://github.com/webbukkit/dynmap-api.git && (cd dynmap-api && mvn install)
</pre>
git clone git://github.com/webbukkit/dynmap.git && (cd dynmap && mvn install)
在 "配置 Nginx" 部分,我个人使用了 /var/www/map.example.com/public_html 和 /var/www/map.example.com/logs,但这决定于你。
 
Note: Also create a folder for the cache eg. /var/www/cache and run chown nginx:nginx /var/www/cache.
 
====设置"站点"====
在 /etc/nginx/sites-available/map.example.com 的文件处,更改为以下信息。
<pre>
    proxy_cache_path  /var/www/cache levels=1:2 keys_zone=map:8m max_size=1g inactive=24h;
server {
    server_name map.example.com;
    access_log /var/www/map.example.com/logs/access.log;
    error_log /var/www/map.example.com/logs/error.log;
    root /var/www/map.example.com/public_html;
 
    location / {
        proxy_pass                  http://[IP OF MINECRAFT SERVER]:9999/;
        proxy_set_header            Host $host;
        proxy_cache                map;
        proxy_cache_key "$host$uri";
        proxy_cache_valid  200 302  60m;
        proxy_cache_valid  404      10m;
        proxy_cache_use_stale      error timeout invalid_header updating http_500 http_503 http_504;
        proxy_connect_timeout 10;
    }
}
</pre>
</pre>
将 proxy_pass 更改为你的Dynmap服务器的IP和端口。
包含 Dynmap 的 ZIP 文件位于 dynmap/target/dynmap-*-bin.zip.
 
====完成====
运行这个命令: service nginx reload 来重载命令


保证 80 端口被防火墙(iptables)开放,并且公共IP有一个DNS的A记录连接到 map.example.com 域名。
;Dynmap for 原版Spout


打开 http://map.example.com
复制并按顺序编译这些项目来编译 Spout 原版服务器的 Dynmap:


===Nginx===
*[https://github.com/SpoutDev/SpoutAPI SpoutAPI] - git://github.com/SpoutDev/SpoutAPI.git
这里介绍了如何使用Nginx作为外部Web服务器搭建Dynmap 网页服务(非代理服务器)。 我们推测你已经完成了以下步骤:
*[https://github.com/SpoutDev/Vanilla SpoutVanilla] - git://github.com/SpoutDev/Vanilla.git
 
*[https://github.com/webbukkit/DynmapSpout DynmapSpout] - git://github.com/webbukkit/DynmapSpout.git
*你所安装的 Dynmap 根目录在 /srv/dynmap
或者将以下复制进你的终端:
*你正确地安装了 Nginx 服务,并且懂得如何使用它来搭建一台PHP在线聊天系统
*你所安装的 Dynmap 和内置网页服务器已经正确运行在 8123 端口
以下展示出 Dynmap 运行在Nginx时的默认配置文件。为了更好的进行数据处理,我特意将Nginx中的php-fpm配置命名为 "php5-fpm.sock"。
<pre>
<pre>
server {
git clone git://github.com/webbukkit/DynmapCoreAPI.git && (cd DynmapCoreAPI && mvn install)
    listen      80;
git clone git://github.com/webbukkit/DynmapCore.git && (cd DynmapCore && mvn install)
    server_name  minecraft.example.com;
git clone git://github.com/SpoutDev/SpoutAPI.git && (cd SpoutAPI && mvn install)
    root        /srv/dynmap/;
git clone git://github.com/SpoutDev/Vanilla.git && (cd Vanilla && mvn install)
 
git clone git://github.com/webbukkit/DynmapSpout.git && (cd DynmapSpout && mvn install)
    index index.html;
 
    access_log /var/log/nginx/minecraft.example.com-access_log;
    error_log /var/log/nginx/minecraft.example.com-error_log;
 
    location / {
        try_files $uri $uri/ =404;
    }
 
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_index index.php;
        fastcgi_pass php5-fpm-sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include /etc/nginx/fastcgi_params;
    }
}
</pre>
</pre>
这些配置会运用到 Dynmap 下所有的URL行中。
包含 Dynmap 的 ZIP 文件位于 DynmapSpout/target/DynmapSpout-*-bin.zip.


如果你想使用 MultiCraft 作为 Dynmap 的后台管理系统也是极好的。
==联系方式==
 
* [http://forums.bukkit.org/threads/misc-dynmap-v0-12-1-realtime-minecraft-maps-314.489/ Bukkit 论坛]
以下是使用Nginx搭建 Dynmap 时使用 MultiCraft 管理的配置:
* [http://dev.bukkit.org/server-mods/dynmap/ BukkitDev 项目页面]
<pre>
* IRC: irc://irc.esper.net/#dynmap ([http://webchat.esper.net/?nick=Webuser&channels=dynmap&prompt=0 在线])
server {
    listen      80;
    server_name  minecraft.example.com;
    root        /srv/dynmap/;
 
    index index.html;
 
    access_log /var/log/nginx/minecraft.example.com-access_log;
    error_log /var/log/nginx/minecraft.example.com-error_log;
 
    location / {
        try_files $uri $uri/ =404;
    }
 
    location /admin {
        alias /srv/multicraft/;
        index index.php;
    }
 
    location ~ ^/admin/(.*\.php)$ {
        alias /srv/multicraft/$1;
        fastcgi_pass php5-fpm-sock;
        fastcgi_param SCRIPT_FILENAME $request_filename;
        include /etc/nginx/fastcgi_params;
    }
 
    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_index index.php;
        fastcgi_pass php5-fpm-sock;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include /etc/nginx/fastcgi_params;
    }
}
</pre>
你需要在确保以上所有步骤正确完成以及配置项无误后,你还需要给 Dynmap 和网页服务器对 standalone/dynmap_webchat.json 文件赋予足够的读写权限用于网页在线聊天系统。


如果你们有关于Nginx+PHP5 FPM等的非 Dynmap类问题,可以前往 [http://www.cryptkcoding.com/2011/08/running-wordpress-with-nginx-php-fpm-apc-and-varnish/ 原作者的博客] 进行详细的提问。
==参考==
==在Windows下建立动态地图插件==
* https://github.com/webbukkit/dynmap/wiki
* https://pluginscdtribe.github.io/wiki/dynmap/
* http://www.mcbbs.net/thread-728931-1-1.html

2021年8月16日 (一) 14:01的最新版本

Minecraft插件百科提醒您,此条目或需要大幅度整改,建议新用户不要模仿此条目格式建立新条目。

原因在于:

  • 缺少概述表
  • 存在维基语法错误
若您清楚改善现状的方法,可以尝试帮忙改进

Dynmap 是一个像谷歌地图一样的、为 Minecraft 服务器设计的地图插件,让你可以在浏览器查看服务器地图。

你可以使用 Dynmap 的集成的网络服务器立即上手,也可以将其部署到 Apache 等现有的网络服务器,易于使用。

Dynmap 可以使用不同的渲染器渲染你的地图,有的适用于高性能,而有的可以展示更详细的细节。

原始的项目是由 k-red 开发。

支持的基于Forge的Mod

支持以下的Mod,尽管这些Mod的老版本可能不支持,当前版本的某些方块也可能不支持:

  • Advanced Machines - IC2
  • Advanced Power Management - IC2
  • Advanced Solar Panels - IC2
  • BetterWorlds
  • BuildCraft
  • Charging Bench - IC2
  • Compact Solars - IC2
  • ComputerCraft
  • Equivalent Exchange 2
  • Ender Storage
  • ExtraBees
  • Extrabiomes XL (v2.x and v3.x)
  • Extrabiomes - Bunyan
  • Forestry (updated in 1.4)
  • Forgotten Nature
  • Greg's Lighting
  • IndustrialCraft 2
  • Iron Chest
  • LC Trees++
  • Millenaire
  • MystCraft
  • Metallurgy 2
  • NetherOres
  • RailCraft
  • Red Power 2
  • SuperSlopes
  • TerraFirmaCraft
  • ThaumCraft
  • Thermal Expansion
  • Tubestuff
  • Twilight Forest
  • XyCraft

支持的服务端

Dynmap 包括了除了 CraftBukkit 的其他版本。其他的最新的版本可以在这里找到。目前有 3 个Dynmap主要的平台:

Spigot

Spigot 通过 Bukkit Dynmap 被完全支持。

MinecraftForge

很多版本的 MinecraftForge 都是支持的,可以使用 DynmapForge 项目。所有的 Forge 版本的 Dynmap 都需要特定的 Forge 版本,升级 Forge 版本也需要升级到对应的 DynmapForge 版本。你应该按照如下的方法来安装或者升级:

  • 下载对应的 ZIP 文件,对应 MC 版本。
  • 解压整个 ZIP 文件,包括子目录,至服务器的根目录。
  • 如果是升级,那么删除 'mods' 下老的 'Dynmap-x.y.zip'。
MCPC+

目前 MCPC+ 的版本(v1.4.7 或之后) 只被 DynmapForge mods 支持对应的 Forge 版本。CraftBukkit 版本不被支持。安装请按照以下步骤。 你可以使用 DynmapCBBridge 来兼容使用的 Bukkit 的插件的数据(可以在这里找到)。这是一个 Bukkit 插件,所以应该放在 'plugins' 目录,并且只支持那些基于 Forge 的 Bukkit 服务器上。

BukkitForge

BukkitForge mod,一个基于 Forge 的 Mod,添加了Bukkit 的 API,是不被 Dynmap 的 Bukkit 版本支持的。可以使用 DynmapForge 版本,并且搭配 DynmapCBBridge 插件。安装过程与上方的 MCPC+ 相同。

Tekkit Classic

Tekkit Classic,和更老的 MCPC (没有+ - v1.2.5),被 DynmapBukkit 支持。

Tekkit-Lite

Tekkit-Lite 被 DynmapForge 支持,而不是 Bukkit Dynmap。按照上方 Forge 的安装方式安装 Dynmap。

Tekkit

Tekkit 是一个将大量的 Minecraft Mods 整合在 Bukkit 服务器的服务端。Dynmap 支持 Tekkit,目前的 Dynmap 版本会自动检测 Mod,和他们的方块ID,渲染支持的方块。目前支持 Tekkit v3.1.3

Spout

Spout 服务器被 DynmapSpout 的实验项目支持(Spout 进行的重构使对其进行支持不切实际)。安装至 Spout 与 Bukkit 相同(解压到 plugins 目录)。注意:这个项目是给 Spout 服务器使用而不是 Bukkit 上的 Spout 插件。Spout插件可以使用 Bukkit Dynmap。

从 Bukkit Dynmap 迁移到 Forge Dynmap

将 Bukkit Dynmap 迁移到 Forge Dynmap 可以按照以下方式进行:

  • 将 <base>/plugins/dynmap 目录(包括所有数据和子目录)移动到 Forge 服务器上的 <base>/dynmap 目录。
  • 编辑 configuration.txt: 替换 'render-triggers' 为以下信息:
    render-triggers:
      - blockupdate
      #- blockupdate-with-id
      #- lightingupdate
      - chunkpopulate
      - chunkgenerate
      #- none
  • 删除 <base>/plugins/dynmap.jar
  • 按照安装对应 Forge 版本的方法安装。

安装

见:Dynmap/安装

配置

见:Dynmap/配置

命令

见:Dynmap/命令

权限

见:Dynmap/权限

网页参数

用于启动Web界面的URL可以有多个参数,可以用于改变发送给玩家的默认界面效果。这可以用来在加载WebUI时加载指定的世界或者地图,或者一个指定的缩放大小,或者将地图的中心设置为某个指定的世界坐标。

参数由一串属性-值组成,每个的参数格式就像这样:attribute-id=value

基础的URL必须含有一个问号 (?) 在第一个参数之前,每个参数之间必须以这个符号间隔,所以,如果这是默认的dynmap网址:http://mygreatserver:8123/

那么,直接打开“fred”世界并且显示“surface”地图的网页,就可以像这样:http://mygreatserver:8123/?worldname=fred&mapname=surface

如果你想要使用一个外置的服务器,格式也是一样的 - 添加问号,使用 & 分隔参数:http://mycoolapacheserver.com/dynmap?worldname=fred&mapname=surface

可用的参数如下:

  • worldname - 这个指定了世界的名称(不是标题)。如果没有定义,那么会显示第一个默认的世界(除非在 _configuration.txt里设置了显示哪个世界)。
  • mapname - 这个指定了显示的地图的名称(不是标题),如果没有指定,那么将会显示选中的世界的第一个地图!(除非在_configuration.txt中设置了显示哪张地图)。
  • zoom - 指定的缩放大小(0为最高的缩放),如果没有提供,。那么将会使用默认的缩放大小(除非在_configuration.txt中指定了默认的缩放大小)。
  • x - 这个指定了X坐标(展示的世界的坐标),如果没有指定,那么将会显示center定义的x坐标(一般为0)。
  • y - 这个指定了Y坐标(展示的世界的坐标),如果没有指定,那么将会显示center定义的y坐标(一般为0)。
  • z - 这个指定了Z坐标(展示的世界的坐标),如果没有指定,那么将会显示center定义的z坐标(一般为0)。
  • nopanel - 如果设置为true,那么地图显示的侧边栏将会移除。
  • chatname - 如果设置为一个字符串,WebUI将会将其转变为发送者发送的聊天消息使用的名称。这将只有在 'trustclientname' 设置为 true时才会生效,作为 'allowurlname' 的附加。在0.28及以后的版本中支持。
  • playername - 如果定义了并将其设置为玩家的账户的名称,并且玩家在线或者开启WebUI后一会儿玩家加入了服务器,WebUI将会将地图初始化在给定玩家的位置。
  • hidechat - 如果设置为 'true',那么WebUI将会关闭所有的聊天输入和输出模块(气泡,输入框,聊天栏)。
  • nogui - 如果设置为 'true',那么WebUI将会关闭所有的控制面板,就像只显示地图层一样。
  • nocompass - 如果设置为 'true',那么UI上的指南针将会隐藏。(v2.2-alpha-1)

地图标记

见:Dynmap/地图标记

自定义方块

见:Dynmap/自定义方块

导出世界为WavefrontOBJ格式

在 Dynmap v1.9.3 中,我们支持了将地图生成并导出为 Wavefront OBJ 格式的文件,这个特性由 jmc-2-obj 工具启发而来,允许管理员(或控制台)选择并导出他们的部分世界为模型文件,用于其他支持 Wavefront OBJ 格式的建模软件的导入 - 包括了 Blender(一个免费开源的渲染和动画套件),Cinema 4D,Maya,3D Studio Max 和其他的软件。这些导出的模型可以用于 Dynmap 不支持的高级渲染(保举哦了更高级的光照和反射)。由于 Dynmap 导出的 OBJ 格式文件与 jmc-2-obj 软件产生的非常相似,所以针对 jmc-2-obj 的模型的导入和处理与 Dynmap 的 OBJ 导出非常相似。

导出和处理使用新的 /dynmapexp 命令完成,此命令可以设置一些属性来控制导出:

  • x0, y0, z0 : 这些是最小的 X, Y, 和 Z 轴的长方体/矩形棱柱的值
  • x1, y1, z1 : 这些是最大的 X, Y, 和 Z 轴的长方体/矩形棱柱的值
  • world : 用于导出的世界的名称
  • byChunk : 如果设置为 true,这将会生成整个区块的所有方块的对象
  • byBlockID : 如果设置为 true,这将会生成所有给定方块ID的对象
  • byBlockIDData : 如果设置为 true,这将会生成所有给定方块ID和方块元数据的对象
  • byTexture : 如果设置为 true,这将会生成所有给定材质的方块的对象
  • shader : 指定用于导出的使用的材质的着色器,默认情况下使用 stdtexture,只有基于材质包的着色器才支持

/dynmapexp 的子命令包括了:

  • /dynmapexp set : 允许设置导出的属性(如上),附加的属性可以在同一个命令使用,如 /dynmapexp set x0 0 y0 0 z0 100。
  • /dynmapexp radius : 只能由一个游戏中的玩家使用:此命令会指定导出的世界为玩家所在的世界,并设置半径为玩家所在位置的半径,Y 轴为 0-255 的所有方块。
  • /dynmapexp info : 显示当前导出的属性
  • /dynmapexp pos0 : 此命令只能由玩家在游戏中使用:设置导出范围的第一个点
  • /dynmapexp pos1 : 此命令只能由玩家在游戏中使用:设置导出范围的第二个点
  • /dynmapexp reset : 重置导出属性为默认值
  • /dynmapexp export : 初始化一个导出,创建一个叫 .zip 的文件(默认在 dynmap 文件夹下的 export 文件夹,可以在 exportpath 中设置)。导出是异步处理的,并且会耗费几分钟完成,用时取决于选区的大小
  • /dynmapexp purge : 删除上一个导出

完成后,ZIP文件中将会包含以下内容:

  • 一个 minecraft.obj 文件,包含导出的模型(可能非常大)
  • 一个 .mtl 文件,包含材质列表(对应每个minecraft材质)
  • 一个 目录,包含使用的材质文件

解压文件并将 minecraft.obj 导入到渲染/建模软件。

开发者

Dynmap 项目包含了多个部分,可以支持多个服务器平台,也可以帮助我们清楚地发布API。用来构建 'dynmap'(Bukkit 的 Dynmap 插件)的有以下几部分(按照构建顺序):

  • DynmapCoreAPI - 这是无关平台的 Dynmap API:插件编写者可以使用这个接口来在任何平台使用 Dynmap(通过将插件转换为 org.dynmap.DynmapCoreAPI 示例)
  • DynmapCore - 这个服务器平台的 Dynmap 核心:几乎所有的网页和渲染都在这里(我们尽可能多的往里放)。在这里构建的结果是不可运行的 - 他们被放入 dynmap 的其他部分(比如,DynmapSpout 支持 Spout 平台)。
  • dynmap-api - Dynmap 的 Bukkit 部分的 API - 定义了 org.dynmap.DynmapAPI 接口,包括了 Bukkit 的调用,通过配合 DynmapCoreAPI(DynmapAPI 继承),将插件实例转为 org.dynmap.DynmapAPI 来使用公布的接口。
  • dynmap - 真正的 Dynmap Bukkit 的部分,包括了那些与服务器无关的代码。

如何编译Dynmap

编译 Dynmap 使用 Maven。使用 Maven 的 mvn install 命令你就可以将项目安装在你的 Maven 仓库,这样就可以用于编译其他需要用此项目作为依赖的项目。基本的方法为,使用 git clone 下载代码,使用 mvn install 编译代码。

Dynmap 的核心系统基本不需要依赖项,核心用于实现特殊的框架,比如 Bukkit 和 Spout。在你编译某平台的框架之前,你应该复制并按顺序编译这些项目:

Dynmap for Bukkit

复制并按顺序编译这些项目来编译 Bukkit 的 Dynmap:

或者将以下复制进你的终端:

git clone git://github.com/webbukkit/DynmapCoreAPI.git && (cd DynmapCoreAPI && mvn install)
git clone git://github.com/webbukkit/DynmapCore.git && (cd DynmapCore && mvn install)
git clone git://github.com/webbukkit/dynmap-api.git && (cd dynmap-api && mvn install)
git clone git://github.com/webbukkit/dynmap.git && (cd dynmap && mvn install)

包含 Dynmap 的 ZIP 文件位于 dynmap/target/dynmap-*-bin.zip.

Dynmap for 原版Spout

复制并按顺序编译这些项目来编译 Spout 原版服务器的 Dynmap:

或者将以下复制进你的终端:

git clone git://github.com/webbukkit/DynmapCoreAPI.git && (cd DynmapCoreAPI && mvn install)
git clone git://github.com/webbukkit/DynmapCore.git && (cd DynmapCore && mvn install)
git clone git://github.com/SpoutDev/SpoutAPI.git && (cd SpoutAPI && mvn install)
git clone git://github.com/SpoutDev/Vanilla.git && (cd Vanilla && mvn install)
git clone git://github.com/webbukkit/DynmapSpout.git && (cd DynmapSpout && mvn install)

包含 Dynmap 的 ZIP 文件位于 DynmapSpout/target/DynmapSpout-*-bin.zip.

联系方式

参考