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

“Dynmap”的版本间的差异

来自Minecraft插件百科
跳转至: 导航搜索
其他: 汉化
在无内部网页服务器环境使用: 搬运
第57行: 第57行:
 
==如何使用==
 
==如何使用==
  
===[https://github.com/webbukkit/dynmap/wiki/Setting-up-without-the-Internal-Web-Server/ 在无内部网页服务器环境使用]===
+
===在无内部网页服务器环境使用]===
 +
 
 +
This page assumes
 +
 
 +
You are reasonably experienced with the standalone web server you are using.
 +
You have the standalone web server and CraftBukkit running on the same machine.
 +
Your Web Server supports PHP. (Only needed for web-to-Minecraft chat)
 +
If you are on Linux, you should know how to use the terminal and chmod.
 +
Change the following:
 +
 
 +
  - class: org.dynmap.InternalClientUpdateComponent
 +
    sendhealth: true
 +
    allowwebchat: true
 +
    webchat-interval: 5
 +
  #- class: org.dynmap.JsonFileClientUpdateComponent
 +
  #  writeinterval: 1
 +
  #  sendhealth: true
 +
  #  allowwebchat: false
 +
To:
 +
 
 +
  #- class: org.dynmap.InternalClientUpdateComponent
 +
  #  sendhealth: true
 +
  #  allowwebchat: true
 +
  #  webchat-interval: 5
 +
  - class: org.dynmap.JsonFileClientUpdateComponent
 +
    writeinterval: 1
 +
    sendhealth: true
 +
    allowwebchat: false
 +
To disable the internal updating mechanism and enable the json-file updating mechanism. This will write to the file standalone/dynmap_world.json in your web-path at an interval that is specified with writeinterval.
 +
 
 +
Copy your files in plugins/dynmap/web to a directory of your webserver. Change configuration.txt so that it points with both tilespath and webpath to the paths where you placed the web-files. For *nix
 +
 
 +
# The path where the tile-files are placed.
 +
tilespath: /path/to/web/server/dynmap/web/tiles
 +
 
 +
# The path where the web-files are located.
 +
webpath: /path/to/web/server/dynmap/web
 +
Or for Windows
 +
 
 +
# The path where the tile-files are placed.
 +
tilespath: c:\\path\\to\\web\\server\\dynmap\\web\\tiles
 +
 
 +
# The path where the web-files are located.
 +
webpath: c:\\path\\to\\web\\server\\dynmap\\web
 +
Now restart your Minecraft server. Join your Minecraft server and place a few blocks (randomly) to trigger dynmap to generate tiles for your map. You can also type dynmap fullrender worldname in your server console to render the whole world with the name worldname.
 +
 
 +
Now refresh your browser. It should now display online players on http://mywebserver/dynmap/, keeping them up-to-date.
 +
 
 +
Troubleshooting
 +
 
 +
If you don't see any tiles on the map, check the tiles directory to see whether they get actually generated. If there are no tiles, it is likely that Minecraft does not have rights to write the tiles in the web-path directory your chose. Another possibility is that you have not filled in tilespath correctly.
 +
 
 +
If you don't see any players or don't see the players moving, go to http://mywebserver/standalone/dynmap_world.json (where world is the name of your world). You should see some code and hitting refresh every few seconds should change that code (the servertime should be updated). If this file is not there or you don't see the file changing, you likely have filled in the wrong webpath in the configuration.
 +
 
 +
In Linux, if web-to-mc-chat does not work, you also need to chmod the 'standalone' folder to 775 or 777:
 +
 
 +
$ chmod -R 775 standalone
 +
This is to allow sendmessage.php to create the jsonfile. This is needed because its your Web Server creating the file and not the minecraft server.
 +
 
 +
If web-to-mc-chat does not work on IIS, you likely need to install PHP.
 +
 
 
===[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-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-the-Dynamic-Map-plugin-under-Windows/  在Windows环境使用]===

2016年8月14日 (日) 15:39的版本

