necromants-tome-7d2d-3-2/README.md

# Книга некроманта / Necromancer's Tome (NecromancerTome)

*English version below — scroll past the Russian half.*

**Версия 1.0.1** — для 7 Days to Die 3.2. Автор: Alex Cube.

- Страница мода: https://www.alexcube.ru/7-days-to-die-moi-mody/kniga-nekromanta-necromancer-s-tome/
- Nexus Mods: https://www.nexusmods.com/7daystodie/mods/12547
- Репозиторий: https://git.08h.ru/alex/necromants-tome-7d2d-3-2
- YouTube-канал автора: https://www.youtube.com/@alexcube

Мод для 7 Days to Die о пути от обычного выжившего до некроманта — с собственной веткой
прогрессии, тёмным оружием, призываемыми существами и сюжетной концовкой.

## Завязка

Всё начинается с записки, читая которую персонаж видит неясный флэшбек.

Некромантия в этом моде — ответ на проклятие, а не побочная ветка крафта. Вместо того чтобы
однажды пасть перед ордой и присоединиться к ней, игрок учится подчинять мёртвых себе: заражать
зомби безумием, стравливать их друг с другом, поднимать против них собственных тварей. Не
выживание вопреки смерти, а власть.

## Прогрессия

Отдельный скилл **"Некромантия"** растёт не от опыта, а от счётчика упокоенных зомби — свой
счётчик, своя механика. Пять тиров, каждый открывает часть арсенала:

| Тир | Порог | Что открывается |
|---|---|---|
| Адепт | сразу | Камень духов, Нож некроманта, Синий портальный камень, Пирамида духов |
| Адепт (доп.) | 20 зомби | Пространственный браслет |
| Адепт (доп.) | 30 / 60 / 100 / 300 зомби | Моды ножа: Слёзы мертвеца, Пир падальщика, Могильный покой, Тёмное чутьё |
| Подмастерье | 500 зомби | Свиток девиации |
| Подмастерье (доп.) | 1400 / 1700 зомби | Моды ножа: Хватка мертвеца, Мёртвая буря |
| Ученик | 2000 зомби | Призыв зомбособаки, Жуки Властелина, Призыв зомбогрифа |
| Некромант | 3000 зомби | Призыв зомбомедведя, Призыв зомбоволка, Свиток банши |
| Мастер | 5000 зомби | Чёрный портальный камень |

## Арсенал

- **Камень духов** — брошенный камень, светящийся некромантской энергией. Задевает одного зомби:
  тот переходит на вашу сторону и начинает атаковать других зомби вместо вас.
- **Свиток девиации** — тот же эффект, но мощнее: при броске переманивает на вашу сторону сразу
  всех зомби в области взрыва, а не одного. Расходуется при использовании.
- **Нож некроманта** — почерневший костяной клинок. Урон растёт вместе с навыком Некромантии:
  почти бесполезен в неопытных руках, смертоносен у прокачанного игрока. Лечит владельца на
  половину нанесённого урона и метит раненого зомби как Жертву — тот при смерти гарантированно
  оставляет особый мешок с ингредиентами.
- **Шесть модов только для Ножа некроманта** — обычные моды для ножей в это оружие не встают, а
  эти не встают ни во что другое: **Слёзы мертвеца** (2 воды с каждого убитого клинком зомби),
  **Пир падальщика** (2 еды за труп), **Могильный покой** (защита от перегрева и переохлаждения,
  пока нож в руках), **Хватка мертвеца** (раненый клинком зомби замедляется), **Мёртвая буря**
  (силовая атака бьёт по площади с кровотечением, за 10 здоровья вместо 5 и двойную выносливость),
  **Тёмное чутьё** (все зомби поблизости отмечены на компасе и карте, пока нож в руках).
- **Кровь некроманта** — ритуальный ресурс: чтобы получить банку, нужны пустая банка, любой нож
  в руках и 90% текущего здоровья за одну порцию. Ингредиент для самых тёмных рецептов — Чёрного
  портала и самого Ножа.
- **Кожа жертвы** и **Прах зомби** — остаются от зомби, помеченного Ножом некроманта как Жертва.
  Ингредиенты для книг призыва и большинства некромантских рецептов соответственно.
- **Синий портальный камень** — держите кнопку использования 10 секунд, чтобы телепортироваться к
  своему спальному мешку. Прерывается любым уроном или силовой атакой раньше времени. Не
  расходуется.
- **Пространственный браслет** — силовая атака открывает личный разлом-хранилище, чей размер
  растёт вместе с уровнем Некромантии. Обычная атака пока ничего не делает.
- **Консервные банки** (пустая / с речной водой / с кипячёной) — расходный цикл вместо
  одноразовых банок: наполняются водой, кипятятся прямо на костре без кастрюли, выпиваются, банка
  возвращается пустой. Речная вода из банки может вызвать дизентерию, как обычная мутная вода;
  кипячёная безопасна. Вмещают меньше воды, чем стеклянные банки.

## Питомцы

Призывные книги поднимают союзных существ, которые дерутся с зомби, а не с игроком. Питомец не
«следует» за игроком в строгом смысле — просто бродит сам по себе, а если отойдёт дальше
32 блоков и в этот момент не занят боем, его телепортирует обратно к владельцу:

- **Зомбособака**, **Зомбомедведь**, **Зомбоволк**, **Зомбогриф** — постоянные спутники. Можно
  держать по одному экземпляру каждого вида одновременно; отзываются обратно в книгу силовой
  атакой.
- **Жуки Властелина** — разовый свиток, выпускающий рой. Жуки сами разлетаются по широкому
  радиусу и жалят зомби; ужаленный переходит на вашу сторону, как от Камня духов. Рой нельзя
  отозвать обратно, активен может быть только один. Расходуется при использовании.
- **Свиток банши** — одноразовый: при открытии вопит голосом банши и поднимает рядом с игроком
  небольшую враждебную орду. Это не союзники — эти зомби так же опасны для вас, как любые другие.

## Оборона базы

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

## Чёрный портал — финал истории

**Чёрный портальный камень открывается на вершине прогрессии (5000 зомби) и является концовкой
мода.** Активация запускает диалог подтверждения, останавливает игру и разворачивает
полноэкранную финальную сцену — она досказывает историю, начатую запиской в первый день.
Заканчивается сцена выбором из двух вариантов: один закрывает историю и выходит в главное меню,
другой возвращает игрока в мир и позволяет играть дальше.

Сюжетные тексты — в `Config/Localization.csv`, ключи `necroFinal*`. Здесь они не пересказываются
намеренно: README читают до прохождения.

## По мелочи

- Стартовая записка при открытии тоже ставит игру на паузу и проигрывает короткий флэшбек.
- Некоторые декоративные блоки (кровати, кулеры, картонные коробки) можно разобрать удержанием,
  как верстак.

## Локализация

**13 языков полностью:** русский, английский, немецкий, испанский, французский, итальянский,
японский, корейский, польский, португальский (Бразилия), турецкий, китайский упрощённый и
традиционный. Все 123 ключа `Config/Localization.csv` заполнены, пустых ячеек нет.

## Установка

Распакуйте папку `NecromancerTome` в `<папка игры>/Mods/` (или в `%APPDATA%/7DaysToDie/Mods/`) и
запустите игру. Мод содержит Harmony-библиотеки, поэтому **EAC должен быть выключен**.

Рассчитан на одиночную игру: ванильная пауза работает только в сингле, поэтому в мультиплеере
сюжетные сцены проиграются без остановки времени.

## Статус

Версия 1.0.1 — исправление по первому баг-репорту с Nexus: содержимое Пространственного
браслета больше не пропадает после выхода из игры (хранилище теперь сохраняется в файле
игрока, рядом с рюкзаком). Весь заявленный контент реализован и проходит тесты в игре. Из запланированного не
сделана только часть фирменных звуков. Текст описания для сайта (RU + EN) — в
`SITE_DESCRIPTION.html` (разметка блоков WordPress). Полная техническая история разработки и текст финала лежат рядом с модом
в `BACKLOG.md` и `FINAL_TEXT.md` — в репозиторий они не входят (спойлеры и внутренняя кухня).

---

# Necromancer's Tome (English)

**Version 1.0.1** - for 7 Days to Die 3.2. By Alex Cube.

- Mod page: https://www.alexcube.ru/7-days-to-die-moi-mody/kniga-nekromanta-necromancer-s-tome/
- Nexus Mods: https://www.nexusmods.com/7daystodie/mods/12547
- Repository: https://git.08h.ru/alex/necromants-tome-7d2d-3-2
- The author's YouTube channel: https://www.youtube.com/@alexcube

A 7 Days to Die mod about the road from ordinary survivor to necromancer - with its own
progression tree, cursed weapons, summonable creatures and a story ending.

## Premise

It all starts with a note, and reading it shows the character a blurred flashback.

Necromancy in this mod is an answer to a curse, not a side branch of crafting. Instead of falling
before the horde one day and joining it, the player learns to bend the dead to their will: to
infect zombies with madness, turn them on each other, raise their own creatures against them. Not
survival in spite of death, but power over it.

## Progression

A dedicated **"Necromancy"** skill grows not from experience but from a count of zombies put to
rest - its own counter, its own mechanic. Five tiers, each opening part of the arsenal:

| Tier | Threshold | What unlocks |
|---|---|---|
| Adept | from the start | Spirit Stone, Necromancer's Knife, Blue Portal Stone, Pyramid of Spirits |
| Adept (extra) | 20 zombies | Spatial Bracelet |
| Adept (extra) | 30 / 60 / 100 / 300 zombies | Knife mods: Tears of the Dead, Scavenger's Feast, Grave's Repose, Dark Sense |
| Journeyman | 500 zombies | Scroll of Deviation |
| Journeyman (extra) | 1400 / 1700 zombies | Knife mods: Dead Man's Grip, Dead Storm |
| Apprentice | 2000 zombies | Summon Zombie Dog, Beetles of the Lord, Summon Zombie Griffin |
| Necromancer | 3000 zombies | Summon Zombie Bear, Summon Zombie Wolf, Banshee's Scroll |
| Master | 5000 zombies | Black Portal Stone |

## Arsenal

- **Spirit Stone** - a thrown stone lit with necromantic energy. It catches a single zombie: that
  one switches to your side and starts attacking other zombies instead of you.
- **Scroll of Deviation** - the same effect, but stronger: on impact it wins over every zombie in
  the blast area at once rather than one. Consumed on use.
- **Necromancer's Knife** - a blackened bone blade. Its damage grows with the Necromancy skill:
  nearly useless in unskilled hands, lethal for a levelled player. Heals the wielder for half the
  damage dealt and marks the wounded zombie as a Victim - on death it is guaranteed to leave a
  special bag of ingredients.
- **Six mods for the Necromancer's Knife only** - ordinary knife mods will not fit this weapon,
  and these will not fit any other: **Tears of the Dead** (2 water from every zombie killed with
  the blade), **Scavenger's Feast** (2 food per corpse), **Grave's Repose** (protection from heat
  and cold while the knife is held), **Dead Man's Grip** (a zombie wounded by the blade is
  slowed), **Dead Storm** (the power attack hits an area and causes bleeding, for 10 health
  instead of 5 and double the stamina), **Dark Sense** (every nearby zombie is marked on the
  compass and map while the knife is held).
- **Necromancer's Blood** - a ritual resource: a jar takes an empty jar, any knife in hand and 90%
  of your current health per portion. An ingredient for the darkest recipes - the Black Portal and
  the Knife itself.
- **Victim's Skin** and **Zombie Ash** - left by a zombie marked as a Victim by the Necromancer's
  Knife. Ingredients for the summoning books and for most necromantic recipes respectively.
- **Blue Portal Stone** - hold the use button for 10 seconds to teleport to your bedroll.
  Interrupted by any damage, or by a power attack before the time is up. Not consumed.
- **Spatial Bracelet** - a power attack opens a personal storage rift whose size grows with your
  Necromancy level. The normal attack does nothing yet.
- **Tin cans** (empty / with river water / with boiled water) - a reusable cycle instead of
  single-use jars: fill them with water, boil it right on a campfire without a pot, drink, and the
  can comes back empty. River water from a can can cause dysentery, like any murky water; boiled
  water is safe. They hold less water than glass jars.

## Pets

Summoning books raise allied creatures that fight zombies rather than the player. A pet does not
"follow" in any strict sense - it wanders on its own, and if it strays further than 32 blocks
while not in combat, it is teleported back to its owner:

- **Zombie Dog**, **Zombie Bear**, **Zombie Wolf**, **Zombie Griffin** - permanent companions. One
  of each kind can be kept at a time; a power attack recalls them into the book.
- **Beetles of the Lord** - a one-shot scroll releasing a swarm. The beetles scatter over a wide
  radius on their own and sting zombies; a stung zombie switches to your side just like with the
  Spirit Stone. The swarm cannot be recalled and only one can be active. Consumed on use.
- **Banshee's Scroll** - single use: on opening it screams with a banshee's voice and raises a
  small hostile horde next to the player. These are not allies - they are as dangerous to you as
  any other zombies.

## Base defence

- **Pyramid of Spirits** - a deployable block, not a held item. While you stand in its radius it
  charms any uncharmed zombie nearby on its own and sets it alight with cold purple flame, turning
  it against the other zombies instead of you or your base. Its block menu toggles the effect and
  shows the edge of the radius.

## The Black Portal - the story's ending

**The Black Portal Stone unlocks at the top of the progression (5000 zombies) and is the mod's
ending.** Activating it opens a confirmation dialogue, stops the game and unfolds a full-screen
finale - it finishes the story the note started on day one. The scene closes on a choice of two:
one ends the story and returns to the main menu, the other puts the player back into the world to
keep playing.

The story texts live in `Config/Localization.csv` under the `necroFinal*` keys. They are
deliberately not retold here: a README gets read before the playthrough.

## Small things

- The opening note also pauses the game and plays a short flashback.
- Some decorative blocks (beds, water coolers, cardboard boxes) can be disassembled by holding the
  key, like a workbench.

## Localization

**13 languages, complete:** Russian, English, German, Spanish, French, Italian, Japanese, Korean,
Polish, Brazilian Portuguese, Turkish, Simplified and Traditional Chinese. All 123 keys in
`Config/Localization.csv` are filled in, with no empty cells.

## Installation

Unpack the `NecromancerTome` folder into `<game folder>/Mods/` (or into
`%APPDATA%/7DaysToDie/Mods/`) and launch the game. The mod ships Harmony libraries, so **EAC must
be turned off**.

Built for single-player: the vanilla pause only works in single-player, so in multiplayer the
story scenes play without stopping time.

## Status

Version 1.0.1 - a fix for the first bug report from Nexus: the contents of the Spatial Bracelet no
longer disappear after leaving the game (the storage is now saved in the player's own file, next
to the backpack). All the announced content is implemented and passes testing in game. Of what was
planned, only part of the mod's own sound effects is missing. The description text for the website
(RU + EN) is in `SITE_DESCRIPTION.html` (WordPress block markup). The full technical history of
development and the text of the finale sit next to the mod in `BACKLOG.md` and `FINAL_TEXT.md` -
they are not part of the repository (spoilers and back-of-house).