Merge branch 'animal-facing' into main

Animals turn to face their direction of travel (east/north/south sprites + west
flip), via AnimalFacingSystem and directional sprite sets in AnimalSet.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Mods/Core/Languages/en/ui.json

@@ -92,6 +92,7 @@
   "menu.settings": "Settings",
   "menu.credits": "Credits",
   "menu.quit": "Quit",
+  "loading.world": "Generating world",
   "newworld.title": "New World",
   "newworld.name": "Name",
   "newworld.defaultname": "New World",

Mods/Core/Languages/ru/ui.json

@@ -92,6 +92,7 @@
   "menu.settings": "Настройки",
   "menu.credits": "Авторы",
   "menu.quit": "Выход",
+  "loading.world": "Создание мира",
   "newworld.title": "Новый мир",
   "newworld.name": "Название",
   "newworld.defaultname": "Новый мир",

src/LittleSim/Content/AnimalSet.cs

@@ -12,22 +12,30 @@ namespace LittleSim.Content;
 /// </summary>
 public sealed class AnimalSet
 {
+    /// <summary>Направленные спрайты одной «внешности» (пол/стадия): восток, север, юг. Запад = зеркало
+    /// востока (флип по X). Север/юг берутся по конвенции имени (_east→_north/_south), иначе = восток.</summary>
+    public readonly record struct Directional(
+        Texture2DRegion East,
+        Texture2DRegion North,
+        Texture2DRegion South
+    );
+
     /// <summary>Вид животного: его деф, спрайты по полу/стадии и набор генов для генерации особи.</summary>
     public sealed class Species
     {
         /// <summary>Исходный деф животного.</summary>
         public required AnimalDef Def { get; init; }
 
-        /// <summary>Спрайт взрослой самки (он же общий/fallback).</summary>
+        /// <summary>Направленные спрайты взрослой самки (она же общий/fallback).</summary>
-        public required Texture2DRegion Female { get; init; }
+        public required Directional FemaleDirs { get; init; }
 
-        /// <summary>Спрайт взрослого самца (fallback — самка).</summary>
+        /// <summary>Направленные спрайты взрослого самца (fallback — самка).</summary>
-        public required Texture2DRegion Male { get; init; }
+        public required Directional MaleDirs { get; init; }
 
-        /// <summary>Спрайт детёныша/подростка (fallback — самка).</summary>
+        /// <summary>Направленные спрайты детёныша/подростка (fallback — самка).</summary>
-        public required Texture2DRegion Baby { get; init; }
+        public required Directional BabyDirs { get; init; }
 
-        /// <summary>Спрайт трупа (fallback — самка).</summary>
+        /// <summary>Спрайт трупа (fallback — самка, восток).</summary>
         public required Texture2DRegion Corpse { get; init; }
 
         /// <summary>Спрайт яйца (тип рождения «яйцекладка»); по умолчанию — общий спрайт-точка.</summary>
@@ -45,6 +53,12 @@ public sealed class AnimalSet
         /// <summary>Эталонный размер тела вида (база GeneMaxBodySize) — предпосчитан для горячих путей
         /// (масса/метаболизм Клайбера каждый кадр), чтобы не делать строковый словарный лукап в цикле.</summary>
         public required float RefBodySize { get; init; }
+
+        /// <summary>Направленные спрайты для стадии/пола: детёныш → BabyDirs; иначе по полу (самец/самка).</summary>
+        public Directional LookDirs(int stage, bool isMale) =>
+            string.Equals(Stages[stage].Texture, "baby", StringComparison.Ordinal) ? BabyDirs
+            : isMale ? MaleDirs
+            : FemaleDirs;
     }
 
     // Встроенный набор стадий по умолчанию (если вид не задал свой): как было до выноса в данные.
@@ -105,22 +119,20 @@ public sealed class AnimalSet
         for (var i = 0; i < defs.Length; i++)
         {
             var def = defs[i];
-            var female = atlases.GetRegion(device, def.Texture);
+            var femaleKey = def.Texture;
+            var maleKey = string.IsNullOrEmpty(def.MaleTexture) ? femaleKey : def.MaleTexture;
+            var babyKey = string.IsNullOrEmpty(def.BabyTexture) ? femaleKey : def.BabyTexture;
             _species[i] = new Species
             {
                 Def = def,
-                Female = female,
+                FemaleDirs = LoadDirs(atlases, device, femaleKey),
-                Male = string.IsNullOrEmpty(def.MaleTexture)
+                MaleDirs = LoadDirs(atlases, device, maleKey),
-                    ? female
+                BabyDirs = LoadDirs(atlases, device, babyKey),
-                    : atlases.GetRegion(device, def.MaleTexture),
-                Baby = string.IsNullOrEmpty(def.BabyTexture)
-                    ? female
-                    : atlases.GetRegion(device, def.BabyTexture),
                 Corpse = string.IsNullOrEmpty(def.CorpseTexture)
-                    ? female
+                    ? atlases.GetRegion(device, femaleKey)
                     : atlases.GetRegion(device, def.CorpseTexture),
                 Egg = string.IsNullOrEmpty(def.EggTexture)
-                    ? female
+                    ? atlases.GetRegion(device, femaleKey)
                     : atlases.GetRegion(device, def.EggTexture),
                 Stages = def.Stages.Length > 0 ? def.Stages : DefaultStages,
                 Body = content.Defs.TryGet<BodyDef>(def.Body, out var body) ? body : null,
@@ -134,6 +146,35 @@ public sealed class AnimalSet
         }
     }
 
+    // Грузит направленный набор по восточному ключу: север/юг — по конвенции имени (_east→_north/_south),
+    // если такой регион есть в атласе; иначе откат на восток (вид с одним спрайтом просто не разворачивается
+    // вверх/вниз, но влево/вправо — флипом востока). Запад всегда = зеркало востока.
+    private static Directional LoadDirs(ModAtlases atlases, GraphicsDevice device, string eastKey)
+    {
+        var east = atlases.GetRegion(device, eastKey);
+        return new Directional(
+            east,
+            TryDir(atlases, device, eastKey, "_north", east),
+            TryDir(atlases, device, eastKey, "_south", east)
+        );
+    }
+
+    private static Texture2DRegion TryDir(
+        ModAtlases atlases,
+        GraphicsDevice device,
+        string eastKey,
+        string suffix,
+        Texture2DRegion fallback
+    ) =>
+        eastKey.Contains("_east", StringComparison.Ordinal)
+        && atlases.TryGetRegion(
+            device,
+            eastKey.Replace("_east", suffix, StringComparison.Ordinal),
+            out var region
+        )
+            ? region
+            : fallback;
+
     /// <summary>Число видов в таблице.</summary>
     public int Count => _species.Length;
 

src/LittleSim/Content/ModAtlases.cs

@@ -48,6 +48,15 @@ public sealed class ModAtlases : IDisposable
         return Get(device, name).GetRegion(textureKey);
     }
 
