模组移除保护

模组移除保护

保护你的游戏世界免受损坏的模组和游戏更新的影响!

[center][size=3][i][color=#A1A1AA]如果 Mod Removal Guard 拯救了你的某个世界,我很想听听——欢迎留言、点赞或截图。
Если Mod Removal Guard спас ваш мир — буду рад паре слов в комментариях, лайку или скриншоту.[/color][/i][/size][/center]

[line]

[center][size=6][b][color=#4EA1FF]Mod Removal Guard — 移除模组而不破坏你的世界(7 Days to Die 3.3)[/color][/b][/size][/center]

模组被弃坑、在游戏更新后损坏,或者你只是不再需要它——你把它移除了,而世界再也回不到从前。被移除模组的方块变成随机的其他方块,储物箱变成汽车,区块停止加载,有时整个存档被重置。[b][color=#F4F4F5]Mod Removal Guard[/color][/b] 阻止这一切发生。

[b][color=#F4F4F5]在移除任何模组之前先安装它。[/color][/b] 只要在没有保护的情况下启动一次,游戏就会把被移除模组的 ID 分配给其他方块——这种损坏无法撤销。

[line]

[size=5][b][color=#4EA1FF]世界为什么会损坏[/color][/b][/size]
存档把每个方块和物品都存为一个编号。游戏在存档旁边维护一份“名称 → 编号”的列表,并在每次启动时把每个已定义的方块恢复为它原来的编号。当模组被移除时,它的名称消失了——它们的编号就被分配给游戏接下来分配编号的方块。世界里原本属于被移除模组的方块,现在都被读成别人的方块;如果那个方块内部有储物或机器,区块可能会永久损坏。

[size=5][b][color=#4EA1FF]保护器做什么[/color][/b][/size]
[list]
[][b][color=#F4F4F5]记住[/color][/b]你的世界使用的每个方块和物品,以及是哪个模组添加的——存档文件夹中的一份目录
[
][b][color=#F4F4F5]保留编号[/color][/b]:当模组消失时,它的方块和物品会以完全相同的编号获得占位符,因此世界里的其他东西都不会改变
[][b][color=#F4F4F5]功能性方块[/color][/b]——储物、工作台、机器、灯、门,任何内部有数据的方块——变成带标记的木质占位符,保留所有这些数据。[b][color=#F4F4F5]重新安装模组后,它们会带着内容物恢复工作[/color][/b]
[
][b][color=#F4F4F5]被动方块[/color][/b]——装饰、雕像、陷阱——在区块加载时被改写为涂成粉色的普通原版木头方块。它们不再依赖任何模组,可以直接敲掉
[][b][color=#F4F4F5]物品和武器/工具模组[/color][/b]变成带清晰描述的粉色小石子;已安装的模组保持原位,工具继续工作。重新安装模组——它们会变回原样
[
]每个占位符都会说明它原本是什么:[i]"Lost block: Autominer (Alter_Autominers) — can be restored"[/i]。文本有英文和俄文(其他语言显示英文)
[][b][color=#F4F4F5]阻止损坏的 tile entity 破坏区块[/color][/b]——移除模组后经典的“卡在等待区块”问题
[
][b][color=#F4F4F5]列出丢失了什么[/color][/b]、来自哪个模组、从何时起:存档文件夹中的 [i]ModRemovalGuard\lost_blocks.json[/i] 和 [i]lost_items.json[/i]
[]也覆盖游戏本身:如果更新移除了你世界中存在的原版方块,它也会获得占位符
[/list]
[size=5][b][color=#4EA1FF]仅需服务器或主机——客户端不需要[/color][/b][/size]
占位符会在服务器发送方块和物品列表给玩家之前被添加进去,因此没有安装该模组的玩家看到的占位符和名称完全相同。同时自己托管单人世界的玩家应为那些世界安装它。

[line]

[size=5][b][color=#4EA1FF]控制台命令[/color][/b][/size]
[code]
mrg status 此世界的保护状态
mrg list blocks|items [lost|catalog] [text] 丢失的方块/物品(默认)或整个目录,按名称或模组筛选
mrg list conflicts 在安装保护器之前就已损坏的编号
mrg report 按模组汇总到 ModRemovalGuard\report.json
mrg catalog 立即更新并保存目录
mrg materialize [dry] 立即改写已加载区块中的被动占位符
[/code]
[size=5][b][color=#4EA1FF]设置 — config.json[/color][/b][/size]
[code]
Enabled true 保护开启/关闭
ProtectBlocks true 方块的占位符
ProtectItems true 物品和物品模组的占位符
PlaceholderTexture 407 木质占位符的纹理(painting.xml 的 TextureId)
MaxPlaceholders 50000 如果缺失的方块/物品类型多于此值则警告(仍会创建占位符)
ProtectTileEntities true 丢弃无法读取的 tile entity 而不是破坏区块
QuietLogs true 用一行摘要代替数千条原版警告
AutoMaterialize true 区块加载时将被动占位符改写为原版方块
MaterializeTo woodShapes:cube 被动占位符变成什么
MaterializePaint 158 该方块的涂装(painting.xml id,0 = 无;158 = 粉色混凝土)
DebugLog false 用于排查问题的详细日志
[/code]
[size=5][b][color=#4EA1FF]游戏更新[/color][/b][/size]
启动时保护器会检查游戏是否仍以它依赖的方式工作。如果更新改变了重要内容,保护器不会半途运行:它会移除所有钩子,在主菜单显示消息并以玩家语言在控制台显示红色错误,并在[b][color=#F4F4F5]启动世界时关闭游戏(或停止服务器)[/color][/b]——因此世界永远不会在无保护状态下加载。加入其他服务器不受影响。在这种情况下,请更新保护器,或者如果你接受风险就移除它。

[size=5][b][color=#4EA1FF]它不做什么[/color][/b][/size]
[list]
[
][b][color=#F4F4F5]它无法撤销安装之前造成的损坏。[/color][/b]游戏已经分配给其他方块的编号保持原样;[i]mrg list conflicts[/i] 会显示它们
[][b][color=#F4F4F5]载具、无人机、动物和 NPC[/color][/b] 来自被移除模组的会直接消失——它们不会破坏世界。它们内部的物品受到保护
[
][b][color=#F4F4F5]通过 dll 添加自身 tile entity 类型[/color][/b]的模组(不是原版工作台、储物或复合方块,而是新类型)无法被拯救:游戏没有办法在区块中跳过它们的数据。这很少见——我们服务器上约 60 个模组中没有一个这样做
[]被改写为粉色木头的被动方块即使模组回来也仍是木头——直接敲掉并放置新的即可
[/list]
[line]

[size=5][b][color=#4EA1FF]安装[/color][/b][/size]
[list=1]
[
]将 [i]ModRemovalGuard[/i] 文件夹复制到 [i]<游戏文件夹>\Mods\[/i]——在专用服务器上,或在单人/合作游戏的主机上
[]在关闭 EAC 的情况下启动游戏(该模组包含 dll)
[
]带着当前所有模组启动你的世界一次——目录会被填充。从现在起你就可以移除模组了
[/list]
[size=5][b][color=#4EA1FF]游戏版本[/color][/b][/size]
在 [b][color=#F4F4F5]7 Days to Die 3.3.0 (b18)[/color][/b] 上构建并测试——包括单人和装有 60 个模组的专用服务器。更早的 3.x 版本未测试;2.x 及更旧版本[b][color=#F4F4F5]不受支持[/color][/b]。在其他版本上,保护器会在启动时自检,如果不匹配则阻止世界加载。

[size=5][b][color=#4EA1FF]移除保护器本身[/color][/b][/size]
功能性方块的占位符仅在保护器安装时存在。只有当 [i]mrg list blocks[/i] 没有显示你仍在意的内容时才移除它——否则那些方块会像移除任何其他模组时一样损坏。如果不确定,就保留它:在没有东西缺失时它不产生任何代价。

[line]

[size=5][b][color=#4EA1FF]免责声明[/color][/b][/size]
模组是不稳定的东西:游戏更新、其他模组或不走运的组合总是可能破坏一些东西。使用风险自负,并保留存档备份。如果你担心——关闭游戏自动更新:在模组构建并发布的游戏版本上,问题很少见。

[size=5][b][color=#4EA1FF]反馈[/color][/b][/size]
如果你喜欢这个模组——点个赞并留下评论,这真的很有帮助,也让我继续创造新东西。附带日志(以及存档 ModRemovalGuard 文件夹中的文件)的错误报告永远欢迎。

[size=5][b][color=#4EA1FF]链接[/color][/b][/size]
[list]
[][url=https://7daystodiemods.com/profiles/skylett]7daystodiemods.com[/url] — 我在本站的模组
[
][url=https://www.nexusmods.com/7daystodie/users/19805394]Nexus Mods[/url] — Nexus 上的相同模组
[][url=https://bar7dtd.ru/]bar7dtd.ru[/url] — 我们的游戏服务器,也是下载我模组的另一个地方
[
][url=https://www.twitch.tv/sky_lett]Twitch[/url] — 来看看吧,有时我还会玩
[][url=https://www.donationalerts.com/r/sky_lett]DonationAlerts[/url] — 支持这项工作或只是说声谢谢
[/list]
[size=5][b][color=#4EA1FF]致玩家和作者[/color][/b][/size]
玩得开心,无惧尝试新模组,让你的世界保持活力。作者们——欢迎联系我:我对合作、兼容性补丁和联合项目持开放态度。我可以在能力范围内根据你的描述制作一个模组——带着你的想法来吧。

[line]

[center][size=6][b][color=#4EA1FF]Mod Removal Guard — удаляйте моды, не ломая мир (7 Days to Die 3.3)[/color][/b][/size][/center]

Мод забросили, он сломался после обновления игры или просто надоел — вы его удаляете, и мир уже не тот. Блоки удалённого мода превращаются в случайные чужие блоки, ящики — в машины, чанки перестают грузиться, иногда сохранение сбрасывается целиком. [b][color=#F4F4F5]Mod Removal Guard[/color][/b] этого не допускает.

[b][color=#F4F4F5]Ставьте его ДО удаления модов.[/color][/b] Одного запуска без защитника достаточно, чтобы игра раздала номера удалённого мода другим блокам, — это уже не исправить.

[line]

[size=5][b][color=#4EA1FF]Почему ломаются миры[/color][/b][/size]
Сохранение хранит каждый блок и предмет как номер. Рядом с сохранением игра держит список «имя → номер» и при каждом запуске возвращает каждому определённому блоку его старый номер. Когда мод удалён, его имён больше нет — и их номера достаются тем блокам, которым игра раздаёт номера следом. Всё, что в мире было блоком удалённого мода, теперь читается как чужой блок; если внутри было хранилище или машина, чанк может испортиться навсегда.

[size=5][b][color=#4EA1FF]Что делает защитник[/color][/b][/size]
[list]
[
][b][color=#F4F4F5]Запоминает[/color][/b] все блоки и предметы, которые использует ваш мир, и какой мод их добавил — каталог в папке сохранения
[][b][color=#F4F4F5]Сохраняет номера[/color][/b]: когда мода нет, его блоки и предметы получают заглушки ровно под теми же номерами, и больше ничего в мире не меняется
[
][b][color=#F4F4F5]Функциональные блоки[/color][/b] — ящики, верстаки, машины, свет, двери, всё, у чего есть данные внутри, — становятся помеченными деревянными заглушками, которые хранят эти данные. [b][color=#F4F4F5]Верните мод — они встанут рабочими, со всем содержимым[/color][/b]
[][b][color=#F4F4F5]Бесфункциональные блоки[/color][/b] — декор, статуи, ловушки — при загрузке чанка переписываются в обычный ванильный деревянный блок, окрашенный в розовый. Он больше ни от какого мода не зависит, его можно просто сломать
[
][b][color=#F4F4F5]Предметы и модификации оружия/инструментов[/color][/b] становятся розовыми камешками с понятным описанием; установленные модификации остаются на месте, инструмент продолжает работать. Верните мод — они снова станут прежними
[]Каждая заглушка подписана: [i]«Утерянный блок: Автомайнер (Alter_Autominers) — может быть восстановлен»[/i]. Тексты — на английском и русском (на других языках игры — английский)
[
][b][color=#F4F4F5]Битые tile entity больше не портят чанки[/color][/b] — то самое вечное «stuck waiting for chunks» после удаления мода
[][b][color=#F4F4F5]Ведёт журнал утерянного[/color][/b]: что, из какого мода и с какого времени — [i]ModRemovalGuard\lost_blocks.json[/i] и [i]lost_items.json[/i] в папке сохранения
[
]Защищает и от самой игры: если обновление удалит ванильный блок, который стоит в вашем мире, он тоже получит заглушку
[/list]
[size=5][b][color=#4EA1FF]Только на сервер или у хоста — клиентам не нужен[/color][/b][/size]
Заглушки добавляются в списки блоков и предметов сервера до того, как сервер отправит их игрокам, поэтому игрок без мода видит те же заглушки и подписи. Игрокам, которые сами хостят одиночные миры, мод нужен для этих миров.

[line]

[size=5][b][color=#4EA1FF]Консольные команды[/color][/b][/size]
[code]
mrg status состояние защиты в этом мире
mrg list blocks|items [lost|catalog] [текст] утерянные блоки/предметы (по умолчанию) или весь каталог, с фильтром по имени или моду
mrg list conflicts номера, испорченные ещё до установки защитника
mrg report сводка по модам в ModRemovalGuard\report.json
mrg catalog обновить и сохранить каталог прямо сейчас
mrg materialize [dry] переписать бесфункциональные заглушки в загруженных чанках сейчас
[/code]
[size=5][b][color=#4EA1FF]Настройки — config.json[/color][/b][/size]
[code]
Enabled true защита вкл/выкл
ProtectBlocks true заглушки для блоков
ProtectItems true заглушки для предметов и модификаций
PlaceholderTexture 407 текстура деревянной заглушки (TextureId из painting.xml)
MaxPlaceholders 50000 предупредить, если пропавших ТИПОВ больше (заглушки всё равно создаются)
ProtectTileEntities true выбрасывать нечитаемые tile entity вместо порчи чанка
QuietLogs true одна строка-сводка вместо тысяч ванильных предупреждений
AutoMaterialize true переписывать бесфункциональные заглушки в ванильные блоки при загрузке чанка
MaterializeTo woodShapes:cube во что они превращаются
MaterializePaint 158 окраска этого блока (id из painting.xml, 0 — без окраски; 158 — розовый бетон)
DebugLog false подробный лог для поиска проблем
[/code]
[size=5][b][color=#4EA1FF]Обновления игры[/color][/b][/size]
При запуске защитник проверяет, что игра работает так, как он рассчитывает. Если обновление изменило что-то важное, защитник не работает наполовину: снимает все свои перехваты, показывает окно в главном меню и красную ошибку в консоли на языке игрока и [b][color=#F4F4F5]закрывает игру (или останавливает сервер) при запуске мира[/color][/b] — мир никогда не загрузится без защиты. Подключение к чужим серверам не затрагивается. В этом случае обновите защитник или удалите его, если готовы рискнуть.

[size=5][b][color=#4EA1FF]Чего защитник не делает[/color][/b][/size]
[list]
[][b][color=#F4F4F5]Не исправляет то, что сломалось до его установки.[/color][/b] Номера, которые игра уже отдала другим блокам, остаются как есть; их показывает [i]mrg list conflicts[/i]
[
][b][color=#F4F4F5]Транспорт, дроны, животные и NPC[/color][/b] удалённых модов просто пропадают — мир от этого не ломается. Предметы, лежавшие в них, защищены
[]Моды, которые через dll добавляют [b][color=#F4F4F5]собственный тип tile entity[/color][/b] (не ванильный верстак, хранилище или composite-блок, а новый вид), спасти нельзя: игра не умеет пропустить их данные в чанке. Это редкость — среди ~60 модов на нашем сервере таких нет
[
]Бесфункциональные блоки, переписанные в розовое дерево, остаются деревом, даже если мод вернуть, — просто сломайте и поставьте новые
[/list]
[line]

[size=5][b][color=#4EA1FF]Установка[/color][/b][/size]
[list=1]
[]Скопируйте папку [i]ModRemovalGuard[/i] в [i]<папка игры>\Mods\[/i] — на выделенный сервер или у хоста одиночной игры / кооператива
[
]Запускайте игру с выключенным EAC (в моде есть dll)
[]Один раз зайдите в мир со всеми текущими модами — заполнится каталог. Дальше моды можно удалять
[/list]
[size=5][b][color=#4EA1FF]Версия игры[/color][/b][/size]
Собран и проверен на [b][color=#F4F4F5]7 Days to Die 3.3.0 (b18)[/color][/b] — в одиночной игре и на выделенном сервере с 60 модами. Более ранние сборки 3.x не проверялись; 2.x и старше [b][color=#F4F4F5]не поддерживаются[/color][/b]. На других версиях защитник проверяет себя при запуске и не даёт загрузить мир, если что-то не совпало.

[size=5][b][color=#4EA1FF]Удаление самого защитника[/color][/b][/size]
Заглушки функциональных блоков существуют, только пока защитник установлен. Удаляйте его, лишь когда [i]mrg list blocks[/i] не показывает ничего нужного, — иначе эти блоки сломаются так же, как при удалении любого другого мода. Если сомневаетесь — оставьте: пока ничего не пропало, он ничего не стоит.

[line]

[size=5][b][color=#4EA1FF]Дисклеймер[/color][/b][/size]
Моды — нестабильная штука: обновления игры, другие моды или неудачное сочетание всегда могут что-то сломать. Используйте на свой страх и риск и делайте резервные копии сохранений. Если волнуетесь — отключите автообновление игры: на версии, для которой мод собран и опубликован, проблем, как правило, нет.

[size=5][b][color=#4EA1FF]Обратная связь[/color][/b][/size]
Если мод понравился — поставьте лайк и оставьте комментарий, это правда помогает и мотивирует делать новое. Сообщения об ошибках с логом (и файлами из папки ModRemovalGuard сохранения) всегда кстати.

[size=5][b][color=#4EA1FF]Ссылки[/color][/b][/size]
[list]
[
][url=https://7daystodiemods.com/profiles/skylett]7daystodiemods.com[/url] — мои моды на этом сайте
[][url=https://www.nexusmods.com/7daystodie/users/19805394]Nexus Mods[/url] — те же моды на Nexus
[
][url=https://bar7dtd.ru/]bar7dtd.ru[/url] — наш игровой сервер и ещё одно место, где можно скачать мои моды
[][url=https://www.twitch.tv/sky_lett]Twitch[/url] — заходите посмотреть, иногда я даже играю
[
][url=https://www.donationalerts.com/r/sky_lett]DonationAlerts[/url] — поддержать работу или просто сказать спасибо
[/list]
[size=5][b][color=#4EA1FF]Игрокам и авторам[/color][/b][/size]
Играйте с удовольствием, пробуйте новые моды без страха и берегите свои миры. Авторов модов приглашаю к сотрудничеству: патчи совместимости, совместные проекты — пишите. Могу собрать мод по вашему описанию и моим возможностям — приходите со своей идеей.