SusMinimap

Универсальная миникарта — tile grid, free texture или node graph; маркеры unit / POI, zoom, fog, frustum камеры.

Пакет

SusGame · Атомы (коммерческий)

Открыть в песочнице

SusGame · Molecules

Свойства

Имя	Тип	По умолчанию
RenderMode	Prop<string>	"grid"
MapWidth	Prop<int>	30
MapHeight	Prop<int>	30
MinimapTexture	Prop<Texture2D>	null
ShowGrid	Prop<bool>	true
CurrentFloorLevel	Prop<int>	0
ShowPlayer	Prop<bool>	false
PlayerPosition	Prop<Vector2>	new Vector2(0.5f, 0.5f)
PlayerForward	Prop<Vector2>	new Vector2(0f, 1f)
PlayerMode	Prop<string>	"center"
ViewConeAngle	Prop<float>	70f
CameraTexture	Prop<Texture2D>	null
ShowCameraIndicator	Prop<bool>	true
CameraBounds	Prop<MinimapCameraRect>	new MinimapCameraRect()
Zoom	Prop<float>	1f
ZoomCenter	Prop<Vector2>	new Vector2(0.5f, 0.5f)
FollowCamera	Prop<bool>	true
MinZoom	Prop<float>	0.5f
MaxZoom	Prop<float>	3f
ZoomStep	Prop<float>	0.25f
ShowZoomControls	Prop<bool>	false
RotationMode	Prop<string>	"north-up"
ShowCompass	Prop<bool>	false
ShowEdgeIndicators	Prop<bool>	true
MaxEdgeIndicators	Prop<int>	6
LabelMode	Prop<string>	"selected"
MaskShape	Prop<string>	"square"
FrameVisible	Prop<bool>	true
FrameTitle	Prop<string>	""
ShowFogOfWar	Prop<bool>	false
FogMask	Prop<Texture2D>	null
Interactive	Prop<bool>	true
AutoResize	Prop<bool>	true
MinSize	Prop<float>	128f
MaxSize	Prop<float>	512f
MapBounds	Prop<MinimapBounds>	new MinimapBounds()

Слоты

Имя
(по умолчанию)
frameOverlay
cornerTopLeft
cornerTopRight
cornerBottomLeft
cornerBottomRight

События

Имя	Поле	Payload
CellClicked	OnCellClicked	Vector2
UnitClicked	OnUnitClicked	int
PoiClicked	OnPoiClicked	string
NodeClicked	OnNodeClicked	string
ZoomChanged	OnZoomChanged	float

Хуки стиля

Контракт USS-классов — внешний вид переопределяется без правки C#. Состояния переключаются этими классами:

• sus-minimap
• sus-minimap__camera
• sus-minimap__compass
• sus-minimap__compass-label
• sus-minimap__compass-label--e
• sus-minimap__compass-label--n
• sus-minimap__compass-label--s
• sus-minimap__compass-label--w
• sus-minimap__container
• sus-minimap__corner
• sus-minimap__corner--bl
• sus-minimap__corner--br
• sus-minimap__corner--tl
• sus-minimap__corner--tr
• sus-minimap__edge-counter
• sus-minimap__edge-indicator
• sus-minimap__edge-layer
• sus-minimap__fog
• sus-minimap__frame
• sus-minimap__label
• sus-minimap__node
• sus-minimap__node--appear
• sus-minimap__node--current
• sus-minimap__node-icon
• sus-minimap__node-label
• sus-minimap__nodes
• sus-minimap__overlay-slot
• sus-minimap__player-arrow
• sus-minimap__player-cone
• sus-minimap__player-layer
• sus-minimap__poi
• sus-minimap__poi--kind-loot
• sus-minimap__poi--kind-objective
• sus-minimap__poi--pulse
• sus-minimap__poi-icon
• sus-minimap__poi-label
• sus-minimap__pois
• sus-minimap__terrain
• sus-minimap__title
• sus-minimap__unit
• sus-minimap__unit--kind-loot
• sus-minimap__unit--kind-objective
• sus-minimap__unit--selected
• sus-minimap__unit-dir
• sus-minimap__unit-hp
• sus-minimap__unit-hp-fill
• sus-minimap__units
• sus-minimap__zoom-btn
• sus-minimap__zoom-controls
• sus-minimap--fit
• sus-minimap--frame-visible
• sus-minimap--free
• sus-minimap--grid
• sus-minimap--interactive
• sus-minimap--mask-circle
• sus-minimap--mask-square
• sus-minimap--node

Использование

Выберите RenderMode (grid | free | node), затем заполните list-пропы из C# (TerrainData / MinimapTexture / NodeData+EdgeData). Маркеры и клики управляются списками — не XML-списками.

var map = new SusMinimap();
map.RenderMode.Value = "grid";
map.MapWidth.Value = 30;
map.MapHeight.Value = 30;
map.MaskShape.Value = "circle";
map.FrameTitle.Value = "Floor 1";
map.ShowGrid.Value = true;
map.Interactive.Value = true;

