Версия 2.0: свои модели ножа и крови, своя краска блоков через патч атласа

Нож некроманта и Кровь некроманта получили собственные модели, а Пирамида духов - собственную поверхность. Три разных способа, каждый выбран по тому, как устроен сам предмет. НОЖ И КРОВЬ - свои префабы в бандлах мода. Форма записи "#@modfolder(...)?prefab" подтверждена живым примером; геометрия у обоих ванильная, меняются материал и текстура. Текстуры генерируются скриптами (см. _private/tools), а не рисуются: правка вида сводится к правке констант и одному запуску. Нож: состаренная кость, почти чёрная обмотка, пурпур во впадинах, плюс слой под ручную роспись рун - он подмешивается в альбедо и в эмиссию, поэтому руны светятся. Слой пользовательский, генератор его никогда не перезаписывает. Положение росписи посчитано по геометрии: развёртка выгружена из меша, и подобрано смещение, при котором вся роспись ложится на одну плоскую грань. Раньше она перегибалась через кромку, обращённую к игроку. Кровь: банка вместо мешка. Заодно чинится расхождение, жившее с самого начала - описание предмета говорило "Банка, наполненная кровью", а наследуемый medicalBloodBag показывал sackPrefab, обычный мешок. Жидкость перерисована по маскам мешей, а не перекрашена тинтом: тинт предмета на этот меш не действует вовсе, у шейдера Game_EntityTintMaskSSS выигрывает _Color материала. ПИРАМИДА - своя краска в атласе блоков через собственный Harmony-патч. Ваниль своих текстур блоков не умеет: Texture у блока это индекс в готовом атласе, а запись краски несёт только TextureId/PaintCost/Group/SortIndex и никогда путь к картинке. Поэтому CustomBlockPaintPatch дописывает наш слой в массивы атласа на лету. Путь через свою модель (Shape="ModelEntity") пробовался и отложен: там остались нерешёнными столкновения и маджента на дальних экземплярах. Краска лучше тем, что блок остаётся обычным Shape="New" - со всеми работающими столкновениями, наведением по E и правильной посадкой, - а поверхность у него своя. Побочно краска доступна кисточкой под именем "Некротический прах". Параметры атласа не угаданы, а замерены в игре (BlockAtlasProbePatch): 512x512, DXT1 для альбедо и DXT5 для нормалей со specular, 10 мип-уровней, массивы нечитаемые - отсюда GPU-копирование и явные настройки импорта текстур. Зонд оставлен намеренно: номер краски в blocks.xml (608) это длина ванильного uvMapping, и после обновления игры он может сдвинуться - зонд печатает фактические числа при каждом запуске. Патчи обёрнуты целиком: они работают внутри загрузки игры, где вылетевшее исключение срывает шаг загрузки. Resources/necropyramid в коммит не идёт - на него никто не ссылается. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01W5F3AVwsusZHMqPBcSQcVJ
2026-09-10 16:28:59 +03:00
parent 026e006c9c
commit ab1b3eadaf
13 changed files with 654 additions and 20 deletions
@@ -122,3 +122,4 @@ necroFinalStayText,XUi,Menu,,,,"You took the army of the dead under your command
 necroFinalReturnTitle,XUi,Menu,,,,The Quiet Harbour,,Der stille Hafen,El puerto tranquilo,Le havre tranquille,Il porto tranquillo,静かな港,고요한 항구,Cicha przystań,O porto tranquilo,Тихая гавань,Sessiz Liman,静港,靜港
 necroFinalReturnText,XUi,Menu,,,,"You ordered the lich to lead the dead away into the forests, so that people could come out of their shelters and start surviving on their own, the way you once survived. If they manage, good. If they do not... then such is their fate. And you went back: to the world where you had already settled in and found your quiet harbour.",,"Du hast dem Lich befohlen, die Toten fort in die Wälder zu führen – damit die Menschen aus ihren Verstecken treten und selbst zu überleben beginnen können, so wie du einst überlebt hast. Schaffen sie es, gut. Schaffen sie es nicht ... dann ist das eben ihr Schicksal. Und du bist zurückgegangen: in die Welt, in der du dich bereits eingerichtet und deinen stillen Hafen gefunden hast.","Ordenaste al liche que se llevara a los muertos a los bosques, para que la gente pudiera salir de sus refugios y empezar a sobrevivir por su cuenta, igual que sobreviviste tú en su día. Si lo consiguen, bien. Si no... será su destino. Y tú regresaste: al mundo donde ya te habías asentado y habías encontrado tu puerto tranquilo.","Tu as ordonné à la liche d'emmener les morts au loin dans les forêts – pour que les gens puissent sortir de leurs abris et commencer à survivre seuls, comme tu as survécu autrefois. S'ils y parviennent, tant mieux. Sinon... c'est leur destin. Et toi, tu es reparti : vers le monde où tu t'étais déjà installé et où tu avais trouvé ton havre tranquille.","Hai ordinato al lich di condurre i morti via nelle foreste, perché la gente potesse uscire dai rifugi e iniziare a sopravvivere da sé, come un tempo sei sopravvissuto tu. Se ce la fanno, bene. Se non ce la fanno... allora è il loro destino. E tu sei tornato indietro: nel mondo dove ti eri già sistemato e avevi trovato il tuo porto tranquillo.",あなたはリッチに命じ、不死者をすべて森へ連れ去らせた。人々が避難所から出て、かつてのあなたと同じように、自らの力で生き延び始められるように。やり遂げるならそれでいい。できなければ……それが彼らの定めというだけだ。そしてあなたは戻っていった。すでに身を落ち着け、静かな港を見つけたあの世界へ。,"당신은 리치에게 명하여 언데드를 모두 숲으로 데려가게 했다. 사람들이 피난처에서 나와, 한때 당신이 그랬듯 스스로 살아남기 시작할 수 있도록. 해낸다면 좋은 일이다. 해내지 못한다면... 그것이 그들의 운명일 뿐이다. 그리고 당신은 돌아갔다. 이미 자리를 잡고 자신만의 고요한 항구를 찾아낸 그 세계로.","Rozkazałeś liczowi wyprowadzić umarłych w lasy – żeby ludzie mogli wyjść ze schronów i zacząć przetrwać o własnych siłach, tak jak kiedyś przetrwałeś ty. Poradzą sobie – dobrze. Nie poradzą... cóż, taki ich los. A ty wróciłeś: do świata, w którym zdążyłeś się urządzić i znaleźć swoją cichą przystań.","Você ordenou ao lich que levasse os mortos embora para as florestas - para que as pessoas pudessem sair dos abrigos e começar a sobreviver por conta própria, como você mesmo sobreviveu um dia. Se conseguirem, ótimo. Se não... então é o destino delas. E você voltou: para o mundo onde já havia se estabelecido e encontrado o seu porto tranquilo.","Вы приказали личу увести нежить в леса — чтобы люди вышли из убежищ и начали выживать сами, как когда-то выживали вы. Справятся — хорошо. Не справятся... значит, такова их судьба. А вы вернулись обратно: в мир, где успели обустроиться и найти свою тихую гавань.","Liche, ölüleri alıp ormanlara götürmesini emrettin - insanlar sığınaklarından çıkıp, bir zamanlar senin hayatta kaldığın gibi kendi başlarına hayatta kalmaya başlayabilsinler diye. Başarırlarsa ne âlâ. Başaramazlarsa... demek ki kaderleri buymuş. Sen ise geri döndün: çoktan yerleşip kendi sessiz limanını bulduğun o dünyaya.",你命令巫妖将亡灵尽数带往森林深处——好让人们走出避难所，像你当年那样，靠自己活下去。若他们撑得住，那很好；若撑不住……那便是他们的命。而你回去了：回到那个你早已安顿下来、寻得自己静港的世界。,你命令巫妖將亡靈盡數帶往森林深處——好讓人們走出避難所，像你當年那樣，靠自己活下去。若他們撐得住，那很好；若撐不住……那便是他們的命。而你回去了：回到那個你早已安頓下來、尋得自己靜港的世界。
 necroFinalBtnTheEnd,XUi,Menu,,,,The End,,Ende,Fin,Fin,Fine,おわり,끝,Koniec,Fim,Конец,Son,全剧终,全劇終
 txName_NecroAsh,painting,Texture,,,,Necrotic Ash,,Nekrotische Asche,Ceniza necrótica,Cendre nécrotique,Cenere necrotica,,,,,Некротический прах,,,
