@xnlc/servers: управление Minecraft-серверами

import { ServerManager, serverManager } from "@xnlc/servers";

const manager = new ServerManager();
// или serverManager (единый экземпляр)

await manager.start(
  id,           // уникальный идентификатор сервера
  serverInfo,   // McServerInfo: настройки сервера
  javaPath,     // путь к Java
  serverDir,    // рабочая папка сервера
  onLog,        // (line: string) => void: каждая строка консоли
  onStateChange // (state: McServerState) => void: изменение состояния
);

await manager.stop(id);  // graceful: команда stop → 30 с → SIGKILL
await manager.kill(id);  // немедленное принудительное завершение

await manager.sendCommand(id, "say Hello");

// Синхронно: значения из кэша фонового сэмплера
const metrics = manager.getMetricsSync(id);
// { cpuPercent: number, memoryMb: number, uptimeSeconds: number }

// Запустить фоновый сбор (1 с интервал по умолчанию)
manager.startMetricsSampler(1000);

const lines = manager.getLogBuffer(id); // до 2000 строк
manager.appendConsoleLine(id, "BuildTools compile..."); // добавить строку вне процесса
manager.clearInstallLogs(id); // очистить логи установки перед стартом

manager.getState(id);        // McServerState
manager.isRunning(id);       // процесс жив (включая starting)
manager.isStarted(id);       // сервер подтвердил готовность

manager.stopAll(); // kill для всех запущенных процессов

import {
  ensureServerJar,
  getPaperVersions, getPaperBuilds,
  getPurpurVersions, getPurpurBuilds,
  getFoliaVersions, getFoliaBuilds,
  getVelocityVersions, getVelocityBuilds,
  getWaterfallVersions, getWaterfallBuilds,
  getSpongeSupportedVersions, getSpongeBuilds,
} from "@xnlc/servers";

import { pingServer, parseHost } from "@xnlc/servers";

const status = await pingServer("play.example.com", 25565);
// ServerStatusResult: MOTD, онлайн, макс. слотов, версия, пинг

import { analyzeServerJar } from "@xnlc/servers";

const info = await analyzeServerJar("/path/to/server.jar");
// JarAnalysisResult: тип ядра, версия, зависимости

import {
  STARTUP_DONE_PATTERNS,
  STOPPING_PATTERNS,
  EULA_PROMPT_PATTERN,
  isStartupDoneLine,
  isStoppingLine,
} from "@xnlc/servers";

import { ServerManager } from "@xnlc/servers";

const manager = new ServerManager();

await manager.start(
  "my-server",
  {
    name: "Survival",
    modloader: "paper",
    mcVersion: "1.21.4",
    xmx: 4096,
    xms: 1024,
  },
  "/usr/bin/java",
  "./mc-servers/my-server",
  (line) => console.log("[LOG]", line),
  (state) => console.log("[STATE]", state.status)
);

// Ждем готовности
while (!manager.isStarted("my-server")) {
  await new Promise((r) => setTimeout(r, 500));
}

// Отправляем команду
await manager.sendCommand("my-server", "op Steve");

// Читаем метрики
console.log(manager.getMetricsSync("my-server"));

// Останавливаем
await manager.stop("my-server");