You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
### Q: My block-textures are messed up when I zoom in on the map!
50
-
First, press the `Update Map` button in BlueMap's menu. This updates all tiles from the server and makes sure
51
-
your browser has not cached anything weird.
52
-
You can also try to clear your browser-cache completely. *(`F12` -> Network -> [x] Disable cache -> `F5`)*
53
-
54
-
If that doesn't help, you might have changed some BlueMap-settings that require a complete re-render of the map:
55
-
Just use `/bluemap purge <map-id>` to delete and re-render the entire map. Then clear your browser-cache again,
56
-
and it should be fixed :)
57
-
58
34
### Q: I have a black map / a lot of the map is missing!
59
35
- Press the `Update Map` button in BlueMap's menu. This updates all tiles from the server and makes sure your
60
36
browser has not cached anything weird.
@@ -84,6 +60,21 @@ This will ignore potentially missing light data while rendering, with some drawb
84
60
- Cave-rendering will always be enabled in those chunks, because it is using the sun-light data to detect the "caves"
85
61
- Everything in those chunks will be rendered fully lit (sun-light value of 15, looks similar to having night-vision)
86
62
63
+
### Q: My map is only loading in low resolution!
64
+
This happens when your webapp can't load the high-resolution tiles for some reason.
65
+
This could be caused by one of these things:
66
+
- You have updated BlueMap, but did not update BlueMap's webapp properly.
67
+
Try to delete the `<webroot>/index.html` and reload BlueMap.
68
+
- You disabled the hires tiles in your map config.
69
+
Set `enable-hires` to `true` in your map config and purge your map so bluemap re-renders it with the hires tiles enabled.
70
+
- You haven't set up your external webserver correctly.
71
+
Please make sure you've read the [External Webservers]({{site.baseurl}}/wiki/webserver/) guide to see how to do that.
72
+
73
+
If you're still having issues, please visit [#support](https://discord.com/channels/665868367416131594/751804128749027421) in our [Discord](https://bluecolo.red/map-discord).
74
+
75
+
### Q: I have black/pink-checkered blocks on my map!
Make sure you have **hardware-acceleration enabled** on your browser!
89
80
Use your favorite search engine to learn how to do this :)
@@ -107,6 +98,18 @@ to check how long each request is taking, and where the bottleneck is.
107
98
If you're certain the connection speed between your server and you is adequate,
108
99
make sure you're on the latest version of BlueMap, as there may have been optimisations since.
109
100
101
+
### Q: Why is BlueMap using so much of my servers CPU?
102
+
When you install BlueMap for the first time, it needs to convert all of your world(s) into 3d models.
103
+
This is a pretty intensive process, so it's not strange at all to see BlueMap using up a lot of CPU power for a while after it's been installed.
104
+
105
+
In the BlueMap config file `core.conf` you can set how many threads BlueMap will use for the conversion process.
106
+
BlueMap runs asynchronously to your server-thread, so as long as the CPU isn't maxed out, it should not slow down your server.
107
+
108
+
After the conversion process is done for the first time, it won't ever have to render the whole map again!
109
+
From then on, BlueMap will keep track of your world and convert only the chunks that change.
110
+
111
+
If you do `/bluemap`, you can see the progress of the conversions and an estimated time that is left.
112
+
110
113
### Q: How can I add or remove maps?
111
114
To add a map, copy a map-config from the `maps`-folder next to the other config-files, open it and tweak the settings
112
115
for your new map. To remove a map, just delete the config-file.
@@ -117,19 +120,6 @@ BlueMaps integrated webserver does not (and will not) support SSL on its own,
117
120
but you can e.g. [use NGINX to reverse-proxy your map]({{site.baseurl}}/wiki/webserver/NginxProxy.html)
118
121
and add SSL that way.
119
122
120
-
### Q: My map disappears when I zoom in!
121
-
This happens when BlueMap is trying to load the hi-res tiles, but can't find them for some reason.
122
-
This could be caused by one of these things:
123
-
- You have updated BlueMap, but did not update BlueMap's webapp properly.
124
-
Try to delete the `<webroot>/index.html` and reload BlueMap.
125
-
- You've set `save-hires-layer` to `false` in your map's config.
126
-
If this is the case, make sure to set the `hires-slider-default` to `0` in `webapp.conf` and set the
127
-
"Render Distance - Hires Layer" slider down to `0` in the webapps settings-menu.
128
-
- You haven't set up your external webserver correctly.
129
-
Please make sure you've read the [External Webservers]({{site.baseurl}}/wiki/webserver/) guide to see how to do that.
130
-
131
-
If you're still having issues, please visit [#support](https://discord.com/channels/665868367416131594/751804128749027421) in our [Discord](https://bluecolo.red/map-discord).
132
-
133
123
### Q: How do I add authentication to my map?
134
124
BlueMap does not support authentication by itself. Instead, you could use [http-basic-auth using an external webserver](https://docs.nginx.com/nginx/admin-guide/security-controls/configuring-http-basic-authentication/).
0 commit comments