pypvz/README.md
2022-04-06 20:22:51 +08:00

149 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

## Python版植物大战僵尸
植物大战僵尸游戏的Python实现基于[marblexu的项目进行创作](https://github.com/marblexu/PythonPlantsVsZombies)
`本项目为个人python语言学习所用的练习项目仅供个人学习和研究使用不得用于其他用途。如果这个游戏侵犯了版权请联系我删除`
* 已有的植物:向日葵,豌豆射手,坚果墙,寒冰射手,樱桃炸弹,三线射手,大嘴花,小喷菇,土豆雷,地刺,胆小菇,倭瓜,火爆辣椒,阳光菇,寒冰菇,魅惑菇
* 已有的僵尸:普通僵尸,旗帜僵尸,路障僵尸,铁桶僵尸,读报僵尸
* 使用 JSON 格式的文件存储进度数据 (例如僵尸出现的位置和时间,背景信息)
* 支持选择植物卡片
* 支持白昼模式,夜晚模式,传送带模式和坚果保龄球模式
* 支持背景音乐播放
* 支持全屏模式
*`F`键进入全屏模式,按`U`键恢复至窗口模式
* 支持用小铲子移除植物
## 环境要求
* `Python` >= 3.7
* `Python-Pygame` >= 1.9
## 开始游戏
### 使用仓库源代码
```shell
python main.py
```
### 使用Windows可执行文件
在本仓库的`Release`页面中下载`pypvz.exe`文件,双击运行即可
## 方法
* 使用鼠标收集阳光,种植植物
* 你可以通过更改`source/constants.py`中的`START_LEVEL_NUM`的数值来更改起始关卡:
* 冒险模式:
* 1 和 2白昼模式
* 3夜晚模式
* 小游戏模式:
* 1传送带模式
* 2坚果保龄球模式
* **注意:目前单文件发布版本不支持自定义调整关卡**
## Windows单文件封装
编译依赖:
- `Python` >= 3.7
- `Python-Pygame` >= 1.9
- `Nuitka`
- `MinGW-w64`或其他C编译器
- `ccache`
- `depends`
- `python-zstandard`(可选)
**在编译环境安装不全时Nuitka可以自动安装MinGW-w64、ccache和depends**
- 由于目前Nuitka打包尚存bug无法自动封装`pygame`中用来解码音频的相关`.dll`文件,因此需要手动在编译命令中添加
- 对于`mp3`编码,需要添加`libmpg123-0.dll`
- 对于`vorbis`编码,需要添加`libogg-0.dll``libvorbis-0.dll``libvorbisfile-3.dll`
- 对于`opus`编码,需要添加`libogg-0.dll``libopus-0.dll``libopusfile-0.dll`
- 以添加`opus`编码的背景音乐支持为例,编译需执行以下命令:
``` cmd
git clone https://github.com/wszqkzqk/pypvz.git
cd pypvz
nuitka --mingw --standalone --onefile --show-progress --show-memory --output-dir=out --windows-icon-from-ico=pypvz.ico --include-data-dir=resources=resources --include-data-file=C:\Users\17265\AppData\Local\Programs\Python\Python310\Lib\site-packages\pygame\libogg-0.dll=libogg-0.dll --include-data-file=C:\Users\17265\AppData\Local\Programs\Python\Python310\Lib\site-packages\pygame\libopus-0.dll=libopus-0.dll --include-data-file=C:\Users\17265\AppData\Local\Programs\Python\Python310\Lib\site-packages\pygame\libopusfile-0.dll=libopusfile-0.dll --windows-disable-console main.py
```
* 其中`C:\Users\17265\AppData\Local\Programs\Python\Python310\Lib\site-packages\pygame\xxx.dll`应当替换为`xxx.dll`实际所在路径
* 由于仅复制了`opus`的解码器故要求所有背景音乐都要以opus编码
可执行文件生成路径为`./out/main.exe`
## 已知bug
* 经死亡的僵尸会触发大嘴花、土豆雷甚至小推车
* 冷冻的僵尸未用蓝色滤镜标识
* 魅惑的僵尸未用红色滤镜标识
* 暂停游戏时僵尸与阳光的生成仍在计时
* 倭瓜、地刺无范围伤害
**欢迎提供[Pull requests](https://github.com/wszqkzqk/pypvz/pulls)或修复方法建议**
## ~~画大饼~~计划(不保证实施)
* 增加保存数据文件以存储用户进度的功能
* 更改僵尸生成方式
* 使僵尸生成更随机化由JSON记录改为随机数生成
* 增加更多植物、僵尸类型与游戏功能、模式,尽量符合原版基本设计
* 细分伤害种类
* 实体
* 一般子弹实体——普通伤害且无特殊效果
* 豌豆
* 孢子
* 星星
* 尖刺
* 特殊子弹实体——非普通伤害或有特殊效果
* 冰豌豆(减速)
* 火豌豆2倍伤害、带有1x1溅射
* 投掷
* 西瓜4倍伤害带有3x3溅射
* 冰瓜4倍伤害带有3x3溅射伤害与减速
* 玉米粒
* 黄油2倍伤害定格
* 卷心菜2倍伤害
* 烟雾
* 线形范围烟雾
* 圆形范围烟雾
* 碾压
* 倭瓜
* 爆炸
* 一般爆炸
* 樱桃炸弹、爆炸坚果与玉米加农炮炮弹
* 毁灭菇
* 火焰爆炸
* 火爆辣椒
* 非灰烬类爆炸(在本项目中可以考虑与一般爆炸合并)
* 土豆雷
* 从地面刺伤
* 缠绕与拖拽
* 吞噬
* 特殊
* 魅惑
* 移除铁制防具
* 全场伤害与冰冻
* 撞击
* 坚果保龄球撞击
* 巨型坚果保龄球撞击
* 吹走
* 更改僵尸生命值机制
* 将防具和本体分开
* 对防具的破损状态予以展示
* 增加部分音效
* 如爆炸、打击等
## 截屏
![截屏1](/demo/demo1.webp)
![截屏2](/demo/demo2.webp)
![截屏3](/demo/demo3.webp)
![截屏4](/demo/demo4.webp)
![截屏5](/demo/demo5.webp)
![截屏6](/demo/demo6.webp)
## 开源协议
[![GPL v3](https://www.gnu.org/graphics/gplv3-127x51.png)](https://www.gnu.org/licenses/gpl-3.0.html)