map.TerrainData.Value = new List<SusMinimap.MinimapCell>
{
    new() { X = 0, Z = 0, Type = 1, FloorLevel = 0, Visibility = 2 },
};
map.UnitData.Value = new List<SusMinimap.MinimapUnitMarker>
{
    /* … */
};

map.OnCellClicked += cell => { /* Vector2 grid coords */ };
map.OnUnitClicked += idx => { /* marker index */ };
map.OnPoiClicked += id => { /* … */ };
map.OnNodeClicked += id => { /* … */ };
map.OnZoomChanged += z => { /* … */ };

// Helpers
// map.FocusOn(new Vector2(0.5f, 0.5f), zoom: 1.5f);
// map.ResetZoom();
// map.RegenerateTerrainTexture();

<template>
  <sus:SusMinimap :RenderMode="Mode.Value"
                  :MapWidth="W.Value"
                  :MapHeight="H.Value"
                  :ShowGrid="Grid.Value"
                  :CurrentFloorLevel="Floor.Value"
                  :MaskShape="Mask.Value"
                  :FrameVisible="Frame.Value"
                  :FrameTitle="Title.Value"
                  :ShowFogOfWar="Fog.Value"
                  :Interactive="Ix.Value"
                  :Zoom="Zoom.Value"
                  :MinZoom="MinZ.Value"
                  :MaxZoom="MaxZ.Value"
                  :FollowCamera="Follow.Value"
                  :ShowCameraIndicator="Cam.Value"
                  :AutoResize="Auto.Value"
                  :MinSize="MinS.Value"
                  :MaxSize="MaxS.Value"
                  @cell-clicked="OnCell"
                  @unit-clicked="OnUnit"
                  @poi-clicked="OnPoi"
                  @node-clicked="OnNode"
                  @zoom-changed="OnZoom" />
</template>

<script>
public Prop<string> Mode = new("grid");
public Prop<int> W = new(30);
public Prop<int> H = new(30);
public Prop<bool> Grid = new(true);
public Prop<int> Floor = new(0);
public Prop<string> Mask = new("circle");
public Prop<bool> Frame = new(true);
public Prop<string> Title = new("Floor 1");
public Prop<bool> Fog = new(false);
public Prop<bool> Ix = new(true);
public Prop<float> Zoom = new(1f);
public Prop<float> MinZ = new(0.5f);
public Prop<float> MaxZ = new(3f);
public Prop<bool> Follow = new(true);
public Prop<bool> Cam = new(true);
public Prop<bool> Auto = new(true);
public Prop<float> MinS = new(128f);
public Prop<float> MaxS = new(512f);
void OnCell(Vector2 cell) { /* … */ }
void OnUnit(int index) { /* … */ }
void OnPoi(string id) { /* … */ }
void OnNode(string id) { /* … */ }
void OnZoom(float z) { /* … */ }
// Fill TerrainData / UnitData / PoiData / NodeData / EdgeData /
// MinimapTexture / FogMask / CameraBounds / MapBounds from C#.
</script>

Prop / API	Роль
RenderMode	grid | free | node
MapWidth · MapHeight	Размеры сетки (по умолчанию 30)
TerrainData	List<MinimapCell> — тайлы сетки (перегенерирует текстуру)
MinimapTexture	Готовая текстура (free / без генерации)
ShowGrid · CurrentFloorLevel	Оформление сетки / несколько этажей
UnitData · PoiData	Списки маркеров
NodeData · EdgeData	Граф (режим node)
CameraTexture · ShowCameraIndicator · CameraBounds · FollowCamera	Frustum камеры
Zoom · ZoomCenter · MinZoom · MaxZoom	Масштаб
MaskShape	square | circle
FrameVisible · FrameTitle	Оформление рамки
ShowFogOfWar · FogMask	Оверлей тумана войны
Interactive	Ввод кликов / масштабирования
AutoResize · MinSize · MaxSize	Ограничение размера хоста
MapBounds	Границы мира (free, World↔minimap)
default / frameOverlay / corner* slots	Содержимое оверлея
RegenerateTerrainTexture · FocusOn · ResetZoom · Toggle	Хелперы
OnCellClicked · OnUnitClicked · OnPoiClicked · OnNodeClicked · OnZoomChanged	События

Режимы

RenderMode	Источник
grid	Ячейки TerrainData → сгенерированная текстура
free	MinimapTexture (+ MapBounds)
node	NodeData + EdgeData (вложенные MinimapNodeState / MinimapEdgeState)

Вложенные типы находятся в SusMinimap (MinimapCell, MinimapUnitMarker, MinimapPOIMarker, MinimapNode, MinimapEdge, MinimapBounds, MinimapCameraRect) — поля смотрите в .sharq.

Заметки

• HUD-обёртка (плейсхолдер / размер): SusHudMinimapFrame — вставляйте этот атом через SetContent или дефолтный слот.
• List/texture/bounds-пропы управляются из C#; XML привязывает только скалярные пропы оформления выше.
• Извлечение ComponentApi может пропускать list-пропы без [CreateProperty] — используйте таблицу / .sharq как источник истины.