Maelstrom data support

CLAUDE.md

@@ -27,6 +27,7 @@ The porting registers and format notes live in `Documents/`:
 - [Documents/Sound-PORTING.md](Documents/Sound-PORTING.md) — audio: DirectSound out, miniaudio in.
 - [Documents/Video-PORTING.md](Documents/Video-PORTING.md) — video: Bink and AVI, on ffmpeg.
 - [Documents/InPlaceArchive.md](Documents/InPlaceArchive.md) — the InPlace archive format and the `.3dxG` model cache.
+- [Documents/Maelstrom-PORTING.md](Documents/Maelstrom-PORTING.md) — running Maelstrom's data on this engine: the schema drift, the converter, and the cache formats its models and textures ship in.
 
 ## Current state
 

CMakeLists.txt

@@ -364,6 +364,27 @@ if(VISTA_ASAN)
     message(STATUS "AddressSanitizer: ON (engine targets only; dependencies stay uninstrumented)")
 endif()
 
+# Which game's data this binary reads.
+#
+# Maelstrom (KD Lab, 2007) ships data written by a VistaEngine from before ~Aug 2007;
+# this tree is a 2008+ snapshot. Most of the drift the archive absorbs on its own --
+# XPrmIArchive skips names it does not know -- but where a field CHANGED NESTING or
+# CHANGED OWNER there is nothing to skip: the reader asks for a block the old writer
+# never wrote, and the whole subtree goes unread. Those sites cannot be served by one
+# body of code without guessing at load time which schema is in front of them, so they
+# are written twice and selected here.
+#
+# The rule at such a site is `#ifdef MAELSTROM_DATA` / `#else` / `#endif`, with the
+# 2008 layout in the #else so a stock build is the code that was already there. Grep
+# MAELSTROM_DATA for the full set; Documents/Maelstrom-PORTING.md explains each one.
+#
+# ON builds a Maelstrom binary, which cannot load Perimeter 2's data, and vice versa.
+option(MAELSTROM_DATA "Read Maelstrom's (pre-2008) data schema instead of Perimeter 2's" OFF)
+if(MAELSTROM_DATA)
+    add_compile_definitions(MAELSTROM_DATA)
+    message(STATUS "Data schema: Maelstrom (pre-2008)")
+endif()
+
 add_subdirectory(XLibs.Net)
 add_subdirectory(Util)
 add_subdirectory(AI)

Environment/ActionsEnvironmental.cpp

@@ -43,6 +43,9 @@ REGISTER_CLASS(Action, ActionSetWaterColor, "Погода\\Установить
 REGISTER_CLASS(Action, ActionSetReflectSkyColor, "Погода\\Установить цвет отражённого неба")
 REGISTER_CLASS(Action, ActionSetTimeScale, "Погода\\Скорость течения времени суток на мире")
 REGISTER_CLASS(Action, ActionSetWaterLevel, "Погода\\Установить уровень воды")
+#ifdef MAELSTROM_DATA
+REGISTER_CLASS(Action, ActionSetCoastSprites, "Погода\\Параметры прибрежных спрайтов")
+#endif
 
 REGISTER_CLASS(Action, ActionSetEffect, "Глобальные действия\\Включить/выключить эффект");
 
@@ -395,6 +398,29 @@ void ActionSetFogOfWar::activate()
 	}
 }
 
+#ifdef MAELSTROM_DATA
+ActionSetCoastSprites::ActionSetCoastSprites()
+{
+	// The trigger editor opened the action on the world's current settings and saved the
+	// difference, so the constructor has to start from them, not from an empty attribute set.
+	if(environment && environment->GetCoastSprites())
+		coastSprites_ = environment->GetCoastSprites()->attributes();
+}
+
+void ActionSetCoastSprites::serialize(Archive& ar)
+{
+	__super::serialize(ar);
+	ar.serialize(coastSprites_, "coastSprites", "Прибрежные спрайты");
+}
+
+void ActionSetCoastSprites::activate()
+{
+	if(environment)
+		if(cCoastSprites* coastSprites = environment->GetCoastSprites())
+			coastSprites->setAttributes(coastSprites_);
+}
+#endif
+
 ActionSetWaterOpacity::ActionSetWaterOpacity()
 {
 	if(environment){

Environment/ActionsEnvironmental.h

@@ -9,6 +9,9 @@
 #include "Physics/WindMap.h"
 #include "Starforce.h"
 #include "Units/LabelObject.h"
+#ifdef MAELSTROM_DATA
+#include "Environment/EnvironmentColors.h"	// CoastSpritesAttributes, for ActionSetCoastSprites
+#endif
 
 struct ActionActivateSources : Action
 {
@@ -209,6 +212,26 @@ class ActionSetSilhouette : public Action
 	void activate(){};
 };
 
+#ifdef MAELSTROM_DATA
+// Maelstrom's own action, dropped by 2008 along with Environment's copy of the coast sprite
+// attributes -- the sprites are still here and still read from the world, only nothing could
+// change them again once the world was loaded. Every screen of the main menu sets its own
+// (14 call sites in Scripts\Content\Triggers\MAIN MENU.scr, the "Waves*" trigger of each
+// screen's environment block), so without it the shoreline keeps the menu world's opening
+// settings through every screen.
+class ActionSetCoastSprites : public Action
+{
+public:
+	ActionSetCoastSprites();
+
+	void serialize(Archive& ar);
+	void activate();
+
+private:
+	CoastSpritesAttributes coastSprites_;
+};
+#endif
+
 class ActionSetFogOfWar : public Action
 {
 public: