Импорт пресета песочницы .cfg и списка модов

Сборки нередко раздают только пресет одиночной игры. Внутри это плоский
список «Параметр=значение» с точками вместо вложенности, поэтому значения
переносятся в SandboxVars.lua профиля по одному: комментарии игры и порядок
остаются на месте, а параметры модов, которых в файле ещё нет, пропускаются
со счётом. Если файла нет вовсе, он собирается из пресета целиком.

Заодно панель принимает строку из игровой кнопки «Поделиться»
(«Название:ModA;ModB;…»): она заменяет список включённых модов, сохраняя
порядок загрузки. Идентификаторов мастерской в такой строке нет, поэтому
пакеты добавляются только для модов, чьи файлы уже на диске, а про остальные
панель предупреждает.

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

internal/api/handlers_presets.go

@@ -5,6 +5,7 @@ import (
 	"fmt"
 	"io"
 	"net/http"
+	"os"
 	"path/filepath"
 	"strings"
 
@@ -140,23 +141,66 @@ func (s *Server) applyPreset(files preset.Files, id string, keep []string) (map[
 		written = append(written, filepath.Base(path))
 	}
 
-	raw := [][2]any{
-		{s.cfg.SandboxConfigPathFor(id), files.Sandbox},
-		{spawnRegionsPath(s.cfg, id), files.SpawnRegions},
-	}
-	for _, pair := range raw {
-		data, _ := pair[1].([]byte)
-		if data == nil {
-			continue
+	result := map[string]any{"kept": kept, "kept_from": keptFrom}
+
+	sandboxPath := s.cfg.SandboxConfigPathFor(id)
+	switch {
+	case files.Sandbox != nil:
+		// Готовый файл сервера кладём как есть.
+		if err := pzconfig.SaveRaw(sandboxPath, files.Sandbox); err != nil {
+			return nil, err
 		}
-		path := pair[0].(string)
-		if err := pzconfig.SaveRaw(path, data); err != nil {
+		written = append(written, filepath.Base(sandboxPath))
+	case files.SandboxPreset != nil:
+		applied, skipped, err := applySandboxPreset(sandboxPath, files.SandboxPreset)
+		if err != nil {
+			return nil, err
+		}
+		written = append(written, filepath.Base(sandboxPath))
+		result["applied"] = applied
+		result["skipped"] = skipped
+	}
+
+	if files.SpawnRegions != nil {
+		path := spawnRegionsPath(s.cfg, id)
+		if err := pzconfig.SaveRaw(path, files.SpawnRegions); err != nil {
 			return nil, err
 		}
 		written = append(written, filepath.Base(path))
 	}
 
-	return map[string]any{"files": written, "kept": kept, "kept_from": keptFrom}, nil
+	result["files"] = written
+	return result, nil
+}
+
+// applySandboxPreset переносит значения пресета одиночной игры в песочницу
+// профиля. Пресет плоский, а файл сервера — таблица Lua с комментариями игры,
+// поэтому значения переставляются по одному, а сам файл остаётся прежним.
+// Если файла ещё нет (профиль ни разу не запускался), он создаётся целиком.
+func applySandboxPreset(path string, data []byte) (applied, skipped int, err error) {
+	values := preset.ParseSandboxPreset(data)
+
+	sandbox, err := pzconfig.LoadSandbox(path)
+	if os.IsNotExist(err) {
+		return len(values.Values), 0, pzconfig.SaveRaw(path, values.Lua())
+	}
+	if err != nil {
+		return 0, 0, err
+	}
+
+	for _, key := range values.Order() {
+		// Параметров модов в файле нет, пока моды не установлены и сервер не
+		// запускался: такие значения пропускаем и считаем.
+		if err := sandbox.Set(key, values.Values[key]); err != nil {
+			skipped++
+			continue
+		}
+		applied++
+	}
+	if applied == 0 {
+		return 0, skipped, errors.New("ни один параметр пресета не подошёл к настройкам профиля")
+	}
+	return applied, skipped, pzconfig.SaveSandbox(path, sandbox)
 }
 
 // keepSource выбирает конфиг, из которого берутся сохраняемые значения.
@@ -218,8 +262,10 @@ func (s *Server) readPresetUpload(w http.ResponseWriter, r *http.Request) ([]pre
 	}
 	defer file.Close()
 
-	if !strings.HasSuffix(strings.ToLower(header.Filename), ".zip") {
-		writeError(w, r, http.StatusBadRequest, "ожидается ZIP-архив пакета настроек")
+	name := strings.ToLower(header.Filename)
+	if !strings.HasSuffix(name, ".zip") && !strings.HasSuffix(name, ".cfg") {
+		writeError(w, r, http.StatusBadRequest,
+			"ожидается ZIP-пакет настроек или пресет песочницы .cfg")
 		return nil, false
 	}
 	data, err := io.ReadAll(io.LimitReader(file, preset.MaxArchiveSize))
@@ -228,7 +274,7 @@ func (s *Server) readPresetUpload(w http.ResponseWriter, r *http.Request) ([]pre
 		return nil, false
 	}
 
-	sets, err := preset.FromZip(data)
+	sets, err := preset.FromUpload(header.Filename, data)
 	if err != nil {
 		writeError(w, r, http.StatusBadRequest, err.Error())
 		return nil, false

internal/preset/preset.go

@@ -32,28 +32,35 @@ const (
 // ErrNoServerFiles возвращается, когда в архиве нет ни одного серверного файла.
 var ErrNoServerFiles = errors.New("в архиве нет серверных файлов Project Zomboid")
 
+// ErrNoSandboxPreset — загруженный .cfg не похож на пресет песочницы.
+var ErrNoSandboxPreset = errors.New("файл не похож на пресет песочницы")
+
 // Files — серверная часть пакета: то, что PZ читает при запуске.
 type Files struct {
 	// Name — имя, под которым файлы лежали в архиве (sophie-server-42-2).
-	Name         string
-	INI          []byte
-	Sandbox      []byte
-	SpawnRegions []byte
+	Name    string
+	INI     []byte
+	Sandbox []byte
+	// SandboxPreset — пресет песочницы одиночной игры (.cfg). Готового файла
+	// сервера в пакете может не быть: сборки нередко раздают только его.
+	SandboxPreset []byte
+	SpawnRegions  []byte
 }
 
 // Summary — то, что панель показывает до импорта, чтобы человек понимал, что
 // именно он собирается записать поверх своих настроек.
 type Summary struct {
-	Name            string   `json:"name"`
-	ServerName      string   `json:"server_name"`
-	Maps            []string `json:"maps"`
-	Mods            int      `json:"mods"`
-	WorkshopItems   int      `json:"workshop_items"`
-	Settings        int      `json:"settings"`
-	SandboxSettings int      `json:"sandbox_settings"`
-	HasINI          bool     `json:"has_ini"`
-	HasSandbox      bool     `json:"has_sandbox"`
-	HasSpawnRegions bool     `json:"has_spawn_regions"`
+	Name             string   `json:"name"`
+	ServerName       string   `json:"server_name"`
+	Maps             []string `json:"maps"`
+	Mods             int      `json:"mods"`
+	WorkshopItems    int      `json:"workshop_items"`
+	Settings         int      `json:"settings"`
+	SandboxSettings  int      `json:"sandbox_settings"`
+	HasINI           bool     `json:"has_ini"`
+	HasSandbox       bool     `json:"has_sandbox"`
+	HasSandboxPreset bool     `json:"has_sandbox_preset"`
+	HasSpawnRegions  bool     `json:"has_spawn_regions"`
 }
 
 // markers — параметры, по которым .ini опознаётся как конфиг сервера. В
@@ -67,6 +74,19 @@ var markers = []string{
 
 const markersRequired = 3
 
+// FromUpload разбирает то, что загрузили в панель: ZIP-пакет сборки или
+// одиночный пресет песочницы.
+func FromUpload(filename string, data []byte) ([]Files, error) {
+	if strings.HasSuffix(strings.ToLower(filename), ".cfg") {
+		if !looksLikeSandboxPreset(data) {
+			return nil, ErrNoSandboxPreset
+		}
+		name := strings.TrimSuffix(path.Base(filename), path.Ext(filename))
+		return []Files{{Name: name, SandboxPreset: data}}, nil
+	}
+	return FromZip(data)
+}
+
 // FromZip достаёт из архива все наборы серверных файлов. Наборов может быть
 // несколько: сборки иногда кладут рядом варианты конфигов.
 func FromZip(data []byte) ([]Files, error) {
@@ -106,6 +126,11 @@ func FromZip(data []byte) ([]Files, error) {
 		if kind == kindINI && !looksLikeServerConfig(content) {
 			continue
 		}
+		// .cfg в архиве хватает и помимо песочницы: списки модов, настройки
+		// папок. Отличаем по знакомым параметрам.
+		if kind == kindSandboxPreset && !looksLikeSandboxPreset(content) {
+			continue
+		}
 
 		set := sets[base]
 		if set == nil {
@@ -117,6 +142,8 @@ func FromZip(data []byte) ([]Files, error) {
 			set.INI = content
 		case kindSandbox:
 			set.Sandbox = content
+		case kindSandboxPreset:
+			set.SandboxPreset = content
 		case kindSpawnRegions:
 			set.SpawnRegions = content
 		}
@@ -125,7 +152,7 @@ func FromZip(data []byte) ([]Files, error) {
 	out := make([]Files, 0, len(sets))
 	for _, set := range sets {
 		// Одни точки появления без конфига и песочницы импортировать некуда.
-		if set.INI == nil && set.Sandbox == nil {
+		if set.INI == nil && set.Sandbox == nil && set.SandboxPreset == nil {
 			continue
 		}
 		out = append(out, *set)
@@ -143,6 +170,7 @@ const (
 	kindOther kind = iota
 	kindINI
 	kindSandbox
+	kindSandboxPreset
 	kindSpawnRegions
 )
 
@@ -156,6 +184,8 @@ func classify(name string) (string, kind) {
 		return name[:len(name)-len("_spawnregions.lua")], kindSpawnRegions
 	case strings.HasSuffix(lower, ".ini"):
 		return name[:len(name)-len(".ini")], kindINI
+	case strings.HasSuffix(lower, ".cfg"):
+		return name[:len(name)-len(".cfg")], kindSandboxPreset
 	}
 	return "", kindOther
 }
@@ -193,11 +223,12 @@ func readEntry(entry *zip.File) ([]byte, error) {
 // Describe собирает сводку по набору: сколько модов, карт и параметров.
 func (f Files) Describe() Summary {
 	s := Summary{
-		Name:            f.Name,
-		HasINI:          f.INI != nil,
-		HasSandbox:      f.Sandbox != nil,
-		HasSpawnRegions: f.SpawnRegions != nil,
-		Maps:            []string{},
+		Name:             f.Name,
+		HasINI:           f.INI != nil,
+		HasSandbox:       f.Sandbox != nil,
+		HasSandboxPreset: f.SandboxPreset != nil,
+		HasSpawnRegions:  f.SpawnRegions != nil,
+		Maps:             []string{},
 	}
 	if f.INI != nil {
 		ini := pzconfig.ParseINI(f.INI)
@@ -207,8 +238,11 @@ func (f Files) Describe() Summary {
 		s.Maps = splitList(ini.Get("Map"))
 		s.Settings = len(ini.Keys())
 	}
-	if f.Sandbox != nil {
+	switch {
+	case f.Sandbox != nil:
 		s.SandboxSettings = len(pzconfig.ParseSandbox(f.Sandbox).Entries())
+	case f.SandboxPreset != nil:
+		s.SandboxSettings = len(ParseSandboxPreset(f.SandboxPreset).Values)
 	}
 	return s
 }

internal/preset/sandbox.go

@@ -0,0 +1,170 @@
+package preset
+
+import (
+	"bytes"
+	"fmt"
+	"regexp"
+	"strconv"
+	"strings"
+)
+
+// Пресет песочницы одиночной игры — это плоский key=value с точками вместо
+// вложенных таблиц:
+//
+//	Version=6
+//	# Комментарий игры
+//	    -- 1 = Insane
+//	Zombies=4
+//	ZombieLore.Speed=2
+//	KDOT.SpecialVehicleChance=4.0
+//
+// Серверу нужен тот же набор значений, но в виде Lua-таблицы SandboxVars.
+
+var (
+	// sandboxKeyRe — путь параметра: имя или несколько имён через точку.
+	sandboxKeyRe = regexp.MustCompile(`^[A-Za-z_][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)*$`)
+	// numberRe — то, что в Lua записывается без кавычек.
+	numberRe = regexp.MustCompile(`^-?\d+(?:\.\d+)?$`)
+)
+
+// sandboxMarkers — параметры, которые есть в любом пресете песочницы. По ним
+// он отличается от прочих .cfg в архиве (списки модов, настройки папок).
+var sandboxMarkers = []string{
+	"Zombies", "Distribution", "DayLength", "StartYear", "StartMonth", "WaterShut",
+	"ElecShut", "XpMultiplier", "StatsDecrease", "Temperature", "Rain", "ZombieLore.Speed",
+	"ZombieLore.Strength", "LootRespawn", "FoodRotSpeed", "Nutrition",
+}
+
+const sandboxMarkersRequired = 3
+
+// SandboxPreset — разобранный пресет песочницы.
+type SandboxPreset struct {
+	// Version — версия формата из первой строки пресета.
+	Version string
+	// Values — путь параметра → значение, уже записанное на языке Lua.
+	Values map[string]string
+	// order хранит порядок появления: файл песочницы читают глазами, и
+	// перемешивать параметры незачем.
+	order []string
+}
+
+// ParseSandboxPreset разбирает пресет. Строки, не похожие на параметр
+// (комментарии игры, расшифровки значений), пропускаются.
+func ParseSandboxPreset(data []byte) *SandboxPreset {
+	p := &SandboxPreset{Values: map[string]string{}}
+
+	text := strings.ReplaceAll(string(data), "\r\n", "\n")
+	for _, line := range strings.Split(text, "\n") {
+		trimmed := strings.TrimSpace(line)
+		// Расшифровки значений игра пишет как "-- 1 = Insane", и знак равенства
+		// в них есть — без этой проверки они стали бы параметрами.
+		if trimmed == "" || strings.HasPrefix(trimmed, "#") || strings.HasPrefix(trimmed, "--") {
+			continue
+		}
+		key, value, found := strings.Cut(trimmed, "=")
+		key = strings.TrimSpace(key)
+		if !found || !sandboxKeyRe.MatchString(key) {
+			continue
+		}
+		if strings.EqualFold(key, "Version") {
+			p.Version = strings.TrimSpace(value)
+			continue
+		}
+		if _, seen := p.Values[key]; !seen {
+			p.order = append(p.order, key)
+		}
+		p.Values[key] = luaValue(value)
+	}
+	return p
+}
+
+// Order возвращает пути параметров в порядке их появления в пресете.
+func (p *SandboxPreset) Order() []string { return p.order }
+
+// looksLikeSandboxPreset отличает пресет песочницы от прочих .cfg.
+func looksLikeSandboxPreset(data []byte) bool {
+	p := ParseSandboxPreset(data)
+	found := 0
+	for _, key := range sandboxMarkers {
+		if _, ok := p.Values[key]; ok {
+			found++
+		}
+	}
+	return found >= sandboxMarkersRequired
+}
+
+// luaValue переводит значение пресета в запись Lua: числа и логические
+// значения идут как есть, всё остальное — строка в кавычках.
+func luaValue(raw string) string {
+	value := strings.TrimSpace(raw)
+	switch {
+	case value == "true" || value == "false":
+		return value
+	case numberRe.MatchString(value):
+		return value
+	default:
+		return strconv.Quote(value)
+	}
+}
+
+// node — узел дерева параметров: либо значение, либо вложенная таблица.
+// Дерево нужно потому, что в Lua «ZombieLore.Speed = 2» внутри таблицы
+// написать нельзя — только настоящей вложенностью.
+type node struct {
+	value    string
+	order    []string
+	children map[string]*node
+}
+
+func (n *node) child(name string) *node {
+	if n.children == nil {
+		n.children = map[string]*node{}
+	}
+	if _, ok := n.children[name]; !ok {
+		n.children[name] = &node{}
+		n.order = append(n.order, name)
+	}
+	return n.children[name]
+}
+
+// Lua собирает из пресета целый SandboxVars.lua. Нужен, когда переносить
+// значения некуда: профиль ещё ни разу не запускался, и своего файла
+// песочницы у него нет.
+func (p *SandboxPreset) Lua() []byte {
+	root := &node{}
+
+	version := p.Version
+	if version == "" {
+		version = "1"
+	}
+	root.child("VERSION").value = version
+
+	for _, key := range p.order {
+		current := root
+		for _, name := range strings.Split(key, ".") {
+			current = current.child(name)
+		}
+		current.value = p.Values[key]
+	}
+
+	var buf bytes.Buffer
+	buf.WriteString("SandboxVars = {\n")
+	writeNode(&buf, root, "    ")
+	buf.WriteString("}\n")
+	return buf.Bytes()
+}
+
+func writeNode(buf *bytes.Buffer, n *node, indent string) {
+	for _, name := range n.order {
+		child := n.children[name]
+		// Значение и вложенные параметры одновременно означали бы, что в
+		// пресете есть и «A», и «A.B»: доверяем вложенности, она полнее.
+		if len(child.order) == 0 {
+			fmt.Fprintf(buf, "%s%s = %s,\n", indent, name, child.value)
+			continue
+		}
+		fmt.Fprintf(buf, "%s%s = {\n", indent, name)
+		writeNode(buf, child, indent+"    ")
+		fmt.Fprintf(buf, "%s},\n", indent)
+	}
+}

internal/preset/sandbox_test.go

@@ -0,0 +1,116 @@
+package preset
+
+import (
+	"strings"
+	"testing"
+
+	"github.com/mrleo1nid/pzmanager/internal/pzconfig"
+)
+
+// sandboxCFG повторяет то, как пресет выглядит у игры: комментарии с решёткой,
+// расшифровки значений со знаком равенства внутри и точки вместо вложенности.
+const sandboxCFG = `Version=6
+# Changing this also sets the "Population Multiplier" in Advanced Zombie Options. Default = Normal
+    -- 1 = Insane
+    -- 4 = Normal
+Zombies=4
+
+# Controls whether some randomization is applied.
+ZombieVoronoiNoise=true
+DayLength=3
+XpMultiplier=1.5
+StatsDecrease=3
+Temperature=3
+Rain=3
+LootRespawn=1
+FoodRotSpeed=5
+Nutrition=true
+WorldItemRemovalList=Base.Hat, Base.Glasses
+ZombieLore.Speed=2
+ZombieLore.Strength=2
+KDOT.SpecialVehicleChance=4.0
+`
+
+func TestParseSandboxPreset(t *testing.T) {
+	p := ParseSandboxPreset([]byte(sandboxCFG))
+
+	if p.Version != "6" {
+		t.Errorf("версия = %q", p.Version)
+	}
+	// Строки «-- 4 = Normal» тоже содержат знак равенства, и параметрами они
+	// не являются.
+	for key := range p.Values {
+		if !sandboxKeyRe.MatchString(key) {
+			t.Errorf("в значения попал мусор: %q", key)
+		}
+	}
+
+	want := map[string]string{
+		"Zombies":                   "4",
+		"ZombieVoronoiNoise":        "true",
+		"XpMultiplier":              "1.5",
+		"ZombieLore.Speed":          "2",
+		"KDOT.SpecialVehicleChance": "4.0",
+		"WorldItemRemovalList":      `"Base.Hat, Base.Glasses"`,
+	}
+	for key, value := range want {
+		if got := p.Values[key]; got != value {
+			t.Errorf("%s = %q, ожидалось %q", key, got, value)
+		}
+	}
+	if _, ok := p.Values["Version"]; ok {
+		t.Error("Version не должен попадать в значения: у файла сервера свой VERSION")
+	}
+}
+
+// Сгенерированный файл читает и сама игра, и парсер панели — второе проверить
+// можно прямо здесь.
+func TestSandboxPresetLuaRoundTrip(t *testing.T) {
+	p := ParseSandboxPreset([]byte(sandboxCFG))
+	lua := p.Lua()
+
+	parsed := pzconfig.ParseSandbox(lua)
+	if got, ok := parsed.Get("VERSION"); !ok || got != "6" {
+		t.Errorf("VERSION = %q (%v)", got, ok)
+	}
+	for key, want := range p.Values {
+		got, ok := parsed.Get(key)
+		if !ok {
+			t.Errorf("параметр %s не читается обратно:\n%s", key, lua)
+			continue
+		}
+		if got != want {
+			t.Errorf("%s = %q, ожидалось %q", key, got, want)
+		}
+	}
+	// Вложенность должна быть настоящей: «ZombieLore.Speed = 2» внутри таблицы
+	// Lua не примет.
+	if strings.Contains(string(lua), "ZombieLore.Speed =") {
+		t.Errorf("точка осталась в имени параметра:\n%s", lua)
+	}
+}
+
+// Пути бывают глубже одного уровня — файл должен остаться разбираемым.
+func TestSandboxPresetDeepPath(t *testing.T) {
+	p := ParseSandboxPreset([]byte("A.B.C=7\nZombies=1\nDayLength=3\nRain=2\n"))
+	parsed := pzconfig.ParseSandbox(p.Lua())
+	if got, ok := parsed.Get("A.B.C"); !ok || got != "7" {
+		t.Fatalf("A.B.C = %q (%v)\n%s", got, ok, p.Lua())
+	}
+}
+
+func TestLooksLikeSandboxPreset(t *testing.T) {
+	if !looksLikeSandboxPreset([]byte(sandboxCFG)) {
+		t.Error("пресет песочницы не опознан")
+	}
+	// В том же архиве лежат списки модов и настройки папок с тем же
+	// расширением .cfg.
+	modFolders := "version=2\nnext=15\nfolder=3|1|4D,61,70,73\n"
+	if looksLikeSandboxPreset([]byte(modFolders)) {
+		t.Error("настройки папок приняты за пресет песочницы")
+	}
+	modList := "!fav!:\nSophie-42-v2:ModA;ModB;ModC\n"
+	if looksLikeSandboxPreset([]byte(modList)) {
+		t.Error("список модов принят за пресет песочницы")
+	}
+}