死亡笔记

死亡笔记

一个客户端NeoForge模组,可在死亡时自动保存物品栏快照,并允许你稍后浏览这些快照。

游戏机制

EN


Death Memo

一个客户端 NeoForge 模组,在你的角色死亡时自动保存物品栏快照,并允许你之后浏览这些快照。 对于服务器管理员或启用了作弊的单一世界,它还提供一键物品恢复、传送到死亡地点以及经验恢复功能。

功能

  • 自动死亡快照 – 当你死亡时,你的盔甲、副手、物品栏、经验、坐标和维度会立即被保存。
  • 本地存储 – 快照保存在 Minecraft 游戏目录内的 deathmemo/ 文件夹中,按每个世界/服务器分开存储。
  • 游戏内历史浏览器 – 可从暂停菜单(“统计信息”按钮旁边)访问的特殊界面,显示你所有的死亡记录。
Pause Menu History screen
  • 详细视图 – 点击日期和时间条目即可查看:
    • 已装备的盔甲、副手物品以及全部 36 个物品栏槽位
    • 坐标(X、Y、Z)和维度
    • 死亡时刻的经验值
Opened Snapshot
  • 管理员恢复工具(需要权限等级 2 或在单一世界中启用作弊):

    • 恢复 – 请求所选快照中的所有物品。

      recovery
    • 传送 – 立即传送到死亡地点。

      pos
    • 经验恢复 – 恢复丢失的经验值。

      xp
    • 请求特定物品 – 点击历史记录中的任意槽位,请求服务器给予你该物品(若有权限)。

      itemissue
    • 视觉反馈 – 自定义彩色提示通知会确认你的恢复请求是被批准还是被拒绝。

      notification
  • 灵活的界面 – 快照可安全地逐个删除。

  • 客户端-服务器交互 – 使用自定义数据包实现安全的命令执行和物品恢复。

需求

  • Minecraft 1.21 或更新版本(NeoForge)
  • NeoForge(建议使用最新版本)
  • owo-lib(UI 框架所需)– Modrinth / CurseForge

安装

  1. 为你的 Minecraft 版本安装 NeoForge。
  2. 从 GitHub 上的 版本 或 发布 部分下载最新的 deathmemo-*.jar,或从源代码构建。
  3. 将模组放入你的 mods/ 文件夹。
  4. 确保你也安装了 owo-lib。
  5. (可选)将同一模组安装到专用服务器上,以便恢复功能在多人游戏中可用。

工作原理

  • 物品栏快照 使用 Minecraft 内置的 ItemStack.CODEC 序列化为 JSON,并保存在 deathmemo/<place>/ 下。
  • “place” 标识符来自服务器 IP(多人游戏)或世界存档名称(单一世界),以确保正确分离。
  • UI 使用 owo-lib 构建,利用 XML 模型(snapshots_screen.xml)和自定义组件(HoverAwareFlowLayout、OneLineLabel)。
  • 网络通信使用三个自定义载荷:
    • RequestItemPayload – 客户端请求物品。
    • CommandRequestPayload – 客户端请求命令(传送/经验)。
    • RequestResponsePayload – 服务器回复成功/失败以及一条在提示中显示的消息。
  • 该模组主要面向客户端,但注册了服务器端处理器,以便恢复功能在多人游戏中可用。

致谢

  • 由独立团队 AronHuisIn 开发,开发者 VPKesha(GitHub:MrDemogg)。
  • 使用 owo-lib 库作为 UI 框架。

许可证

本项目依据 CC BY-NC 4.0 许可证分发。 你可以按照许可证文件自由使用、修改和分发。 但是,在分发本项目或其衍生作品时,必须适当注明原作者(VPKesha,即 MrDemogg)。 未经作者许可,禁止将本项目代码用于商业用途。 了解更多


发现错误或有建议?欢迎在 GitHub 仓库中提交 issue。


RU


Death Memo