+    /// <summary>Регион по ключу, если он есть (для опциональных вариантов, напр. направленных спрайтов).</summary>
+    public bool TryGetRegion(GraphicsDevice device, string textureKey, out Texture2DRegion region)
+    {
+        var segments = textureKey.Split('/');
+        var depth = Math.Min(GroupDepth, segments.Length - 1);
+        var name = depth == 0 ? "Atlas" : string.Join('.', segments[..depth]);
+        return Get(device, name).TryGetRegion(textureKey, out region);
+    }
+
     /// <inheritdoc />
     public void Dispose()
     {

src/LittleSim/Scenes/LoadGameScene.cs

@@ -73,7 +73,7 @@ public sealed class LoadGameScene : Scene
                         if (!Context.Scenes.IsTransitioning)
                         {
                             Context.Scenes.Switch(
-                                new WorldScene(save.ToConfig(), save),
+                                new WorldLoadingScene(save.ToConfig(), save),
                                 Transitions.Fade(0.6f)
                             );
                         }

src/LittleSim/Scenes/NewWorldScene.cs

@@ -154,7 +154,7 @@ public sealed class NewWorldScene : Scene
             Seed = seed,
             SmoothPasses = _smoothing,
         };
-        Context.Scenes.Switch(new WorldScene(config), Transitions.Fade(0.6f));
+        Context.Scenes.Switch(new WorldLoadingScene(config), Transitions.Fade(0.6f));
     }
 
     private void Back()

src/LittleSim/Scenes/WorldLoadingScene.cs

@@ -0,0 +1,63 @@
+using LittleSim.App;
+using LittleSim.Content;
+using LittleSim.UI;
+using MrGameEng.Core;
+using MrGameEng.UI;
+using Myra.Graphics2D.UI;
+
+namespace LittleSim.Scenes;
+
+/// <summary>
+/// Экран загрузки между окном создания/выбора мира и игровой сценой. Генерация мира
+/// (<see cref="WorldScene.OnLoad"/>: рельеф, атласы, спавн) идёт синхронно и блокирует кадр; раньше под
+/// ней был лишь сплошной фейд без индикатора. Эта сцена рисует надпись «Создание мира…», даёт ей
+/// прорисоваться, затем переключается на <see cref="WorldScene"/> БЕЗ перехода — её последний кадр
+/// (надпись) и остаётся на экране, пока идёт генерация, давая игроку понятную обратную связь.
+/// </summary>
+public sealed class WorldLoadingScene : Scene
+{
+    private readonly WorldConfig _config;
+    private readonly WorldSave? _save;
+    private GameSettings _settings = new();
+    private Label _label = null!;
+    private int _frames;
+
+    /// <summary>Новый мир (<paramref name="save"/> = null) или загрузка сохранения.</summary>
+    public WorldLoadingScene(WorldConfig config, WorldSave? save = null)
+    {
+        _config = config;
+        _save = save;
+    }
+
+    protected override void OnLoad()
+    {
+        _settings = GameSettingsStore.Load();
+        var desktop = this.UseScaledUI(); // ставит MyraEnvironment.Game до создания виджетов
+        _label = new Label
+        {
+            TextColor = Ui.Accent,
+            HorizontalAlignment = HorizontalAlignment.Center,
+            VerticalAlignment = VerticalAlignment.Center,
+        };
+        desktop.Root = Ui.Screen(_label);
+        UpdateSystems.Add(new CallbackSystem(Tick));
+    }
+
+    private void Tick()
+    {
+        var content = Context.Services.Get<GameContent>();
+        var word = content.Languages.Get("loading.world");
+        var dots = new string('.', (int)(Context.Clock.UnscaledTotalTime * 2) % 4);
+        _label.Text = word + dots;
+
+        // Дождаться, пока надпись точно прорисована (переход въезда завершён + пара кадров), затем
+        // мгновенно переключиться: блокирующий WorldScene.OnLoad оставит на экране кадр с надписью.
+        _frames++;
+        if (Context.Scenes.IsTransitioning || _frames < 2)
+        {
+            return;
+        }
+
+        Context.Scenes.Switch(new WorldScene(_config, _save));
+    }
+}

src/LittleSim/Scenes/WorldScene.cs

@@ -322,6 +322,7 @@ public sealed class WorldScene : Scene
         );
         UpdateSystems.Add(new AnimalAppearanceSystem(_needs));
         UpdateSystems.Add(new AnimalGrowthSystem(Context.Clock, SecondsPerDay, _animals, CellSize));
+        UpdateSystems.Add(new AnimalFacingSystem(_animals, CellSize));
         UpdateSystems.Add(new AnimalMortalitySystem(Store, _animals, CellSize));
         UpdateSystems.Add(new CorpseSystem(Store, Context.Clock, SecondsPerDay, climate));
         UpdateSystems.Add(

src/LittleSim/Sim/AnimalFactory.cs

@@ -269,9 +269,7 @@ public static class AnimalFactory
 
     /// <summary>Спрайт стадии: набор "baby" — текстура детёныша; иначе по полу (самец/самка).</summary>
     public static Texture2DRegion RegionFor(AnimalSet.Species sp, int stage, bool isMale) =>
-        string.Equals(sp.Stages[stage].Texture, "baby", StringComparison.Ordinal) ? sp.Baby
+        sp.LookDirs(stage, isMale).East; // восток — базовое направление; разворот делает AnimalFacingSystem
-        : isMale ? sp.Male
-        : sp.Female;
 
     /// <summary>Взрослая ли стадия (способна размножаться) — флаг из данных стадии.</summary>
     public static bool IsAdult(AnimalSet.Species sp, int stage) => sp.Stages[stage].Adult;

src/LittleSim/Sim/AnimalSystems.cs

@@ -1627,6 +1627,67 @@ public sealed class AnimalAppearanceSystem(NeedSet needs)
     }
 }
 
+/// <summary>
+/// Разворот спрайта по направлению движения (как в RimWorld): зверь смотрит туда, куда идёт. Восток —
+/// базовая текстура, запад — её зеркало (флип по X), север/юг — отдельные текстуры (если есть у вида).
+/// Направление берётся из цели «мозга» (<see cref="AnimalBrain.Target"/>) относительно позиции; стоящий
+/// зверь сохраняет прежний разворот. При смене региона пересчитывает центр-origin и масштаб (текстуры
+/// направлений могут отличаться шириной). Презентация (читает sim, пишет только Sprite/Transform-scale).
+/// </summary>
+public sealed class AnimalFacingSystem(AnimalSet animals, int cellSize)
+    : QuerySystem<AnimalBrain, AnimalOrganism, AnimalGrowth, Transform2D, Sprite>
+{
+    private const float MinMove = 0.5f; // короче — считаем стоящим, разворот не трогаем
+
+    protected override void OnUpdate()
+    {
+        foreach (var (brains, organisms, growths, transforms, sprites, _) in Query.Chunks)
+        {
+            var b = brains.Span;
+            var o = organisms.Span;
+            var g = growths.Span;
+            var t = transforms.Span;
+            var s = sprites.Span;
+            for (var i = 0; i < b.Length; i++)
+            {
+                var dir = b[i].Target - t[i].Position;
+                if (dir.LengthSquared() < MinMove * MinMove)
+                {
+                    continue; // стоит/у цели — сохраняем текущий разворот
+                }
+
+                var sp = animals[o[i].Species];
+                var dirs = sp.LookDirs(g[i].Stage, o[i].IsMale);
+                Texture2DRegion region;
+                SpriteFlip flip;
+                if (MathF.Abs(dir.X) >= MathF.Abs(dir.Y))
+                {
+                    region = dirs.East;
+                    flip = dir.X < 0f ? SpriteFlip.X : SpriteFlip.None; // запад = зеркало востока
+                }
+                else
+                {
+                    region = dir.Y < 0f ? dirs.North : dirs.South; // экранный Y вниз: вверх = север
+                    flip = SpriteFlip.None;
+                }
+
+                ref var sprite = ref s[i];
+                if (sprite.Region == region && sprite.Flip == flip)
+                {
+                    continue; // разворот не изменился
+                }
+
+                sprite.Region = region;
+                sprite.Origin = new Vector2(region.Width / 2f, region.Height / 2f);
+                sprite.Flip = flip;
+                t[i].Scale = new Vector2(
+                    AnimalFactory.Scale(sp, o[i].Traits, g[i].Stage, region, cellSize)
+                );
+            }
+        }
+    }
+}
+
 /// <summary>
 /// Рост и стадии (фаза A3): копит возраст в игровых днях, переключает стадию (Baby→Juvenile→Adult→
 /// Senior) по порогам из генов и при смене стадии меняет спрайт (детёныш/самка/самец) и размер.