@@ -66,10 +66,103 @@
 				<property class="TEFeaturePyramidWard" />
 			</property>
 			<property name="Material" value="Msteel_shapes" />
 			<!-- ВЕРНУТО НА Shape="New" 2026-09-10 по решению пользователя: «пока верни пирамиду,
 			     которая была у нас изначально».
 			     Своя модель со своей текстурой требует Shape="ModelEntity", и на этом пути осталось
 			     два невылеченных дефекта - разбор и все замеры в BACKLOG.md, раздел про пирамиду:
 			       - нет столкновений: при "New" их считает воксельная система блока, а "ModelEntity"
 			         берёт от модели, и одного BoxCollider на корне в слое 16 не хватило;
 			       - дальние экземпляры рисуются фиолетовым (маджента = не найден шейдер), ближние
 			         при этом верны; добавленный LODGroup положения не исправил.
 			     Всё, что сделано для того пути, сохранено и работает: генератор текстуры
 			     _private/tools/make_pyramid_textures.py, сборка _private/Extracted/ShapesUnityProject,
 			     бандл Resources/necropyramid. Чтобы вернуться к нему, достаточно заменить Shape на
 			     ModelEntity и раскомментировать строку Model ниже. -->
 			<property name="Shape" value="New" />
 			<!-- Своя модель отключена вместе с возвратом на Shape="New" (см. комментарий выше).
 			     Строка сохранена: она рабочая, ею подключается наш бандл. -->
 			<property name="Model" value="@:Shapes/pyramid.fbx" />