Клиентский мод для NeoForge, который автоматически сохраняет снимки вашего инвентаря при смерти и позволяет просматривать их позже.
Для операторов серверов или одиночной игры с включёнными читами также доступно восстановление предметов, телепортация на место гибели и возврат опыта в один клик.

Возможности

  • Автоматические снимки при смерти – Когда вы умираете, ваша броня, вторая рука, инвентарь, опыт, координаты и измерение сразу сохраняются.
  • Локальное хранение – Снимки хранятся в папке deathmemo/ внутри игровой директории Minecraft отдельно для каждого мира/сервера.
  • Внутриигровой просмотр истории – Специальный экран, доступный из меню паузы (рядом с кнопкой «Статистика»), показывает все ваши записи о смертях.
Pause Menu History screen
  • Детальный просмотр – Нажмите на запись с датой и временем, чтобы увидеть:
    • Надетую броню, предмет во второй руке и все 36 ячеек инвентаря
    • Координаты (X, Y, Z) и измерение
    • Количество опыта на момент смерти
Opened Snapshot
  • Инструменты восстановления для операторов (требуется уровень прав 2 или включённые читы):

    • Восстановление – запрос всех предметов из выбранного снимка обратно.

      recovery
    • Телепортация – мгновенное перемещение на место смерти.

      pos
    • Восстановление опыта – выдача потерянных очков опыта.

      xp
    • Запрос отдельного предмета – клик по любому слоту в истории отправляет запрос серверу на выдачу конкретного предмета (при наличии прав).

      itemissue
    • Визуальная обратная связь – кастомные цветные уведомления-тосты подтверждают, одобрен ли ваш запрос на восстановление, или отклонён.

      notification
  • Гибкий интерфейс – снимки можно безопасно удалять по одному.

  • Клиент-серверное взаимодействие – используются собственные пакеты для безопасного выполнения команд и восстановления предметов.

Требования

  • Minecraft 1.21 или новее (NeoForge)
  • NeoForge (последняя рекомендованная версия)
  • owo-lib (необходима для UI-фреймворка) – Modrinth / CurseForge

Установка

  1. Установите NeoForge для вашей версии Minecraft.
  2. Скачайте последний файл deathmemo-*.jar из раздела Версии или Релизы на гитхабе или соберите из исходников.
  3. Поместите мод в папку mods/.
  4. Убедитесь, что у вас также установлена библиотека owo-lib.
  5. (Опционально) Установите этот же мод на выделенный сервер, чтобы функции восстановления работали в многопользовательской игре.

Как это работает

  • Снимки инвентаря сериализуются в JSON с использованием встроенного в Minecraft кодека ItemStack.CODEC и сохраняются в deathmemo/<место>/.
  • Идентификатор «места» получается из IP сервера (для мультиплеера) или имени сохранения мира (для одиночной игры), обеспечивая разделение.
  • Интерфейс построен на owo-lib, используя XML-модель (snapshots_screen.xml) и собственные компоненты (HoverAwareFlowLayout, OneLineLabel).
  • Сетевое взаимодействие используют три кастомных пакета:
    • RequestItemPayload – клиент запрашивает предмет.
    • CommandRequestPayload – клиент запрашивает выполнение команды (телепортация/опыт).
    • RequestResponsePayload – сервер отвечает успехом/неудачей и сообщением, которое показывается в тосте.
  • Мод в первую очередь клиентский, но регистрация серверных обработчиков позволяет функциям восстановления работать в мультиплеере.

Авторство

  • Разработано инди-командой AronHuisIn, разработчик VPKesha (Github: MrDemogg).
  • Использует библиотеку owo-lib для UI-фреймворка.

Лицензия

Проект распространяется под лицензией CC BY-NC 4.0
Вы можете свободно использовать, менять и распространять его в соответствии с файлом лицензии.
Однако при распространении этого проекта или его производных требуется указание оригинального автора (VPKesha ака MrDemogg)
Коммерческая деятельность с использованием кода из данного проекта запрещена без разрешения автора
Подробнее


Нашли ошибку или есть предложение? Создайте issue в репозитории на GitHub.