Эта страница ещё не переведена — показана английская версия.

Map

Статичный мир: границы, рельеф, препятствия и вопрос «куда что можно поставить?». Физическая модель намеренно гораздо проще визуальной: примитивы с площадью основания и высотой, слои с правилами и один запрос допустимой позиции, которым пользуются все остальные модули.

Когда это нужно

• Вам нужен статичный мир — границы, рельеф, препятствия, — к которому сервер может обращаться с запросами, а не только отрисовывать его.
• Точки появления, выпадающие предметы и декорации должны попадать в допустимые места: для этого есть один запрос RandomPosition на правилах, и обойти его нельзя.
• Арены должны генерироваться заново на каждый матч: объявленный Seed воспроизводит ту же карту (map) в баг-репорте.
• Ящики и стены ломаются и появляются снова: разрушаемые объекты с HP и таймерами респауна.
• Ботам (bot) и снарядам нужны raycast и проверка прямой видимости относительно набора препятствий.
• Не нужно, если мир чисто визуальный и серверный код не спрашивает, куда что можно поставить.

Кто что делает

Коротко

[Map("arena", Seed = 42, Bounds = "160x160")]
public static class Arena
{
    [Terrain(HeightNoise = 0.3f)]                 public static Terrain Height;  // 3D height field
    [Scatter("rock", Count = 40, MinSpacing = 6)] public static ObstacleSet Rocks;
    [Destructible("crate", Count = 12, Hp = 100, RespawnAfter = "30s")] public static ObstacleSet Crates;
    [Layer("ground", NotInside = "water")]        public static Layer Ground;
}
// or: Maps.Named("arena-caves-v3")  — authored in the panel or loaded from an asset

@Map('arena', { seed: 42, bounds: '160x160' })
export class Arena {
  @Terrain({ heightNoise: 0.3 }) height: Terrain;                   // 3D height field
  @Scatter('rock', { count: 40, minSpacing: 6 }) rocks: ObstacleSet;
  @Destructible('crate', { count: 12, hp: 100, respawnAfter: '30s' }) crates: ObstacleSet;
  @Layer('ground', { notInside: 'water' }) ground: Layer;
}
// or: Maps.named('arena-caves-v3')  — authored in the panel or loaded from an asset

@Map("arena", seed=42, bounds="160x160")
class Arena:
    height = terrain(height_noise=0.3)                  # 3D height field
    rocks = scatter("rock", count=40, min_spacing=6)
    crates = destructible("crate", count=12, hp=100, respawn_after="30s")
    ground = layer("ground", not_inside="water")
# or: maps.named("arena-caves-v3")  — authored in the panel or loaded from an asset

USTRUCT(PSMap = (Name = "arena", Seed = 42, Bounds = "160x160"))
struct FArena
{
    GENERATED_BODY()

    UPROPERTY(PSTerrain = (HeightNoise = "0.3"))                             FPSTerrain Height;  // 3D height field
    UPROPERTY(PSScatter = (Obstacle = "rock", Count = 40, MinSpacing = 6))   FPSObstacleSet Rocks;
    UPROPERTY(PSDestructible = (Obstacle = "crate", Count = 12, Hp = 100,
                                RespawnAfter = "30s"))                       FPSObstacleSet Crates;
    UPROPERTY(PSStratum = (Name = "ground", NotInside = "water"))            FPSStratum Ground;
};
// or: PS::Maps::Named(TEXT("arena-caves-v3")) — authored in the panel or loaded from an asset
// declarations compile into the same pushed model — playserv push from the UE project or CI

[Map("arena", Seed = 42, Bounds = "160x160")]
public static class Arena
{
    [Terrain(HeightNoise = 0.3f)]                 public static Terrain Height;  // 3D height field
    [Scatter("rock", Count = 40, MinSpacing = 6)] public static ObstacleSet Rocks;
    [Destructible("crate", Count = 12, Hp = 100, RespawnAfter = "30s")] public static ObstacleSet Crates;
    [Layer("ground", NotInside = "water")]        public static Layer Ground;
}
// or: Maps.Named("arena-caves-v3")  — authored in the panel or loaded from an asset

Scatter и Destructible — генераторы расстановки, а не броски кубика во время игры. Генератор срабатывает при публикации версии карты: сорок камней превращаются в сорок объявленных примитивов, и в опубликованной версии лежат примитивы, а не правило. Поэтому один и тот же Seed даёт те же сорок камней в матче, в повторе и в баг-репорте. Геометрические ограничения проверяются один раз, на этом готовом наборе, ещё до того, как версия попадёт в окружение (environment).

Запрос, которым пользуются все остальные:

var spawn = map.RandomPosition(r =>
{
    r.Layer("ground");
    r.AwayFrom(players, minDistance: 12);
    r.NoRepeat(lastN: 3);
});

const spawn = map.randomPosition((r) => {
  r.layer('ground');
  r.awayFrom(players, { minDistance: 12 });
  r.noRepeat({ lastN: 3 });
});

spawn = map.random_position(rules=lambda r: (
    r.layer("ground"),
    r.away_from(players, min_distance=12),
    r.no_repeat(last_n=3),
))

// Dedicated-server host: place a spawn through the same rule-based query
Map->Positions->GetRandom({ .Stratum = PSKeys::Strata::Ground,
                            .AwayFrom = Players,
                            .MinDistance = 12.f,
                            .NoRepeatLastN = 3 },
    TPSOnResult<FVector>::CreateLambda([](const TPSResult<FVector>& Result)
    {
        if (!Result.HasValue()) { return; }
        PlaceSpawn(Result.Value());
    }));
// co_await support ships later: a built-in SDK coroutine wrapper that respects Unreal's GC and threading.

var spawn = map.RandomPosition(r =>
{
    r.Layer("ground");
    r.AwayFrom(players, minDistance: 12);
    r.NoRepeat(lastN: 3);
});

Модель

Два слоя, и объявляют их разные люди.

Что объявляет карта.

Ярус мира и экземпляр карты — никогда не синонимы.

Что верно для любого запроса.

Ошибки

• Не найдена карта, версия или экземпляр — ответ not found; так же отвечает и отозванная версия. Повторять запрос бессмысленно.
• Публикация изменённой геометрии под существующей версией — конфликт: сделайте новую версию.
• Ошибки публикации возникают при объявлении и при деплое, но никогда во время игры: карта сверх лимита примитивов, выпуклая оболочка сверх лимита вершин, произвольный меш в роли препятствия — всё это отказы при валидации ещё до выпуска.
• Запрос высоты за границами — не ошибка, а объявленный ответ «за границами». Его можно отличить от ответа «внутри препятствия», потому что в одном случае клиент разворачивается, а в другом — объезжает.
• Превышена частота запросов — ответ из категории ограничения частоты с указанием, когда можно повторить.

Ограничения

Конкретные числа появятся в главе об ограничениях платформы, а что происходит при достижении каждого потолка, определено уже сейчас.

• Примитивов препятствий на карту, вершин выпуклой оболочки, разрешение карты высот, размер границ, локаций на карту: всё это отклоняется при публикации, а не во время запроса.
• Экземпляров на карту: создание ещё одного отклоняется как конфликт; существующие экземпляры ради свободного места никогда не освобождаются.
• Хранимые версии: отзывается самая старая версия в статусе deprecating, но версия, на которой работает живая комната, — никогда.
• Частота запросов к пространству: ограничение частоты с указанием, когда можно повторить.