查看“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 的。

插件的部件可供你按照自己的需要添加/删除功能，Using the components Dynmap comes supplied with, 支持聊天泡泡, 网页-游戏聊天, 和可配置的标记, 标签, 和 line。

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

==安装==

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

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

==第一次使用==

当你开启 CraftBukkit 时, 你应该可以在浏览器里跳转到 http://yourserverip: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/ 虚拟主机]

===插件设置===
        Base Plugin Settings
        Component Configuration
        World and Template Settings
        HD Map Configuration
        Support for MinecraftForge based mods
        Support for Minecraft Servers other than CraftBukkit
    Commands
        Configuring Maps and Worlds using dmap
    Permissions
        Web UI Login Support and Permissions
    Web UI Parameters
    Using Markers
    Custom Block Definitions
    Exporting World Data in Wavefront OBJ Format

==开发者相关==

The dynmap project consists of multiple components that have been divided to allow for support of multiple server platforms, as well as allowing our 'published API' to be more clearly expressed. The components needed to build 'dynmap' (the Dynmap plugin for Bukkit) are the following (in the order they need to be built):

    DynmapCoreAPI - this is the platform neutral API for Dynmap: plugin writers can use this to interface with Dynmap on any platform (by casting the Plugin instance for the dynmap plugin to 'org.dynmap.DynmapCoreAPI').

    DynmapCore - this is the server-neutral core of Dynmap: nearly all the web and rendering logic for Dynmap is here (as much of it as we can put in). The build results here are not runnable - they're input to the 'dynmap' component build and others (e.g. 'DynmapSpout', which is for the Spout server).

    dynmap-api - this is the Bukkit-specific API library for Dynmap - it defines the org.dynmap.DynmapAPI interface, which includes Bukkit-specific calls. As with the DynmapCoreAPI (which DynmapAPI extends), take the Plugin instance for 'dynmap' and cast it to org.dynmap.DynmapAPI to access the published interfaces.

    dynmap - this component builds the actual dynmap-for-Bukkit deliverable, and only includes code which cannot be made server-neutral.

How to compile Dynmap
还有许多页面没有搬运！bukkit项目页面也没有搬运！会尽快补充请谅解