Upstream/dynmap
1
0
Fork 0
mirror of https://github.com/webbukkit/dynmap.git synced 2024-11-28 13:15:30 +01:00
Code Issues Projects Releases Wiki Activity

Complete Redo of Page

BlackAsLight 2021-09-25 00:38:13 +10:00
parent 2a787f082c
commit 203a9558b5
2 changed files with 32 additions and 30 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
Installation-Setup-of-Dynmap-on-Linux.md Normal file

@ -0,0 +1,32 @@
These instructions are for the internal web server Dynmap starts up on a Linux based distribution. They are basic in nature and do not go into the customisation you can do to Dynmap.
1. Download the latest `Dynmap.jar` file, for your type of server, and place it into the `./server/plugins/` or `./server/mods/` directory.
- [Bukkit/Spigot/Paper](https://www.spigotmc.org/resources/dynmap.274/)
- [Forge/Fabric](https://www.curseforge.com/minecraft/mc-mods/dynmapforge/files)
- [dynmap.us](https://dynmap.us/builds/dynmap/?C=M;O=D)
2. Startup or restart your server for Dynmap. **DO NOT** ever `/reload` your server. This will break Dynmap and a restart will be required to fix it.
3. Check the server console and make sure Dynmap says `Web server started on address 0.0.0.0:8123`
4. While logged into Minecraft and on the server, type `/dynmap radiusrender 100`.
- This will tell Dynmap to render a small area around where your player currently is in your world so you can actually see something on the map instead of a black screen.
5. If the server is hosted locally on the same machine you're on, open a web browser and go to http://localhost:8123/.
6. If it's not hosted locally or to allow other people to view the map, they'll need to go to `http://<Server IP>:8123/`.
- Make sure it's HTTP and not HTTPS. Some browsers or browser extensions switch to HTTPS automatically and at this moment, Dynmap will not work on HTTPS.
- Replace `<Server IP>` with your server IP.
7. If you get a took too long to respond error then the router/firewall of the machine the server is running on is blocking you from connecting. You'll need to [Port Forward](https://portforward.com/) and/or check the machine's firewall to allow port 8123.
8. At this point Dynmap should be working properly. You should have received the "web server started" message, and able to view a small part of the map as well as players. Now you'll want to do `/dynmap fullrender` so the entire map appears.
*Note 1: Dynmap does not generate chunks. It only renders images of chunks that exist. If you'd like more of the world visible than you can either download, install, and run a pre-generator [plugin](https://duckduckgo.com/?t=ffab&q=pregenerator+plugin&atb=v265-1&ia=web)/[mod](https://duckduckgo.com/?q=pregenerator+mod&t=ffab&atb=v265-1&ia=web) or explore your world. If you go with the pre-generator then when it's done you'll want to `/dynmap purgeworld` **then** `/dynmap fullrender`.*
*Note 2: If you're using a custom world, like an earth map, or one made with world painter, you'll need to download, install, and run a pre-generator [plugin](https://duckduckgo.com/?t=ffab&q=pregenerator+plugin&atb=v265-1&ia=web)/[mod](https://duckduckgo.com/?q=pregenerator+mod&t=ffab&atb=v265-1&ia=web) as those worlds are missing some data that doesn't get added until the chunks are loaded and as a result Dynmap is unable to see those chunks as existing without said data.*
# External Web Server
If you'd like to use an external web server then these tutorials are available to you:
- Apache2 for Debian/Ubuntu: [[Dynmap with Apache httpd on Arch Linux]]
- Apache/httpd for Arch Linux: [[Dynmap with apache2 on Debian]]
- Lighttpd for Arch Linux: [[Dynmap with lighttpd on Arch Linux]]
- Nginx: [[Dynmap with Nginx]] (courtesy of cryptk)
# HTTPS-ing / Port Omitting / Custom Domain
If you're running the internal web server instead of an external one and you'd like to HTTPS your connection to Dynmap, omit the port from your link or replace the IP with your own domain that you own then you can setup [[Nginx as a Reverse Proxy]]

30
Setting-up-the-Dynamic-Map-plugin-under-Linux.md

@ -1,30 +0,0 @@
This page assumes:
* Your Minecraft-server directory to be: `/opt/minecraft_server/`.
* You have the latest CraftBukkit installed.
* Your Minecraft server is hosted at `localhost`.
To install and test dynmap:
* Copy the file `dynmap.jar` and the folder `dynmap` to `/opt/minecraft_server/plugins/`.
* (Re)start your Minecraft server.
* Join your Minecraft server.
* Place a few blocks.
* Open up your browser.
* Navigate to *http://localhost:8123/*.
You should see your map with your name in the top-left. Once you click on your name, the map will pan to your location and your should see a part of the map that has been generated.
# Publishing #
If you want the map to be accessible for others, you have two options:
* Forward an external port to your internal minecraft server with TCP port 8123. For more information on port-forwarding: http://portforward.com/.
* Host the map partly on your big webserver. Note that the webserver must already have access to the Minecraft server. See below.
# Big Webservers #
If you are hosting a Apache or lighttpd server, you might want to be able to get to the Dynmap-map from the same url as your website. Like *http://www.yourwebsite.com/dynmap/* instead of *http://www.yourwebsite.com:8123/*. If this is the case, you can pick your webserver from the list below.
* apache2 under Debian/Ubuntu: [[Dynmap with Apache httpd on Arch Linux]]
* apache/httpd under Arch Linux: [[Dynmap with apache2 on Debian]]
* lighttpd under Arch Linux: [[Dynmap with lighttpd on Arch Linux]]
* nginx [[Dynmap with Nginx]] (courtesy of cryptk)