Skip to content

Commit a6b1b6f

Browse files
authored
Update FAQ.md
1 parent ec72ffe commit a6b1b6f

File tree

1 file changed

+27
-37
lines changed

1 file changed

+27
-37
lines changed

wiki/FAQ.md

Lines changed: 27 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -31,30 +31,6 @@ on the map. Also make sure to click `Update Map` in the menu on the left to make
3131
Please make sure to read the changelog, as there may be more steps necessary than just swapping out the .jar file.
3232
Those steps will be clearly listed on the update page.
3333

34-
### Q: Why is BlueMap using so much of my CPU?
35-
When you install BlueMap for the first time, it needs to convert all of your world(s) into 3d models.
36-
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.
37-
38-
In the BlueMap config file `core.conf` you can set how many threads BlueMap will use for the conversion process.
39-
BlueMap runs asynchronously to your server-thread, so as long as the CPU isn't maxed out, it should not slow down your server.
40-
41-
After the conversion process is done for the first time, it won't ever have to render the whole map again!
42-
From then on, BlueMap will keep track of your world and convert only the chunks that change.
43-
44-
If you do `/bluemap`, you can see the progress of the conversions and an estimated time that is left.
45-
46-
### Q: I have black/pink-checkered blocks on my map!
47-
Read this: [https://bluemap.bluecolored.de/wiki/customization/Mods.html](https://bluemap.bluecolored.de/wiki/customization/Mods.html)
48-
49-
### 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-
5834
### Q: I have a black map / a lot of the map is missing!
5935
- Press the `Update Map` button in BlueMap's menu. This updates all tiles from the server and makes sure your
6036
browser has not cached anything weird.
@@ -84,6 +60,21 @@ This will ignore potentially missing light data while rendering, with some drawb
8460
- Cave-rendering will always be enabled in those chunks, because it is using the sun-light data to detect the "caves"
8561
- Everything in those chunks will be rendered fully lit (sun-light value of 15, looks similar to having night-vision)
8662

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!
76+
Read this: [https://bluemap.bluecolored.de/wiki/customization/Mods.html](https://bluemap.bluecolored.de/wiki/customization/Mods.html)
77+
8778
### Q: The map (web-app) has low FPS (lagging)
8879
Make sure you have **hardware-acceleration enabled** on your browser!
8980
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.
10798
If you're certain the connection speed between your server and you is adequate,
10899
make sure you're on the latest version of BlueMap, as there may have been optimisations since.
109100

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+
110113
### Q: How can I add or remove maps?
111114
To add a map, copy a map-config from the `maps`-folder next to the other config-files, open it and tweak the settings
112115
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,
117120
but you can e.g. [use NGINX to reverse-proxy your map]({{site.baseurl}}/wiki/webserver/NginxProxy.html)
118121
and add SSL that way.
119122

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-
133123
### Q: How do I add authentication to my map?
134124
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/).
135125

0 commit comments

Comments
 (0)