# Гайд для тестировщиков: кастомные чат-команды + поведение наёмника

Клиент 2007/PV7 не имеет окон журнала/поиска/титулов/управления наёмником — поэтому функционал вынесен
в **чат-команды**. В игре список доступен по **`@h3`**.

## 1. Кастомные чат-команды (все добавленные нами)

| Команда | Что делает |
|---|---|
| `@h3` | Показать этот список команд (в игре) |
| `@quests` | Список твоих квестов (журнал) |
| `@quest <N>` | Детали квеста N; `@quest <N> cancel` — отменить |
| `@status` (`@cd`) | Твои активные статус-эффекты + кулдауны скиллов |
| `@whereis <моб>` | Где спавнится моб (карты + кол-во) и что дропает |
| `@market <предмет>` | Поиск предмета по открытым вендорам + цена |
| `@cooking` (`@cook`) | Интерфейс кулинарии |
| `@achievements` (`@ach`) | Твои достижения + прогресс |
| `@title <N>` | Установить титул N; `@title off` — снять |
| `@merc` (`@mercenary`) | Статус твоего наёмника (HP/SP/лояльность/убийства/скиллы) |

Все — уровень 0 (доступны всем игрокам), правится в `conf/atcommand_athena.conf`.

## 2. Наёмник (Mercenary Soldier) — поведение и тестирование

### Как им «управлять»
**Наёмник полностью автономен — прямого управления НЕТ** (в отличие от оф-сервера, где мерком рулят
из клиентского окна; под PV7 такого окна нет). Ты «ведёшь» его косвенно: он сам следует за тобой и сам
вступает в бой. Статус смотришь через `@merc`.

### Что наёмник делает САМ (кастомный AI, тик 100мс)
1. **Следует за хозяином:** если ты отошёл дальше ~3 клеток — подходит к тебе (в пределах 3 клеток);
   если дальше ~13 клеток (отстал/телепорт) — бежит догонять. Рядом (≤3) — стоит (это нормально).
2. **Авто-агр:** атакует **ближайшего врага (моба) в пределах ~10 клеток** (его range2), которого твой
   персонаж считает врагом.
3. **Преследует и бьёт** цель в ближнем бою.
4. **Кастует атак-скиллы** в бою — шанс = `merc_skill_rate` (battle/monster.conf, дефолт **30**; 0 = только melee).
5. **Поднимает self-бафы** (по классу: Parry/Reflect/Berserk/Defender/AutoGuard/Quicken/AutoBerserk/Sight),
   когда стоит без боя рядом с хозяином.

### Как ПРОВЕРИТЬ (важно — нужны правильные условия!)
Наёмник стоит и «ничего не делает», ЕСЛИ: ты рядом (≤3 клеток) **и** врагов в ~10 клетках нет — это
**корректное** поведение. Чтобы увидеть AI, нужно его спровоцировать:

1. Призвать: `@item 12153` → использовать (или Archer-скролл 12153-12162 / Spear / Sword).
2. **Выйти в ПОЛЕ С МОБАМИ** (не в город!).
3. **Тест следования:** отойти от наёмника на **5+ клеток** → он должен подойти к тебе.
4. **Тест авто-агра:** встать в **~5–8 клетках от моба** (не атакуя его сам) → наёмник должен побежать
   к мобу и начать его бить; в бою иногда кастует скилл.
5. **Тест статуса:** `@merc` → показывает HP/SP/лояльность/убийства/список скиллов.
6. Тюнинг: `merc_skill_rate: 0` → наёмник только melee (для сравнения); `:100` → максимум скиллов.

### Если наёмник ИНЕРТЕН при ПРАВИЛЬНЫХ условиях
Если при условиях п.3–4 (поле, моб в ~8 клетках, ты отошёл на 5+) наёмник **всё равно** стоит/не
следует/не атакует — **это баг**, сообщи. Тогда я добавлю диагностический лог в AI-тик, чтобы
локализовать (код по чтению корректен — нужен рантайм-сигнал, какой путь не срабатывает).
Подозрительные места для отчёта: следует ли вообще / агрит ли / бьёт ли (что именно из трёх не работает).