Minecraft Python 版

项目简介

Minecraft Python 版是一个用 Python + Pyglet 编写的极简 Minecraft 风格 3D 沙盒演示。它用很少的代码实现了一个可自由探索的方块世界：你可以走动、跳跃、切换飞行模式，并用鼠标放置或破坏方块。

项目的目标不只是「做一个游戏」，而是把它打造成 编程教育工具——孩子们喜欢 Minecraft，而 Python 又是极佳的第一门语言，两者结合能有效激发学习兴趣。

核心玩法

移动

• W / S：前进 / 后退
• A / D：左右平移
• 鼠标：转动视角
• 空格：跳跃
• Tab：切换飞行模式

建造

• 1：砖块
• 2：草方块
• 3：沙子
• 鼠标左键：删除方块
• 鼠标右键：放置方块

退出

• ESC：释放鼠标，然后关闭窗口

运行方式

项目依赖非常少，安装 Pyglet 后克隆仓库并运行主程序即可：

pip install pyglet
git clone https://github.com/fogleman/Minecraft.git
cd Minecraft
python main.py

在 macOS 上如果遇到 Pyglet 64 位模式问题，可以尝试以 32 位模式运行 Python，或改用支持 64 位的 Pyglet 版本。

设计愿景

作者希望项目未来能演进为一个可导入的 Python 库/API，让使用者通过配置来创建世界并运行，例如：

import mc

world = mc.World(...)
world.set_block(x, y, z, mc.DIRT)
mc.run(world)

理想中的 API 应支持重力、跳跃速度、行走速度等参数配置，并提供地形生成的扩展钩子。

适合谁

• 想了解 3D 游戏基本结构的 Python 初学者
• 需要课堂演示素材的编程老师
• 对体素世界、第一人称相机实现感兴趣的开发者

如果你需要性能更好、地形生成更完善且支持存档的版本，可以看看同作者用 C 和现代 OpenGL 编写的 Craft 项目。