Skip to content

feat(webapp): URL query param controls for embed use cases#793

Open
Apezdr wants to merge 1 commit intoBlueMap-Minecraft:masterfrom
Apezdr:feat/url-embed-params
Open

feat(webapp): URL query param controls for embed use cases#793
Apezdr wants to merge 1 commit intoBlueMap-Minecraft:masterfrom
Apezdr:feat/url-embed-params

Conversation

@Apezdr
Copy link
Copy Markdown

@Apezdr Apezdr commented Apr 25, 2026

Summary

Adds URL query parameter support to show/hide individual UI elements, making BlueMap much more useful as an embedded iframe. All params default to true so existing deployments are completely unaffected.

Changes

  • New EmbedParams.js utility parses query params once at load time
  • App.vue gates ControlBar, ZoomButtons, and MainMenu on their respective params
  • ControlBar.vue gates each individual button on its own param

Supported params

Param Hides
?controls=false Entire top control bar
?menu=false Menu button + side panel
?zoom=false Zoom buttons
?maps=false Maps button
?markers=false Markers button
?players=false Players button
?daynight=false Day/night switch
?controlsswitch=false View controls switch
?resetcamera=false Reset camera button
?position=false Position input
?compass=false Compass

Example

Minimal embed with no UI chrome:

<iframe src="https://example.com/bluemap/?controls=false&menu=false&zoom=false#world:0:64:0:100:0:0:0:0:0"></iframe>

Adds ?param=false URL params to show/hide individual UI elements,
allowing iframes and embeds to strip down the UI as needed.

Supported params (all default true):
  controls, menu, zoom, maps, markers, players,
  daynight, controlsswitch, resetcamera, position, compass
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant