菜单
The AMC in-game map system — OlMap/EditorOlMap wrappers, the custom game-world projection and reProjectPoint helpers, WebGL layers, styling from tw-var, static points, and realtime player streams. Read before touching anything under src/lib/ui/OlMap, src/lib/ui/EditorOlMap, or src/lib/components/Map.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
The pakop C#/.NET WASM module (CUE4Parse-based) — what it does (pak-file inspection/hashing), how to build it (pnpm build:pakop), and how to consume it (lazy dynamic import). Read before touching wasm/pakop or the pak routes.
How to fetch data in the AMC web app — the apiClient helper, visibility-aware polling / EventSource / WebSocket wrappers in src/lib/api/_api.ts, per-domain API modules, and protobuf decoding. Read before adding any network call.
The AMC app shell — hooks.server.ts prerender-time head injection (SEO meta, theme-color, font preloads, icons), hooks.ts URL delocalization, and asset import suffixes (?no-inline, ?url). Read before changing global head tags, fonts, SEO metadata, or hooks.
High-level architecture of the AMC web app — SvelteKit static/SPA hybrid, Vite plugin pipeline, i18n strategy, WASM modules, dev-server proxies. Read before making structural or build-related changes.
Utility function conventions in the AMC web repo — es-toolkit for lodash-like helpers (lodash-es was removed), but check src/lib/utils first. Read before adding utility helpers.
Import path aliases ($lib, $messages) and workspace packages used in the AMC web repo. Read when writing imports or resolving where a module comes from.
| name | map-system |
| description | The AMC in-game map system — OlMap/EditorOlMap wrappers, the custom game-world projection and reProjectPoint helpers, WebGL layers, styling from tw-var, static points, and realtime player streams. Read before touching anything under src/lib/ui/OlMap, src/lib/ui/EditorOlMap, or src/lib/components/Map. |
The site renders the Motor Town game world with OpenLayers through two layers of abstraction:
src/lib/ui/OlMap/ — base display map: custom Projection, WebGLTileLayer image tiles, view controls, reduced-motion awareness. Accepts a layers?: BaseLayer[] prop for overlays.src/lib/ui/EditorOlMap/ — editing variant used by the track editor.src/lib/components/Map/ — feature layer: the main map page (Map/), plus Delivery/, Housing/, Jobs/, Players/, Collapsible/ subfeatures, wired to routes in src/routes/(map)/.Game-world coordinates must be re-projected before rendering. Constants and helpers in src/lib/ui/OlMap/utils.ts:
MAP_REAL_X_LEFT = -1280000;
MAP_REAL_Y_TOP = -320000;
MAP_REAL_SIZE = 2200000;
reProjectPoint([x, y]); // game coords → map coords (flips Y)
reProjectPointInverse([x, y]); // map coords → game coords
Any Point geometry you add must go through reProjectPoint — raw game coordinates will render off-map.
WebGLVectorLayer for large point sets (players, delivery points) — performance matters at this feature count; plain VectorLayer is fine for small overlays.Style objects come from $lib/tw-var exports (colorEmerald400, textXs, fontSans, adjustOpacity(...), …) — never hardcode hex/px values.src/lib/components/Map/Map/staticPoints.ts from $lib/data/*; point/POI types live in src/lib/components/Map/types.ts.Player positions stream via the API layer (getPlayerRealtimePositionV2 — protobuf WebSocket; see [[api-layer]]) with getAbortSignal() for cleanup. Delivery info is cached in deliveryInfoCaches.svelte.ts (reactive rune module).
Hover/click info uses HoverInfoTooltip.svelte, PoiPanel.svelte, and info components (DeliveryInfo, HousingInfo, PlayerInfo); map search is Search.svelte. Navigation between map subpages uses goto from $app/navigation (routes under src/routes/(map)/).
Related: [[api-layer]], [[openlayers]], [[project-structure]]