查看“Dynmap”的源代码

{{Bukkit Plugin Infobox
|版本=v1.5.5.7
|前置插件=[[Vault]]
|兼容服务端版本=全版本
|原帖=https://dev.bukkit.org/bukkit-plugins/dynmap/
}}
                    
{{待翻译}}
来源：[https://github.com/webbukkit/dynmap/wiki/ wiki], [https://dev.bukkit.org/bukkit-plugins/dynmap/ bukkit]

[[Category:管理]] [[Category:网页]] [[Category:信息]]


=简介=

Dynmap是一个可以用网页浏览的、像谷歌地图一样的动态地图插件。Dynmap的网页结构是建立在整个MineCraft游戏之外的，非常实用和易用，Dynmap也可应用于基于Apache类软件的网页。 <br /> 
Dynmap可以用不同的渲染图层渲染你的服务器世界地图, 有些适合于展示, 有些有着更多的地图细节。

这个插件的原始项目是由 k-zed.开发给 hMod 的。

插件的部件可供你按照自己的需要添加/删除功能，使用Dnymap支持的部件,包括聊天泡泡, 网页-游戏聊天, 和可配置的标记, 标签, 下换线。 [[文件:Dynmap.png]]

==功能==
* 每个游戏世界深度可设置的地图
* 实时更新：地图总是和服务器世界实时同步，当你打开着你的网页时更新一直会显示
* 玩家和他们的头像在地图上可见
* 地图上的聊天信息可见 (显示在聊天泡泡或者聊天框里)
* 地图浏览者能和游戏内的玩家聊天
* 实时Minecraft时间在地图上可见
* 实时Minecraft季节在地图上可见
* WorldGuard, Residence, Towny 和 Factions regions 插件都能在地图上可见 (需要相应版本的 Dynmap-* 补丁)

总的来说高度可配置和可定制化

==安装==

复制dynmap-*.jar 进你的补丁文件夹. 如果用于更新, 删除之前安装的 dynmap-*.jar - 你不需要删除任何补丁/地图文件夹或者它的文件。

如果你正在运行一个独立网页服务器 (比如 Apache) 你可能需要先复制文件'plugins/dynmap/web/' 到你的http-root的一个文件夹，里然后再执行此教程。升级时，请确保你也升级了被复制的文件。

==第一次使用==

    当你开启 CraftBukkit 时, 你应该可以在浏览器里跳转到 http://yourserverip:8123/（http://你服务器的IP:8123/）。 如果你是用你现在正在使用的PC来运行 CraftBukkit, 你可以跳转到 http://localhost:8123/。 <br /> 
    你应该能够看到在游戏内的玩家。 需要注意的是此时地图还未被渲染, 所以背景应该是黑色的。<br /> 

    如果你计划使用高清渲染, 现在你就可以着手做这件事了。开启configuration.txt顶端的 'deftemplatesuffix: hires' 。更多关于deftemplatesuffix的信息可在基础补丁设置查看。<br /> 

    如果你只是想让Dynmap有效, 在游戏里使用这个命令 /dynmap fullrender。 wiki上有更多关于命令和权限的内容。<br /> 
    地图此时应该会显露出来，给它一些时间。程序信息之后会显示 Dynmap 正在工作 (Dynmap is working) 和 渲染已完成 （render is completed)。

