Как интегрировать локальную LLM в игру S.T.A.L.K.E.R. Anomaly: туториал по созданию динамических событий

Зачем вообще это нужно? Или как сломать статичность Зоны

Проблема S.T.A.L.K.E.R. Anomaly, как и большинства модов, — предсказуемость. Ты проходишь локацию в сотый раз, и уже знаешь, что в том сарае будет пара бандитов, а на вышке — снайпер. События скриптованы, диалоги зациклены. Игра превращается в симулятор рутины.

Решение — внедрить локальную языковую модель. Не для чата с NPC (хотя и это возможно), а для генерации уникальных, неповторяющихся событий на лету. Представь: LLM анализирует твое состояние, погоду, репутацию и выдает сценарий — "Группа сталкеров наткнулась на артефакт в зоне выброса, но один из них получил дозу радиации. Они просят помощи в обмен на часть добычи". И это не скрипт. Это каждый раз новая история.

Что нам понадобится: железо, софт и немного безумия

• S.T.A.L.K.E.R. Anomaly 1.5.1 или новее — установленная и рабочая.
• Локальная LLM — например, Llama 3.1 8B или аналогичная. Если у тебя слабая видеокарта, посмотри гайд про запуск Llama на 6 ГБ VRAM.
• Ollama или LM Studio — для запуска модели. Сравнение инструментов есть в статье LM Studio vs llama.cpp.
• Python 3.10+ — с установленными библиотеками: requests, flask, py-lua.
• Базовое понимание Lua — скрипты Anomaly написаны на нем.
• Терпение — потому что все это может сломаться в самый неподходящий момент.

Шаг за шагом: от установки LLM до первого события в игре

1 Запускаем локальную LLM и настраиваем API

Устанавливаем Ollama (проще всего) и качаем модель. В терминале:

ollama pull llama3.1:8b
ollama run llama3.1:8b

По умолчанию Ollama слушает на localhost:11434. Нам нужен API для генерации текста. Создаем простой Python-сервер, который будет принимать запросы от игры и возвращать сгенерированные события.

from flask import Flask, request, jsonify
import requests
import json

app = Flask(__name__)
OLLAMA_URL = "http://localhost:11434/api/generate"

PROMPT_TEMPLATE = """
Ты — генератор событий для игры S.T.A.L.K.E.R. Anomaly.
Игрок находится в локации: {location}. 
Погода: {weather}. Репутация игрока: {reputation}.
Сгенерируй краткое описание уникального события (3-4 предложения).
Событие должно включать: цель, препятствие, награду.
Формат ответа JSON: {"goal": "...", "obstacle": "...", "reward": "..."}
"""

@app.route('/generate_event', methods=['POST'])
def generate_event():
    data = request.json
    prompt = PROMPT_TEMPLATE.format(
        location=data.get('location', 'Темная долина'),
        weather=data.get('weather', 'ясно'),
        reputation=data.get('reputation', 'нейтральный')
    )
    
    payload = {
        "model": "llama3.1:8b",
        "prompt": prompt,
        "stream": False,
        "options": {"temperature": 0.8}
    }
    
    response = requests.post(OLLAMA_URL, json=payload)
    if response.status_code == 200:
        result = response.json()
        generated_text = result['response']
        # Парсим JSON из текста (здесь может быть больно)
        try:
            event_data = json.loads(generated_text.strip())
        except json.JSONDecodeError:
            event_data = {"goal": "Исследовать аномалию", "obstacle": "Неизвестно", "reward": "Артефакт"}
        return jsonify(event_data)
    else:
        return jsonify({"error": "LLM не ответила"}), 500

if __name__ == '__main__':
    app.run(port=5000, debug=False)

Сохраняем как llm_server.py и запускаем: python llm_server.py. Сервер будет слушать на порту 5000.

2 Подключаем Lua-скрипт в Anomaly к нашему API

В папке игры находим скрипты. Например, gamedata\scripts\. Создаем новый файл llm_events.script. Вот основа:

-- llm_events.script
local http = require("socket.http")
local ltn12 = require("ltn12")
local json = require("json")

function generate_event_via_llm()
    local location = level.name()  -- текущая локация
    local weather = get_weather()  -- функция получения погоды (упрощенно)
    local reputation = get_reputation()  -- репутация игрока
    
    local request_body = json.encode({
        location = location,
        weather = weather,
        reputation = reputation
    })
    
    local response_body = {}
    local res, code, headers = http.request({
        url = "http://localhost:5000/generate_event",
        method = "POST",
        headers = {
            ["Content-Type"] = "application/json",
            ["Content-Length"] = #request_body
        },
        source = ltn12.source.string(request_body),
        sink = ltn12.sink.table(response_body)
    })
    
    if code == 200 then
        local response_text = table.concat(response_body)
        local event_data = json.decode(response_text)
        -- Создаем задание в игре на основе event_data
        create_task(event_data.goal, event_data.obstacle, event_data.reward)
        return true
    else
        log("Ошибка при запросе к LLM: " .. tostring(code))
        return false
    end
end

-- Хук: вызываем генерацию события при входе в новую локацию
function on_level_changed()
    if math.random() < 0.3 then  -- 30% шанс сгенерировать событие
        generate_event_via_llm()
    end
end

Это упрощенный код. В реальности нужно добавить функции get_weather, get_reputation и create_task, которые взаимодействуют с движком игры. Для этого придется копаться в существующих скриптах Anomaly.

3 Интегрируем скрипт в игровой цикл

Нужно найти файл, отвечающий за загрузку локаций. Часто это bind_stalker.script. Добавляем вызов нашей функции при смене уровня. Ищем функцию on_level_changed или аналогичную и вставляем туда вызов on_level_changed() из нашего скрипта.

-- В bind_stalker.script, в секции смены уровня:
function play_change_level()
    -- ... существующий код ...
    -- Наш хук
    if llm_events then
        llm_events.on_level_changed()
    end
end

Перезапускаем игру. При переходе в новую локацию с шансом 30% должно сгенерироваться событие через LLM. Проверяем лог игры на ошибки.

Что пошло не так: типичные косяки и как их избежать

А что если...: идеи для развития

• Динамические диалоги — NPC, которые говорят не заготовленные фразы, а генерируют ответы на основе ситуации. Потребует интеграции текстового ввода (мод с чатом?).
• Генерация квестов на лету — не просто "принеси 5 шкур", а многоэтапные истории с неочевидными решениями. LLM может создавать условия, которые проверяются скриптами.
• Адаптивный ИИ противников — бандиты, которые анализируют твою тактику и меняют поведение. Сложно, но возможно через модификацию скриптов ИИ.
• Персонализированные события — если игрок часто использует определенное оружие, LLM генерирует события, связанные с ним (например, поиск уникальных модификаций).

Вопросы и ответы

Интеграция локальной LLM в Anomaly — это не про стабильность. Это про эксперименты, баги и моменты, когда Зона вдруг оживает и преподносит сюрприз, который не был запрограммирован. Если ты готов копаться в коде и мириться с тормозами, результат того стоит. Удачи, сталкер.