From bbc163b204f3e2de3946027dfedb5bb056281888 Mon Sep 17 00:00:00 2001
From: maj00r <maj00r@host>
Date: Sun, 4 Oct 2026 14:00:52 +0200
Subject: [PATCH] Warn when the experimental renderer is picked

---
 StarterNG/Views/Settings.axaml    | 22 ++++++++++++++--------
 StarterNG/Views/Settings.axaml.cs |  7 +++++++
 StarterNG/startercfg/lang/cz.xml  |  1 +
 StarterNG/startercfg/lang/en.xml  |  1 +
 StarterNG/startercfg/lang/hu.xml  |  1 +
 StarterNG/startercfg/lang/pl.xml  |  1 +
 StarterNG/startercfg/lang/ru.xml  |  1 +
 7 files changed, 26 insertions(+), 8 deletions(-)

diff --git a/StarterNG/Views/Settings.axaml b/StarterNG/Views/Settings.axaml
index 2a40755..4378719 100644
--- a/StarterNG/Views/Settings.axaml
+++ b/StarterNG/Views/Settings.axaml
@@ -248,14 +248,20 @@
                                 <StackPanel>
                                     <ctl:SettingRow ConfigKey="gfxrenderer" Label="{Binding [RenderEngine], Source={x:Static starterNg:App.Loc}}"
                                                     Description="{Binding [RenderEngineDesc], Source={x:Static starterNg:App.Loc}}">
-                                        <ComboBox x:Name="RenderEngineCb" SelectedIndex="0">
-                                            <ComboBoxItem Content="{Binding [REFull], Source={x:Static starterNg:App.Loc}}" />
-                                            <ComboBoxItem Content="{Binding [REOld], Source={x:Static starterNg:App.Loc}}" />
-                                            <ComboBoxItem Content="{Binding [RESimpShader], Source={x:Static starterNg:App.Loc}}" />
-                                            <ComboBoxItem Content="{Binding [RESimp], Source={x:Static starterNg:App.Loc}}" />
-                                            <ComboBoxItem Content="{Binding [REOff], Source={x:Static starterNg:App.Loc}}" />
-                                            <ComboBoxItem Content="{Binding [REExperimental], Source={x:Static starterNg:App.Loc}}" />
-                                        </ComboBox>
+                                        <StackPanel Spacing="6">
+                                            <ComboBox x:Name="RenderEngineCb" SelectedIndex="0"
+                                                      SelectionChanged="RenderEngineCb_OnSelectionChanged">
+                                                <ComboBoxItem Content="{Binding [REFull], Source={x:Static starterNg:App.Loc}}" />
+                                                <ComboBoxItem Content="{Binding [REOld], Source={x:Static starterNg:App.Loc}}" />
+                                                <ComboBoxItem Content="{Binding [RESimpShader], Source={x:Static starterNg:App.Loc}}" />
+                                                <ComboBoxItem Content="{Binding [RESimp], Source={x:Static starterNg:App.Loc}}" />
+                                                <ComboBoxItem Content="{Binding [REOff], Source={x:Static starterNg:App.Loc}}" />
+                                                <ComboBoxItem Content="{Binding [REExperimental], Source={x:Static starterNg:App.Loc}}" />
+                                            </ComboBox>
+                                            <TextBlock x:Name="RenderEngineWarning" IsVisible="False" TextWrapping="Wrap"
+                                                       Foreground="{StaticResource CarbonAccentBright}"
+                                                       Text="{Binding [REExperimentalWarning], Source={x:Static starterNg:App.Loc}}" />
+                                        </StackPanel>
                                     </ctl:SettingRow>
                                     <ctl:SettingRow ConfigKey="gfx.angleplatform" Description="{Binding [RenderAngleVulkanDesc], Source={x:Static starterNg:App.Loc}}">
                                         <CheckBox x:Name="RenderAngleVulkanCb" Content="{Binding [RenderAngleVulkan], Source={x:Static starterNg:App.Loc}}" />
diff --git a/StarterNG/Views/Settings.axaml.cs b/StarterNG/Views/Settings.axaml.cs
index ad857f7..9b0b740 100644
--- a/StarterNG/Views/Settings.axaml.cs
+++ b/StarterNG/Views/Settings.axaml.cs
@@ -448,6 +448,13 @@ public partial class Settings : UserControl, ISettingsCapture
             SaveStatus.Text = App.Loc["SettingsSaved"];
     }
 
+    private void RenderEngineCb_OnSelectionChanged(object? sender, SelectionChangedEventArgs e)
+    {
+        if (RenderEngineWarning is not null)
+            RenderEngineWarning.IsVisible =
+                SimulatorSettings.RenderEngines.ElementAtOrDefault(RenderEngineCb.SelectedIndex) == "experimental";
+    }
+
     private UpdateChannel SelectedChannel() =>
         UpdateChannelCb.SelectedIndex == 1 ? UpdateChannel.Staging : UpdateChannel.Stable;
 
diff --git a/StarterNG/startercfg/lang/cz.xml b/StarterNG/startercfg/lang/cz.xml
index f40ec0c..76324b1 100644
--- a/StarterNG/startercfg/lang/cz.xml
+++ b/StarterNG/startercfg/lang/cz.xml
@@ -367,6 +367,7 @@
     <String key="RESimp">Zjednodušený</String>
     <String key="REOff">Vypnout vizuální vrstvu</String>
     <String key="REExperimental">Experimentální</String>
+    <String key="REExperimentalWarning">Upozornění: experimentální renderer je ve vývoji. Může být nestabilní, nezobrazovat části scény nebo se na některých grafických kartách nespustit. Pokud se simulátor nespustí nebo vypadá špatně, vraťte se k rendereru „Plný“.</String>
 
     <String key="Resolution">Rozlišení</String>
     <String key="BufforResolution">Rozlišení bufferu</String>
diff --git a/StarterNG/startercfg/lang/en.xml b/StarterNG/startercfg/lang/en.xml
index 305b53b..dfa3c38 100644
--- a/StarterNG/startercfg/lang/en.xml
+++ b/StarterNG/startercfg/lang/en.xml
@@ -375,6 +375,7 @@
     <String key="RESimp">Simplified</String>
     <String key="REOff">Disable visual layer</String>
     <String key="REExperimental">Experimental</String>
+    <String key="REExperimentalWarning">Note: the experimental renderer is still being developed. It may be unstable, miss parts of the scene or not start on some graphics cards. If the simulator does not start or looks wrong, go back to the “Full” renderer.</String>
 
     <String key="Resolution">Resolution</String>
     <String key="BufforResolution">Buffer resolution</String>
diff --git a/StarterNG/startercfg/lang/hu.xml b/StarterNG/startercfg/lang/hu.xml
index eccaad0..1592ae3 100644
--- a/StarterNG/startercfg/lang/hu.xml
+++ b/StarterNG/startercfg/lang/hu.xml
@@ -367,6 +367,7 @@
     <String key="RESimp">Egyszerűsített</String>
     <String key="REOff">Vizuális réteg kikapcsolása</String>
     <String key="REExperimental">Kísérleti</String>
+    <String key="REExperimentalWarning">Figyelem: a kísérleti renderelő még fejlesztés alatt áll. Instabil lehet, a jelenet egyes részei hiányozhatnak, vagy egyes videokártyákon el sem indul. Ha a szimulátor nem indul el vagy hibásan jelenik meg, válts vissza a „Teljes” renderelőre.</String>
 
     <String key="Resolution">Felbontás</String>
     <String key="BufforResolution">Puffer felbontása</String>
diff --git a/StarterNG/startercfg/lang/pl.xml b/StarterNG/startercfg/lang/pl.xml
index 7168818..6d7d9bf 100644
--- a/StarterNG/startercfg/lang/pl.xml
+++ b/StarterNG/startercfg/lang/pl.xml
@@ -375,6 +375,7 @@
     <String key="RESimp">Uproszczony</String>
     <String key="REOff">Wyłącz warstwę wizualną</String>
     <String key="REExperimental">Eksperymentalny</String>
+    <String key="REExperimentalWarning">Uwaga: renderer eksperymentalny jest w trakcie rozwoju. Może działać niestabilnie, nie pokazywać części obiektów albo nie uruchomić się na niektórych kartach graficznych. Gdy symulator nie startuje lub wygląda źle, wróć do renderera „Pełny”.</String>
 
     <String key="Resolution">Rozdzielczość</String>
     <String key="BufforResolution">Rozdzielczość bufora</String>
diff --git a/StarterNG/startercfg/lang/ru.xml b/StarterNG/startercfg/lang/ru.xml
index 333c9e7..a559f5d 100644
--- a/StarterNG/startercfg/lang/ru.xml
+++ b/StarterNG/startercfg/lang/ru.xml
@@ -367,6 +367,7 @@
     <String key="RESimp">Упрощённый</String>
     <String key="REOff">Отключить визуальный слой</String>
     <String key="REExperimental">Экспериментальный</String>
+    <String key="REExperimentalWarning">Внимание: экспериментальный рендерер находится в разработке. Он может работать нестабильно, не показывать части сцены или не запускаться на некоторых видеокартах. Если симулятор не запускается или выглядит неправильно, вернитесь к рендереру «Полный».</String>
 
     <String key="Resolution">Разрешение</String>
     <String key="BufforResolution">Разрешение буфера</String>