Skip to content

About

纯 Python + NumPy 光线投射赛博朋克 FPS:WASD 移动 / 鼠标转向 / Shift 冲刺 / 8 波生存。无引擎、无外部资源。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

NEON PROTOCOL

霓虹协议 · 数据要塞入侵

纯 Python + NumPy 手写的赛博朋克光线投射 FPS —— 无游戏引擎、无贴图文件、无音频文件,所有画面与声音运行时程序化生成。

Stars Release License


你是一个被上传进敌方内网的黑客进程(代号 GHOST)。要塞里部署了四类 ICE 防御程序,它们会沿掩体追猎你。在 8 波不断增强的攻势中存活下来,并用途中拾取的 「协议补丁」强化自己。

快速开始

# 要求:Python 3.8+
git clone https://github.com/WsNodeX/neon-protocol.git
cd neon-protocol

python -m venv venv
venv\Scripts\activate          # Windows;Linux/macOS 用 source venv/bin/activate
pip install pygame numpy

python -m neon_protocol.main

实机画面

gameplay

上面这段不是录屏,是 --headless 模式逐帧渲染出来的:python -m neon_protocol.main --headless --shots out/ --shot-frames 60,72,84,...,再由 scripts/make_game_gif.py 合成。

截图

战斗 敌潮
combat combat-2
协议补丁(局内成长) 全网拓扑(Tab 全屏地图)
upgrade fullmap

操作

按键 动作
W A S D 移动(相对视角方向,带惯性)
鼠标 转向瞄准
左键 开火
Shift 冲刺(短暂无敌帧,唯一的主动防御手段)
1 / 2 / 3 切换武器
Tab 全屏网络拓扑图
ESC 暂停

特性

  • 自研光线投射引擎 —— 墙体 / 地板 / 精灵 / 粒子全部用 NumPy 向量化计算, 60 FPS,零贴图依赖;霓虹纹理程序化生成。
  • 流场寻路(Flow Field) —— 敌人沿 BFS 距离场绕墙推进,不顶墙、不抖动; 失去视线自动绕路。
  • 有限状态机 AI —— idle → alert → chase → attack → dead,感知系统含视线 + 距离 + 视野锥 + 听觉。
  • 实时合成音频 —— 音效全部由 NumPy 波形合成运行时生成,仓库里一个 .wav 都没有。
  • 固定步长物理(1/120s) —— 低帧率机器上移动手感与 AI 反应完全一致。
  • 波次 + 局内 build —— 每波清空抽 3 张协议补丁(穿透、暴击、汲取…),组合出流派。
  • CRT 后处理 —— 扫描线、暗角、画面撕裂,阴极射线管质感。

无头 / 调试

python -m neon_protocol.main --headless --frames 3000   # 机器人自动跑图,输出性能报告
python -m neon_protocol.main --bench                    # 渲染分层基准测试
python -m neon_protocol.main --res 640x400 --scale 2    # 调分辨率 / 整数放大

渲染管线

graph LR
  L[关卡生成<br/>房间+走廊] --> R[光线投射<br/>逐列 DDA]
  R --> S[精灵排序<br/>深度遮挡]
  S --> P[粒子]
  P --> C[CRT 后处理<br/>扫描线/暗角/撕裂]
  C --> F[60 FPS 画面]
Loading

项目结构

文件 职责
main.py 启动入口、参数解析、无头压测 / 截图 / 基准
game.py 主循环、状态机、输入、固定步长物理、渲染编排
entities.py 玩家 / 敌人 / 子弹 / 掉落物 / 粒子
level.py 随机要塞生成(房间 + 走廊)
renderer.py 光线投射渲染与 CRT 后处理
hud.py 界面叠层(武器 / 血量 / 小地图 / 升级卡)
textures.py 程序化纹理与武器精灵
audio.py 实时波形合成音效

技术要点

模块 实现
渲染 逐列 DDA 光线投射,墙体 / 地板 / 天空 NumPy 向量化,精灵深度排序 + 遮挡裁剪
寻路 BFS 距离场 → 流场方向图,全图敌人共享一张场,O(1) 查询移动方向
AI 有限状态机 + 感知(视线射线 / 视野锥 / 听觉半径),冲突避免分离力
物理 固定 1/120s 步长 + 渲染插值,贴墙滑动(轴分离碰撞)
音频 NumPy 合成(方波 / 噪声 / 包络),mixer.Sound(array) 直接播放

已知限制

  • 需要 pygame 和 numpy。 这是仓库里唯一的两个外部依赖——"零资源文件"指的是 贴图和音频,不是零依赖。
  • 纯 CPU 渲染。 没有 GPU 加速,分辨率越高帧率越低;--scale 整数放大是为了在 低分下保帧率。
  • 单人 8 波内容。 通关即结束,没有无尽模式或联机。

许可

MIT —— 自由使用、修改、再分发。

About

纯 Python + NumPy 光线投射赛博朋克 FPS:WASD 移动 / 鼠标转向 / Shift 冲刺 / 8 波生存。无引擎、无外部资源。

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages