> For the complete documentation index, see [llms.txt](https://manulcraft.gitbook.io/manulcraft/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://manulcraft.gitbook.io/manulcraft/towny/puppet.md).

# Марионетка и метрополия

## Марионетки

**Марионетка** — город, который находится под контролем другого города (**метрополии**). Со временем марионетка накапливает **очки автономии**, растёт по уровням и в итоге получает полную независимость. Скорость этого пути зависит от того, как метрополия обращается с подчинённым городом.

***

### Кратко

|                                         |                                  |
| --------------------------------------- | -------------------------------- |
| Уровней автономии                       | 4, затем независимость (5-й)     |
| Начальный уровень                       | 1 — Интегрированная марионетка   |
| Очков для повышения                     | 2500                             |
| Базовый прирост                         | 10 очков в час (240 в сутки)     |
| Доля налогов, которую платит метрополия | 30% (настраивается от 0 до 100%) |
| Дань метрополии                         | только на уровне 4               |

***

### Как город становится марионеткой

* **Ультиматум.** Мэр метрополии отправляет ультиматум: `/t puppet ultimatum <город>`. Мэр получает кнопки **\[Принять]** и **\[Отклонить]**. Принять можно и командами `/t puppet accept <город>` и `/t puppet deny <город>`.
* **Итог войны или СВО.** Победитель может сделать проигравшего своей марионеткой, если выбран исход «Марионетка».

Нельзя сделать марионеткой город, который уже марионетка. Марионетка не может сама отправлять ультиматумы.

Новая марионетка всегда начинает с **1 уровня** и нулевых очков автономии. Пять суток после создания она не может объявить войну за освобождение (см. «Восстание»).

***

### Уровни автономии

| Уровень | Название                   | Коротко                                         |
| :-----: | -------------------------- | ----------------------------------------------- |
|    1    | Интегрированная марионетка | Почти нет свободы, метрополия может менять мэра |
|    2    | Марионетка                 | Метрополия сама решает, какие права выдать      |
|    3    | Колония                    | Можно выйти из нации и сменить название         |
|    4    | Доминион                   | Полусвободный город: свои войны, но с данью     |
|    5    | Независимое                | Город больше не марионетка                      |

Повышение происходит **автоматически**, как только набрано нужное число очков. Излишек очков переходит на следующий уровень. Набрав 2500 очков на 4 уровне, город получает независимость.

#### Что можно делать на каждом уровне

**Постоянные права уровня** город имеет всегда. **Выдаваемые права** метрополия может включать и отключать вручную (`/t puppet rights` или меню). Всё остальное заблокировано.

| Действие (команда)                            |  1  |     2    |     3    |     4    |
| --------------------------------------------- | :-: | :------: | :------: | :------: |
| Сменить название (`/t rename`, `/t set name`) |  —  | выдаётся |     ✅    |     ✅    |
| Выйти из нации (`/n leave`)                   |  —  |     —    |     ✅    |     ✅    |
| Снимать деньги с нации (`/n withdraw`)        |  —  | выдаётся | выдаётся |     ✅    |
| Покинуть город (`/t leave`)                   |  —  | выдаётся | выдаётся |     ✅    |
| Команда `/t fs`                               |  —  | выдаётся | выдаётся |     ✅    |
| Команда `/t set king`                         |  —  | выдаётся | выдаётся |     ✅    |
| Объединение городов (`/t merge`)              |  —  |     —    | выдаётся | выдаётся |
| Удалить город (`/t delete`)                   |  —  |     —    | выдаётся | выдаётся |
| Объявить войну (`/t war declare`)             |  —  |     —    |     —    | выдаётся |
| Объявить СВО (`/t svo declare`)               |  —  |     —    |     —    | выдаётся |
| Объявить рейд (`/t raid <город>`)             |  —  |     —    |     —    | выдаётся |

**«—»** значит, что команда заблокирована и метрополия не может её разрешить. **«выдаётся»** значит, что метрополия может выдать это право отдельно.

Дополнительно:

* **Траст.** На уровнях 1–3 мэр метрополии всегда в трасте города-марионетки, и убрать его нельзя. На уровне 4 метрополия больше не может навязывать траст.
* **Мэр.** На уровне 1 метрополия может сама назначать мэра марионетки.
* **Войны против метрополии.** Ни при каких правах марионетка не может объявить войну, СВО или рейд **своей же метрополии**. Для этого есть восстание (см. ниже).

***

### Очки автономии

#### Как начисляются

Каждый час марионетка получает очки:

```
очки в час = 10 × множитель налогов × множитель идеологии
```

Начисление идёт даже когда игроки не в сети. После перезапуска сервера пропущенные часы досчитываются (до 30 суток).

#### Доля налогов метрополии

У каждого города в Towny есть **ежедневное содержание** (списывается в 12:00). Метрополия может **взять на себя часть** этого содержания марионетки. Чем большую долю оплачивает метрополия, тем **меньше** очков получает марионетка: она чувствует себя зависимой, а не обособленной.

|    Доля налогов    | Множитель прироста | Очков в сутки | Дней до повышения |
| :----------------: | :----------------: | :-----------: | :---------------: |
|         0%         |        ×1.5        |      360      |        \~7        |
| 30% (по умолчанию) |        ×1.0        |      240      |       \~10.4      |
|         60%        |         ×0         |       0       |         —         |
|        100%        |         ×−1        |      −240     |         —         |

Между этими точками множитель считается плавно (например, при 15% он равен ×1.25). При 60% рост останавливается, а при большей доле очки **убывают**.

Метрополия платит свою долю из собственной казны перед началом нового дня. Если денег не хватает, вносит сколько есть, а мэр получает сообщение.

Меняется долей командой `/t puppet tax <город> <0-100>` или кнопками в меню.

#### Идеология метрополии

Если метрополия придерживается **фашизма**, положительный прирост марионетки уменьшается вдвое (×0.5). Отрицательный прирост это не меняет. Подробнее о том, как выбирается идеология и что она означает

#### Как ускорить автономию: вклады

Жители марионетки могут ускорять рост очков, помогая метрополии.

**Деньги.** `/t puppet contribute money <сумма>` - сумма списывается с вашего счёта и переводится в казну метрополии. 1000 монет дают 1 очко.

**Руда.** Возьмите предмет в основную руку и введите `/t puppet contribute ore [количество]`. Предметы попадают на **склад метрополии**. Чем ценнее материал, тем больше очков:

| Материал                                       | Очков за штуку |
| ---------------------------------------------- | :------------: |
| Уголь, медный слиток, редстоун, лазурит, кварц |      0.05      |
| Железный слиток                                |       0.1      |
| Золотой слиток                                 |      0.25      |
| Изумруд                                        |       0.5      |
| Алмаз                                          |        1       |
| Незеритовый слиток                             |       10       |

Принимаются только обычные предметы без названия и особых свойств. Если склад метрополии переполнен, лишнее вернётся вам.

**Дневной лимит:** не больше **120 очков** за сутки отдельно за деньги и отдельно за руду. Лимит сбрасывается раз в сутки.

#### Понижение уровня

* На **1 уровне** очки не уходят ниже нуля.
* На **уровнях 2–4** при падении очков до **−500** город **теряет один уровень**, а очки сбрасываются в 0. Ненужные выданные права отзываются.
* Метрополия может **понизить марионетку сознательно** за деньги (по умолчанию 5000 из казны метрополии): очки сбросятся, уровень упадёт на 1.

***

### Налоги и дань

|                  | Кто платит             | Кому                                    | Когда                                |
| ---------------- | ---------------------- | --------------------------------------- | ------------------------------------ |
| **Доля налогов** | Метрополия             | Казна марионетки (покрывает содержание) | Каждый день перед началом нового дня |
| **Дань**         | Марионетка (уровень 4) | Казна метрополии                        | Каждый день, 5% от баланса казны     |

Дань берётся только с денег, которые остаются **сверх** ежедневного содержания города, так что из-за дани город не разорится.

***

### Идеология и форма правления

Пока марионетка на **уровне 1, 2 или 3**, её идеология и форма правления автоматически совпадают с метрополией. Проверка идёт каждую минуту: если метрополия сменила курс, марионетка последует за ней, а самовольная смена вернётся обратно. На **4 уровне** и после независимости город снова выбирает сам.

***

### Для метрополии

#### Меню управления

`/t puppet menu` открывает меню с вашими марионетками. В нём можно:

* посмотреть уровень, очки автономии, прирост и время до повышения;
* изменить долю налогов кнопками −10 / −5 / −1 / +1 / +5 / +10%;
* выдавать и забирать права, доступные на уровне города;
* понизить уровень за деньги (нужно нажать дважды).

Меню обновляется само.

#### Команды

| Команда                                      | Что делает                           |
| -------------------------------------------- | ------------------------------------ |
| `/t puppet menu`                             | Меню управления марионетками         |
| `/t puppet status`                           | Статус всех ваших марионеток         |
| `/t puppet tax <город> [0-100]`              | Показать или изменить долю налогов   |
| `/t puppet rights <город> [право] [on\|off]` | Показать или изменить выданные права |
| `/t puppet demote <город> confirm`           | Понизить уровень за деньги           |
| `/t puppet setmayor <город> <игрок>`         | Назначить мэра (только на 1 уровне)  |
| `/t puppet release <город>`                  | Отпустить марионетку на свободу      |
| `/t puppet ultimatum <город>`                | Предложить городу стать марионеткой  |

#### `/etown` — управление городом-марионеткой

Командой `/etown <город> <команда>` метрополия может выполнять действия в городе-марионетке. Набор доступных команд зависит от уровня:

| Уровень | Что разрешено                                                         |
| :-----: | --------------------------------------------------------------------- |
|    1    | Всё                                                                   |
|    2    | Всё, кроме `set mayor`, `delete` и `merge`                            |
|    3    | `invite`, `kick`, `rank`, `toggle`, `deposit`, `spawn`, `bankhistory` |
|    4    | Только `deposit` и `withdraw`                                         |

#### Советы

* Чтобы марионетка росла медленнее, увеличьте долю налогов. При 60% рост останавливается, но тогда метрополия ежедневно платит большую часть чужого содержания.
* Следите за казной: если денег не хватает на оплату доли налогов, метрополия платит сколько есть.
* Выдавать права разумно только там, где вы этого хотите: чем больше прав у марионетки, тем ближе она к самостоятельности.

***

### Для марионетки

| Команда                                   | Что делает                                                |
| ----------------------------------------- | --------------------------------------------------------- |
| `/t puppet status` (или `/t puppet menu`) | Ваш уровень, очки, прирост, права, время до повышения     |
| `/t puppet contribute money <сумма>`      | Перевести деньги в казну метрополии за очки автономии     |
| `/t puppet contribute ore [количество]`   | Отдать руду из руки на склад метрополии за очки автономии |
| `/t release`                              | Начать войну за освобождение                              |

Жители марионетки могут пользоваться `status` и `contribute`. Остальные команды управления доступны только метрополии.

#### Как повысить уровень быстрее

1. Делайте вклады деньгами и рудой (до 120 очков в день за каждый вид).
2. Договаривайтесь с метрополией об уменьшении доли налогов: чем она меньше, тем быстрее растут очки.
3. Не позволяйте очкам уйти в минус, иначе можно потерять уровень.

***

### Восстание и независимость

#### Независимость

На 4 уровне, набрав 2500 очков, город получает **полную независимость**: перестаёт быть марионеткой, а дань и ограничения снимаются.

#### Освобождение

Метрополия может сама отпустить марионетку командой `/t puppet release <город>`.

#### Война за освобождение

Марионетка любого уровня может **восстать**: `/t release` объявляет метрополии войну за освобождение.

* Объявление стоит денег (по умолчанию 1500 из казны марионетки).
* Между попытками действует пауза (по умолчанию 5 суток; отсчёт начинается с момента, когда город стал марионеткой).
* Победа марионетки освобождает её. При победе метрополии город остаётся марионеткой.

***

### Что происходит в особых ситуациях

* **Метрополия удалена.** Все её марионетки освобождаются.
* **Марионетка удалена.** Она исчезает из списка марионеток метрополии.
* **Метрополия проиграла войну.** Её марионетки могут перейти к победителю.
* **Метрополия сменила мэра.** Траст автоматически выдаётся новому мэру.

***

### Частые вопросы

**Можно ли повысить уровень за деньги?** Только косвенно: вклады деньгами дают очки автономии (1 очко за 1000 монет, до 120 очков в день).

**Что будет, если у метрополии не хватит денег на налоги марионетки?** Она внесёт сколько сможет, недостающее марионетка платит сама. Если денег не хватит и ей, применяются обычные правила Towny.

**Можно ли отказаться от ультиматума?** Да, это делает мэр города командой `/t puppet deny <город>`.

**Может ли у марионетки быть своя марионетка?** Нет: марионетка не может отправлять ультиматумы.

**Почему я не могу выйти из нации?** На уровнях 1–2 это право закрыто. Оно открывается на уровне 3.

**Почему заблокирована команда `/t war declare`?** До 4 уровня марионетка вообще не может объявлять войны, а на 4 уровне для этого нужно право от метрополии. Против метрополии — никогда, для неё есть `/t release`.