Dynmap
外文名Dynmap
插件类型Spigot / CraftBukkit
最新版本v1.5.5.7
兼容服务端全版本
前置插件Vault
源地址http://dev.bukkit.org/bukkit-plugins/Dynmap
Icon-info.png
本页面已存在其他语言的内容,请协助翻译为本地化的中文。
  • 点击此处开始翻译。
  • 如本模板出现在原文存档页面,请注意更新主页面后,仍需要去除此处该模板。
  • 如当前页面已经没有需要翻译的内容,请删去待翻译模板。
  • 有标题的大篇幅文章,如果短时间内无法全部翻译,请先把所有的标题翻译出来,以便之后的贡献者选择与翻译章节内容。

来源:wiki, bukkit


简介

Dynmap是一个可以用网页浏览的、像谷歌地图一样的动态地图插件。Dynmap的网页结构是建立在整个MineCraft游戏之外的,非常实用和易用,Dynmap也可应用于基于Apache类软件的网页。
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/。 
你应该能够看到在游戏内的玩家。 需要注意的是此时地图还未被渲染, 所以背景应该是黑色的。
   如果你计划使用高清渲染, 现在你就可以着手做这件事了。开启configuration.txt顶端的 'deftemplatesuffix: hires' 。更多关于deftemplatesuffix的信息可在基础补丁设置查看。
   如果你只是想让Dynmap有效, 在游戏里使用这个命令 /dynmap fullrender。 wiki上有更多关于命令和权限的内容。
地图此时应该会显露出来,给它一些时间。程序信息之后会显示 Dynmap 正在工作 (Dynmap is working) 和 渲染已完成 (render is completed)。

相关

   Bukkit论坛 (已失效)
   Bukkit项目页面
   IRC: irc://irc.esper.net/#dynmap (via web)

如何使用

在无内部网页服务器环境使用]

This page assumes

You are reasonably experienced with the standalone web server you are using. You have the standalone web server and CraftBukkit running on the same machine. Your Web Server supports PHP. (Only needed for web-to-Minecraft chat) If you are on Linux, you should know how to use the terminal and chmod. Change the following:

 - class: org.dynmap.InternalClientUpdateComponent
   sendhealth: true
   allowwebchat: true
   webchat-interval: 5
 #- class: org.dynmap.JsonFileClientUpdateComponent
 #  writeinterval: 1
 #  sendhealth: true
 #  allowwebchat: false

To:

 #- class: org.dynmap.InternalClientUpdateComponent
 #  sendhealth: true
 #  allowwebchat: true
 #  webchat-interval: 5
 - class: org.dynmap.JsonFileClientUpdateComponent
   writeinterval: 1
   sendhealth: true
   allowwebchat: false

To disable the internal updating mechanism and enable the json-file updating mechanism. This will write to the file standalone/dynmap_world.json in your web-path at an interval that is specified with writeinterval.

Copy your files in plugins/dynmap/web to a directory of your webserver. Change configuration.txt so that it points with both tilespath and webpath to the paths where you placed the web-files. For *nix

  1. The path where the tile-files are placed.

tilespath: /path/to/web/server/dynmap/web/tiles

  1. The path where the web-files are located.

webpath: /path/to/web/server/dynmap/web Or for Windows

  1. The path where the tile-files are placed.

tilespath: c:\\path\\to\\web\\server\\dynmap\\web\\tiles

  1. The path where the web-files are located.

webpath: c:\\path\\to\\web\\server\\dynmap\\web Now restart your Minecraft server. Join your Minecraft server and place a few blocks (randomly) to trigger dynmap to generate tiles for your map. You can also type dynmap fullrender worldname in your server console to render the whole world with the name worldname.

Now refresh your browser. It should now display online players on http://mywebserver/dynmap/, keeping them up-to-date.

Troubleshooting

If you don't see any tiles on the map, check the tiles directory to see whether they get actually generated. If there are no tiles, it is likely that Minecraft does not have rights to write the tiles in the web-path directory your chose. Another possibility is that you have not filled in tilespath correctly.

