返回资源列表

GitHub(作者 mottopanikeiku) · mottopanikeiku

doomformer:把整数神经网络编译成 DOOM 地图

doomformer:把整数神经网络编译成 DOOM 地图是GitHub(作者 mottopanikeiku)的免费开源项目(英文)。前置条件:需要基础 Python 使用能力,并了解神经网络前向计算(矩阵乘、ReLU)的基本概念;网页另提到模型在 strokes 上训练,未说明额外训练前提。

理解并复现一个把整数神经网络映射为 DOOM 地图机制(voodoo dolls、光照值、地板高度)的编译器,能在本地跑通安装、示例与校验流程,并了解其防自欺的检查设计。

打开官方课程
难度
见前置条件
类型
项目 · 开源项目
语言
英文
规模
3 个课节
内容费用
免费
动手
需要动手环境

使用限制

仓库与 Colab 笔记本可直接浏览;本地运行需自备 Python 3.11+ 与 C 工具链,游玩 WAD 需自备引擎和免费 IWAD。

补充内容
Colab 笔记本,可免本地安装运行示例

学完你能

  • 安装 doomformer 并用 hello 命令跑通一个小型 MLP,观察 DOOM 计算结果与 NumPy 整数参考逐值相等
  • 用 draw --digit 命令生成 MNIST 地图,理解海洋角色行走画数字、地图读取并识别数字的流程
  • 解释神经网络各要素到地图机制的映射:值→voodoo dolls 数量、权重→地板线、求和→光照或高度、ReLU→门梯
  • 运行 museum verify 演示,观察 MUTATE 改动一条连接后读数从 7 变为 1、RESTORE 后恢复
  • 了解仓库的校验方法:每次运行与 NumPy 对比、篡改权重线、2 万随机网络模糊测试等
  • 用 doomformer doctor 检查并搭建 ACC/ACS 编译器等依赖环境

适合你吗

适合

对神经网络原理、编译器与非常规计算感兴趣,希望动手跑通一个完整 AI 小项目的学习者。

暂不适合

想系统学习神经网络理论、训练方法或 DOOM 模组制作的人,本仓库重点在编译与逐值校验。

需要先会

需要基础 Python 使用能力,并了解神经网络前向计算(矩阵乘、ReLU)的基本概念;网页另提到模型在 strokes 上训练,未说明额外训练前提。

课程特点

内容侧重
侧重实践应用
练习与项目
按 README 运行 hello、draw --digit 7 与 museum verify 三项示例;如需脱离 Python 体验,可下载 museum.wad 与 Freedoom IWAD 后用 gzdoom -iwad freedoom2.wad -file museum.wad 打开。
学习时长
3 个课节原站未给出统一学习时长;实际用时取决于已有基础。
内容费用
免费仓库公开可读,README 节选直接给出安装命令、命令用法与原理说明,未见付费墙或登录拦截。

内容覆盖

  • Quick start:pip 安装、doomformer hello、draw --digit
  • Walk a digit:海洋角色行走画数字,DOOM 读取结果
  • The museum:floor pads、READ、MUTATE 与 RESTORE 演示
  • How it works:神经网络要素与 DOOM 地图机制的对应、引擎限制的规避
  • What is checked:与 NumPy 逐值对比、篡改与模糊测试等校验方法
  • doomformer facts:引擎事实检查
  • Quick start 中提到的 Colab 笔记本(节选未提供正文)

常见问题

免费吗?

免费:仓库公开可读,README 节选直接给出安装命令、命令用法与原理说明,未见付费墙或登录拦截。实践无额外费用:网页只提到用 pip 安装、本地运行和免费 Freedoom IWAD,未说明需要付费云服务或 API。

需要什么基础?

需要基础 Python 使用能力,并了解神经网络前向计算(矩阵乘、ReLU)的基本概念;网页另提到模型在 strokes 上训练,未说明额外训练前提。软件、账号与硬件:Python 3.11+,Linux 或 macOS;doctor 构建 ACC 编译器需要 git、cmake 与 C 编译器;可选用 Colab 免安装学习;游玩 museum.wad 需 GZDoom 等引擎与 Freedoom IWAD。

有中文吗?

本站记录的语言是英文;是否有中文字幕或译本本站未核实,请以原站为准。

怎么开始?

从原始资源入口开始:https://github.com/mottopanikeiku/doomformer。本页“学前准备”列出环境与工具,“学习指南”给出开课提示词,可以在自己的电脑上按步骤开始。开课提示词尚未完整验证。补充内容需要自备:Colab 笔记本,可免本地安装运行示例。

来源与使用须知

收录时间
本站首次收录 2026-11-01
指南参考

版权与转载

  • MIT:代码可自由使用和修改,需保留版权声明。原站说明
  • 本站只提供原始链接和学习指南,不转载、不镜像课程材料;引用时请注明原作者与出处。