Skip to content

Commit 782143d

Browse files
committed
feat(release): Add BlueMap configuration files and Helm release setup
1 parent 32c9070 commit 782143d

File tree

18 files changed

+981
-2
lines changed

18 files changed

+981
-2
lines changed
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
## ##
2+
## BlueMap ##
3+
## Core-Config ##
4+
## ##
5+
6+
# By changing the setting (accept-download) below to TRUE you are indicating that you have accepted mojang's EULA (https://account.mojang.com/documents/minecraft_eula),
7+
# you confirm that you own a license to Minecraft (Java Edition)
8+
# and you agree that BlueMap will download and use a minecraft-client file (depending on the minecraft-version) from mojangs servers (https://piston-meta.mojang.com/) for you.
9+
# This file contains resources that belong to mojang and you must not redistribute it or do anything else that is not compliant with mojang's EULA.
10+
# BlueMap uses resources in this file to generate the 3D-Models used for the map and texture them. (BlueMap will not work without those resources.)
11+
# 2025-08-14T10:51:51
12+
accept-download: true
13+
14+
# The folder where bluemap saves data-files it needs during runtime or to save e.g. the render-progress to resume it later.
15+
# Default is "bluemap"
16+
data: "bluemap"
17+
18+
# This changes the amount of threads that BlueMap will use to render the maps.
19+
# A higher value can improve render-speed but could impact performance on the host machine.
20+
# This should be always below or equal to the number of available processor-cores.
21+
# Zero or a negative value means the amount of available processor-cores subtracted by the value.
22+
# (So a value of -2 with 6 cores results in 4 render-processes)
23+
# Default is 1
24+
render-thread-count: 3
25+
26+
# Controls whether BlueMap should try to find and load mod-resources and datapacks from the server/world-directories.
27+
# Default is true
28+
scan-for-mod-resources: true
29+
30+
# If this is true, BlueMap might send really basic metrics reports containing only the implementation-type and the version that is being used to https://metrics.bluecolored.de/bluemap/
31+
# This allows me to track the basic usage of BlueMap and helps me stay motivated to further develop this tool! Please leave it on :)
32+
# An example report looks like this: {"implementation":"bukkit","version":"5.11","mcVersion":"?"}
33+
# Default is true
34+
metrics: true
35+
36+
# Config-section for debug-logging
37+
log: {
38+
# The file where the debug-log will be written to.
39+
# Comment out to disable debug-logging completely.
40+
# Java String formatting syntax can be used to add time, see: https://docs.oracle.com/javase/8/docs/api/java/util/Formatter.html
41+
# Default is no logging
42+
file: "bluemap/logs/debug.log"
43+
#file: "bluemap/logs/debug_%1$tF_%1$tT.log"
44+
45+
# Whether the logger should append to an existing file, or overwrite it
46+
# Default is false
47+
append: false
48+
}
Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
apiVersion: kustomize.config.k8s.io/v1beta1
2+
kind: Kustomization
3+
namespace: bluemap
4+
generatorOptions:
5+
disableNameSuffixHash: true
6+
resources:
7+
- ../../../../../apps/base/bluemap/
8+
patches:
9+
- path: release.yaml
10+
11+
configMapGenerator:
12+
- name: bluemap-config
13+
files:
14+
- core.conf
15+
- name: bluemap-maps
16+
files:
17+
- maps/world.conf
18+
- maps/world_nether.conf
19+
- maps/world_the_end.conf
20+
- maps/world_op.conf
21+
- maps/world_op_nether.conf
22+
secretGenerator:
23+
- name: s3-conf
24+
files:
25+
- s3.conf
Lines changed: 162 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,162 @@
1+
## ##
2+
## BlueMap ##
3+
## Map-Config ##
4+
## ##
5+
6+
# The path to the save-folder of the world to render.
7+
# (If this is not defined (commented out or removed), the map will be only registered to the web-server and the web-app
8+
# but not rendered or loaded by BlueMap. This can be used to display a map that has been rendered somewhere else.)
9+
# world: "world"
10+
11+
# The dimension of the world. Can be "minecraft:overworld", "minecraft:the_nether", "minecraft:the_end"
12+
# or any dimension-key introduced by a mod or datapack.
13+
dimension: "minecraft:overworld"
14+
15+
# The display-name of this map -> how this map will be named on the webapp.
16+
# You can change this at any time.
17+
# Default is the id of this map
18+
name: "world (overworld)"
19+
20+
# A lower value makes the map sorted first (in lists and menus), a higher value makes it sorted later.
21+
# The value needs to be an integer but it can be negative.
22+
# You can change this at any time.
23+
# Default is 0
24+
sorting: 0
25+
26+
# The position on the world where the map will be centered if you open it.
27+
# You can change this at any time.
28+
# This defaults to the world-spawn if you don't set it.
29+
#start-pos: {x:500, z:-820}
30+
31+
# The color of the sky as a hex-color
32+
# You can change this at any time.
33+
# Default is "#7dabff"
34+
sky-color: "#7dabff"
35+
36+
# The color of the void as a hex-color
37+
# You can change this at any time.
38+
# Default is "#000000"
39+
void-color: "#000000"
40+
41+
# Defines the initial sky-light-strength the map will be set to when it is opened.
42+
# 0 is no sky-light, 1 is fully lighted.
43+
# You can change this at any time.
44+
# Default is 1
45+
sky-light: 1
46+
47+
# Defines the ambient light-strength that every block is receiving, regardless of the sunlight/blocklight.
48+
# 0 is no ambient light, 1 is fully lighted.
49+
# You can change this at any time.
50+
# Default is 0
51+
ambient-light: 0.1
52+
53+
# BlueMap tries to omit all blocks that are below this Y-level and are not visible from above-ground.
54+
# More specific: Block-Faces that have a sunlight/skylight value of 0 are removed.
55+
# This improves the performance of the map on slower devices by a lot, but might cause some blocks to disappear that should normally be visible.
56+
# Changing this value requires a re-render of the map.
57+
# Set to a very high value to remove caves everywhere (e.g. 10000)
58+
# Set to a very low value to remove nothing and render all caves (e.g. -10000)
59+
# Default is 55 (slightly below water-level)
60+
remove-caves-below-y: 55
61+
62+
# This is the amount of blocks relative to the "ocean-floor" heightmap that the cave-detection will start at.
63+
# Everything above that (heightmap-relative) y-level will not be removed.
64+
# Comment or set to a very high value to disable using the ocean-floor heightmap for cave-detection.
65+
# Changing this value requires a re-render of the map.
66+
# Defaults to 10000 (disabled)
67+
cave-detection-ocean-floor: -5
68+
69+
# With this value set to true, BlueMap also uses the block-light value (additionally to the sky-light) to "detect caves".
70+
# (See: remove-caves-below-y)
71+
# Changing this value requires a re-render of the map.
72+
# Default is false
73+
cave-detection-uses-block-light: false
74+
75+
# The minimum "inhabitedTime" value that a chunk must have to be rendered.
76+
# The "inhabitedTime" value of a chunk refers to the cumulative number of ticks players have been near this chunk.
77+
# If you set this to a value greater than 0, bluemap will only render chunks that players have visited already.
78+
# Default is 0
79+
min-inhabited-time: 0
80+
81+
# With the render-mask you can limit the map-render.
82+
# This can be used to render only a certain part of a world or ignore the nethers ceiling.
83+
# If you change the render-mask, bluemap automatically tries to update the map,
84+
# including deleting map-tiles which are outside the new limits.
85+
# You can use "/bluemap fix-edges <map>" to fix any remaining issues.
86+
#
87+
# Please check out the wiki for more detailed information on how to configure this:
88+
# https://bluemap.bluecolored.de/wiki/customization/Masks.html
89+
#
90+
# Default is no mask, bluemap will render everything that exists.
91+
render-mask: [
92+
{
93+
#min-x: -4000
94+
#max-x: 4000
95+
#min-z: -4000
96+
#max-z: 4000
97+
#min-y: 50
98+
#max-y: 100
99+
}
100+
]
101+
102+
# Using this, BlueMap pretends that every Block outside of the defined render-mask is AIR,
103+
# this means you can see the blocks where the world is cut (instead of having a see-through/xray view).
104+
# This has only an effect if you set some render-mask above.
105+
# Changing this value requires a re-render of the map.
106+
# Default is true
107+
render-edges: true
108+
109+
# The sun-light strength that blocks at map-edges will recieve if render-edges is enabled.
110+
# Should be a value between 0 and 15
111+
# Default is 15
112+
edge-light-strength: 8
113+
114+
# Whether the perspective view will be enabled for this map.
115+
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and free-flight view is disabled.
116+
# Default is true
117+
enable-perspective-view: true
118+
119+
# Whether the flat (isometric, top-down) view will be enabled for this map.
120+
# Having only flat-view enabled while disabling free-flight and perspective will speed up the render and reduce the maps storage-size.
121+
# Default is true
122+
enable-flat-view: true
123+
124+
# Whether the free-flight view will be enabled for this map.
125+
# Changing this to true requires a re-render of the map, only if the hires-layer is enabled and perspective view is disabled.
126+
# Default is true
127+
enable-free-flight-view: true
128+
129+
# Whether the hires-layer will be enabled.
130+
# Disabling this will speed up rendering and reduce the size of the map-files a lot.
131+
# But you will not be able to see the full 3d-models if you zoom in on the map.
132+
# Changing this to false will not remove any existing tiles, existing tiles just won't get updated anymore.
133+
# Changing this to true will require a re-render of the map.
134+
# Default is true
135+
enable-hires: true
136+
137+
# This defines the storage-config that will be used to save this map.
138+
# You can find your storage configs next to this config file in the 'storages'-folder.
139+
# Changing this value requires a re-render of the map. The map in the old storage will not be deleted.
140+
# Default is "file"
141+
storage: "s3"
142+
143+
# Normally BlueMap detects if a chunk has not yet generated it's light-data and omits rendering those chunks.
144+
# If this is set to true BlueMap will render Chunks even if there is no light-data!
145+
# This can be useful for example if some mod prevents light-data from being saved correctly.
146+
# However, this also has a few drawbacks:
147+
# - For those chunks, every block will always be fully lit
148+
# - Night-mode might not work correctly
149+
# - Caves will always be rendered (ignoring the 'renderCaves' setting)
150+
# Default is false
151+
ignore-missing-light-data: false
152+
153+
# Here you can define any static marker-sets with markers that should be displayed on the map.
154+
# You can change this at any time.
155+
# If you need dynamic markers, you can use any plugin that integrates with BlueMap's API.
156+
# Here is a list: https://bluemap.bluecolored.de/community/3rdPartySupport.html
157+
marker-sets: {
158+
159+
# Please check out the wiki for information on how to configure this:
160+
# https://bluemap.bluecolored.de/wiki/customization/Markers.html
161+
162+
}

0 commit comments

Comments
 (0)