If you don't see any players or don't see the players moving, go to http://mywebserver/standalone/dynmap_world.json (where world is the name of your world). You should see some code and hitting refresh every few seconds should change that code (the servertime should be updated). If this file is not there or you don't see the file changing, you likely have filled in the wrong webpath in the configuration.

In Linux, if web-to-mc-chat does not work, you also need to chmod the 'standalone' folder to 775 or 777:

$ chmod -R 775 standalone This is to allow sendmessage.php to create the jsonfile. This is needed because its your Web Server creating the file and not the minecraft server.

If web-to-mc-chat does not work on IIS, you likely need to install PHP.

在Linux环境使用

在Windows环境使用

在虚拟主机环境使用

插件设置

命令

命令列表
Hiding and showing players

/dynmap hide: Hides the player from the map.
/dynmap hide thedude: Hides the player thedude from the map.
/dynmap show: Shows the player on the map again.
/dynmap show thedude: Shows the player thedude on the map again.
Rendering

/dynmap render: renders one tile of the map where you are standing.
/dynmap fullrender: Attempts to render all maps of the entire world from your location (or from the center of that world, if issued from the server console).
/dynmap fullrender world: Attempts to render all maps of the world named world from the center of that world.
/dynmap fullrender world:surface: Attempts to render the map named surface for the world named world from the center of that world.
/dynmap radiusrender radius: attempts to render at least a radius block area, centered on your current location.
/dynmap radiusrender radius mapname: attempts to render at least a radius block area, centered on your current location of map 'mapname'
/dynmap radiusrender world x z radius: attempts to render at least a radius block area, centered on 'x,64,z' on world 'world'.
/dynmap updaterender: attempts to render tiles needing updating, starting at current location, for all maps. Stops at edge of map and at tiles that don't need updating.
/dynmap updaterender mapname: attempts to render tiles needing updating, starting at current location, for given map. Stops at edge of map and at tiles that don't need updating.
/dynmap updaterender world x z: attempts to render tiles needing updating, starting at given location on given world, for all maps. Stops at edge of map and at tiles that don't need updating.
/dynmap updaterender world x z mapname: attempts to render tiles needing updating, starting at given location on given world, for given map. Stops at edge of map and at tiles that don't need updating.
/dynmap cancelrender world: cancels any active fullrender or radiusrender on the given world.
/dynmap purgequeue: clears the tile update queue
/dynmap purgeworld world: purge all the map files for world 'world'
/dynmap purgemap world map: purge all the map files for map 'map' on world 'world'
/dynmap pause all: pause all map rendering (updates and full/radius renders)
/dynmap pause none: resume all map rendering
Statistics

/dynmap stats: shows rendering statistics for all maps on all worlds.
/dynmap stats world : shows rendering statistics for maps on world world.
/dynmap triggerstats : shows triggered render statistics for all worlds.
/dynmap resetstats : resets rendering statistics for all maps on all worlds.
/dynmap resetstats world : resets rendering statistics for maps on world world.
Markers

These commands are only available if the Markers Component has been enabled (v0.22 or later required).

