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