Версия 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

Config/Localization.csv

@@ -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,,,,,Некротический прах,,,

Config/blocks.xml

@@ -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="TintColor" value="8A4142" />
+			<!-- <property name="Model" value="#@modfolder(NecromancerTome):Resources/necropyramid?necroPyramidPrefab.prefab" /> -->
+			<!-- 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,

Config/items.xml

@@ -900,29 +900,54 @@
 			     boneShivPrefab, то есть слот тинта у этого меша рабочий и на оружии с
 			     ShowQuality тоже применяется. Копать тут больше нечего; осталось только
 			     посмотреть глазами, достаточно ли чёрный получается клинок. -->
-			<property name="TintColor" value="0, 0, 0"/>
-
-			<!-- СВОЯ МОДЕЛЬ, ЗАГОТОВКА 2026-09-10 - ВКЛЮЧАТЬ ТОЛЬКО ВМЕСТЕ С БАНДЛОМ.
-			     Строка ниже намеренно закомментирована: файла Resources/necroknife в моде ещё
-			     нет, а Meshfile, указывающий в никуда, сломает нож прямо в живой папке мода -
-			     игра читает именно её, и вечерний тест v1.0 идёт с этих же файлов.
-			     Раскомментировать в тот момент, когда бандл лёг в Resources/, и не раньше.
+			<!-- TintColor ОТКЛЮЧЁН 2026-09-10 вместе с переходом на свою текстуру.
+			
+			     TintColor - это МНОЖИТЕЛЬ цвета меша, а 0,0,0 множит в чистый чёрный. Он был нужен,
+			     пока нож носил ванильную бежевую кость: другого способа затемнить клинок не было.
+			     Теперь цвет несёт своя текстура necroKnife_d.png, и тот же множитель погасил бы
+			     всё нарисованное в ноль - вместе с пурпурным свечением в альбедо.
+			
+			     Иконка от этого не зависит: она отдельный арт (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.
-			     Живым примером форма не проверена - первый тестовый бандл с кубом её подтвердит
-			     или опровергнет, до того как рисовать текстуру.
-
-			     necroknife - имя AssetBundle, заданное префабу в Unity (инспектор, нижняя строка
-			     AssetBundle); necroKnifePrefab.prefab - имя префаба ВНУТРИ бандла. Оба должны
-			     совпасть с тем, что реально собралось, иначе предмет останется без модели молча.
-			     Сборка - Mods/_NecromancerTome_private/tools/UnityEditorScripts/BuildNecroBundles.cs.
-
+			     ФОРМА ПОДТВЕРЖДЕНА ЖИВЫМ ПРИМЕРОМ 2026-09-10: с этой строкой тестовый красный
+			     нож появился в руке. Значит и запись работает, и бандл из папки мода читается,
+			     и Standard-шейдер из Unity 2022.3.62f2 игра отрисовывает. Больше не гипотеза -
+			     этой же формой можно подключать любые следующие свои модели.
+			
+			     necroknife - имя AssetBundle, заданное префабу в Unity; necroKnifePrefab.prefab -
+			     имя префаба ВНУТРИ бандла. Оба должны совпасть с тем, что реально собралось, иначе
+			     предмет останется без модели молча. Пересборка - меню 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>