5 Commits
Author SHA1 Message Date
mrleo1nidandClaude Opus 5 5d50b609f6 Настройки сервера и песочницы разложены по разделам
CI / test (push) Successful in 21s
Release / release (push) Successful in 26s
Полторы сотни параметров сплошным списком читать невозможно. Теперь они
разбиты на разделы — «Основное», «PVP и урон», «Убежища», «Античит» и так
далее, — свёрнутые по умолчанию, кроме первого. Поиск раскрывает разделы с
совпадениями и прячет остальные, а раскрытые разделы не схлопываются при
возврате на вкладку.

Категории составлены по настоящим конфигам Build 41 и 42: все 144 ключа
.ini и 270 параметров песочницы раскладываются без остатка. Нумерованные
и однотипные ключи (AntiCheatProtectionType1..24, *Loot, Animal*, Firearm*)
подхватываются по префиксу, а незнакомые попадают в «Прочее» — в новых
версиях игры ключи добавляют, и терять их со страницы нельзя.

Описания параметров панель больше не выдумывает, а берёт из самого
конфига: игра пишет их комментариями на языке сервера. Полный текст — во
всплывающей подсказке, начало — под полем; поиск ищет и по описанию, так
что параметр можно найти по-русски.

Заодно исправлено сохранение файлов с виндовыми переводами строк: панель
переписывала их в LF, и правка одного параметра меняла каждую строку
файла. Проверено на реальном SandboxVars.lua: правка одного значения
меняет ровно одну строку, размер файла не меняется.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 03:07:59 +03:00
mrleo1nidandClaude Opus 5 4a346c4ed9 В обновлении видно изменения всех пропущенных версий
CI / test (push) Successful in 21s
Release / release (push) Successful in 29s
Панель показывала описание только последнего релиза. Пропустив пару
версий, человек не узнал бы, что менялось в промежутке, — теперь
запрашивается список релизов и показываются все, что новее установленной,
каждая со своим заголовком и датой. Черновики и предрелизы отбрасываются,
порядок восстанавливается по номерам версий, а не по тому, как их отдал
Gitea.

Заодно в карточке профиля появились подсказки: сколько на машине ОЗУ (не
выбирать же лимит JVM вслепую) и что означает пустое поле начальной
памяти.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 02:25:16 +03:00
mrleo1nidandClaude Opus 5 e78a72d516 Память JVM задаётся раздельно, автоперезапуск можно отменить
Панель принудительно ставила -Xms равным -Xmx: куча не растёт на ходу, но
JVM обязана занять весь объём при старте. На машине с 5 ГБ ОЗУ сервер с
4g так вообще не поднимался — «Failed to allocate initial Java heap».

Теперь -Xmx задаётся как раньше, а -Xms стал отдельным полем профиля и по
умолчанию пуст: JVM берёт память по мере надобности. Пара значений
проверяется при сохранении профиля, а не при запуске сервера, — про
опечатку лучше узнать из формы, чем из лога упавшего сервера.

Там же в супервизоре: ожидание автоподъёма стало отдельным состоянием.
Раньше упавший сервер уходил в цикл «падение — пауза 10 секунд — падение»,
причём во время паузы он считался остановленным, и прервать это было
нечем. Теперь паузу видно в статусе с обратным отсчётом и её можно
отменить, а после трёх падений сразу после запуска подряд панель
перестаёт поднимать сервер сама: так проявляется нехватка памяти или
битый конфиг, и перезапуск тут не помогает.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 02:25:16 +03:00
mrleo1nidandClaude Opus 5 f6eba8c75c Кнопка SteamCMD называет то, что произойдёт
Release / release (push) Successful in 26s
CI / test (push) Successful in 20s
«Установить / обновить через SteamCMD» одинаково выглядела и на чистой
машине, и на готовой. Теперь пока серверных файлов нет — это «Установить
сервер через SteamCMD», после установки — «Обновить сервер через
SteamCMD»; подсказка и вопрос перед запуском меняются вместе с ней.

На чистой машине подсказка вместо требования остановить сервер (его ещё
нет) говорит то, что важно знать заранее: сколько это займёт времени и
места на диске.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 02:02:08 +03:00
mrleo1nidandClaude Opus 5 27a2fd6386 Консоль не принимает команды у остановленного сервера
CI / test (push) Successful in 20s
Release / release (push) Successful in 25s
Поле ввода и кнопка «Отправить» были активны всегда, хотя команда уходит
в stdin процесса: у остановленного сервера его просто нет, и панель
отвечала ошибкой уже после отправки. Теперь консоль блокируется, а
подсказка объясняет, почему.

