# Dynmap



# Installation and usage

### **Prerequisites**

Spigot/Paper 1.10.2+ (This guide makes use of 1.19.4)

Java 11+ (This guide makes use of Java 17+)

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/nBpimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/nBpimage.png)

[ ![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/Mmwimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/Mmwimage.png)

---

Additional port allocation (In this guide the port is 25663)

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/sn8image.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/sn8image.png)

---

Free storage (a lot)

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/yFaimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/yFaimage.png)

---

### **Installation**

Download [dynmap](https://modrinth.com/plugin/dynmap)

Upload it in the `plugins` folder, from the File Manager.

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/QJYimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/QJYimage.png)

(Re)start the server to load the plugin. You'll know it loaded successfully if it generated a folder named "dynmap"

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/WMHimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/WMHimage.png)

---

#### **Web Server**

**In the `Configuration.txt`, located at `plugins/dynmap/Configuration.txt`:**

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/yBKimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/yBKimage.png)

Find (use CTRL + F shortcut) `webserver-port` field within the file.

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/gyLimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/gyLimage.png)

Change the port's value to your additional port allocation's value.

[![image.png](https://help.alienhost.net/uploads/images/gallery/2024-12/scaled-1680-/zq4image.png)](https://help.alienhost.net/uploads/images/gallery/2024-12/zq4image.png)

Restart the server to apply the changes

# Changing Storage Type (Optimization)

### **What is this chapter about?**

In this chapter I'll help you optimize Dynmap. The default configuration is not the best, it can be improved and that's what we are doing.

#### **Changing Storage Provider**

By default the storage type is set to `filetree` (As shown by the following image).

The configuration is located at `plugins/dynmap/configuration.txt`.

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/h4Rimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/h4Rimage.png)

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/ckximage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/ckximage.png)

##### **SQLite**

We would suggest you to switch over to SQLite if you were using the default `filetree` storage.

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/Fciimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/Fciimage.png)

- Change `type` to sqlite (case non-sensitive)
- Make sure `type` and `dbfile` are the only enabled settings (to comment lines out, put a `#` in front of the line.
- `dbfile` allows you to customize the database's name. Doesn't have any performance impact. <span style="color: rgb(224, 62, 45);">The file's extension must be</span> `<span style="color: rgb(224, 62, 45);">.db</span>`.
- When using **Fabric/Forge** you'll need to make use of [Kosmolot's SQLite mod](https://www.curseforge.com/minecraft/mc-mods/sqlite-jdbc).

##### **MySQL**

Another option is `MySQL` we don't really suggest you to use this for DynMap due to network latency and other external factors

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/XSximage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/XSximage.png)

- Change `type` to mysql (case non-sensitive)
- Change the other highlighted values to the ones generated. [Refer to this guide](https://help.alienhost.net/books/game-panel/page/databases).
- Now save the file and restart the server to have the new storage type applied.

# Changing the resolution of the map (Optimization)

<table border="1" id="bkmrk-possible-values-desc" style="border-collapse: collapse; width: 100%; height: 453.781px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><tbody><tr style="height: 73.4375px;"><td style="height: 73.4375px;">#### **Possible values**

</td><td style="height: 73.4375px;">#### **Description**

</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**`vlowres`**</td><td style="height: 46.5938px;">Uses the HDMap renderer with view from the SE with the "vlowres" resolution (2 pixels per block edge)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**`lowres`**</td><td style="height: 46.5938px;">Uses the HDMap renderer with view from the SE with the "lowres" resolution (4 pixels per block edge)</td></tr><tr style="height: 46.5938px;"><td style="height: 46.5938px;">**`hires`**</td><td style="height: 46.5938px;">Uses the HDMap renderer with view from the SE with the "hires" resolution (16 pixels per block edge)</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**`low_boost_hi`**</td><td style="height: 80.1875px;">Uses the HDMap renderer with view from the SE with the "lowres" resolution (4 pixels per block edge), with boosted tiles  
rendered at "hires" (16 pixels per block edge)</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**`hi_boost_vhi`**</td><td style="height: 80.1875px;">Uses the HDMap renderer with view from the SE with the "hires" resolution (16 pixels per block edge), with resolution boosted  
tiles rendered at 'vhires' resolution (32 pixels perblock edge)</td></tr><tr style="height: 80.1875px;"><td style="height: 80.1875px;">**`hi_boost_xhi`**</td><td style="height: 80.1875px;">Uses the HDMap renderer with view from the SE with the "hires" resolution (16 pixels per block edge), with resolution boosted  
tiles rendered at 'xhires' resolution (64 pixels perblock edge)</td></tr></tbody></table>

---

#### **Brief Explanation**

These values allow you to either save storage (**vlowres** saves the most) or have a high quality map (**hi\_boost\_xhi** provides the best quality/resolution for the map).

#### **Which option should I choose?**

The default value is **hires.** That probably works for most server owners. But for those who lack storage, they may be prompted to pick a "storafe saver" option such as **vlowres** or **lowres.**

Additionally High Resolution maps take a lot of time to render (and an exhorbitant amount of storage).

#### **Where and how to change the resolution**

Through the use of the File Manager, reach the following path: `/<span class="FileManagerBreadcrumbs___StyledSpan-sc-1yfrkfk-2 gkgxcJ">home</span>/container/plugins/<span class="FileManagerBreadcrumbs___StyledSpan2-sc-1yfrkfk-5 dMBayU">dynmap</span>` (NOTE: This is the path for Spigot/Paper servers. These are all folders), where you'll find a text file named `configuration.txt`. Open it.

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-07/scaled-1680-/U9Vimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-07/U9Vimage.png)

Now change `deftemplatesuffix` with one of the values given at the beggining of this article. Save the file with the `Save content` button and restart the server through the console.

#### **Examples**

**Very Low Resolution:**

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-01/scaled-1680-/image.png)](https://help.alienhost.net/uploads/images/gallery/2025-01/image.png)

---

**Low Resolution:**

[![image.png](https://help.alienhost.net/uploads/images/gallery/2025-01/scaled-1680-/mEKimage.png)](https://help.alienhost.net/uploads/images/gallery/2025-01/mEKimage.png)