Minecraft SquareMap is a 2D map plugin geared towards performance and simplicity. If you want a 3D map with full-resolution textures, see BlueMap instead. We’re going to cover the basic installation, usage, and troubleshooting of the plugin on a Paper, Fabric, or Sponge server. You can install any of these loaders on WinterNode Minecraft hosting.
Installation
You can grab the latest releases of SquareMap from its GitHub page under the Releases section as show in the image to the right. Each release will have a separate Jar for Paper, Fabric, and Sponge that you’ll need to use for each loader respectively.
After you’ve downloaded the Jar file for the loader you’re using, you’ll need to upload it to your server either Using SFTP or the File Manager. The final step for a basic installation is giving SquareMap its own port. You most likely already have one: new servers come with several ports set up automatically, so check Management → Allocations in the Game Panel first and pick one that isn’t your Primary allocation and isn’t already used by another plugin. You only need to request another port if every one is already in use. See our Additional Ports & Allocations page for how.
You’ll find the Configuration File for SquareMap in your loaders configuration folder such as plugins or config and then SquareMap → config.yml and the option you’ll need to change is labeled settings → internal-webserver → port, with the port option itself being on line 6 for configuration version 2.
Adding a map to the config
By default you’ll have a map for every world on your server, but if you want to change specific World Map settings like it’s order in the world list, it’s icon in the list, it’s render height, or it’s name, then it’ll need a specific entry in the config.
You can also disable all Worlds by default and enable specific Worlds that you want a map for by changing the default World Map entry labeled default to false. The config entry you’re looking for is located at world-settings → default → map → enabled.
You can add a new entry to the World Map configuration by copying config entries from the default World Map config or the Wiki’s Default Config Section. The key point that each section must be named with the world name using the minecraft: prefix. For example, an entry adding the vanilla overworld dimension would use minecraft:overworld to name the section.
After adding the entry name, you need to add either enabled: true or enabled: false as it’s first sub-entry. From there you can configure the World Map using any of the options shown in the default World Map config or on the wiki.