Заодно из вывода убираются управляющие последовательности терминала.
SteamCMD раскрашивает свои сообщения, и в браузере это выглядело как
«[0mWaiting for user info...[0mOK». Чистка стоит на общем пути записи в
буфер: через него идёт и вывод сервера, и SteamCMD, и сообщения панели.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 01:56:55 +03:00
18 changed files with 1185 additions and 108 deletions
+34 -2
View File
@@ -22,7 +22,8 @@
- **Мониторинг** — состояние, аптайм, CPU и память процесса сервера, свободные - **Мониторинг** — состояние, аптайм, CPU и память процесса сервера, свободные
ОЗУ и диск на хосте, список игроков онлайн. ОЗУ и диск на хосте, список игроков онлайн.
- **Редактор конфигов** — `servertest.ini` и `SandboxVars.lua` прямо в - **Редактор конфигов** — `servertest.ini` и `SandboxVars.lua` прямо в
браузере, с поиском по параметрам и сохранением комментариев в файле. браузере: параметры разложены по разделам, у каждого видно описание из
самого конфига, поиск идёт и по названию, и по описанию.
- **Мод-менеджер** — моды списком с галочками и перетаскиванием порядка - **Мод-менеджер** — моды списком с галочками и перетаскиванием порядка
загрузки, добавление по ссылке и разворачивание коллекций Steam целиком. загрузки, добавление по ссылке и разворачивание коллекций Steam целиком.
- **Бэкапы** — ручные и по расписанию, отдельно по каждому профилю, с - **Бэкапы** — ручные и по расписанию, отдельно по каждому профилю, с
@@ -192,6 +193,22 @@ Mod ID, который нужен серверу, лежит внутри сам
Один пакет мастерской может содержать несколько модов — в списке они идут Один пакет мастерской может содержать несколько модов — в списке они идут
отдельными строками, и включать их можно по отдельности. отдельными строками, и включать их можно по отдельности.
## Редактор конфигов
Вкладки «Конфиг сервера» и «Песочница» показывают параметры не сплошным
списком, а разделами: «Основное», «PVP и урон», «Убежища», «Античит» и так
далее. Разделы сворачиваются, а поиск сверху раскрывает те, где нашлось
совпадение. Ключи, которых панель не знает (в новой версии игры их всегда
добавляют), не теряются — они собираются в раздел «Прочее».
Описания параметров панель берёт из самого конфига: игра пишет их
комментариями на языке сервера. Полный текст виден при наведении, начало —
прямо под полем.
Правка меняет ровно ту строку, которую поправили: комментарии, порядок и
переводы строк файла сохраняются, а рядом остаётся копия прежней версии с
расширением `.bak`.
## Профили серверов ## Профили серверов
Профиль — это отдельный сервер: свой мир, свой `*.ini`, свои настройки Профиль — это отдельный сервер: свой мир, свой `*.ini`, свои настройки
@@ -213,6 +230,20 @@ Mod ID, который нужен серверу, лежит внутри сам
При создании профиля можно скопировать `.ini` и настройки песочницы из При создании профиля можно скопировать `.ini` и настройки песочницы из
существующего: удобно, когда нужен тот же набор правил, но чистый мир. существующего: удобно, когда нужен тот же набор правил, но чистый мир.
### Память JVM
`java_memory` — это `-Xmx`, верхняя граница кучи. `java_memory_min` (`-Xms`)
по умолчанию пуст, и это осознанно: равные значения избавляют от роста кучи на
ходу, но заставляют JVM занять весь объём сразу при старте. На машине, где
столько свободной памяти не набирается, сервер тогда не поднимется вовсе —
`Failed to allocate initial Java heap`. Задавайте минимум, только если памяти
заведомо хватает.
Сервер, упавший сразу после запуска три раза подряд, панель перестаёт
поднимать автоматически: обычно так проявляется нехватка памяти или битый
конфиг, и перезапуск делу не помогает. Пока идёт отсчёт до автоподъёма, его
можно отменить кнопкой «Отменить перезапуск».
Удаление профиля убирает его только из панели — мир и конфиги остаются на Удаление профиля убирает его только из панели — мир и конфиги остаются на
диске. Чтобы вернуть профиль, создайте его с тем же идентификатором. диске. Чтобы вернуть профиль, создайте его с тем же идентификатором.
@@ -327,7 +358,8 @@ profiles: # серверы: у каждого свой м
- id: vanilla # vanilla -> vanilla.ini, Saves/Multiplayer/vanilla - id: vanilla # vanilla -> vanilla.ini, Saves/Multiplayer/vanilla
title: Ванильный мир # как профиль подписан в панели title: Ванильный мир # как профиль подписан в панели
admin_password: "" # пароль админа игрового сервера admin_password: "" # пароль админа игрового сервера
java_memory: 4g # -Xmx для JVM этого профиля java_memory: 4g # -Xmx: верхняя граница кучи JVM
java_memory_min: "" # -Xms: пусто — JVM берёт память по мере надобности
extra_args: [] # доп. аргументы start-server.sh extra_args: [] # доп. аргументы start-server.sh
- id: modded - id: modded
title: Сборка с модами title: Сборка с модами
+3
View File
@@ -32,6 +32,9 @@ func (s *Server) handleGetServerConfig(w http.ResponseWriter, r *http.Request) {
"path": path, "path": path,
"keys": ini.Keys(), "keys": ini.Keys(),
"values": ini.Map(), "values": ini.Map(),
// Игра сама пишет в конфиг описания параметров на языке сервера —
// показываем их, вместо того чтобы придумывать свои.
"descriptions": ini.Comments(),
}) })
} }
+32
View File
@@ -7,15 +7,36 @@ import (
"os" "os"
"github.com/mrleo1nid/pzmanager/internal/config" "github.com/mrleo1nid/pzmanager/internal/config"
"github.com/mrleo1nid/pzmanager/internal/pzconfig"
"github.com/mrleo1nid/pzmanager/internal/pzserver" "github.com/mrleo1nid/pzmanager/internal/pzserver"
) )
// validateProfileMemory проверяет границы кучи JVM здесь, а не при запуске
// сервера: иначе про опечатку в профиле стало бы известно только из лога
// упавшего сервера.
func validateProfileMemory(dto profileDTO) error {
maxBytes, err := pzconfig.ParseMemory(dto.JavaMemory)
if err != nil {
return err
}
minBytes, err := pzconfig.ParseMemory(dto.JavaMemoryMin)
if err != nil {
return err
}
if maxBytes > 0 && minBytes > maxBytes {
return fmt.Errorf("начальный размер памяти (%s) больше максимального (%s)",
dto.JavaMemoryMin, dto.JavaMemory)
}
return nil
}
// profileDTO — профиль в том виде, в каком его показывает панель. Пароль // profileDTO — профиль в том виде, в каком его показывает панель. Пароль
// наружу не отдаётся, только признак того, что он задан. // наружу не отдаётся, только признак того, что он задан.
type profileDTO struct { type profileDTO struct {
ID string `json:"id"` ID string `json:"id"`
Title string `json:"title"` Title string `json:"title"`
JavaMemory string `json:"java_memory"` JavaMemory string `json:"java_memory"`
JavaMemoryMin string `json:"java_memory_min"`
ExtraArgs []string `json:"extra_args"` ExtraArgs []string `json:"extra_args"`
HasAdminPassword bool `json:"has_admin_password"` HasAdminPassword bool `json:"has_admin_password"`
AdminPassword string `json:"admin_password,omitempty"` AdminPassword string `json:"admin_password,omitempty"`
@@ -33,6 +54,7 @@ func (s *Server) profileToDTO(p config.Profile) profileDTO {
ID: p.ID, ID: p.ID,
Title: p.Title, Title: p.Title,
JavaMemory: p.JavaMemory, JavaMemory: p.JavaMemory,
JavaMemoryMin: p.JavaMemoryMin,
ExtraArgs: p.ExtraArgs, ExtraArgs: p.ExtraArgs,
HasAdminPassword: p.AdminPassword != "", HasAdminPassword: p.AdminPassword != "",
HasConfig: fileExists(s.cfg.ServerConfigPathFor(p.ID)), HasConfig: fileExists(s.cfg.ServerConfigPathFor(p.ID)),
@@ -61,11 +83,16 @@ func (s *Server) handleCreateProfile(w http.ResponseWriter, r *http.Request) {
if !decodeJSON(w, r, &dto) { if !decodeJSON(w, r, &dto) {
return return
} }
if err := validateProfileMemory(dto); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
profile := config.Profile{ profile := config.Profile{
ID: dto.ID, ID: dto.ID,
Title: dto.Title, Title: dto.Title,
JavaMemory: dto.JavaMemory, JavaMemory: dto.JavaMemory,
JavaMemoryMin: dto.JavaMemoryMin,
ExtraArgs: dto.ExtraArgs, ExtraArgs: dto.ExtraArgs,
AdminPassword: dto.AdminPassword, AdminPassword: dto.AdminPassword,
} }
@@ -133,11 +160,16 @@ func (s *Server) handleUpdateProfile(w http.ResponseWriter, r *http.Request) {
if !decodeJSON(w, r, &dto) { if !decodeJSON(w, r, &dto) {
return return
} }
if err := validateProfileMemory(dto); err != nil {
writeError(w, http.StatusBadRequest, err.Error())
return
}
updated := config.Profile{ updated := config.Profile{
ID: id, ID: id,
Title: dto.Title, Title: dto.Title,
JavaMemory: dto.JavaMemory, JavaMemory: dto.JavaMemory,
JavaMemoryMin: dto.JavaMemoryMin,
ExtraArgs: dto.ExtraArgs, ExtraArgs: dto.ExtraArgs,
// Пустой пароль означает "оставить прежний": наружу мы его не отдаём, // Пустой пароль означает "оставить прежний": наружу мы его не отдаём,
// и форма присылает пустую строку, пока его не меняли. // и форма присылает пустую строку, пока его не меняли.
+6 -2
View File
@@ -236,12 +236,16 @@ func StartBackupScheduler(ctx context.Context, s *Server) {
// При обычном старте то же самое делает супервизор. // При обычном старте то же самое делает супервизор.
func (s *Server) applyJavaMemory(log func(string)) error { func (s *Server) applyJavaMemory(log func(string)) error {
profile := s.cfg.ActiveProfile() profile := s.cfg.ActiveProfile()
if profile.JavaMemory == "" { if profile.JavaMemory == "" && profile.JavaMemoryMin == "" {
return nil return nil
} }
if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory); err != nil { if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory, profile.JavaMemoryMin); err != nil {
return err return err
} }
if profile.JavaMemoryMin != "" {
log(fmt.Sprintf("Память JVM: от %s до %s", profile.JavaMemoryMin, profile.JavaMemory))
} else {
log("Лимит памяти JVM выставлен: " + profile.JavaMemory) log("Лимит памяти JVM выставлен: " + profile.JavaMemory)
}
return nil return nil
} }
+5
View File
@@ -34,6 +34,11 @@ type Profile struct {
// запуске: файл запуска сервера общий для всех профилей. // запуске: файл запуска сервера общий для всех профилей.
JavaMemory string `yaml:"java_memory"` JavaMemory string `yaml:"java_memory"`
// JavaMemoryMin — -Xms. Пусто (по умолчанию) означает, что JVM занимает
// память по мере надобности: равные -Xms и -Xmx заставляют её забрать всё
// сразу, и на машине с небольшой ОЗУ сервер не поднимется.
JavaMemoryMin string `yaml:"java_memory_min"`
// ExtraArgs — дополнительные аргументы start-server.sh. // ExtraArgs — дополнительные аргументы start-server.sh.
ExtraArgs []string `yaml:"extra_args"` ExtraArgs []string `yaml:"extra_args"`
} }
+48 -4
View File
@@ -16,6 +16,10 @@ type iniLine struct {
Key string Key string
Value string Value string
Raw string Raw string
// Comment — описание параметра: строки комментария прямо перед ним.
// Project Zomboid пишет их на языке сервера, так что панели есть что
// показать человеку, не выдумывая своих формулировок.
Comment string
} }
// INI — конфиг PZ в виде плоских key=value. Разбор сохраняет исходный порядок // INI — конфиг PZ в виде плоских key=value. Разбор сохраняет исходный порядок
@@ -23,22 +27,46 @@ type iniLine struct {
type INI struct { type INI struct {
lines []iniLine lines []iniLine
index map[string]int index map[string]int
// crlf — файл был с виндовыми переводами строк. Сохраняем как было: иначе
// правка одного параметра переписывает весь файл целиком.
crlf bool
} }
// ParseINI разбирает содержимое конфига. // ParseINI разбирает содержимое конфига.
func ParseINI(data []byte) *INI { func ParseINI(data []byte) *INI {
ini := &INI{index: make(map[string]int)} ini := &INI{index: make(map[string]int)}
text := strings.ReplaceAll(string(data), "\r\n", "\n") raw := string(data)
ini.crlf = strings.Contains(raw, "\r\n")
text := strings.ReplaceAll(raw, "\r\n", "\n")
// Комментарии копим до ближайшего параметра: в конфигах PZ описание стоит
// строкой выше. Пустая строка обрывает связь — иначе описание прилипло бы
// к следующему блоку.
var comment []string
for _, raw := range strings.Split(text, "\n") { for _, raw := range strings.Split(text, "\n") {
trimmed := strings.TrimSpace(raw) trimmed := strings.TrimSpace(raw)
key, value, found := strings.Cut(raw, "=") key, value, found := strings.Cut(raw, "=")
if !found || trimmed == "" || strings.HasPrefix(trimmed, "#") {
if strings.HasPrefix(trimmed, "#") {
comment = append(comment, strings.TrimSpace(strings.TrimPrefix(trimmed, "#")))
ini.lines = append(ini.lines, iniLine{Raw: raw}) ini.lines = append(ini.lines, iniLine{Raw: raw})
continue continue
} }
if !found || trimmed == "" {
comment = nil
ini.lines = append(ini.lines, iniLine{Raw: raw})
continue
}
key = strings.TrimSpace(key) key = strings.TrimSpace(key)
ini.index[key] = len(ini.lines) ini.index[key] = len(ini.lines)
ini.lines = append(ini.lines, iniLine{Key: key, Value: strings.TrimSpace(value)}) ini.lines = append(ini.lines, iniLine{
Key: key,
Value: strings.TrimSpace(value),
Comment: strings.Join(comment, " "),
})
comment = nil
} }
return ini return ini
} }
@@ -90,6 +118,17 @@ func (i *INI) Keys() []string {
return out return out
} }
// Comments возвращает описания параметров: ключ -> текст комментария.
func (i *INI) Comments() map[string]string {
out := make(map[string]string, len(i.index))
for _, l := range i.lines {
if l.Key != "" && l.Comment != "" {
out[l.Key] = l.Comment
}
}
return out
}
// Map отдаёт все параметры в виде словаря. // Map отдаёт все параметры в виде словаря.
func (i *INI) Map() map[string]string { func (i *INI) Map() map[string]string {
out := make(map[string]string, len(i.index)) out := make(map[string]string, len(i.index))
@@ -103,6 +142,11 @@ func (i *INI) Map() map[string]string {
// Render собирает файл обратно в текст. // Render собирает файл обратно в текст.
func (i *INI) Render() []byte { func (i *INI) Render() []byte {
newline := "\n"
if i.crlf {
newline = "\r\n"
}
var buf bytes.Buffer var buf bytes.Buffer
for n, l := range i.lines { for n, l := range i.lines {
if l.Key == "" { if l.Key == "" {
@@ -113,7 +157,7 @@ func (i *INI) Render() []byte {
buf.WriteString(l.Value) buf.WriteString(l.Value)
} }
if n < len(i.lines)-1 { if n < len(i.lines)-1 {
buf.WriteByte('\n') buf.WriteString(newline)
} }
} }
return buf.Bytes() return buf.Bytes()
+63 -13
View File
@@ -6,24 +6,71 @@ import (
"os" "os"
"path/filepath" "path/filepath"
"regexp" "regexp"
"strconv"
"strings" "strings"
) )
// javaLauncherFile — файл, из которого сервер берёт аргументы JVM. // javaLauncherFile — файл, из которого сервер берёт аргументы JVM.
const javaLauncherFile = "ProjectZomboid64.json" const javaLauncherFile = "ProjectZomboid64.json"
var xmxRe = regexp.MustCompile(`^-Xm[sx]`) var (
heapArgRe = regexp.MustCompile(`^-Xm[sx]`)
memoryRe = regexp.MustCompile(`^([0-9]+)([kKmMgG])$`)
)
// SetJavaMemory прописывает лимит памяти JVM в ProjectZomboid64.json. Именно // ParseMemory переводит запись вида "4g" в байты. Возвращает 0, если строка
// оттуда start-server.sh берёт -Xmx, поэтому менять размер памяти в аргументах // пустая, и ошибку, если формат непонятен.
// запуска бесполезно. func ParseMemory(value string) (int64, error) {
func SetJavaMemory(serverDir, memory string) error { value = strings.TrimSpace(value)
memory = strings.TrimSpace(memory) if value == "" {
if memory == "" { return 0, nil
}
match := memoryRe.FindStringSubmatch(value)
if match == nil {
return 0, fmt.Errorf("объём памяти должен выглядеть как 4g или 8192m, получено %q", value)
}
amount, err := strconv.ParseInt(match[1], 10, 64)
if err != nil {
return 0, fmt.Errorf("не разобран объём памяти %q", value)
}
switch strings.ToLower(match[2]) {
case "k":
return amount * 1024, nil
case "m":
return amount * 1024 * 1024, nil
default:
return amount * 1024 * 1024 * 1024, nil
}
}
// SetJavaMemory прописывает границы кучи JVM в ProjectZomboid64.json. Именно
// оттуда start-server.sh берёт -Xmx и -Xms, поэтому менять размер памяти в
// аргументах запуска бесполезно.
//
// maxMemory задаёт -Xmx (верхнюю границу), minMemory — -Xms. Пустой minMemory
// означает, что -Xms не выставляется вовсе: JVM тогда занимает память по мере
// надобности. Равные значения удобны тем, что куча не растёт на ходу, но JVM
// обязана занять весь объём при старте — на машине с небольшой ОЗУ сервер
// просто не поднимется.
func SetJavaMemory(serverDir, maxMemory, minMemory string) error {
maxMemory = strings.TrimSpace(maxMemory)
minMemory = strings.TrimSpace(minMemory)
if maxMemory == "" && minMemory == "" {
return nil return nil
} }
if !regexp.MustCompile(`^[0-9]+[kKmMgG]$`).MatchString(memory) {
return fmt.Errorf("объём памяти должен выглядеть как 4g или 8192m, получено %q", memory) maxBytes, err := ParseMemory(maxMemory)
if err != nil {
return err
}
minBytes, err := ParseMemory(minMemory)
if err != nil {
return err
}
// JVM с -Xms больше -Xmx не стартует вообще, поэтому ловим это здесь, а не
// в логе упавшего сервера.
if maxBytes > 0 && minBytes > maxBytes {
return fmt.Errorf("начальный размер кучи (%s) больше максимального (%s)", minMemory, maxMemory)
} }
path := filepath.Join(serverDir, javaLauncherFile) path := filepath.Join(serverDir, javaLauncherFile)
@@ -41,14 +88,17 @@ func SetJavaMemory(serverDir, memory string) error {
args, _ := doc["vmArgs"].([]any) args, _ := doc["vmArgs"].([]any)
updated := make([]any, 0, len(args)+2) updated := make([]any, 0, len(args)+2)
for _, a := range args { for _, a := range args {
if str, ok := a.(string); ok && xmxRe.MatchString(str) { if str, ok := a.(string); ok && heapArgRe.MatchString(str) {
continue continue
} }
updated = append(updated, a) updated = append(updated, a)
} }
// -Xms равным -Xmx: JVM сразу забирает память и не тратит время на рост if minMemory != "" {
// кучи в момент, когда на сервере много игроков. updated = append(updated, "-Xms"+minMemory)
updated = append(updated, "-Xms"+memory, "-Xmx"+memory) }
if maxMemory != "" {
updated = append(updated, "-Xmx"+maxMemory)
}
doc["vmArgs"] = updated doc["vmArgs"] = updated
out, err := json.MarshalIndent(doc, "", " ") out, err := json.MarshalIndent(doc, "", " ")
+167
View File
@@ -0,0 +1,167 @@
package pzconfig
import (
"encoding/json"
"os"
"path/filepath"
"testing"
)
// TestSetJavaMemoryKeepsOnlyXmx: -Xms равным -Xmx заставляет JVM занять весь
// объём при старте, и на машине с небольшой ОЗУ сервер падает с «Failed to
// allocate initial Java heap». Ставим только верхнюю границу.
func TestSetJavaMemoryKeepsOnlyXmx(t *testing.T) {
dir := t.TempDir()
writeLauncher(t, dir, map[string]any{
"mainClass": "zombie/network/GameServer",
"vmArgs": []any{
"-Djava.awt.headless=true",
"-XX:+UseZGC",
// Значения от прошлой установки должны замениться.
"-Xms8g",
"-Xmx8g",
},
})
if err := SetJavaMemory(dir, "3g", ""); err != nil {
t.Fatal(err)
}
args := launcherArgs(t, dir)
var xms, xmx int
for _, a := range args {
switch {
case len(a) > 4 && a[:4] == "-Xms":
xms++
t.Errorf("в аргументах остался %s — JVM займёт всю память при старте", a)
case a == "-Xmx3g":
xmx++
}
}
if xms != 0 {
t.Errorf("-Xms не должен добавляться, найдено вхождений: %d", xms)
}
if xmx != 1 {
t.Errorf("-Xmx3g встречается %d раз, ожидалось 1: %v", xmx, args)
}
// Чужие аргументы должны остаться нетронутыми.
if !contains(args, "-XX:+UseZGC") || !contains(args, "-Djava.awt.headless=true") {
t.Errorf("потеряны исходные аргументы: %v", args)
}
}
func TestSetJavaMemoryValidates(t *testing.T) {
dir := t.TempDir()
writeLauncher(t, dir, map[string]any{"vmArgs": []any{}})
for _, bad := range []string{"4", "4gb", "много", "-4g", "4g; rm -rf /"} {
if err := SetJavaMemory(dir, bad, ""); err == nil {
t.Errorf("значение %q принято, ожидалась ошибка", bad)
}
}
// Пустые значения — «не трогать», это не ошибка.
if err := SetJavaMemory(dir, "", ""); err != nil {
t.Errorf("пустое значение вернуло ошибку: %v", err)
}
for _, good := range []string{"512m", "4g", "8G", "16384M"} {
if err := SetJavaMemory(dir, good, ""); err != nil {
t.Errorf("значение %q отклонено: %v", good, err)
}
}
// JVM с -Xms больше -Xmx не стартует, поэтому ловим это заранее.
if err := SetJavaMemory(dir, "2g", "4g"); err == nil {
t.Error("начальный размер больше максимального принят, ожидалась ошибка")
}
if err := SetJavaMemory(dir, "4g", "2g"); err != nil {
t.Errorf("корректная пара 2g/4g отклонена: %v", err)
}
}
func writeLauncher(t *testing.T, dir string, doc map[string]any) {
t.Helper()
raw, err := json.MarshalIndent(doc, "", " ")
if err != nil {
t.Fatal(err)
}
if err := os.WriteFile(filepath.Join(dir, javaLauncherFile), raw, 0o644); err != nil {
t.Fatal(err)
}
}
func launcherArgs(t *testing.T, dir string) []string {
t.Helper()
raw, err := os.ReadFile(filepath.Join(dir, javaLauncherFile))
if err != nil {
t.Fatal(err)
}
var doc struct {
VMArgs []string `json:"vmArgs"`
}
if err := json.Unmarshal(raw, &doc); err != nil {
t.Fatal(err)
}
return doc.VMArgs
}
func contains(list []string, want string) bool {
for _, item := range list {
if item == want {
return true
}
}
return false
}
// TestSetJavaMemoryWritesXmsWhenAsked: минимальный размер кучи задаётся
// отдельно и попадает в файл, только если его действительно указали.
func TestSetJavaMemoryWritesXmsWhenAsked(t *testing.T) {
dir := t.TempDir()
writeLauncher(t, dir, map[string]any{"vmArgs": []any{"-XX:+UseZGC"}})
if err := SetJavaMemory(dir, "6g", "2g"); err != nil {
t.Fatal(err)
}
args := launcherArgs(t, dir)
if !contains(args, "-Xms2g") || !contains(args, "-Xmx6g") {
t.Fatalf("границы кучи не выставлены: %v", args)
}
// Убрали минимум — из файла он тоже должен уйти.
if err := SetJavaMemory(dir, "6g", ""); err != nil {
t.Fatal(err)
}
args = launcherArgs(t, dir)
for _, a := range args {
if len(a) > 4 && a[:4] == "-Xms" {
t.Errorf("после очистки минимума остался %s: %v", a, args)
}
}
if !contains(args, "-Xmx6g") {
t.Errorf("максимум потерян: %v", args)
}
}
func TestParseMemory(t *testing.T) {
cases := map[string]int64{
"": 0,
"512m": 512 * 1024 * 1024,
"4g": 4 * 1024 * 1024 * 1024,
"8G": 8 * 1024 * 1024 * 1024,
"1024k": 1024 * 1024,
}
for input, want := range cases {
got, err := ParseMemory(input)
if err != nil {
t.Errorf("ParseMemory(%q): %v", input, err)
continue
}
if got != want {
t.Errorf("ParseMemory(%q) = %d, ожидалось %d", input, got, want)
}
}
if _, err := ParseMemory("4гб"); err == nil {
t.Error("значение с кириллицей принято")
}
}
+31
View File
@@ -154,3 +154,34 @@ func TestSandboxEntriesFollowFileOrder(t *testing.T) {
} }
} }
} }
// TestKeepsWindowsLineEndings: конфиги, созданные игрой на Windows, приходят с
// CRLF. Если при сохранении переписать их в LF, изменится каждая строка файла —
// правка одного параметра превратится в полную перезапись.
func TestKeepsWindowsLineEndings(t *testing.T) {
ini := ParseINI([]byte("# Комментарий\r\nMaxPlayers=32\r\nPVP=true\r\n"))
ini.Set("MaxPlayers", "64")
got := string(ini.Render())
if strings.Count(got, "\r\n") != 3 {
t.Errorf("переводы строк не сохранены:\n%q", got)
}
if strings.Contains(strings.ReplaceAll(got, "\r\n", ""), "\n") {
t.Errorf("в файле появились одиночные LF:\n%q", got)
}
// Файл с LF таким и остаётся.
unix := ParseINI([]byte("MaxPlayers=32\nPVP=true"))
unix.Set("PVP", "false")
if strings.Contains(string(unix.Render()), "\r") {
t.Error("в файл с LF добавились CR")
}
sandbox := ParseSandbox([]byte("SandboxVars = {\r\n Zombies = 3,\r\n}\r\n"))
if err := sandbox.Set("Zombies", "1"); err != nil {
t.Fatal(err)
}
if strings.Count(string(sandbox.Render()), "\r\n") != 3 {
t.Errorf("песочница потеряла CRLF:\n%q", string(sandbox.Render()))
}
}
+11 -2
View File
@@ -24,6 +24,8 @@ type Sandbox struct {
lines []string lines []string
// index сопоставляет путь параметра с номером строки. // index сопоставляет путь параметра с номером строки.
index map[string]int index map[string]int
// crlf — файл был с виндовыми переводами строк; сохраняем как было.
crlf bool
} }
var ( var (
@@ -34,7 +36,9 @@ var (
// ParseSandbox разбирает содержимое SandboxVars.lua. // ParseSandbox разбирает содержимое SandboxVars.lua.
func ParseSandbox(data []byte) *Sandbox { func ParseSandbox(data []byte) *Sandbox {
s := &Sandbox{index: make(map[string]int)} s := &Sandbox{index: make(map[string]int)}
text := strings.ReplaceAll(string(data), "\r\n", "\n") raw := string(data)
s.crlf = strings.Contains(raw, "\r\n")
text := strings.ReplaceAll(raw, "\r\n", "\n")
s.lines = strings.Split(text, "\n") s.lines = strings.Split(text, "\n")
var stack []string var stack []string
@@ -139,11 +143,16 @@ func (s *Sandbox) Set(path, value string) error {
// Render собирает файл обратно. // Render собирает файл обратно.
func (s *Sandbox) Render() []byte { func (s *Sandbox) Render() []byte {
newline := "\n"
if s.crlf {
newline = "\r\n"
}
var buf bytes.Buffer var buf bytes.Buffer
for n, line := range s.lines { for n, line := range s.lines {
buf.WriteString(line) buf.WriteString(line)
if n < len(s.lines)-1 { if n < len(s.lines)-1 {
buf.WriteByte('\n') buf.WriteString(newline)
} }
} }
return buf.Bytes() return buf.Bytes()
+19 -1
View File
@@ -1,6 +1,20 @@
package pzserver package pzserver
import "sync" import (
"regexp"
"sync"
)
// ansiRe ловит управляющие последовательности терминала: SteamCMD и сам
// сервер раскрашивают вывод, а в браузере эти коды превращаются в мусор
// вида "[0mOK". Первый вариант — CSI (цвета, перемещение курсора), второй —
// всё остальное, что начинается с ESC.
var ansiRe = regexp.MustCompile("\x1b\\[[0-9;?]*[ -/]*[@-~]|\x1b.")
// stripANSI убирает управляющие последовательности из строки вывода.
func stripANSI(text string) string {
return ansiRe.ReplaceAllString(text, "")
}
// LogLine — одна строка консоли сервера с монотонным номером, по которому // LogLine — одна строка консоли сервера с монотонным номером, по которому
// веб-клиент понимает, что он пропустил, и откуда догружать. // веб-клиент понимает, что он пропустил, и откуда догружать.
@@ -33,6 +47,10 @@ func newLogBuffer(capacity int) *logBuffer {
// append кладёт строку в буфер и рассылает подписчикам. // append кладёт строку в буфер и рассылает подписчикам.
func (b *logBuffer) append(line LogLine) { func (b *logBuffer) append(line LogLine) {
// Чистим здесь, а не у каждого источника: через буфер проходят и вывод
// сервера, и SteamCMD, и сообщения самой панели.
line.Text = stripANSI(line.Text)
b.mu.Lock() b.mu.Lock()
line.Seq = b.nextSeq line.Seq = b.nextSeq
b.nextSeq++ b.nextSeq++
+41
View File
@@ -0,0 +1,41 @@
package pzserver
import "testing"
// TestStripANSI берёт строки ровно в том виде, в каком их печатает SteamCMD:
// в браузере коды раскраски превращались в мусор вроде "[0mOK".
func TestStripANSI(t *testing.T) {
cases := map[string]string{
"\x1b[0mConnecting anonymously to Steam Public...\x1b[0mOK": "Connecting anonymously to Steam Public...OK",
"\x1b[0m Update state (0x3) reconfiguring, progress: 0.00": " Update state (0x3) reconfiguring, progress: 0.00",
"\x1b[1;32mSuccess!\x1b[0m": "Success!",
// Перемещение курсора и очистка строки — тоже CSI.
"\x1b[2K\x1b[1GЗагрузка": "Загрузка",
// Обычные строки не должны меняться.
"[----] Installing update...": "[----] Installing update...",
"Steam Console Client (c) Valve": "Steam Console Client (c) Valve",
"Мир сохранён, игроков онлайн: 3": "Мир сохранён, игроков онлайн: 3",
"": "",
}
for input, want := range cases {
if got := stripANSI(input); got != want {
t.Errorf("stripANSI(%q) = %q, ожидалось %q", input, got, want)
}
}
}
// TestAppendStripsANSI проверяет, что чистка стоит на общем пути: через буфер
// идёт и вывод сервера, и SteamCMD, и сообщения самой панели.
func TestAppendStripsANSI(t *testing.T) {
buf := newLogBuffer(10)
buf.append(LogLine{Stream: "task", Text: "\x1b[0mWaiting for user info...\x1b[0mOK"})
lines := buf.since(0)
if len(lines) != 1 {
t.Fatalf("строк в буфере: %d", len(lines))
}
if lines[0].Text != "Waiting for user info...OK" {
t.Errorf("в буфер попала строка с кодами: %q", lines[0].Text)
}
}
+89 -4
View File
@@ -24,6 +24,9 @@ type State string
const ( const (
StateStopped State = "stopped" StateStopped State = "stopped"
// StateRestarting — сервер упал и ждёт автоподъёма. Отдельное состояние
// нужно, чтобы это ожидание можно было отменить кнопкой.
StateRestarting State = "restarting"
StateStarting State = "starting" StateStarting State = "starting"
StateRunning State = "running" StateRunning State = "running"
StateStopping State = "stopping" StateStopping State = "stopping"
@@ -42,6 +45,14 @@ const playersPollInterval = 30 * time.Second
// restartDelay — пауза перед автоподъёмом упавшего сервера. // restartDelay — пауза перед автоподъёмом упавшего сервера.
const restartDelay = 10 * time.Second const restartDelay = 10 * time.Second
// Сервер, падающий сразу после старта, автоперезапуском не лечится: обычно
// это нехватка памяти или испорченный конфиг. После нескольких таких падений
// подряд перестаём поднимать его сам, чтобы не крутить бесконечный цикл.
const (
quickCrashWindow = time.Minute
maxQuickCrashes = 3
)
// Status — снимок состояния для веб-панели. // Status — снимок состояния для веб-панели.
type Status struct { type Status struct {
State State `json:"state"` State State `json:"state"`
@@ -56,6 +67,8 @@ type Status struct {
PlayersAt int64 `json:"players_at"` PlayersAt int64 `json:"players_at"`
LastExit string `json:"last_exit"` LastExit string `json:"last_exit"`
AutoRestart bool `json:"auto_restart"` AutoRestart bool `json:"auto_restart"`
// RestartInSec — сколько секунд осталось до автоподъёма (0, если не ждём).
RestartInSec int64 `json:"restart_in_sec"`
Proc sysinfo.ProcStats `json:"proc"` Proc sysinfo.ProcStats `json:"proc"`
Host sysinfo.HostStats `json:"host"` Host sysinfo.HostStats `json:"host"`
} }
@@ -89,6 +102,13 @@ type Supervisor struct {
captured []string captured []string
autoQuery bool autoQuery bool
// restartCancel закрывается, чтобы отменить ожидание автоперезапуска;
// restartAt — когда оно закончится.
restartCancel chan struct{}
restartAt time.Time
// crashStreak — сколько раз подряд сервер упал сразу после запуска.
crashStreak int
sampler *sysinfo.Sampler sampler *sysinfo.Sampler
stopOnce sync.Once stopOnce sync.Once
quit chan struct{} quit chan struct{}
@@ -165,9 +185,14 @@ func (s *Supervisor) Status() Status {
if s.cmd != nil && s.cmd.Process != nil { if s.cmd != nil && s.cmd.Process != nil {
st.PID = s.cmd.Process.Pid st.PID = s.cmd.Process.Pid
} }
if !s.startedAt.IsZero() && s.state != StateStopped { if !s.startedAt.IsZero() && s.state != StateStopped && s.state != StateRestarting {
st.UptimeSec = int64(time.Since(s.startedAt).Seconds()) st.UptimeSec = int64(time.Since(s.startedAt).Seconds())
} }
if s.state == StateRestarting && !s.restartAt.IsZero() {
if left := time.Until(s.restartAt).Seconds(); left > 0 {
st.RestartInSec = int64(left + 0.5)
}
}
s.mu.Unlock() s.mu.Unlock()
st.Installed = s.Installed() st.Installed = s.Installed()
@@ -185,9 +210,28 @@ func (s *Supervisor) Status() Status {
func (s *Supervisor) Start() error { func (s *Supervisor) Start() error {
s.mu.Lock() s.mu.Lock()
defer s.mu.Unlock() defer s.mu.Unlock()
// Запуск руками — знак, что причину падений устранили.
s.crashStreak = 0
// Если ждали автоподъёма, поднимаем немедленно.
s.cancelRestartLocked()
return s.startLocked() return s.startLocked()
} }
// cancelRestartLocked снимает запланированный автоперезапуск. Вызывается под
// удержанным s.mu.
func (s *Supervisor) cancelRestartLocked() {
if s.restartCancel == nil {
return
}
close(s.restartCancel)
s.restartCancel = nil
s.restartAt = time.Time{}
if s.state == StateRestarting {
s.state = StateStopped
}
}
func (s *Supervisor) startLocked() error { func (s *Supervisor) startLocked() error {
if s.state != StateStopped { if s.state != StateStopped {
return ErrAlreadyRunning return ErrAlreadyRunning
@@ -204,8 +248,8 @@ func (s *Supervisor) startLocked() error {
profile := s.cfg.ActiveProfile() profile := s.cfg.ActiveProfile()
// Лимит памяти живёт в файле запуска, общем для всех профилей, поэтому // Лимит памяти живёт в файле запуска, общем для всех профилей, поэтому
// выставляем его на каждом старте — иначе профиль унаследует чужой -Xmx. // выставляем его на каждом старте — иначе профиль унаследует чужой -Xmx.
if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory); err != nil { if err := pzconfig.SetJavaMemory(s.cfg.ServerDir, profile.JavaMemory, profile.JavaMemoryMin); err != nil {
s.AppendLog("manager", "Не удалось выставить лимит памяти JVM: "+err.Error()) s.AppendLog("manager", "Не удалось выставить границы памяти JVM: "+err.Error())
} }
args := []string{"-servername", profile.ID} args := []string{"-servername", profile.ID}
@@ -322,6 +366,8 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
err := cmd.Wait() err := cmd.Wait()
close(exited) close(exited)
lifetime := time.Since(s.startedAt)
s.mu.Lock() s.mu.Lock()
wasIntentional := s.intentionalStop wasIntentional := s.intentionalStop
s.state = StateStopped s.state = StateStopped
@@ -336,6 +382,15 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
s.lastExit = "штатное завершение" s.lastExit = "штатное завершение"
} }
reason := s.lastExit reason := s.lastExit
// Падение сразу после запуска — признак того, что перезапуск не поможет:
// не хватило памяти, испорчен конфиг, нет файлов сервера.
if !wasIntentional && lifetime < quickCrashWindow {
s.crashStreak++
} else {
s.crashStreak = 0
}
streak := s.crashStreak
autoRestart := s.cfg.AutoRestart && !wasIntentional autoRestart := s.cfg.AutoRestart && !wasIntentional
s.mu.Unlock() s.mu.Unlock()
@@ -343,14 +398,38 @@ func (s *Supervisor) wait(cmd *exec.Cmd, exited chan struct{}) {
if !autoRestart { if !autoRestart {
return return
} }
if streak >= maxQuickCrashes {
s.AppendLog("manager", fmt.Sprintf(
"Сервер падает сразу после запуска %d раза подряд — автоперезапуск остановлен. "+
"Посмотрите ошибку выше и запустите сервер вручную.", streak))
return
}
s.mu.Lock()
cancel := make(chan struct{})
s.restartCancel = cancel
s.restartAt = time.Now().Add(restartDelay)
s.state = StateRestarting
s.mu.Unlock()
s.AppendLog("manager", fmt.Sprintf("Автоперезапуск через %s (можно отменить кнопкой «Остановить»)", restartDelay))
s.AppendLog("manager", fmt.Sprintf("Автоперезапуск через %s", restartDelay))
select { select {
case <-time.After(restartDelay): case <-time.After(restartDelay):
case <-cancel:
// Состояние уже переставил тот, кто отменил ожидание.
s.AppendLog("manager", "Автоперезапуск отменён")
return
case <-s.quit: case <-s.quit:
return return
} }
s.mu.Lock() s.mu.Lock()
s.restartCancel = nil
s.restartAt = time.Time{}
if s.state == StateRestarting {
s.state = StateStopped
}
err = s.startLocked() err = s.startLocked()
s.mu.Unlock() s.mu.Unlock()
if err != nil && !errors.Is(err, ErrAlreadyRunning) { if err != nil && !errors.Is(err, ErrAlreadyRunning) {
@@ -394,6 +473,12 @@ func (s *Supervisor) sendQuiet(command string) error {
// мир), затем SIGTERM группе процессов и в крайнем случае SIGKILL. // мир), затем SIGTERM группе процессов и в крайнем случае SIGKILL.
func (s *Supervisor) Stop() error { func (s *Supervisor) Stop() error {
s.mu.Lock() s.mu.Lock()
// Ждём автоподъёма — «остановить» здесь значит «не поднимать».
if s.state == StateRestarting {
s.cancelRestartLocked()
s.mu.Unlock()
return nil
}
if s.state == StateStopped || s.cmd == nil { if s.state == StateStopped || s.cmd == nil {
s.mu.Unlock() s.mu.Unlock()
return ErrNotRunning return ErrNotRunning
+69 -14
View File
@@ -16,6 +16,7 @@ import (
"fmt" "fmt"
"net/http" "net/http"
"os/exec" "os/exec"
"sort"
"strconv" "strconv"
"strings" "strings"
"time" "time"
@@ -27,6 +28,14 @@ const adminCommand = "pzmanager-admin"
// ErrNoAdmin возвращается, когда обновление из панели недоступно. // ErrNoAdmin возвращается, когда обновление из панели недоступно.
var ErrNoAdmin = errors.New("обновление из панели недоступно: нет pzmanager-admin или правила sudo") var ErrNoAdmin = errors.New("обновление из панели недоступно: нет pzmanager-admin или правила sudo")
// ReleaseNote — одна версия в списке изменений.
type ReleaseNote struct {
Version string `json:"version"`
Notes string `json:"notes"`
Published int64 `json:"published"`
URL string `json:"url"`
}
// Info — то, что панель показывает в разделе обновления. // Info — то, что панель показывает в разделе обновления.
type Info struct { type Info struct {
Current string `json:"current"` Current string `json:"current"`
@@ -40,6 +49,10 @@ type Info struct {
CanApply bool `json:"can_apply"` CanApply bool `json:"can_apply"`
// ManualCommand — что выполнить в терминале, если сама не может. // ManualCommand — что выполнить в терминале, если сама не может.
ManualCommand string `json:"manual_command"` ManualCommand string `json:"manual_command"`
// Changelog — все версии между установленной и последней, свежие первыми.
// Одного описания последнего релиза мало: пропустив пару версий, человек
// не увидит, что менялось в промежутке.
Changelog []ReleaseNote `json:"changelog"`
// Error — почему не удалось узнать последнюю версию. // Error — почему не удалось узнать последнюю версию.
Error string `json:"error,omitempty"` Error string `json:"error,omitempty"`
} }
@@ -75,12 +88,14 @@ func (u *Updater) apiBase() (string, error) {
return fmt.Sprintf("%s://%s/api/v1/repos/%s", scheme, host, path), nil return fmt.Sprintf("%s://%s/api/v1/repos/%s", scheme, host, path), nil
} }
// Check спрашивает у Gitea последний релиз и сравнивает его с текущей версией. // Check спрашивает у Gitea список релизов и оставляет те, что новее
// установленной версии.
func (u *Updater) Check(ctx context.Context) Info { func (u *Updater) Check(ctx context.Context) Info {
info := Info{ info := Info{
Current: u.Version, Current: u.Version,
CanApply: u.CanApply(ctx), CanApply: u.CanApply(ctx),
ManualCommand: u.manualCommand(), ManualCommand: u.manualCommand(),
Changelog: []ReleaseNote{},
} }
api, err := u.apiBase() api, err := u.apiBase()
@@ -89,7 +104,10 @@ func (u *Updater) Check(ctx context.Context) Info {
return info return info
} }
req, err := http.NewRequestWithContext(ctx, http.MethodGet, api+"/releases/latest", nil) // limit с запасом: показываем изменения за все пропущенные версии, но не
// тянем историю репозитория целиком.
req, err := http.NewRequestWithContext(ctx, http.MethodGet,
api+"/releases?limit=30&draft=false", nil)
if err != nil { if err != nil {
info.Error = err.Error() info.Error = err.Error()
return info return info
@@ -101,36 +119,73 @@ func (u *Updater) Check(ctx context.Context) Info {
} }
defer resp.Body.Close() defer resp.Body.Close()
if resp.StatusCode == http.StatusNotFound {
info.Error = "в репозитории ещё нет релизов"
return info
}
if resp.StatusCode != http.StatusOK { if resp.StatusCode != http.StatusOK {
info.Error = "репозиторий ответил " + resp.Status info.Error = "репозиторий ответил " + resp.Status
return info return info
} }
var release struct { var releases []struct {
TagName string `json:"tag_name"` TagName string `json:"tag_name"`
Body string `json:"body"` Body string `json:"body"`
HTMLURL string `json:"html_url"` HTMLURL string `json:"html_url"`
PublishedAt time.Time `json:"published_at"` PublishedAt time.Time `json:"published_at"`
Draft bool `json:"draft"`
Prerelease bool `json:"prerelease"`
} }
if err := json.NewDecoder(resp.Body).Decode(&release); err != nil { if err := json.NewDecoder(resp.Body).Decode(&releases); err != nil {
info.Error = "ответ репозитория не разобран: " + err.Error() info.Error = "ответ репозитория не разобран: " + err.Error()
return info return info
} }
info.Latest = release.TagName notes := make([]ReleaseNote, 0, len(releases))
info.Notes = release.Body for _, r := range releases {
info.URL = release.HTMLURL if r.Draft || r.Prerelease || r.TagName == "" {
if !release.PublishedAt.IsZero() { continue
info.Published = release.PublishedAt.Unix()
} }
info.Available = IsNewer(u.Version, release.TagName) note := ReleaseNote{Version: r.TagName, Notes: r.Body, URL: r.HTMLURL}
if !r.PublishedAt.IsZero() {
note.Published = r.PublishedAt.Unix()
}
notes = append(notes, note)
}
if len(notes) == 0 {
info.Error = "в репозитории ещё нет релизов"
return info return info
} }
// Gitea отдаёт релизы свежими вперёд, но полагаться на это не станем.
sort.Slice(notes, func(i, j int) bool {
if IsNewer(notes[j].Version, notes[i].Version) {
return true
}
if IsNewer(notes[i].Version, notes[j].Version) {
return false
}
return notes[i].Published > notes[j].Published
})
latest := notes[0]
info.Latest = latest.Version
info.Notes = latest.Notes
info.URL = latest.URL
info.Published = latest.Published
info.Available = IsNewer(u.Version, latest.Version)
info.Changelog = NewerThan(notes, u.Version)
return info
}
// NewerThan оставляет из списка релизы новее указанной версии, сохраняя
// порядок «свежие первыми».
func NewerThan(notes []ReleaseNote, current string) []ReleaseNote {
out := make([]ReleaseNote, 0, len(notes))
for _, note := range notes {
if IsNewer(current, note.Version) {
out = append(out, note)
}
}
return out
}
// CanApply проверяет, что привилегированный скрипт на месте и sudo пускает к // CanApply проверяет, что привилегированный скрипт на месте и sudo пускает к
// нему без пароля. Проверяем вызовом: наличие файла ещё не значит, что // нему без пароля. Проверяем вызовом: наличие файла ещё не значит, что
// правило sudoers действует. // правило sudoers действует.
+30
View File
@@ -57,3 +57,33 @@ func TestAPIBase(t *testing.T) {
} }
} }
} }
func TestNewerThan(t *testing.T) {
notes := []ReleaseNote{
{Version: "v0.3.0"},
{Version: "v0.2.2"},
{Version: "v0.2.1"},
{Version: "v0.2.0"},
{Version: "v0.1.3"},
}
got := NewerThan(notes, "v0.2.0")
want := []string{"v0.3.0", "v0.2.2", "v0.2.1"}
if len(got) != len(want) {
t.Fatalf("отобрано %d версий, ожидалось %d: %v", len(got), len(want), got)
}
for i, version := range want {
if got[i].Version != version {
t.Errorf("changelog[%d] = %s, ожидалось %s", i, got[i].Version, version)
}
}
// На последней версии показывать нечего.
if got := NewerThan(notes, "v0.3.0"); len(got) != 0 {
t.Errorf("на последней версии отобрано %d записей: %v", len(got), got)
}
// Сборка из рабочей копии не знает своей версии — показываем всё.
if got := NewerThan(notes, "dev"); len(got) != len(notes) {
t.Errorf("для dev отобрано %d из %d записей", len(got), len(notes))
}
}
+452 -34
View File
@@ -94,6 +94,7 @@ function escapeHTML(value) {
const STATE_LABELS = { const STATE_LABELS = {
stopped: "Остановлен", stopped: "Остановлен",
restarting: "Ждёт перезапуска",
starting: "Запускается", starting: "Запускается",
running: "Работает", running: "Работает",
stopping: "Останавливается", stopping: "Останавливается",
@@ -230,8 +231,18 @@ async function refreshStatus() {
renderTask(data.task); renderTask(data.task);
} }
// hostStats нужен карточкам профилей: там подсказываем, сколько памяти можно
// отдать JVM, чтобы не выбирать объём вслепую.
let hostStats = {};
function renderStatus(status) { function renderStatus(status) {
const label = STATE_LABELS[status.state] || status.state; hostStats = status.host || {};
let label = STATE_LABELS[status.state] || status.state;
// Пока идёт обратный отсчёт, показываем, сколько осталось: иначе непонятно,
// происходит ли вообще что-нибудь.
if (status.state === "restarting" && status.restart_in_sec > 0) {
label = `Перезапуск через ${status.restart_in_sec} с`;
}
$("#status-text").textContent = label; $("#status-text").textContent = label;
$("#status-dot").className = `dot ${status.state}`; $("#status-dot").className = `dot ${status.state}`;
@@ -261,20 +272,46 @@ function renderStatus(status) {
? `${formatBytes(host.disk_free_bytes)} из ${formatBytes(host.disk_total_bytes)}` ? `${formatBytes(host.disk_free_bytes)} из ${formatBytes(host.disk_total_bytes)}`
: "—"; : "—";
// Кнопка называет то, что произойдёт: на чистой машине это установка, на
// готовой — обновление.
$("#install-state").textContent = status.installed $("#install-state").textContent = status.installed
? "Серверные файлы установлены." ? "Серверные файлы установлены."
: "Серверные файлы не найдены — установите их перед первым запуском."; : "Серверные файлы не найдены — сервер ещё не установлен.";
$("#btn-install").textContent = status.installed
? "Обновить сервер через SteamCMD"
: "Установить сервер через SteamCMD";
$("#install-hint").textContent = status.installed
? "Сервер должен быть остановлен. Обновление занимает несколько минут — прогресс виден во вкладке «Консоль»."
: "Займёт несколько минут и около 3 ГБ на диске — прогресс виден во вкладке «Консоль».";
const running = status.state !== "stopped"; const running = status.state !== "stopped";
$("#btn-start").disabled = running || !status.installed; const waitingRestart = status.state === "restarting";
// В ожидании автоподъёма обе кнопки осмысленны: «Запустить» поднимает
// сервер сразу, «Остановить» отменяет перезапуск.
$("#btn-start").disabled = (running && !waitingRestart) || !status.installed;
$("#btn-stop").disabled = !running; $("#btn-stop").disabled = !running;
$("#btn-stop").textContent = waitingRestart ? "Отменить перезапуск" : "Остановить";
$("#btn-restart").disabled = !status.installed; $("#btn-restart").disabled = !status.installed;
$("#btn-install").disabled = running; $("#btn-install").disabled = running;
// Консоль есть только у живого процесса: у остановленного сервера нет stdin,
// и команда всё равно вернулась бы ошибкой.
const consoleInput = $("#console-command");
const consoleButton = $("#console-form").querySelector("button[type=submit]");
// Процесс есть только в этих двух состояниях; в ожидании перезапуска писать
// некуда, хотя формально сервер и не «остановлен».
const consoleReady = status.state === "running" || status.state === "starting";
consoleInput.disabled = !consoleReady;
consoleButton.disabled = !consoleReady;
consoleInput.placeholder = consoleReady
? "Команда сервера, например: players, save, quit"
: "Сервер остановлен — консоль принимает команды только на работающем";
// Профили делят игровые порты и файл запуска, поэтому переключать их можно // Профили делят игровые порты и файл запуска, поэтому переключать их можно
// только на остановленном сервере. // только на остановленном сервере.
const picker = $("#profile-select"); const picker = $("#profile-select");
picker.disabled = running; picker.disabled = running && !waitingRestart;
picker.title = running picker.title = running
? "Остановите сервер, чтобы переключить профиль" ? "Остановите сервер, чтобы переключить профиль"
: "Профиль сервера: свой мир, конфиг и моды"; : "Профиль сервера: свой мир, конфиг и моды";
@@ -313,13 +350,20 @@ async function serverAction(path, confirmText) {
} }
$("#btn-start").addEventListener("click", () => serverAction("/api/server/start")); $("#btn-start").addEventListener("click", () => serverAction("/api/server/start"));
$("#btn-stop").addEventListener("click", () => $("#btn-stop").addEventListener("click", () => {
serverAction("/api/server/stop", "Остановить игровой сервер? Игроки будут отключены.")); // Отмена перезапуска ничего не рушит, спрашивать незачем.
const waiting = $("#btn-stop").textContent === "Отменить перезапуск";
serverAction("/api/server/stop", waiting ? "" : "Остановить игровой сервер? Игроки будут отключены.");
});
$("#btn-restart").addEventListener("click", () => $("#btn-restart").addEventListener("click", () =>
serverAction("/api/server/restart", "Перезапустить сервер? Игроки будут отключены.")); serverAction("/api/server/restart", "Перезапустить сервер? Игроки будут отключены."));
$("#btn-install").addEventListener("click", async () => { $("#btn-install").addEventListener("click", async () => {
if (!confirm("Запустить установку/обновление серверных файлов через SteamCMD?")) return; // Тот же вопрос, что и на кнопке: «установить» и «обновить» — разные вещи
// по ощущениям, хотя команда SteamCMD одна.
const installed = $("#install-state").textContent.startsWith("Серверные файлы установлены");
const action = installed ? "Обновить серверные файлы" : "Установить сервер";
if (!confirm(`${action} через SteamCMD?`)) return;
try { try {
await post("/api/install"); await post("/api/install");
ok("Задача запущена — следите за вкладкой «Консоль»"); ok("Задача запущена — следите за вкладкой «Консоль»");
@@ -461,6 +505,197 @@ const CONFIG_HINTS = {
const BOOLEAN_VALUES = new Set(["true", "false"]); const BOOLEAN_VALUES = new Set(["true", "false"]);
// Категории параметров servertest.ini. Порядок важен: в нём и рисуются
// разделы, а всё, чего здесь нет, попадает в «Прочее» — конфиг PZ меняется от
// версии к версии, и новые ключи не должны пропадать со страницы.
const CONFIG_GROUPS = [
{
title: "Основное",
keys: ["PublicName", "PublicDescription", "Public", "Open", "MaxPlayers",
"ServerWelcomeMessage", "ResetID", "ServerPlayerID", "Seed",
"server_browser_announced_ip", "PublicServerIP", "ServerBrowserAnnouncedIP"],
},
{
title: "Доступ и учётные записи",
keys: ["Password", "MaxAccountsPerUser", "DenyLoginOnOverloadedServer",
"AutoCreateUserInWhiteList", "DropOffWhiteListAfterDeath", "LoginQueueEnabled",
"LoginQueueConnectTimeout", "AllowCoop", "AllowNonAsciiUsername",
"SteamScoreboard", "SteamVAC", "DoLuaChecksum"],
},
{
title: "Сеть и порты",
keys: ["DefaultPort", "UDPPort", "RCONPort", "RCONPassword", "PingLimit", "UPnP",
"MaxPacketsPerSecond", "ClientCommandFilter", "MultiplayerStatisticsPeriod"],
},
{
title: "PVP и урон",
keys: ["PVP", "PVPLogToolChat", "PVPLogToolFile", "SafetySystem", "ShowSafety",
"SafetyToggleTimer", "SafetyCooldownTimer", "SafetyDisconnectDelay",
"PVPMeleeDamageModifier", "PVPFirearmDamageModifier", "PVPMeleeWhileHitReaction",
"KnockedDownAllowed", "SneakModeHideFromOtherPlayers", "PlayerBumpPlayer",
"UsePhysicsHitReaction", "CarEngineAttractionModifier"],
},
{
title: "Мир и правила",
keys: ["Map", "SpawnPoint", "SpawnItems", "SaveWorldEveryMinutes", "PauseEmpty",
"NoFire", "AllowDestructionBySledgehammer", "SledgehammerOnlyInSafehouse",
"PlayerRespawnWithSelf", "PlayerRespawnWithOther", "FastForwardMultiplier",
"RemovePlayerCorpsesOnCorpseRemoval", "TrashDeleteAll", "BloodSplatLifespanDays",
"ItemNumbersLimitPerContainer", "SafehousePreventsLootRespawn",
"ConstructionPreventsLootRespawn", "HoursForLootRespawn", "MaxItemsForLootRespawn",
"SwitchZombiesOwnershipEachUpdate", "UltraSpeedDoesnotAffectToAnimals",
"SleepAllowed", "SleepNeeded", "SpeedLimit"],
},
{
title: "Бэкапы самой игры",
keys: ["BackupsCount", "BackupsOnStart", "BackupsOnVersionChange", "BackupsPeriod"],
},
{
title: "Моды",
keys: ["Mods", "WorkshopItems"],
},
{
title: "Чат и голос",
keys: ["GlobalChat", "ChatStreams", "VoiceEnable", "VoiceMinDistance", "VoiceMaxDistance",
"Voice3D", "ChatMessageCharacterLimit", "ChatMessageSlowModeTime", "AnnounceDeath",
"AnnounceAnimalDeath", "MinutesPerPage", "BanKickGlobalSound"],
},
{
title: "Фильтр брани",
keys: ["BadWordListFile", "GoodWordListFile", "BadWordPolicy", "BadWordReplacement"],
},
{
title: "Видимость игроков",
keys: ["DisplayUserName", "ShowFirstAndLastName", "UsernameDisguises",
"HideDisguisedUserName", "MouseOverToSeeDisplayName", "HidePlayersBehindYou",
"MapRemotePlayerVisibility", "ShowCoordinates", "DisableScoreboard",
"HideAdminsInPlayerList"],
},
{
title: "Убежища",
keys: ["PlayerSafehouse", "AdminSafehouse", "SafehouseAllowTrepass", "SafehouseAllowFire",
"SafehouseAllowLoot", "SafehouseAllowRespawn", "SafehouseDaySurvivedToClaim",
"SafeHouseRemovalTime", "SafehouseAllowNonResidential", "SafehouseDisableDisguises",
"MaxSafezoneSize", "DisableSafehouseWhenOwnerConnected",
"DisableSafehouseWhenPlayerConnected"],
},
{
title: "Фракции и войны",
keys: ["Faction", "FactionDaySurvivedToCreate", "FactionPlayersRequiredForTag",
"War", "WarStartDelay", "WarDuration", "WarSafehouseHitPoints"],
},
{
title: "Рации",
keys: ["DisableRadioStaff", "DisableRadioAdmin", "DisableRadioGM", "DisableRadioOverseer",
"DisableRadioModerator", "DisableRadioInvisible"],
},
{
title: "Discord",
keys: ["DiscordEnable", "DiscordToken", "DiscordChannel", "DiscordChannelID",
"DiscordChatChannel", "DiscordLogChannel", "DiscordCommandChannel", "WebhookAddress"],
},
{
title: "Античит и журналы",
keys: ["AntiCheatSafety", "AntiCheatSpeed", "AntiCheatNoClip", "AntiCheatHit",
"AntiCheatPacketException", "AntiCheatPermission", "AntiCheatXP", "AntiCheatSafeHouse",
"AntiCheatPlayer", "AntiCheatChecksum", "KickFastPlayers", "ClientActionLogs", "PerkLogs"],
// Нумерованных проверок два десятка, перечислять их поимённо бессмысленно.
prefixes: ["AntiCheatProtectionType"],
},
{
title: "Транспорт",
keys: ["DisableVehicleTowing", "DisableTrailerTowing", "DisableBurntTowing"],
},
];
// Категории верхнеуровневых параметров песочницы. Вложенные (ZombieLore.Speed
// и подобные) группируются сами — по имени таблицы, в которой лежат.
const SANDBOX_GROUPS = [
{
title: "Зомби",
keys: ["Zombies", "Distribution", "ZombiesRespawn", "ZombieRespawn", "ZombieMigrate",
"ZombieVoronoiNoise", "ZombieAttractionMultiplier", "ZombieHealthImpact",
"ZombiePopLootEffect", "MultiHitZombies", "RearVulnerability", "SirenEffectsZombies",
"RallyGroupSize", "RallyTravelDistance", "RallyGroupSeparation", "RallyGroupRadius",
"HoursForCorpseRemoval", "DecayingCorpseHealthImpact", "BloodLevel",
"BloodSplatLifespanDays"],
},
{
title: "Мир и время",
keys: ["DayLength", "StartYear", "StartMonth", "StartDay", "StartTime", "DayNightCycle",
"NightLength", "NightDarkness", "TimeSinceApo", "WaterShut", "ElecShut",
"WaterShutModifier", "ElecShutModifier", "Alarm", "AlarmDecay", "AlarmDecayModifier",
"LockedHouses", "ErosionSpeed", "ErosionDays", "EndRegen", "Helicopter", "MetaEvent",
"SleepingEvent", "AnnotatedMapChance", "VehicleStoryChance", "ZoneStoryChance",
"SurvivorHouseChance", "MaximumLootedBuildingRooms"],
},
{
title: "Погода",
keys: ["ClimateCycle", "FogCycle", "Temperature", "TemperatureModifier", "Rain",
"RainModifier", "MaxFogIntensity", "MaxRainFxIntensity", "EnableSnowOnGround"],
},
{
title: "Лут и предметы",
keys: ["LootRespawn", "SeenHoursPreventLootRespawn", "HoursForLootRespawn",
"MaxItemsForLootRespawn", "ConstructionPreventsLootRespawn", "RollsMultiplier",
"LootItemRemovalList", "RemoveStoryLoot", "RemoveZombieLoot", "WorldItemRemovalList",
"HoursForWorldItemRemoval", "ItemRemovalListBlacklistToggle", "MaximumLooted",
"DaysUntilMaximumLooted", "RuralLooted", "MaximumDiminishedLoot",
"DaysUntilMaximumDiminishedLoot", "SkillBookLoot", "RecipeResourceLoot"],
// *Loot, *LootNew и *LootFactor — десятки однотипных ключей.
prefixes: ["Food", "Canned", "Literature", "Medical", "SurvivalGears", "Weapon",
"RangedWeapon", "Ammo", "Mechanics", "Other", "Clothing", "Container", "Key", "Media",
"Memento", "Cookware", "Material", "Farming", "Tool"],
suffixes: ["Loot", "LootNew", "LootFactor"],
},
{
title: "Персонаж и навыки",
keys: ["XpMultiplier", "XpMultiplierAffectsPassive", "StatsDecrease", "Endurance",
"Nutrition", "StarterKit", "InjurySeverity", "BoneFracture", "CharacterFreePoints",
"ConstructionBonusPoints", "NightVisionEnabled", "InjuredHealingModifier",
"MuscleStrainFactor", "DiscomfortFactor", "WoundInfectionFactor", "NegativeTraitsPenalty",
"EnablePoisoning", "ClothingDegradation", "AllClothesUnlocked", "NoBlackClothes",
"EasyClimbing", "AttackBlockMovements", "MetaKnowledge", "SeeNotLearntRecipe",
"LiteratureCooldown", "MinutesPerPage", "LevelForMediaXPCutoff",
"LevelForDismantleXPCutoff"],
},
{
title: "Еда, вода и хозяйство",
keys: ["FoodRotSpeed", "FridgeFactor", "MaggotSpawn", "EnableTaintedWaterText",
"FishAbundance", "NatureAbundance", "PlantResilience", "PlantAbundance", "Farming",
"FarmingSpeedNew", "FarmingAmountNew", "CompostTime", "KillInsideCrops",
"PlantGrowingSeasons", "PlaceDirtAboveground", "ClayLakeChance", "ClayRiverChance",
"DaysForRottenFoodRemoval", "AidPackage"],
},
{
title: "Животные",
keys: ["MaximumRatIndex", "DaysUntilMaximumRatIndex"],
prefixes: ["Animal"],
},
{
title: "Транспорт",
keys: ["CarSpawnRate", "ChanceHasGas", "InitialGas", "CarGasConsumption", "LockedCar",
"CarGeneralCondition", "CarDamageOnImpact", "DamageToPlayerFromHitByACar", "TrafficJam",
"CarAlarm", "PlayerDamageFromCrash", "SirenShutoffHours", "RecentlySurvivorVehicles",
"EnableVehicles", "VehicleEasyUse", "MassInvasion"],
prefixes: ["FuelStation"],
},
{
title: "Огнестрельное оружие",
keys: [],
prefixes: ["Firearm"],
},
{
title: "Электричество и огонь",
keys: ["AllowExteriorGenerator", "FireSpread", "MaximumFireFuelHours", "LightBulbLifespan"],
prefixes: ["Generator"],
},
{
title: "Служебное",
keys: ["VERSION"],
},
];
let serverConfigValues = {}; let serverConfigValues = {};
async function loadServerConfig() { async function loadServerConfig() {
@@ -475,24 +710,144 @@ async function loadServerConfig() {
return; return;
} }
serverConfigValues = data.values; serverConfigValues = data.values;
const container = $("#config-fields"); const descriptions = data.descriptions || {};
data.keys.forEach((key) => { const entries = data.keys.map((key) => ({
container.appendChild(buildConfigField(key, data.values[key], CONFIG_HINTS[key])); key,
}); value: data.values[key],
description: descriptions[key],
}));
renderGroupedFields("#config-fields", entries, CONFIG_GROUPS, CONFIG_HINTS);
applyFieldFilter("#config-filter", "#config-fields"); applyFieldFilter("#config-filter", "#config-fields");
refreshFieldSaveState(SAVE_TARGETS[0]); refreshFieldSaveState(SAVE_TARGETS[0]);
} }
// groupEntries раскладывает параметры по разделам. Неизвестные ключи не
// теряются: они собираются в «Прочее» — конфиг PZ меняется от версии к версии.
function groupEntries(entries, groups) {
const byKey = new Map();
entries.forEach((entry) => byKey.set(entry.key, entry));
const result = [];
const used = new Set();
groups.forEach((group) => {
const items = [];
group.keys.forEach((key) => {
const entry = byKey.get(key);
if (entry && !used.has(key)) {
used.add(key);
items.push(entry);
}
});
(group.prefixes || []).forEach((prefix) => {
entries.forEach((entry) => {
if (used.has(entry.key)) return;
// Для лута prefixes перечисляет вид припасов, suffixes — вид ключа
// (FoodLoot, FoodLootNew, RareLootFactor): совпасть должны оба.
const suffixes = group.suffixes;
const matches = suffixes
? suffixes.some((suffix) => entry.key === prefix + suffix)
: entry.key.startsWith(prefix);
if (matches) {
used.add(entry.key);
items.push(entry);
}
});
});
// Суффиксы без своей пары в prefixes — например RareLootFactor.
(group.suffixes || []).forEach((suffix) => {
entries.forEach((entry) => {
if (!used.has(entry.key) && entry.key.endsWith(suffix)) {
used.add(entry.key);
items.push(entry);
}
});
});
if (items.length) result.push({ title: group.title, items });
});
// Вложенные параметры песочницы сами собой образуют разделы: у них путь вида
// ZombieLore.Speed.
const nested = new Map();
const rest = [];
entries.forEach((entry) => {
if (used.has(entry.key)) return;
const dot = entry.key.indexOf(".");
if (dot > 0) {
const table = entry.key.slice(0, dot);
if (!nested.has(table)) nested.set(table, []);
nested.get(table).push(entry);
return;
}
rest.push(entry);
});
Array.from(nested.entries())
.sort((a, b) => a[0].localeCompare(b[0]))
.forEach(([table, items]) => result.push({ title: table, items }));
if (rest.length) result.push({ title: "Прочее", items: rest });
return result;
}
// Какие разделы человек раскрыл: вкладка перерисовывается при каждом переходе,
// и без этого раскрытый раздел схлопывался бы обратно.
const openedGroups = new Map();
function rememberOpenGroups(containerSelector) {
const opened = new Set();
$$(`${containerSelector} .cfg-group`).forEach((group) => {
if (group.open) opened.add(group.dataset.group);
});
openedGroups.set(containerSelector, opened);
}
// renderGroupedFields рисует разделы: свёрнутые по умолчанию, кроме первого —
// иначе сотня параметров снова превращается в простыню.
function renderGroupedFields(containerSelector, entries, groups, hints) {
const container = $(containerSelector);
container.replaceChildren();
const opened = openedGroups.get(containerSelector);
groupEntries(entries, groups).forEach((group, index) => {
const section = document.createElement("details");
section.className = "cfg-group";
section.dataset.group = group.title;
section.open = opened ? opened.has(group.title) : index === 0;
const summary = document.createElement("summary");
summary.innerHTML =
`${escapeHTML(group.title)} <span class="cfg-count">${group.items.length}</span>`;
section.appendChild(summary);
const fields = document.createElement("div");
fields.className = "fields";
group.items.forEach((entry) => {
fields.appendChild(buildConfigField(
entry.key, entry.value, hints ? hints[entry.key] : null, entry.description));
});
section.appendChild(fields);
container.appendChild(section);
});
}
// buildConfigField выбирает тип поля по текущему значению: булевы значения // buildConfigField выбирает тип поля по текущему значению: булевы значения
// удобнее переключать списком, числа — числовым полем. // удобнее переключать списком, числа — числовым полем.
function buildConfigField(key, value, hint) { function buildConfigField(key, value, hint, description) {
const wrapper = document.createElement("div"); const wrapper = document.createElement("div");
wrapper.className = "cfg-field"; wrapper.className = "cfg-field";
wrapper.dataset.key = key.toLowerCase(); wrapper.dataset.key = key.toLowerCase();
wrapper.dataset.hint = (hint || "").toLowerCase(); // Поиск идёт и по описанию: по-русски параметр искать привычнее, чем по
// английскому имени ключа.
wrapper.dataset.hint = `${hint || ""} ${description || ""}`.toLowerCase();
const label = document.createElement("label"); const label = document.createElement("label");
label.textContent = hint || key; label.textContent = hint || key;
if (description) {
// Полный текст — во всплывающей подсказке: описания бывают в несколько
// строк, и разворачивать их для каждого параметра значит утопить форму.
wrapper.title = description;
}
wrapper.appendChild(label); wrapper.appendChild(label);
let input; let input;
@@ -525,6 +880,13 @@ function buildConfigField(key, value, hint) {
keyLabel.className = "key"; keyLabel.className = "key";
keyLabel.textContent = key; keyLabel.textContent = key;
wrapper.appendChild(keyLabel); wrapper.appendChild(keyLabel);
if (description) {
const hintLine = document.createElement("div");
hintLine.className = "hint";
hintLine.textContent = description;
wrapper.appendChild(hintLine);
}
return wrapper; return wrapper;
} }
@@ -589,10 +951,29 @@ $("#btn-config-save").addEventListener("click", async () => {
function applyFieldFilter(inputSelector, containerSelector) { function applyFieldFilter(inputSelector, containerSelector) {
const filter = $(inputSelector).value.trim().toLowerCase(); const filter = $(inputSelector).value.trim().toLowerCase();
$$(`${containerSelector} .cfg-field`).forEach((field) => { $$(`${containerSelector} .cfg-field`).forEach((field) => {
field.hidden = filter && !field.dataset.key.includes(filter) && !field.dataset.hint.includes(filter); field.hidden = filter && !field.dataset.key.includes(filter) && !field.dataset.hint.includes(filter);
}); });
// Раздел без совпадений прячем целиком, а с совпадениями — раскрываем:
// искать параметр по свёрнутым разделам бессмысленно.
$$(`${containerSelector} .cfg-group`).forEach((group) => {
const visible = Array.from(group.querySelectorAll(".cfg-field")).filter((f) => !f.hidden);
group.hidden = visible.length === 0;
if (filter) {
group.open = visible.length > 0;
} }
const count = group.querySelector(".cfg-count");
if (count) {
count.textContent = filter ? `${visible.length}` : `${group.querySelectorAll(".cfg-field").length}`;
}
});
}
// toggle не всплывает, поэтому слушаем на фазе перехвата.
["#config-fields", "#sandbox-fields"].forEach((selector) =>
$(selector).addEventListener("toggle", () => rememberOpenGroups(selector), true));
$("#config-filter").addEventListener("input", () => applyFieldFilter("#config-filter", "#config-fields")); $("#config-filter").addEventListener("input", () => applyFieldFilter("#config-filter", "#config-fields"));
$("#sandbox-filter").addEventListener("input", () => applyFieldFilter("#sandbox-filter", "#sandbox-fields")); $("#sandbox-filter").addEventListener("input", () => applyFieldFilter("#sandbox-filter", "#sandbox-fields"));
@@ -612,10 +993,8 @@ async function loadSandbox() {
refreshFieldSaveState(SAVE_TARGETS[1]); refreshFieldSaveState(SAVE_TARGETS[1]);
return; return;
} }
const container = $("#sandbox-fields"); const entries = data.entries.map((entry) => ({ key: entry.path, value: entry.value }));
data.entries.forEach((entry) => { renderGroupedFields("#sandbox-fields", entries, SANDBOX_GROUPS, null);
container.appendChild(buildConfigField(entry.path, entry.value, null));
});
applyFieldFilter("#sandbox-filter", "#sandbox-fields"); applyFieldFilter("#sandbox-filter", "#sandbox-fields");
refreshFieldSaveState(SAVE_TARGETS[1]); refreshFieldSaveState(SAVE_TARGETS[1]);
} }
@@ -1026,8 +1405,16 @@ function renderProfileCards() {
<input type="text" data-field="title" value="${escapeHTML(p.title || "")}"> <input type="text" data-field="title" value="${escapeHTML(p.title || "")}">
</label> </label>
<label class="field"> <label class="field">
<span>Память JVM</span> <span>Память JVM, максимум</span>
<input type="text" data-field="java_memory" value="${escapeHTML(p.java_memory || "")}"> <input type="text" data-field="java_memory" value="${escapeHTML(p.java_memory || "")}">
<small>${escapeHTML(memoryHint())}</small>
</label>
<label class="field">
<span>Память JVM, начальная</span>
<input type="text" data-field="java_memory_min" value="${escapeHTML(p.java_memory_min || "")}"
placeholder="не задана">
<small>Пусто — JVM берёт память по мере надобности. Если задать, она
займёт этот объём сразу при старте и не сможет подняться, когда его нет.</small>
</label> </label>
<label class="field"> <label class="field">
<span>Пароль админа игры</span> <span>Пароль админа игры</span>
@@ -1047,6 +1434,15 @@ function renderProfileCards() {
// renderCopySource предлагает копировать настройки только с тех профилей, у // renderCopySource предлагает копировать настройки только с тех профилей, у
// которых конфиг уже создан игрой. // которых конфиг уже создан игрой.
// memoryHint подсказывает разумный потолок: JVM должна поместиться в свободную
// память, иначе сервер не поднимется вовсе.
function memoryHint() {
if (!hostStats.mem_total_bytes) return "Например 4g";
const total = formatBytes(hostStats.mem_total_bytes);
const free = formatBytes(hostStats.mem_available_bytes);
return `На машине ${total} ОЗУ, свободно ${free}. Оставьте запас системе.`;
}
function renderCopySource() { function renderCopySource() {
$("#new-profile-copy").innerHTML = $("#new-profile-copy").innerHTML =
`<option value="">не копировать</option>` + `<option value="">не копировать</option>` +
@@ -1088,6 +1484,7 @@ $("#profile-cards").addEventListener("click", async (event) => {
await put(`/api/profiles/${encodeURIComponent(id)}`, { await put(`/api/profiles/${encodeURIComponent(id)}`, {
title: field("title"), title: field("title"),
java_memory: field("java_memory"), java_memory: field("java_memory"),
java_memory_min: field("java_memory_min"),
admin_password: field("admin_password"), admin_password: field("admin_password"),
}); });
ok("Профиль сохранён"); ok("Профиль сохранён");
@@ -1240,8 +1637,13 @@ async function loadUpdateInfo() {
} }
const notes = $("#update-notes"); const notes = $("#update-notes");
notes.hidden = !(info.available && info.notes); const changelog = info.changelog || [];
if (!notes.hidden) renderReleaseNotes(info.notes, info.url); notes.hidden = !(info.available && changelog.length);
if (!notes.hidden) {
notes.querySelector("summary").textContent =
changelog.length > 1 ? `Что нового (версий: ${changelog.length})` : "Что нового";
renderChangelog(changelog);
}
$("#btn-manager-restart").disabled = !info.can_apply; $("#btn-manager-restart").disabled = !info.can_apply;
$("#btn-manager-restart").title = info.can_apply $("#btn-manager-restart").title = info.can_apply
@@ -1252,18 +1654,31 @@ async function loadUpdateInfo() {
// Описание релиза приходит из Gitea разметкой Markdown, и показывать её как // Описание релиза приходит из Gitea разметкой Markdown, и показывать её как
// есть неудобно: первым идёт раздел про установку, который в уже работающей // есть неудобно: первым идёт раздел про установку, который в уже работающей
// панели ни к чему. Берём только список изменений. // панели ни к чему. Берём только список изменений.
function renderReleaseNotes(text, url) { function releaseItems(text) {
const body = $("#update-notes-body"); const changes = text.split(/^##\s+Изменения\s*$/m)[1];
body.replaceChildren(); return (changes ?? text)
const changesSection = text.split(/^##\s+Изменения\s*$/m)[1];
const items = (changesSection ?? text)
.split("\n") .split("\n")
.map((line) => line.trim()) .map((line) => line.trim())
.filter((line) => line.startsWith("- ")) .filter((line) => line.startsWith("- "))
.map((line) => line.slice(2).trim()) .map((line) => line.slice(2).trim())
.filter(Boolean); .filter(Boolean);
}
// renderChangelog показывает изменения всех версий между установленной и
// последней: пропустив несколько релизов, иначе не узнать, что было в них.
function renderChangelog(releases) {
const body = $("#update-notes-body");
body.replaceChildren();
releases.forEach((release) => {
const heading = document.createElement("h4");
heading.className = "release-version";
heading.textContent = release.published
? `${release.version}${formatDate(release.published)}`
: release.version;
body.appendChild(heading);
const items = releaseItems(release.notes || "");
if (items.length) { if (items.length) {
const list = document.createElement("ul"); const list = document.createElement("ul");
items.forEach((item) => { items.forEach((item) => {
@@ -1272,20 +1687,23 @@ function renderReleaseNotes(text, url) {
list.appendChild(li); list.appendChild(li);
}); });
body.appendChild(list); body.appendChild(list);
} else { return;
// Непривычный формат описания — показываем как есть, лишь бы не потерять.
const raw = document.createElement("pre");
raw.textContent = text.trim();
body.appendChild(raw);
} }
if (url) { // Непривычный формат описания — показываем как есть, лишь бы не потерять.
const raw = document.createElement("pre");
raw.textContent = (release.notes || "").trim() || "Описание не заполнено";
body.appendChild(raw);
});
const newest = releases[0];
if (newest && newest.url) {
const link = document.createElement("a"); const link = document.createElement("a");
link.href = url; link.href = newest.url;
link.target = "_blank"; link.target = "_blank";
link.rel = "noopener noreferrer"; link.rel = "noopener noreferrer";
link.className = "release-link"; link.className = "release-link";
link.textContent = "Полное описание релиза"; link.textContent = "Полное описание релизов";
body.appendChild(link); body.appendChild(link);
} }
} }
+6 -6
View File
@@ -114,8 +114,8 @@
<div class="card" id="install-card"> <div class="card" id="install-card">
<h3>Серверные файлы</h3> <h3>Серверные файлы</h3>
<p id="install-state" class="muted"></p> <p id="install-state" class="muted"></p>
<button class="btn btn-primary" id="btn-install">Установить / обновить через SteamCMD</button> <button class="btn btn-primary" id="btn-install">Установить сервер через SteamCMD</button>
<p class="muted small">Сервер должен быть остановлен. Обновление занимает несколько минут — прогресс виден во вкладке «Консоль».</p> <p class="muted small" id="install-hint">Займёт несколько минут и около 3 ГБ на диске — прогресс виден во вкладке «Консоль».</p>
</div> </div>
</section> </section>
@@ -129,8 +129,8 @@
<pre id="console-output" class="console"></pre> <pre id="console-output" class="console"></pre>
<form class="console-input" id="console-form"> <form class="console-input" id="console-form">
<input type="text" id="console-command" placeholder="Команда сервера, например: players, save, quit" <input type="text" id="console-command" placeholder="Команда сервера, например: players, save, quit"
autocomplete="off" spellcheck="false"> autocomplete="off" spellcheck="false" disabled>
<button class="btn btn-primary" type="submit">Отправить</button> <button class="btn btn-primary" type="submit" disabled>Отправить</button>
</form> </form>
<p class="muted small">Полезные команды: <code>players</code>, <code>save</code>, <code>servermsg "текст"</code>, <p class="muted small">Полезные команды: <code>players</code>, <code>save</code>, <code>servermsg "текст"</code>,
<code>kickuser "ник"</code>, <code>banuser "ник"</code>, <code>checkModsNeedUpdate</code>.</p> <code>kickuser "ник"</code>, <code>banuser "ник"</code>, <code>checkModsNeedUpdate</code>.</p>
@@ -149,7 +149,7 @@
</div> </div>
</div> </div>
<p class="muted" id="config-empty" hidden></p> <p class="muted" id="config-empty" hidden></p>
<div id="config-fields" class="fields"></div> <div id="config-fields"></div>
</section> </section>
<!-- Песочница --> <!-- Песочница -->
@@ -165,7 +165,7 @@
</div> </div>
</div> </div>
<p class="muted" id="sandbox-empty" hidden></p> <p class="muted" id="sandbox-empty" hidden></p>
<div id="sandbox-fields" class="fields"></div> <div id="sandbox-fields"></div>
</section> </section>
<!-- Моды --> <!-- Моды -->
+55 -2
View File
@@ -108,7 +108,7 @@ code {
background: var(--muted); background: var(--muted);
} }
.dot.running { background: var(--accent); box-shadow: 0 0 8px var(--accent); } .dot.running { background: var(--accent); box-shadow: 0 0 8px var(--accent); }
.dot.starting, .dot.stopping { background: var(--warn); animation: pulse 1.2s infinite; } .dot.starting, .dot.stopping, .dot.restarting { background: var(--warn); animation: pulse 1.2s infinite; }
.dot.stopped { background: #5b636f; } .dot.stopped { background: #5b636f; }
@keyframes pulse { 50% { opacity: .35; } } @keyframes pulse { 50% { opacity: .35; } }
@@ -267,6 +267,40 @@ input.input-sm, .input-sm { width: auto; padding: 6px 10px; font-size: 13px; }
gap: 12px; gap: 12px;
} }
.cfg-group {
border: 1px solid var(--border);
border-radius: var(--radius);
background: var(--bg-soft);
margin-bottom: 10px;
}
.cfg-group > summary {
padding: 11px 14px;
cursor: pointer;
font-weight: 600;
font-size: 14px;
user-select: none;
list-style: none;
}
.cfg-group > summary::-webkit-details-marker { display: none; }
.cfg-group > summary::before {
content: "▸";
display: inline-block;
width: 14px;
color: var(--muted);
}
.cfg-group[open] > summary::before { content: "▾"; }
.cfg-group > summary:hover { background: var(--bg-card); border-radius: var(--radius); }
.cfg-count {
color: var(--muted);
font-weight: 400;
font-size: 12px;
margin-left: 4px;
}
.cfg-group > .fields { padding: 0 14px 14px; }
.cfg-field { .cfg-field {
background: var(--bg-card); background: var(--bg-card);
border: 1px solid var(--border); border: 1px solid var(--border);
@@ -275,7 +309,17 @@ input.input-sm, .input-sm { width: auto; padding: 6px 10px; font-size: 13px; }
} }
.cfg-field.changed { border-color: var(--accent-dark); } .cfg-field.changed { border-color: var(--accent-dark); }
.cfg-field label { display: block; font-size: 13px; margin-bottom: 6px; } .cfg-field label { display: block; font-size: 13px; margin-bottom: 6px; }
.cfg-field .hint { color: var(--muted); font-size: 12px; margin-top: 5px; } .cfg-field .hint {
color: var(--muted);
font-size: 12px;
margin-top: 5px;
/* Описания из конфига бывают в абзац: показываем начало, остальное — в
подсказке при наведении. */
display: -webkit-box;
-webkit-line-clamp: 3;
-webkit-box-orient: vertical;
overflow: hidden;
}
.cfg-field .key { color: var(--muted); font-family: var(--mono); font-size: 11px; } .cfg-field .key { color: var(--muted); font-family: var(--mono); font-size: 11px; }
/* ---------- Моды ---------- */ /* ---------- Моды ---------- */
@@ -477,6 +521,15 @@ input.input-sm, .input-sm { width: auto; padding: 6px 10px; font-size: 13px; }
line-height: 1.5; line-height: 1.5;
} }
.release-version {
margin: 14px 0 6px;
font-size: 13px;
color: var(--accent);
text-transform: none;
letter-spacing: 0;
}
.release-version:first-child { margin-top: 0; }
.release-notes ul { margin: 0; padding-left: 20px; } .release-notes ul { margin: 0; padding-left: 20px; }
.release-notes li { margin-bottom: 5px; } .release-notes li { margin-bottom: 5px; }
.release-notes li:last-child { margin-bottom: 0; } .release-notes li:last-child { margin-bottom: 0; }