/dmarker add <label> icon:<icon> set:<set-id> : adds a new marker at the player's current location, with a given label and optional icon and optional marker set
/dmarker add id:<id> <label> icon:<icon> set:<set-id> : adds a new marker at the player's current location, with the given ID, the given label and optional icon and optional marker set
/dmarker add id:<id> <label> icon:<icon> set:<set-id> x:<x-coord> y:<y-coord> z:<z-coord> world:<Worldname> : adds a new marker at the given location, with the given ID, the given label and optional icon and optional marker set
/dmarker movehere <label> : updates the location of the first marker matching the given label to match the current player's position
/dmarker movehere id:<id> : updates the location of the marker with the given ID to match the current player's position
/dmarker update <label> icon:<newicon> newlabel:<newlabel> : updates the icon and/or label of the first marker matching the given label
/dmarker update id:<id> icon:<newicon> newlabel:<newlabel> : updates the icon and/or label of the marker with the given ID
/dmarker delete <label> : deletes the first marker matching the given label
/dmarker delete id:<id> : deletes the marker with the given ID
/dmarker list : lists the attributes of all the defined markers in the default marker set
/dmarker list set:<set-id> : lists the attributes of all the defined markers in the given marker set
/dmarker icons : lists the attributes of all the icons defined for use by markers
/dmarker addset <label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : add new marker set with given label (ID = label)
/dmarker addset id:<id> <label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : add new marker set with given ID and label
/dmarker updateset <label> newlabel:<new-label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : update marker set with given label (ID = label)
/dmarker updateset id:<id> newlabel:<new-label> hide:<hide-by-def> prio:<priority> minzoom:<minzoom> : update marker set with given ID
/dmarker deleteset <label> : delete marker set with given label
/dmarker deleteset id:<id> : delete marker set with given ID
/dmarker listsets : list all markers
/dmarker addicon id:<id> <label> file:"filename" : Install new icon, with given ID and label, and using given file (path is handled relative to MC server directory, and file contents are copied).
/dmarker updateicon id:<id> newlabel:<label> file:"filename" : Update icon, replacing existing settings with provided new values.
/dmarker deleteicon id:<id> : delete icon with given ID
/dmarker addcorner : add corner to corner list using current location
/dmarker addcorner <x> <z> <world> : add corner with given x and z coordinate on given world to corner list
/dmarker clearcorners : clear corner list
/dmarker addarea <label> : add new area with given label using corner list
/dmarker addarea id:<id> <label> : add new area with given ID using corner list
/dmarker deletearea <label> : delete area with given label
/dmarker deletearea id:<id> <label> : delete area with given ID
/dmarker listareas : list details of all areas
/dmarker updatearea <label> <arg>:<value> ... : update attributes of area with given label
/dmarker updatearea id:<id> <arg>:<value> ... : update attributes of area with given ID
/dmarker addline <label> : add new line with given label using corner list
/dmarker addline id:<id> <label> : add new line with given ID using corner list
/dmarker deleteline <label> : delete line with given label
/dmarker deleteline id:<id> <label> : delete line with given ID
/dmarker listlines : list details of all lines
/dmarker updateline <label> <arg>:<value> ... : update attributes of line with given label
/dmarker updateline id:<id> <arg>:<value> ... : update attributes of line with given ID
Map/World Configuration Commands

/dmap worldlist : list all worlds configured (enabled or disabled)
/dmap worldset worldname enabled:<true

权限

权限列表
SuperPerms-based access control, including specific support for PermissionsEx, BukkitPermissions, bPermissions, and classic Permissions. The following nodes are defined:

dynmap.render - allows /dynmap render command
dynmap.show.self - allows /dynmap show (on self)
dynmap.show.others - allows /dynmap show
dynmap.hide.self - allows /dynmap hide (on self)
dynmap.hide.others - allows /dynmap hide
dynmap.fullrender - allows /dynmap fullrender or /dynmap fullrender
dynmap.radiusrender - allows /dynmap radiusrender
dynmap.updaterender - allows /dynmap updaterender
dynmap.cancelrender - allows /dynmap cancelrender
dynmap.pause - allows /dynmap pause
dynmap.reload - allows /dynmap reload
dynmap.stats - allows /dynmap stats or /dynmap stats or /dynmap triggerstats
dynmap.resetstats - allows /dynmap resetstats or /dynmap resetstats
dynmap.sendtoweb - allows /dynmap sendtoweb
dynmap.purgequeue - allows /dynmap purgequeue
dynmap.ids-for-ip - allows /dynmap ids-for-ip
dynmap.ips-for-id - allows /dynmap ips-for-id
dynmap.add-id-for-ip - allows /dynmap add-id-for-ip
dynmap.del-id-for-ip - allows /dynmap del-id-for-ip
dynmap.marker.add - allows /dmarker add
dynmap.marker.movehere - allows /dmarker movehere
dynmap.marker.update - allows /dmarker update
dynmap.marker.delete - allows /dmarker delete
dynmap.marker.list - allows /dmarker list
dynmap.marker.icons - allows /dmarker icons
dynmap.marker.addset - allows /dmarker addset
dynmap.marker.updateset - allows /dmarker updateset
dynmap.marker.deleteset - allows /dmarker deleteset
dynmap.marker.listsets - allows /dmarker listsets
dynmap.marker.addicon - allows /dmarker addicon
dynmap.marker.updateicon - allows /dmarker updateicon
dynmap.marker.deleteicon - allows /dmarker deleteicon
dynmap.marker.addarea - allows /dmarker addarea
dynmap.marker.updatearea - allows /dmarker updatearea
dynmap.marker.deletearea - allows /dmarker deletearea
dynmap.marker.listareas - allows /dmarker listareas
dynmap.marker.addline - allows /dmarker addline
dynmap.marker.updateline - allows /dmarker updateline
dynmap.marker.deleteline - allows /dmarker deleteline
dynmap.marker.listlines - allows /dmarker listlines
dynmap.dmap.worldlist - allows /dmap worldlist
dynmap.dmap.worldset - allows /dmap worldset
dynmap.dmap.worldreset - allows /dmap worldreset
dynmap.dmap.mapdelete - allows /dmap mapdelete
dynmap.dmap.mapset - allows /dmap mapset
dynmap.dmap.mapadd - allows /dmap mapadd
dynmap.dmap.perspectivelist - allows /dmap perspectivelist
dynmap.dmap.shaderlist - allows /dmap shaderlist
dynmap.dmap.lightinglist - allows /dmap lightinglist
dynmap.webregister - allows /dynmap webregister
dynmap.webregister.other - allows /dynmap webregister player-id
dynmap.webchat - allows sending of chat messages from web interface (login or id-by-ip required)
dynmap.playermarkers.showall - allows user to see all player positions when protected-player-info has been set to restrict access
dynmap.world.<world-name> - allows user to see maps on world if that world has been set to protected.
dynmap.map.<world-name>.<map-name> - allows user to see specific map on specific world , if that map has been set to be protected.

网页UI参数

使用标记

自定义方块定义

用Wavefront OBJ格式传输世界数据

其他

为了展示API,同时也为了协助管理这个已经非常庞大的补丁,我们已经开始了为Dynmap增加额外补丁的进程。所有这些工作都依赖于经由API的Dynmap和接口,只有对这些功能感兴趣的人们才会添加这些附加功能,这些功能有:

dynmap-mobs: 在dynmap地图上提供指定生物的实时位置。

dynmap-residence: 继承 'regions' (地区)以支持Residence在Dynmap中的使用, 实时更新Residence的改变。

Dynmap-WorldGuard: 继承 'regions' (地区)以支持WorldGuard 在Dynmap中的使用, 实时更新WorldGuard的改变。

Dynmap-Towny: 继承 'regions' (地区)以支持Towny在Dynmap中的使用, 实时更新Towny的改变。

Dynmap-Factions: 继承 'regions' (地区)以支持Factions在Dynmap中的使用, 实时更新Factions的改变。

Dynmap-CommandBook: 使用CommandBook,添加对显示/home和/warp 位置的支持。

Dynmap-Essentials: 使用Essentials,添加对显示/home和/warp 位置的支持。

Dynmap-GriefPrevention: 添加对显示Grief Protection claims(保护占领)的支持。

Dynmap2CraftIRC3: 通过CraftIRC,将Dynmap的网页聊天与IRC相结合。

Dynmap-SimpleClans: Dynmap的网页聊天与SimpleClans 相结合。

Dynmap-HeroChat: 结合Herochat v5.5+ 与Dynmap。

Dynmap-PhysicalShop

Dynmap-pyLandmarks

Dynmap-PreciousStones: 结合PreciousStones 与Dynmap。

Dynmap-AdminCmd: 结合AdminCmd与Dynmap。

Dynmap-PlayerWarp

Dynmap-Citizens: 结合Citizens与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 还有许多页面没有搬运,会尽快补充请谅解