-			<property name="Texture" value="356" />
+			<!-- <property name="Model" value="#@modfolder(NecromancerTome):Resources/necropyramid?necroPyramidPrefab.prefab" /> -->
-			<property name="TintColor" value="8A4142" />
+			<!-- ModelOffset - ПОЛОЖЕНИЕ МОДЕЛИ, и задавать его надо именно здесь.
 			     Меш формы из shapes-бандла сделан под воксельную систему: его границы лежат не вокруг
 			     начала координат, а в углу (центр -0.50, 0.13, -0.50 при размере 0.51 x 0.26 x 0.50).
 			     Как ModelEntity такая модель вылезает из своего куба - что и наблюдалось: «поднялась,
 			     вершиной упирается в верхний угол».
 			     Сначала это лечили сдвигом детей ВНУТРИ префаба. Модель встала верно, но по блоку
 			     по-прежнему нельзя было попасть и не работало наведение по E: о сдвиге знал только
 			     префаб, а игра держала свой объём для попаданий там, где модель была бы без сдвига.
 			     Игрок целился в одно, а попадал мимо.
 			     Ваниль двигает модель именно этим свойством (у верстака стоит "0,.5,0"), и его игра
 			     учитывает целиком - и в отрисовке, и в попаданиях. Значение посчитано скриптом сборки
 			     по фактическим границам меша: по X и Z в центр куба, по Y основанием на нижнюю грань.
 			     Если меш заменят, скрипт напечатает новое значение в лог. -->
 			<!-- ModelOffset нужен только при ModelEntity; при "New" положение задаёт сама форма.
 			     Значение верное, посчитано скриптом сборки - сохранено для возврата.
 			<property name="ModelOffset" value="0.5,-0.495,0.5" /> -->
 			<!-- ПОКРАСКА ВМЕСТО СВОЕЙ ТЕКСТУРЫ, 2026-09-10. Мысль пользователя: «в игре есть
 			     кисточка, позволяющая перекрашивать блоки, можем ли мы наложить текстуру через
 			     покраску, только заранее?» Можем - именно это свойство Texture и делает.
 			     Data/Config/painting.xml сопоставляет краски из кисточки с номерами текстур атласа
 			     (поле TextureId), а Texture у блока задаёт краску заранее. Доступно 156 красок;
 			     выписаны с названиями в _private/Extracted/paints.txt.
 			     Было 356 (txName_Steel_wall, «оцинкованная стальная стена») - выбор достался от
 			     steelShapes вместе с парой Material/Texture и к праху отношения не имел.
 			     Пробовали 11 (txName_Gravel, «гравий») - в игре прочиталось как земля.
 			     Сейчас 552 (txName_GraniteBlack, «гранит чёрный»): тёмный камень ближе к
 			     спрессованному праху, чем крупная осыпь гравия.
 			     СВОЮ текстуру сюда подставить НЕЛЬЗЯ, проверено по коду игры: у записи краски есть
 			     только TextureId, PaintCost, Group, SortIndex - поля с путём к своей картинке нет.
 			     TextureId это индекс в уже собранном атласе, а сам атлас лежит в
 			     blocktextureatlases_assets_all.bundle среди Addressables игры (рядом с
 			     TerrainTextures), и крючка для подмены его модом не нашлось. Своя текстура
 			     возможна только через путь ModelEntity со своим бандлом - см. BACKLOG.md.
 			     Подбирать краску удобнее всего кисточкой прямо в игре: доступны все 156, перезапуск
 			     не нужен. Найденный номер прописывается сюда.
 			     СЕЙЧАС ЭТИ ДВА СВОЙСТВА НЕ РАБОТАЮТ. Блок снова на Shape="ModelEntity" со своей
 			     моделью (2026-09-10, после того как префаб довели до вида ванильного): при
 			     ModelEntity поверхность даёт материал префаба, а не атлас, и Texture с TintColor
 			     не участвуют. Оставлены нетронутыми, чтобы возврат к покраске был ровно двумя
 			     правками - Shape на "New" и переключить строку Model ниже.
 			     TintColor - множитель поверх краски. Взят пепельно-серый с уходом в фиолет, в тон
 			     остальному мод-набору. Прежний 8A4142 давал ржаво-красный.
 			     Texture принимает и ШЕСТЬ значений через запятую - по одному на грань (в ванили есть
 			     например value="195,570,570,570,570,570"). Если захочется основание отличать от
 			     скатов - делается здесь же, без всякого бандла.
 			     Хорошие запасные варианты из того же списка: 606 concrete_broken (потрескавшийся
 			     бетон), 552 GraniteBlack (чёрный гранит), 443 Rust_black (чёрная ржавчина),
 			     385 Green_rusty_metal (зелёная ржавчина, в тон вкраплениям). -->
 			<!-- СВОЯ КРАСКА, 2026-09-10. Это уже НЕ ванильная краска из атласа: текстуру пирамиды
 			     добавляет в атлас наш собственный Harmony-патч, HarmonySrc/CustomBlockPaintPatch.cs.
 			     Блок при этом остаётся обычным Shape="New" - со всеми работающими столкновениями,
 			     наведением по E и правильной посадкой, - а поверхность у него своя.
 			     608 - это НОМЕР ЗАПИСИ В uvMapping, а не номер краски. Патч печатает его в лог при
 			     каждом запуске: «uvMapping entry 608 points at slice 407». Краска дополнительно
 			     регистрируется под именем txName_NecroAsh («Некротический прах») и занимает слот 13,
 			     но блоку нужен именно номер записи.
 			     ХРУПКОЕ МЕСТО: 608 - это длина uvMapping ванильной игры, то есть наша запись просто
 			     дописывается в конец. Число верно, пока атлас игры не изменился; после обновления игры
 			     оно может сдвинуться. Патч печатает фактический номер в лог, поэтому расхождение видно
 			     сразу - сверяться при обновлениях.
 			     TintColor убран намеренно: цвет несёт сама текстура, а тинт - множитель, он бы её
 			     исказил. Тот же вывод, что уже сделан по ножу и по банке крови.
 			<property name="TintColor" value="C8BCD2" /> -->
 			<property name="Texture" value="608" />
 			<!-- Real generated art (exch/pyramidOfSpirit.png, copied to
 			     UIAtlases/ItemIconAtlas/) added 2026-09-02, per direct instruction - no
 			     CustomIconTint alongside it (same lesson as every other real icon in this mod,
@@ -900,29 +900,54 @@
 			     boneShivPrefab, то есть слот тинта у этого меша рабочий и на оружии с
 			     ShowQuality тоже применяется. Копать тут больше нечего; осталось только
 			     посмотреть глазами, достаточно ли чёрный получается клинок. -->
-			<property name="TintColor" value="0, 0, 0"/>
+			<!-- TintColor ОТКЛЮЧЁН 2026-09-10 вместе с переходом на свою текстуру.
-
+			
-			<!-- СВОЯ МОДЕЛЬ, ЗАГОТОВКА 2026-09-10 - ВКЛЮЧАТЬ ТОЛЬКО ВМЕСТЕ С БАНДЛОМ.
+			     TintColor - это МНОЖИТЕЛЬ цвета меша, а 0,0,0 множит в чистый чёрный. Он был нужен,
-			     Строка ниже намеренно закомментирована: файла Resources/necroknife в моде ещё
+			     пока нож носил ванильную бежевую кость: другого способа затемнить клинок не было.
-			     нет, а Meshfile, указывающий в никуда, сломает нож прямо в живой папке мода -
+			     Теперь цвет несёт своя текстура necroKnife_d.png, и тот же множитель погасил бы
-			     игра читает именно её, и вечерний тест v1.0 идёт с этих же файлов.
+			     всё нарисованное в ноль - вместе с пурпурным свечением в альбедо.
-			     Раскомментировать в тот момент, когда бандл лёг в Resources/, и не раньше.
+			
 			     Иконка от этого не зависит: она отдельный арт (CustomIcon выше), CustomIconTint
 			     здесь никогда не стоял. И на иконке клинок именно КОСТЯНОЙ, а не чёрный, так что
 			     чёрный множитель ей вдобавок противоречил.
 			     Побочно это снимает неоднозначность теста трубы: красный клинок мог быть виден
 			     только за счёт эмиссии, если тинт всё-таки давил альбедо нашего меша. Без тинта
 			     вопроса больше нет.
 			<property name="TintColor" value="0, 0, 0"/> -->
 			<!-- СВОЯ МОДЕЛЬ. ВКЛЮЧЕНА 2026-09-10 вместе с бандлом Resources/necroknife (2.19 МБ,
 			     собран Unity 2022.3.62f2 в batch-режиме; внутри necroKnifePrefab.prefab, три меша
 			     boneShiv_LOD0/1/2, текстуры boneShiv_d/_n и материал necroKnife.mat - бандл
 			     самодостаточный, проверено по составу).
 			     ВНИМАНИЕ: в бандле сейчас ТЕСТОВЫЙ вид - ярко-красный материал с эмиссией. Это
 			     проверка трубы, а не финальная модель. Красный выбран потому, что ванильный нож
 			     бежевый и по нему не отличить, загрузился наш бандл или подставилась ваниль;
 			     эмиссия - потому что TintColor ниже стоит 0,0,0, и если игра множит тинт на
 			     материал нашего меша, красный альбедо ушёл бы в чёрный и тест ничего бы не показал.
 			     Настоящая текстура рисуется поверх _private/Extracted/boneShiv_d.png после того,
 			     как труба подтвердится.
 			     Синтаксис: "#" - грузить из бандла, "@modfolder(NecromancerTome):" - путь от
 			     корня этого мода, "?" отделяет путь к префабу ВНУТРИ бандла. Форма собрана из
 			     двух подтверждённых кусков: ваниль пишет "#Entities/Trees?SnakeweedPrefab.prefab"
 			     (Data/Config/blocks.xml), а поддержка "@modfolder:" лежит в Assembly-CSharp.
-			     Живым примером форма не проверена - первый тестовый бандл с кубом её подтвердит
+			     ФОРМА ПОДТВЕРЖДЕНА ЖИВЫМ ПРИМЕРОМ 2026-09-10: с этой строкой тестовый красный
-			     или опровергнет, до того как рисовать текстуру.
+			     нож появился в руке. Значит и запись работает, и бандл из папки мода читается,
-
+			     и Standard-шейдер из Unity 2022.3.62f2 игра отрисовывает. Больше не гипотеза -
-			     necroknife - имя AssetBundle, заданное префабу в Unity (инспектор, нижняя строка
+			     этой же формой можно подключать любые следующие свои модели.
-			     AssetBundle); necroKnifePrefab.prefab - имя префаба ВНУТРИ бандла. Оба должны
+			
-			     совпасть с тем, что реально собралось, иначе предмет останется без модели молча.
+			     necroknife - имя AssetBundle, заданное префабу в Unity; necroKnifePrefab.prefab -
-			     Сборка - Mods/_NecromancerTome_private/tools/UnityEditorScripts/BuildNecroBundles.cs.
+			     имя префаба ВНУТРИ бандла. Оба должны совпасть с тем, что реально собралось, иначе
-
+			     предмет останется без модели молча. Пересборка - меню NecromancerTome -> Ctrl+Shift+B
 			     либо batch: Unity.exe -batchmode -nographics -quit -projectPath <проект>
 			     -executeMethod NecroKnifeSetup.SetupAndBuild. Игру после каждой пересборки
 			     перезапускать: моды и их бандлы читаются только при старте.
 			     Геометрия остаётся ванильной, меняются материал и текстура, поэтому HoldType,
 			     посадка в руке и анимации от базового ножа продолжают подходить без правок. -->
-			<!-- <property name="Meshfile" value="#@modfolder(NecromancerTome):Resources/necroknife?necroKnifePrefab.prefab"/> -->
+			<property name="Meshfile" value="#@modfolder(NecromancerTome):Resources/necroknife?necroKnifePrefab.prefab"/>
 			<!-- MOD SLOTS ADDED 2026-09-07 (user request: "добавь в нож слоты для
 			     модификаций... модификации там будут особые, именно для ножа
@@ -1263,7 +1288,39 @@
 			     same reasoning as every other hand-drawn icon in this mod (Dog/Insect summon
 			     books, etc.) - don't recolor finished art. -->
 			<property name="CustomIcon" value="NecromantsBlood"/>
-			<property name="TintColor" value="60, 0, 10"/>
+
 			<!-- СВОЯ БАНКА С КРОВЬЮ, 2026-09-10 (указание: «берём чай из золотарника, и жёлтое
 			     заменяем на кровавый цвет, с фиолетовыми оттенками»).
 			     Заодно чинится расхождение текста и модели: описание предмета
 			     (resourceNecromancerBloodDesc) с самого начала говорит «Банка, наполненная кровью
 			     самого некроманта», а наследуемый medicalBloodBag показывает
 			     @:Other/Items/Misc/sackPrefab.prefab - обычный мешок. Банка вернее и по механике:
 			     рецепт и так требует пустую банку (recipes.xml, NecromancerBloodPatch.cs).
 			     ПОЧЕМУ НЕ ХВАТИЛО ТИНТА - ПРОВЕРЕНО В ИГРЕ. Сначала пробовали дёшево, без бандла:
 			     ванильный префаб чая плюс TintColor. Проверка 2026-09-10 показала, что банка
 			     осталась чаем из золотарника - тинт предмета на этот меш НЕ ПОДЕЙСТВОВАЛ ВООБЩЕ.
 			     У шейдера Game_EntityTintMaskSSS выигрывает собственный _Color материала (у чая
 			     жёлтый, 166,133,37), и свойство предмета его не перебивает. Поэтому TintColor здесь
 			     не задаётся совсем: он ничего не даёт и только вводил бы в заблуждение.
 			     И по сути: кровь отличается от чая не цветом, а тем, что она непрозрачная, тёмная и
 			     густая, с плёнкой на стекле. Поэтому жидкость ПЕРЕРИСОВАНА по яркости, а не
 			     перекрашена множителем - генератор _private/tools/make_necroblood_textures.py.
 			     HoldType 3 - хват банки вместо 45 (мешок), Material Mglass - стекло вместо ткани
 			     (звук удара и осколки при разбитии). Без них банка держалась бы как мешок.
 			     ЧТО СМОТРЕТЬ ГЛАЗАМИ. Материал собран на встроенном Standard в режиме Fade: родной
 			     шейдер переиспользовать нельзя, AssetRipper выгрузил шейдеры заглушками. У Standard
 			     альфа текстуры - это прозрачность, поэтому она задана осознанно: стекло
 			     полупрозрачное, жидкость плотная. Банка должна читаться как стекло с густой кровью,
 			     а не как матовый сосуд. -->
 			<property name="Meshfile" value="#@modfolder(NecromancerTome):Resources/necroblood?necroBloodPrefab.prefab"/>
 			<property name="HoldType" value="3"/>
 			<property name="Material" value="Mglass"/>
 			<property name="EconomicValue" value="0"/>
 		</item>
 	</append>
@@ -0,0 +1,149 @@
 using System;
 using System.Text;
 using HarmonyLib;
 using UnityEngine;
 namespace NecromancerTome
 {
 	/// <summary>
 	/// DIAGNOSTIC - measures the game's opaque block texture atlas and logs what it finds. Adds
 	/// nothing and changes nothing.
 	///
 	/// KEPT ON PURPOSE, though it started as throwaway reconnaissance for CustomBlockPaintPatch.
 	/// That patch appends our paint to the end of the atlas, so the block's Texture number in
 	/// blocks.xml (608 today) is simply "however many entries vanilla had". A game update that
 	/// grows the atlas moves it. This probe prints the real numbers on every load, which is what
 	/// turns that drift from a silent wrong texture into one line in the log.
 	///
 	/// WHY THIS EXISTS. The Pyramid of Spirits should ship with its own surface, but vanilla has
 	/// no way to add one: a block's Texture property is an INDEX into a prebuilt atlas, and the
 	/// atlas itself lives in blocktextureatlases_assets_all.bundle. Confirmed by reading the
 	/// game's own strings - a paint entry carries only TextureId/PaintCost/Group/SortIndex, never
 	/// a path to an image. So the only way in is to extend the atlas at runtime from a Harmony
 	/// patch.
 	///
 	/// Extending it means building a bigger Texture2DArray, copying every existing slice across
 	/// and appending ours. That REQUIRES knowing the array's exact width, height, format and
 	/// mipmap count - a slice that disagrees on any of those cannot be copied in. None of it can
 	/// be known statically, hence this probe: measure first, write the real patch second.
 	///
 	/// TWO LESSONS FROM THE FIRST ATTEMPT, both paid for in a broken load:
 	///
 	/// 1. A THROWING POSTFIX BREAKS THE GAME'S LOADING. The first version dereferenced
 	///    BlockTextureData.list without checking it, threw, and the log answered with
 	///    "XML loader: Executing post load step on 'materials.xml' failed". A probe must be
 	///    incapable of harm, so everything here is wrapped and nothing is allowed to escape.
 	///
 	/// 2. THIS RUNS BEFORE THE PAINT TABLE EXISTS. ReloadTextureArrays fires during
 	///    MeshDescription.Init, and the log shows painting.xml loading well after it - so
 	///    BlockTextureData.list is still null at that point. Hence the probe reports several
 	///    times instead of once: the early call shows the atlas as loaded, later calls show it
 	///    once the rest of the game has caught up.
 	///
 	/// </summary>
 	[HarmonyPatch(typeof(MeshDescription), "ReloadTextureArrays")]
 	public static class BlockAtlasProbePatch
 	{
 		const int MaxReports = 4;
 		static int reports;
 		static void Postfix()
 		{
 			if (reports >= MaxReports) return;
 			reports++;
 			// Never let a measurement break a load: the game calls this from inside its own
 			// XML post-load step, and an escaping exception aborts that step.
 			try
 			{
 				LogOpaqueAtlas(reports);
 			}
 			catch (Exception e)
 			{
 				Debug.LogWarning("[NecromancerTome] BlockAtlasProbe: measurement #" + reports +
 					" failed harmlessly: " + e.Message);
 			}
 		}
 		public static void LogOpaqueAtlas(int report)
 		{
 			var sb = new StringBuilder();
 			sb.AppendLine("[NecromancerTome] BlockAtlasProbe #" + report + ": opaque block atlas");
 			if (MeshDescription.meshes == null)
 			{
 				sb.AppendLine("  MeshDescription.meshes is null - too early");
 				Debug.Log(sb.ToString());
 				return;
 			}
 			MeshDescription mesh = MeshDescription.meshes[MeshDescription.MESH_OPAQUE];
 			if (mesh == null)
 			{
 				sb.AppendLine("  MESH_OPAQUE is null - too early");
 				Debug.Log(sb.ToString());
 				return;
 			}
 			var atlas = mesh.textureAtlas as TextureAtlasBlocks;
 			if (atlas == null)
 			{
 				sb.AppendLine("  textureAtlas is " + (mesh.textureAtlas == null
 					? "null" : mesh.textureAtlas.GetType().Name) + ", expected TextureAtlasBlocks");
 				Debug.Log(sb.ToString());
 				return;
 			}
 			sb.AppendLine("  uvMapping entries: " +
 				(atlas.uvMapping == null ? "null" : atlas.uvMapping.Length.ToString()));
 			Describe(sb, "diffuse ", atlas.diffuseTexture);
 			Describe(sb, "normal  ", atlas.normalTexture);
 			Describe(sb, "specular", atlas.specularTexture);
 			// A new paint needs an unused index in BlockTextureData.list. The table is filled
 			// from painting.xml, which loads AFTER the textures - so on the early call this is
 			// still null, and that is expected rather than a fault.
 			if (BlockTextureData.list == null)
 			{
 				sb.AppendLine("  paint table: not built yet (painting.xml loads later)");
 			}
 			else
 			{
 				int used = 0, free = 0;
 				for (int i = 0; i < BlockTextureData.list.Length; i++)
 				{
 					if (BlockTextureData.list[i] == null) free++; else used++;
 				}
 				sb.AppendLine("  paint slots: " + used + " used, " + free + " free, " +
 					BlockTextureData.list.Length + " total");
 			}
 			Debug.Log(sb.ToString());
 		}
 		static void Describe(StringBuilder sb, string label, Texture texture)
 		{
 			if (texture == null)
 			{
 				sb.AppendLine("  " + label + ": null");
 				return;
 			}
 			var arr = texture as Texture2DArray;
 			if (arr == null)
 			{
 				sb.AppendLine("  " + label + ": " + texture.GetType().Name +
 					" (expected Texture2DArray) " + texture.width + "x" + texture.height);
 				return;
 			}
 			// depth = how many slices are already in the array; ours would become index `depth`,
 			// and every number below has to be matched exactly by our own texture.
 			sb.AppendLine("  " + label + ": " + arr.width + "x" + arr.height +
 				" slices=" + arr.depth +
 				" format=" + arr.format +
 				" graphicsFormat=" + arr.graphicsFormat +
 				" mips=" + arr.mipmapCount +
 				" readable=" + arr.isReadable);
 		}
 	}
 }
@@ -0,0 +1,321 @@
 using System;
 using System.Collections.Generic;
 using System.IO;
 using System.Reflection;
 using HarmonyLib;
 using UnityEngine;
 namespace NecromancerTome
 {
 	/// <summary>
 	/// Adds the mod's own paint to the game's opaque block texture atlas, so the Pyramid of
 	/// Spirits can ship with a surface that does not exist in vanilla.
 	///
 	/// WHY A PATCH IS THE ONLY WAY. A block's Texture property is an INDEX into a prebuilt
 	/// atlas; a paint entry in painting.xml carries TextureId/PaintCost/Group/SortIndex and
 	/// never a path to an image, and the atlas itself is compiled into
 	/// blocktextureatlases_assets_all.bundle. Nothing in the XML layer can introduce new image
 	/// data, so the array has to be extended at runtime.
 	///
 	/// WHY THIS HOOK. CreateBlockTextures is the coroutine that reads painting.xml. Hooking its
 	/// completion is deliberate and was learned the hard way: an earlier probe ran from
 	/// MeshDescription.ReloadTextureArrays and found BlockTextureData.list still null, because
 	/// the texture arrays load BEFORE painting.xml. By the time this coroutine finishes, both the
 	/// arrays and the paint table exist.
 	///
 	/// THE NUMBERS THIS RELIES ON were measured in-game rather than assumed (BlockAtlasProbe,
 	/// 2026-09-10): the opaque atlas holds 407 slices of 512x512 with a full 10-level mip chain,
 	/// diffuse as DXT1 and normal/specular as DXT5, and all three arrays are non-readable. Two
 	/// consequences drive the code below - our textures must match those numbers exactly, and
 	/// every copy must go through the GPU, since a non-readable array cannot be read back.
 	///
 	/// SAFETY. Everything is wrapped: this runs inside the game's own XML loading, and an
 	/// escaping exception aborts that step - which is exactly how a careless earlier version
 	/// produced "XML loader: Executing post load step on 'materials.xml' failed". If anything
 	/// here fails, the mod logs it and leaves the game exactly as it was.
 	/// </summary>
 	public static class CustomBlockPaintPatch
 	{
 		/// <summary>Bundle we ship the paint textures in, relative to the mod folder.</summary>
 		const string BundlePath = "Resources/necroatlas";
 		const string DiffuseAsset = "Assets/NecroAtlas/atlas_necroPyramid_d.png";
 		const string NormalAsset = "Assets/NecroAtlas/atlas_necroPyramid_n.png";
 		const string SpecularAsset = "Assets/NecroAtlas/atlas_necroPyramid_m.png";
 		/// <summary>Name the paint is registered under; blocks.xml refers to the resulting id.</summary>
 		public const string PaintName = "txName_NecroAsh";
 		/// <summary>Paint id handed out by the game once registration succeeds, -1 while unset.
 		/// Logged on success so it can be written into blocks.xml.</summary>
 		public static int AssignedPaintId = -1;
 		static bool alreadyRan;
 		/// <summary>
 		/// Patch the coroutine's MoveNext. A coroutine compiles into a hidden state-machine
 		/// class, so the method that actually runs is MoveNext, not CreateBlockTextures itself -
 		/// AccessTools.EnumeratorMoveNext resolves it for us.
 		/// </summary>
 		[HarmonyPatch]
 		static class CreateBlockTexturesHook
 		{
 			static IEnumerable<MethodBase> TargetMethods()
 			{
 				MethodBase coroutine = AccessTools.Method(
 					typeof(BlockTexturesFromXML), "CreateBlockTextures");
 				if (coroutine == null)
 				{
 					Debug.LogWarning("[NecromancerTome] CustomBlockPaint: " +
 						"BlockTexturesFromXML.CreateBlockTextures not found - paint not added");
 					yield break;
 				}
 				MethodBase moveNext = AccessTools.EnumeratorMoveNext(coroutine);
 				if (moveNext == null)
 				{
 					Debug.LogWarning("[NecromancerTome] CustomBlockPaint: " +
 						"could not resolve the coroutine's MoveNext - paint not added");
 					yield break;
 				}
 				yield return moveNext;
 			}
 			// __result == false means the enumerator is done: the XML has been read in full.
 			static void Postfix(bool __result)
 			{
 				if (__result || alreadyRan) return;
 				alreadyRan = true;
 				try
 				{
 					AddPaint();
 				}
 				catch (Exception e)
 				{
 					Debug.LogWarning("[NecromancerTome] CustomBlockPaint: failed, game left " +
 						"untouched: " + e);
 				}
 			}
 		}
 		static void AddPaint()
 		{
 			if (GameManager.IsDedicatedServer)
 			{
 				Debug.Log("[NecromancerTome] CustomBlockPaint: dedicated server, textures skipped");
 				return;
 			}
 			MeshDescription mesh = MeshDescription.meshes[MeshDescription.MESH_OPAQUE];
 			var atlas = mesh == null ? null : mesh.textureAtlas as TextureAtlasBlocks;
 			if (atlas == null)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: opaque atlas unavailable");
 				return;
 			}
 			AssetBundle bundle = LoadBundle();
 			if (bundle == null) return;
 			try
 			{
 				var diffuse = bundle.LoadAsset<Texture2D>(DiffuseAsset);
 				var normal = bundle.LoadAsset<Texture2D>(NormalAsset);
 				var specular = bundle.LoadAsset<Texture2D>(SpecularAsset);
 				if (diffuse == null || normal == null || specular == null)
 				{
 					Debug.LogWarning("[NecromancerTome] CustomBlockPaint: bundle is missing one " +
 						"of the three textures - nothing added");
 					return;
 				}
 				Describe("our diffuse ", diffuse);
 				Describe("our normal  ", normal);
 				Describe("our specular", specular);
 				int slice = Append(ref atlas.diffuseTexture, diffuse, "diffuse");
 				Append(ref atlas.normalTexture, normal, "normal");
 				Append(ref atlas.specularTexture, specular, "specular");
 				if (slice < 0) return;
 				mesh.TexDiffuse = atlas.diffuseTexture;
 				mesh.TexNormal = atlas.normalTexture;
 				mesh.TexSpecular = atlas.specularTexture;
 				mesh.ReloadTextureArrays(false);
 				int textureId = RegisterUvMapping(atlas, slice);
 				RegisterPaint(textureId);
 			}
 			finally
 			{
 				// Keep the loaded textures alive: only the bundle wrapper is released.
 				bundle.Unload(false);
 			}
 		}
 		/// <summary>
 		/// Give the new slice an entry in uvMapping and return its index - that index is what a
 		/// block's Texture property in blocks.xml actually refers to.
 		///
 		/// The entry is CLONED from an existing plain opaque paint rather than built field by
 		/// field. UVRectTiling carries more than a slice number (tiling, block size, material
 		/// flags), and copying a known-good neighbour keeps every one of those correct without
 		/// guessing at fields we have never inspected. Only the slice index is changed.
 		/// </summary>
 		static int RegisterUvMapping(TextureAtlasBlocks atlas, int slice)
 		{
 			// 356 is txName_Steel_wall - an ordinary full-block opaque paint, which is exactly
 			// the shape of entry we want.
 			const int TemplateTextureId = 356;
 			if (atlas.uvMapping == null || atlas.uvMapping.Length <= TemplateTextureId)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: uvMapping too small to " +
 					"clone a template from - paint not registered");
 				return -1;
 			}
 			int textureId = atlas.uvMapping.Length;
 			Array.Resize(ref atlas.uvMapping, textureId + 1);
 			UVRectTiling tile = atlas.uvMapping[TemplateTextureId];
 			// Только индекс слоя: имени у UVRectTiling нет, оно живёт в BlockTextureData.
 			tile.index = slice;
 			atlas.uvMapping[textureId] = tile;
 			Debug.Log("[NecromancerTome] CustomBlockPaint: uvMapping entry " + textureId +
 				" points at slice " + slice + " (cloned from " + TemplateTextureId + ")");
 			return textureId;
 		}
 		/// <summary>
 		/// Register the paint itself, so it has a name, shows up in the paint brush, and can be
 		/// referred to by name. The block only needs the texture id, but a nameless texture with
 		/// no paint entry would be invisible to the rest of the game.
 		/// </summary>
 		static void RegisterPaint(int textureId)
 		{
 			if (textureId < 0) return;
 			if (BlockTextureData.list == null)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: paint table missing - " +
 					"texture added but not named");
 				return;
 			}
 			int free = -1;
 			for (int i = 0; i < BlockTextureData.list.Length; i++)
 			{
 				if (BlockTextureData.list[i] == null) { free = i; break; }
 			}
 			if (free < 0)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: no free paint slot - " +
 					"texture added but not named");
 				return;
 			}
 			var data = new BlockTextureData
 			{
 				ID = free,
 				Name = PaintName,
 				LocalizedName = Localization.Get(PaintName),
 				TextureID = (ushort)textureId,
 				Group = "txGroupMasonry",
 				PaintCost = 1,
 				SortIndex = 0,
 				Hidden = false,
 			};
 			data.Init();
 			AssignedPaintId = free;
 			Debug.Log("[NecromancerTome] CustomBlockPaint: paint registered, slot " + free +
 				", texture id " + textureId + " -> put Texture=\"" + textureId +
 				"\" on the block in blocks.xml");
 		}
 		static AssetBundle LoadBundle()
 		{
 			if (ModEntry.Instance == null)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: mod path unknown");
 				return null;
 			}
 			string path = Path.Combine(ModEntry.Instance.Path, BundlePath);
 			if (!File.Exists(path))
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: bundle not found at " + path);
 				return null;
 			}
 			AssetBundle bundle = AssetBundle.LoadFromFile(path);
 			if (bundle == null)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: bundle failed to load: " + path);
 			}
 			return bundle;
 		}
 		/// <summary>
 		/// Rebuild a texture array one slice larger and put our texture in the new last slot.
 		/// Returns the new slice index, or -1 if the arrays disagree on anything that makes a
 		/// copy impossible.
 		/// </summary>
 		static int Append(ref Texture target, Texture2D ours, string label)
 		{
 			var src = target as Texture2DArray;
 			if (src == null)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: " + label +
 					" is not a Texture2DArray - skipped");
 				return -1;
 			}
 			if (ours.width != src.width || ours.height != src.height)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: " + label + " size mismatch, " +
 					"atlas is " + src.width + "x" + src.height + " but ours is " +
 					ours.width + "x" + ours.height + " - skipped");
 				return -1;
 			}
 			if (ours.graphicsFormat != src.graphicsFormat)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: " + label + " format mismatch, " +
 					"atlas is " + src.graphicsFormat + " but ours is " + ours.graphicsFormat +
 					" - skipped");
 				return -1;
 			}
 			if (ours.mipmapCount != src.mipmapCount)
 			{
 				Debug.LogWarning("[NecromancerTome] CustomBlockPaint: " + label + " mip mismatch, " +
 					"atlas has " + src.mipmapCount + " but ours has " + ours.mipmapCount +
 					" - skipped");
 				return -1;
 			}
 			int slice = src.depth;
 			var grown = new Texture2DArray(src.width, src.height, slice + 1,
 				src.graphicsFormat, UnityEngine.Experimental.Rendering.TextureCreationFlags.MipChain,
 				src.mipmapCount);
 			grown.name = src.name + "+necro";
 			grown.wrapMode = src.wrapMode;
 			grown.filterMode = src.filterMode;
 			grown.anisoLevel = src.anisoLevel;
 			// GPU-side copy: the game's arrays are non-readable, so nothing can be pulled back
 			// to the CPU. CopyTexture moves whole slices with their mip chains.
 			for (int i = 0; i < slice; i++) Graphics.CopyTexture(src, i, grown, i);
 			Graphics.CopyTexture(ours, 0, grown, slice);
 			target = grown;
 			Debug.Log("[NecromancerTome] CustomBlockPaint: " + label + " grown from " + slice +
 				" to " + (slice + 1) + " slices");
 			return slice;
 		}
 		static void Describe(string label, Texture2D tex)
 		{
 			Debug.Log("[NecromancerTome] CustomBlockPaint: " + label + " " +
 				tex.width + "x" + tex.height + " format=" + tex.format +
 				" graphicsFormat=" + tex.graphicsFormat + " mips=" + tex.mipmapCount);
 		}
 	}
 }
