Public landing page live map; docs for Discord, live embeds, email

panel/server/src/routes/mod.rs

@@ -65,6 +65,8 @@ pub fn api(state: &AppState) -> Router<AppState> {
         .route("/guilds/{id}/invites", post(map::send_invite))
         .route("/leaderboard", get(servers::global_leaderboard))
         .route("/landing", get(landing::public_landing))
+        .route("/public/map/{id}", get(worldmap::public_info))
+        .route("/public/map/{id}/overlay", get(worldmap::public_overlay))
         .route("/email/unsubscribe", get(emails::unsubscribe))
         .route("/launcher/authlib-injector.json", get(account::authlib_index))
         .route("/launcher/authlib-injector.jar", get(account::authlib_jar))

panel/server/src/routes/worldmap.rs

@@ -171,3 +171,49 @@ pub async fn tile(State(state): State<AppState>, Path((id, dim, z, x, file)): Pa
     }
     resp
 }
+
+// ---------------------------------------------------------------------------
+// Public map (landing page)
+// ---------------------------------------------------------------------------
+
+/// The landing page's map section decides what the public may see. Without an enabled map section, nothing is public.
+async fn landing_map(state: &AppState, requested: i64) -> AppResult<(i64, Value)> {
+    let cfg = crate::routes::landing::get_config(state).await?;
+    let block = cfg.blocks.iter().find(|b| b.block_type == "map" && b.enabled).ok_or_else(|| AppError::not_found("no public map"))?;
+    let wanted = block.options.get("server_id").and_then(|v| v.as_i64().or_else(|| v.as_str().and_then(|s| s.parse().ok()))).unwrap_or(0);
+    let id: i64 = if wanted > 0 {
+        wanted
+    } else {
+        sqlx::query_scalar("SELECT COALESCE(MIN(id), 0) FROM game_servers WHERE live_map_enabled = 1").fetch_one(&state.db).await?
+    };
+    if id == 0 || (requested != 0 && requested != id) {
+        return Err(AppError::not_found("no public map"));
+    }
+    let server = get_server(state, id).await?;
+    if !server.map_enabled {
+        return Err(AppError::not_found("no public map"));
+    }
+    let flag = |key: &str, default: bool| block.options.get(key).and_then(|v| v.as_bool().or_else(|| v.as_str().map(|s| s == "true"))).unwrap_or(default);
+    Ok((id, json!({ "claims": flag("show_claims", true), "pins": flag("show_pins", true), "players": flag("show_players", false) })))
+}
+
+/// `GET /api/v1/public/map/{server}`: tile key and dimensions for the landing page map (0 = the server the page chose).
+pub async fn public_info(State(state): State<AppState>, Path(requested): Path<i64>) -> AppResult<Json<Value>> {
+    let (id, layers) = landing_map(&state, requested).await?;
+    let mut v = info(&state, id, true).await;
+    v["server_id"] = json!(id);
+    v["layers"] = layers;
+    Ok(Json(v))
+}
+
+pub async fn public_overlay(State(state): State<AppState>, Path(requested): Path<i64>) -> AppResult<Json<Value>> {
+    let (id, layers) = landing_map(&state, requested).await?;
+    let overlay = state.worldmap.overlay(id);
+    let on = |k: &str| layers[k].as_bool().unwrap_or(false);
+    Ok(Json(json!({
+        "players": if on("players") { json!(state.worldmap.live_players(id)) } else { json!([]) },
+        "claims": if on("claims") { overlay.get("claims").cloned().unwrap_or(json!([])) } else { json!([]) },
+        "pins": if on("pins") { overlay.get("pins").cloned().unwrap_or(json!([])) } else { json!([]) },
+        "updated": state.worldmap.stats(id).last_overlay_at,
+    })))
+}

panel/server/tests/public_map.rs

@@ -0,0 +1,52 @@
+mod common;
+use common::*;
+
+fn tile(zoom: u8, x: i32, y: i32) -> Vec<u8> {
+    let png = [0x89, b'P', b'N', b'G', 0x0d, 0x0a, 0x1a, 0x0a, 1, 2, 3, 4];
+    let mut v = vec![zoom];
+    v.extend(x.to_be_bytes());
+    v.extend(y.to_be_bytes());
+    v.extend((png.len() as u32).to_be_bytes());
+    v.extend(png);
+    v
+}
+
+#[tokio::test]
+async fn the_landing_page_decides_what_the_public_sees_of_the_map() {
+    let t = setup().await;
+    let admin = t.login("admin", "supersecret").await;
+    let (_, srv) = t.call("POST", "/api/admin/servers", Some(&admin), Some(json!({"name": "SMP", "instance_id": "smp"}))).await;
+    let key = srv["token"].as_str().unwrap().to_string();
+    assert_eq!(t.call_raw("POST", "/api/server/v1/map/tiles?dim=minecraft:overworld", Some(&key), tile(0, 0, 0)).await.0, StatusCode::OK);
+    t.call("POST", "/api/server/v1/map/players", Some(&key), Some(json!({"players": [{"uuid": "11111111-1111-1111-1111-111111111111", "name": "Steve", "dimension": "minecraft:overworld", "x": 1.0, "y": 64.0, "z": 2.0, "yaw": 0.0}]}))).await;
+    t.call("POST", "/api/server/v1/map/overlay", Some(&key), Some(json!({"claims": [{"id": "c"}], "pins": [{"id": "p"}]}))).await;
+
+    // No map section on the landing page: nothing is public.
+    assert_eq!(t.call("GET", "/api/v1/public/map/0", None, None).await.0, StatusCode::NOT_FOUND);
+
+    let landing = |opts: Value| json!({"blocks": [{"id": "m1", "type": "map", "enabled": true, "options": opts}]});
+    assert_eq!(t.call("PUT", "/api/admin/landing", Some(&admin), Some(landing(json!({"show_players": false})))).await.0, StatusCode::OK);
+    let (s, info) = t.call("GET", "/api/v1/public/map/0", None, None).await;
+    assert_eq!(s, StatusCode::OK, "{info}");
+    assert_eq!(info["ready"], true);
+    assert_eq!(info["layers"]["players"], false);
+    assert_eq!(info["layers"]["claims"], true);
+    // The tile key from the public info loads tiles without signing in.
+    let token = info["token"].as_str().unwrap();
+    let (s, png) = t.fetch(&format!("/api/map/{}/overworld/0/0/0.png?t={token}", info["server_id"])).await;
+    assert_eq!((s, png.len()), (StatusCode::OK, 12));
+
+    // Players stay hidden unless the admin turns them on.
+    let (_, o) = t.call("GET", "/api/v1/public/map/0/overlay", None, None).await;
+    assert_eq!(o["players"].as_array().unwrap().len(), 0);
+    assert_eq!(o["claims"].as_array().unwrap().len(), 1);
+    t.call("PUT", "/api/admin/landing", Some(&admin), Some(landing(json!({"show_players": true, "show_pins": false})))).await;
+    let (_, o) = t.call("GET", "/api/v1/public/map/0/overlay", None, None).await;
+    assert_eq!(o["players"][0]["name"], "Steve");
+    assert_eq!(o["pins"].as_array().unwrap().len(), 0);
+
+    // Another server's map isn't exposed, and turning the section off closes it.
+    assert_eq!(t.call("GET", "/api/v1/public/map/999", None, None).await.0, StatusCode::NOT_FOUND);
+    t.call("PUT", "/api/admin/landing", Some(&admin), Some(json!({"blocks": [{"id": "m1", "type": "map", "enabled": false, "options": {}}]}))).await;
+    assert_eq!(t.call("GET", "/api/v1/public/map/0", None, None).await.0, StatusCode::NOT_FOUND);
+}

panel/web/src/components/LandingMap.svelte

@@ -0,0 +1,32 @@
+<script lang="ts">
+  import { onMount } from 'svelte';
+  import MapViewer from '@scopenet/map/MapViewer.svelte';
+  import { startFeed, type MapInfo, type MapLayers, type MapOverlay } from '@scopenet/map';
+  import { get } from '../lib/api';
+
+  // The public live map on the landing page. The admin chooses the server and which layers visitors may see.
+  let { serverId = 0, height = 560 }: { serverId?: number; height?: number } = $props();
+
+  let info = $state<(MapInfo & { layers?: MapLayers }) | null>(null);
+  let overlay = $state<MapOverlay | null>(null);
+  let error = $state('');
+  const tileUrl = (slug: string, z: number, x: number, y: number) => `${info?.tile_base}/${slug}/${z}/${x}/${y}.png?t=${info?.token}`;
+  const available = $derived(info?.layers ?? { claims: true, pins: true, players: false });
+
+  onMount(() => startFeed({
+    loadInfo: () => get<MapInfo & { layers: MapLayers }>(`/api/v1/public/map/${serverId}`),
+    loadOverlay: () => get<MapOverlay>(`/api/v1/public/map/${serverId}/overlay`),
+    onInfo: (i) => { info = i; error = ''; },
+    onOverlay: (o) => { overlay = o; error = ''; },
+    onError: (m) => { error = m; },
+    overlayMs: 4000
+  }));
+</script>
+
+<div class="frame" style:height="{Math.min(1000, Math.max(300, height))}px">
+  <MapViewer {info} {overlay} {tileUrl} {error} {available} />
+</div>
+
+<style>
+  .frame { width: 100%; border-radius: 20px; overflow: hidden; border: 1px solid rgba(255, 255, 255, 0.1); box-shadow: 0 30px 80px -30px rgba(0, 0, 0, 0.7); --map-accent: var(--accent, #8b6cff); }
+</style>

panel/web/src/lib/landingSchema.ts

@@ -44,6 +44,7 @@ export const BLOCK_SCHEMAS: Record<BlockType, BlockSchema> = {
   divider: { type: 'divider', label: 'Divider', description: 'Space or rule between sections', group: 'Layout', defaults: { style: 'line', height: 48 }, fields: [choice('style', 'Style', ['line', 'space', 'glow']), field('height', 'Height', 'number')] },
   testimonials: { type: 'testimonials', label: 'Testimonials', description: 'Player quotes and reviews', group: 'Content', defaults: { columns: '3', items: [] }, fields: [choice('columns', 'Columns', ['2', '3']), list('items', 'Quotes', [field('quote', 'Quote', 'textarea'), field('name', 'Player name'), field('role', 'Role')], { quote: '', name: '', role: '' })] },
   video: { type: 'video', label: 'Video', description: 'Hosted video or YouTube embed', group: 'Media', defaults: { url: '', caption: '', poster: '' }, fields: [field('url', 'Video or YouTube URL', 'media'), field('poster', 'Poster image', 'media'), field('caption', 'Caption')] },
+  map: { type: 'map', label: 'Live map', description: 'The SCOPENET Map of a server: terrain, guild land and shops', group: 'Network', defaults: { server_id: 0, height: 560, show_claims: true, show_pins: true, show_players: false }, fields: [field('server_id', 'Server id (0 = the first server with a map)', 'number'), field('height', 'Height (px)', 'number'), field('show_claims', 'Show guild land', 'toggle'), field('show_pins', 'Show spawn, warps, markets and shops', 'toggle'), field('show_players', 'Show players online (live positions!)', 'toggle')] },
   buttons: { type: 'buttons', label: 'Button group', description: 'Custom links and action buttons', group: 'Conversion', defaults: { align: 'center', items: [] }, fields: [choice('align', 'Alignment', ['left', 'center']), list('items', 'Buttons', [field('label', 'Label'), field('url', 'URL', 'url'), choice('style', 'Style', ['primary', 'secondary'])], { label: 'Visit', url: '', style: 'primary' })] },
 };
 

panel/web/src/lib/types.ts

@@ -172,7 +172,7 @@ export interface FaqItem {
   answer: string;
 }
 
-export type BlockType = 'hero' | 'download' | 'servers' | 'leaderboard' | 'stats' | 'instances' | 'news' | 'faq' | 'socials' | 'text' | 'image' | 'split' | 'features' | 'gallery' | 'cta' | 'divider' | 'testimonials' | 'video' | 'buttons';
+export type BlockType = 'hero' | 'download' | 'servers' | 'leaderboard' | 'stats' | 'instances' | 'news' | 'faq' | 'socials' | 'text' | 'image' | 'split' | 'features' | 'gallery' | 'cta' | 'divider' | 'testimonials' | 'video' | 'buttons' | 'map';
 
 export interface LandingBlock {
   id: string;

panel/web/src/pages/PublicLanding.svelte

@@ -6,6 +6,7 @@
   } from '@lucide/svelte';
   import { get, formatBytes } from '../lib/api';
   import { session } from '../lib/session.svelte';
+  import LandingMap from '../components/LandingMap.svelte';
   import type { LandingConfig, HostedDownload, BlockType, FaqItem } from '../lib/types';
 
   let config = $state<LandingConfig | null>(null);
@@ -724,6 +725,11 @@
             {#if block.options?.caption}<p class="muted">{block.options.caption}</p>{/if}
           </div></section>
 
+        {:else if block.type === 'map'}
+          <section class="section" id={sectionId(block)}><div class="container"><div class="section-head"><h2>{block.title}</h2><p class="muted">{block.subtitle}</p></div>
+            <LandingMap serverId={Number(block.options?.server_id) || 0} height={Number(block.options?.height) || 560} />
+          </div></section>
+
         {:else if block.type === 'buttons'}
           <section class="section" id={sectionId(block)}><div class="container"><div class="section-head"><h2>{block.title}</h2><p class="muted">{block.subtitle}</p></div><div class="custom-actions" class:align-left={block.options?.align === 'left'}>
             {#each block.options?.items ?? [] as item}{#if item.label && item.url}<a class="custom-button" class:secondary={item.style === 'secondary'} href={safeLink(item.url)}>{item.label}</a>{/if}{/each}