MACS2: extract tools and build dat file

Makefile

@@ -109,6 +109,9 @@ endif
 	$(STRIP) descumm$(EXEEXT) -o $(WIN32PATH)/tools/descumm$(EXEEXT)
 	$(STRIP) desword2$(EXEEXT) -o $(WIN32PATH)/tools/desword2$(EXEEXT)
 	$(STRIP) detwine$(EXEEXT) -o $(WIN32PATH)/tools/detwine$(EXEEXT)
+	$(STRIP) demacs2$(EXEEXT) -o $(WIN32PATH)/tools/demacs2$(EXEEXT)
+	$(STRIP) extract_macs2$(EXEEXT) -o $(WIN32PATH)/tools/extract_macs2$(EXEEXT)
+	$(STRIP) create_macs2_translation$(EXEEXT) -o $(WIN32PATH)/tools/create_macs2_translation$(EXEEXT)
 	$(STRIP) extract_mohawk$(EXEEXT) -o $(WIN32PATH)/tools/extract_mohawk$(EXEEXT)
 	$(STRIP) gob_loadcalc$(EXEEXT) -o $(WIN32PATH)/tools/gob_loadcalc$(EXEEXT)
 	$(STRIP) grim_animb2txt$(EXEEXT) -o $(WIN32PATH)/tools/grim_animb2txt$(EXEEXT)
@@ -308,6 +311,9 @@ endif
 	$(STRIP) descumm$(EXEEXT) -o $(AMIGAOSPATH)/descumm$(EXEEXT)
 	$(STRIP) desword2$(EXEEXT) -o $(AMIGAOSPATH)/desword2$(EXEEXT)
 	$(STRIP) detwine$(EXEEXT) -o $(AMIGAOSPATH)/detwine$(EXEEXT)
+	$(STRIP) demacs2$(EXEEXT) -o $(AMIGAOSPATH)/demacs2$(EXEEXT)
+	$(STRIP) extract_macs2$(EXEEXT) -o $(AMIGAOSPATH)/extract_macs2$(EXEEXT)
+	$(STRIP) create_macs2_translation$(EXEEXT) -o $(AMIGAOSPATH)/create_macs2_translation$(EXEEXT)
 	$(STRIP) extract_mohawk$(EXEEXT) -o $(AMIGAOSPATH)/extract_mohawk$(EXEEXT)
 	$(STRIP) extract_ngi$(EXEEXT) -o $(AMIGAOSPATH)/extract_ngi$(EXEEXT)
 	$(STRIP) gob_loadcalc$(EXEEXT) -o $(AMIGAOSPATH)/gob_loadcalc$(EXEEXT)

Makefile.common

@@ -35,6 +35,7 @@ PROGRAMS = \
 	extract_gob_cdi \
 	extract_mohawk \
 	extract_macs2 \
+	create_macs2_translation \
 	extract_ngi \
 	construct_mohawk \
 	msn_convert_mod \
@@ -145,6 +146,9 @@ demacs2_OBJS := \
 extract_macs2_OBJS := \
 	engines/macs2/extract_macs2.o
 
+create_macs2_translation_OBJS := \
+	engines/macs2/create_macs2_translation.o
+
 extract_hadesch_OBJS := \
 	engines/hadesch/extract_hadesch.o \
 	$(UTILS)

engines/macs2/TRANSLATE.md

@@ -0,0 +1,29 @@
+# MACS2 Tools
+
+Tools for the MACS2 engine (Schatz im Silbersee).
+
+## Translation Workflow
+
+The game was originally released in German only. Translations are managed via standard PO files.
+
+### 1. Extract strings to a PO template
+
+```bash
+create_macs2_translation extract RESOURCE.MCS macs2.pot
+```
+
+This produces a `.pot` file with all game strings grouped by dialog context. The format uses `msgctxt` to identify the source (scene or object) and `\n` to separate lines within a dialog unit.
+
+The `\n` separators correspond to individual display lines in the game. Keep the same number of lines as the original.
+
+### 3. Pack into binary
+
+```bash
+create_macs2_translation pack en.po macs2_translation.dat
+```
+
+### 4. Install
+
+Place `macs2_translation.dat` in the game directory alongside `RESOURCE.MCS`. ScummVM will detect the translation and offer the translated language variant.
+
+The file is also distributed via `dists/engine-data/macs2_translation.dat` in the ScummVM source tree.