@@ -10,8 +10,14 @@ namespace NecromancerTome
 	/// </summary>
 	public class ModEntry : IModApi
 	{
 		/// <summary>The mod's own folder, kept from InitMod so patches can find files we ship
 		/// (currently Resources/necroatlas for the custom block paint). Nothing else knows where
 		/// the mod lives - the game hands it over exactly once, right here.</summary>
 		public static Mod Instance;
 		public void InitMod(Mod _modInstance)
 		{
 			Instance = _modInstance;
 			var harmony = new Harmony("necromancertome.harmony");
 			harmony.PatchAll(Assembly.GetExecutingAssembly());
 			PetFollowPatch.Init();
@@ -44,6 +44,13 @@
      <HintPath>..\..\..\7DaysToDie_Data\Managed\UnityEngine.AnimationModule.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <!-- AssetBundle.LoadFromFile for CustomBlockPaintPatch.cs (2026-09-10) - the mod ships its
         own block paint textures in Resources/necroatlas, and Unity keeps bundle loading in its
         own module rather than CoreModule. -->
    <Reference Include="UnityEngine.AssetBundleModule">
      <HintPath>..\..\..\7DaysToDie_Data\Managed\UnityEngine.AssetBundleModule.dll</HintPath>
      <Private>false</Private>
    </Reference>
    <!-- PlayerActionsLocal.Secondary (PlayerAction) for PortalStonePatch.cs's power-attack
         channel-cancel (2026-08-29) - the game's own input layer, not something this mod
         previously needed to touch directly. -->
@@ -4,6 +4,6 @@
 	<DisplayName value="Necromancer's Tome" />
 	<Description value="A dark necromancy progression for 7 Days to Die 3.2: a kill-count-driven skill tree with cursed weapons, charm/deviation magic, summonable undead pets, base-defence wards, and a story-ending Black Portal ritual. Fully localized into 13 languages. Single-player; requires EAC off." />
 	<Author value="Alex Cube" />
-	<Version value="1.0.0" />
+	<Version value="2.0.0" />
 	<Website value="https://www.alexcube.ru/7-days-to-die-moi-mody/kniga-nekromanta-necromancer-s-tome/" />
 </xml>