Add a web map to your server

Supported web maps

There are multiple web maps plugins/mods out there like Dynmap, Bluemap, or Squaremap. At the moment, Aternos only supports Squaremap for your Minecraft server. Dynmap and Bluemap aren't supported at the moment. The following steps show you how to configure SquareMap for your server.

Use server software for mods or plugins

To install SquareMap, you first need to switch to server software that supports installing mods or plugins. SquareMap exists both as a mod and as a plugin, so you can choose whatever fits your needs better.

• Install plugins (Minecraft: Java Edition)
• Install mods (Minecraft: Java Edition)

Install SquareMap and start your server

After setting up your server software, search for "SquareMap" in the mod/plugin browser and install a compatible version. 

You can then start your server, which will automatically create the SquareMap config file.

Configure SquareMap

For SquareMap to work on Aternos, you need to configure it correctly. The location of the config file depends on whether you are using it as a plugin (Spigot/PaperMC) or as a mod (Fabric/Forge/NeoForge):

• Plugin: /plugins/squaremap/config.yml
• Mod: /squaremap/config.yml

In the config file, set the port to 80 and the web-address to your server address (e.g. https://example.aternos.me):

settings:
    web-address: https://example.aternos.me
    internal-webserver:
        port: 80

All other options can remain unchanged.

Restart your server and access your web map

After updating the config file, restart your server to apply the changes. Once your server is running, you can open your web map by entering your server address (e.g. example.aternos.me) in your browser. You can also share this address with your players.