==相关==

    [http://forums.bukkit.org/threads/misc-dynmap-v0-12-1-realtime-minecraft-maps-314.489/ Bukkit论坛 (已失效）]
    [http://dev.bukkit.org/server-mods/dynmap/ Bukkit项目页面]
    IRC: irc://irc.esper.net/#dynmap (via web)

==如何使用==

===[https://github.com/webbukkit/dynmap/wiki/Setting-up-without-the-Internal-Web-Server/ 在无内部网页服务器环境使用]===
===[https://github.com/webbukkit/dynmap/wiki/Setting-up-the-Dynamic-Map-plugin-under-Linux/ 在Linux环境使用]===
===[https://github.com/webbukkit/dynmap/wiki/Setting-up-the-Dynamic-Map-plugin-under-Windows/  在Windows环境使用]===
===[https://github.com/webbukkit/dynmap/wiki/Setting-up-Dynmap-through-hosting-services/ 在虚拟主机环境使用]===

===[https://github.com/webbukkit/dynmap/wiki/Configuration/ 插件设置]===
*[https://github.com/webbukkit/dynmap/wiki/Base-Plugin-Settings/ 基础补丁设置]
*[https://github.com/webbukkit/dynmap/wiki/Component-Configuration/ 部件配置]
*[https://github.com/webbukkit/dynmap/wiki/World-and-template-settings/ 世界及模板设置]
*[https://github.com/webbukkit/dynmap/wiki/HD-Map-Configuration/ 高清地图配置]
*[https://github.com/webbukkit/dynmap/wiki/Support-for-MinecraftForge-based-mods/ 基于Forge的支持]
*[https://github.com/webbukkit/dynmap/wiki/Support-for-Minecraft-Servers-other-than-CraftBukkit/ 基于CraftBukkit外其他服务端的支持]

===[https://github.com/webbukkit/dynmap/wiki/Commands/ 命令]===
*[https://github.com/webbukkit/dynmap/wiki/Configuring-Maps-and-Worlds-using-dmap/ 用dmap配置地图和世界] 

===[https://github.com/webbukkit/dynmap/wiki/Permissions/ 权限]===
*[https://github.com/webbukkit/dynmap/wiki/Web-ui-login-support-and-permissions/ 网页UI登陆支持和权限] 

===[https://github.com/webbukkit/dynmap/wiki/Web-UI-Parameters/ 网页UI参数]===
===[https://github.com/webbukkit/dynmap/wiki/Using-markers/ 使用标记]===
===[https://github.com/webbukkit/dynmap/wiki/Custom-Block-Definitions/ 自定义方块定义]===
===[https://github.com/webbukkit/dynmap/wiki/Exporting-World-Data-in-Wavefront-OBJ-Format/ 用Wavefront OBJ格式传输世界数据]===

==其他==

Both to demonstrate the API, and to help manage the growth of this already-huge plugin, we've started producing additional plugins for Dynmap. All of these will depend on Dynmap and interface through its APIs, but only need to be added by folks that are interested in the additional function they provide:

dynmap-mobs: Provides marker layer for real-time position of selected mobs on dynmap maps.
dynmap-residence: Successor to the 'regions' support for Residence in Dynmap, with live update of Residence changes
Dynmap-WorldGuard: Successor to the 'regions' support for WorldGuard in Dynmap, with live update of WorldGuard changes
Dynmap-Towny: Successor to the 'regions' support for Towny in Dynmap, with live update of Towny changes
Dynmap-Factions: Successor to the 'regions' support for Factions in Dynmap, with live update of Factions changes
Dynmap-CommandBook: Add support for showing /home and /warp locations defined using CommandBook.
Dynmap-Essentials: Add support for showing /home and /warp locations defined using Essentials.
Dynmap-GriefPrevention: Add support for showing Grief Protection claims
Dynmap2CraftIRC3: Integrate Dynmap's web chat with IRC via CraftIRC
Dynmap-SimpleClans: Integrate SimpleClans with Dynmap
Dynmap-HeroChat: Integrate HeroChat v5.5+ with Dynmap
Dynmap-PhysicalShop
Dynmap-pyLandmarks
Dynmap-PreciousStones: Integrate PreciousStones with Dynmap
Dynmap-AdminCmd: Integrate AdminCmd with Dynmap
Dynmap-PlayerWarp
Dynmap-Citizens: Integrate Citizens with Dynmap

==开发者相关==

Dynmap 插件由多个部件组成，用于支持多平台服务器，同时为了让我们的“已发布API”能被更好的理解。组成dynmap插件的必须部件 （用于Bukkit的Dynmap 补丁）在下文列出：

    DynmapCoreAPI - 这是用于Dynmap的 neutral API 平台: 插件开发者能以此作为 Dynmap与任何平台的接口（通过指向dynmap 补丁实例 org.dynmap.DynmapCoreAPI 实现）

    DynmapCore - 这是Dynmap的 server-neutral 核心: 几乎所有Dynmap的网页和渲染逻辑都在这（尽我们所能的放进去）。 这样开发的结果就是不可运行 - 所以他们都被放进了 'dynmap' 及其他部件开发里(例如 'DynmapSpout', 是用于 Spout 服务端的).

    dynmap-api - 这是dynmap专用于Bukkit（Bukkit-specific）的 API 库 - 它定义了 org.dynmap.DynmapAPI 的接口,包括对 Bukkit-specific 的调用。 还包括 DynmapCoreAPI ( DynmapCoreAPI 是 DynmapAPI 的拓展), 即将补丁实例为 'dynmap' 之后指向 org.dynmap.DynmapAPI 然后接入公共接口。
 
    dynmap - 这个部件让了 dynmap-for-Bukkit 真正的可用, 只包含了不可运行为server-neutral的代码。

==兼容性==

The following mods are known to support dynmap integration without needing an add-on:

DeathTPPlus
xWarp
Vanish No Packet
Ultimate Core
Also, for the best response to questions and such, please post comments to our main forum thread - http://www.minecraftforum.net/topic/1543523-dynmap-dynamic-web-based-maps-for-minecraft/. Once again, having more than one place just isn't helpful, and this is where the 'Dynmap Community' already operates.

==被公开的信息==

This plugin utilizes Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:

A unique identifier
The server's version of Java
Whether the server is in offline or online mode
The plugin's version
The server's version
The OS version/name and architecture
The core count for the CPU
The number of players online
The Metrics version

How to compile Dynmap
还有许多页面没有搬运,会尽快补充请谅解