<p align="center">
<img
src="https://user-images.githubusercontent.com/2184469/42918029-a8364c66-8ad1-11e8-8147-2653091ccd38.png"
width="50%"
/>
</p>
[![build-status][]][ci-server]
[![PackageVersion][pypi-version]][pypi-home]
[![PythonVersion][python-version]][python-home]
[![Stable][pypi-status]][pypi-home]
[![Format][pypi-format]][pypi-home]
[![License][pypi-license]](LICENSE)
[build-status]: https://app.travis-ci.com/Kautenja/nes-py.svg?branch=master
[ci-server]: https://app.travis-ci.com/Kautenja/nes-py
[pypi-version]: https://badge.fury.io/py/nes-py.svg
[pypi-license]: https://img.shields.io/pypi/l/nes-py.svg
[pypi-status]: https://img.shields.io/pypi/status/nes-py.svg
[pypi-format]: https://img.shields.io/pypi/format/nes-py.svg
[pypi-home]: https://badge.fury.io/py/nes-py
[python-version]: https://img.shields.io/pypi/pyversions/nes-py.svg
[python-home]: https://python.org
nes-py is an NES emulator and OpenAI Gym interface for MacOS, Linux, and
Windows based on the [SimpleNES](https://github.com/amhndu/SimpleNES) emulator.
<table align="center">
<tr>
<td>
<img
width="256"
alt="Bomberman II"
src="https://user-images.githubusercontent.com/2184469/84821320-8c52e780-afe0-11ea-820a-662d0e54fc90.png"
/>
</td>
<td>
<img
width="256"
alt="Castelvania II"
src="https://user-images.githubusercontent.com/2184469/84821323-8ceb7e00-afe0-11ea-89f1-56d379ae4286.png"
/>
</td>
<td>
<img
width="256"
alt="Excitebike"
src="https://user-images.githubusercontent.com/2184469/84821325-8d841480-afe0-11ea-9ae2-599b83af6f65.png"
/>
</td>
</tr>
<tr>
<td>
<img
width="256"
alt="Super Mario Bros."
src="https://user-images.githubusercontent.com/2184469/84821327-8d841480-afe0-11ea-8172-d564aca35b5e.png"
/>
</td>
<td>
<img
width="256"
alt="The Legend of Zelda"
src="https://user-images.githubusercontent.com/2184469/84821329-8d841480-afe0-11ea-9a57-c9daca04ed3b.png"
/>
</td>
<td>
<img
width="256"
alt="Tetris"
src="https://user-images.githubusercontent.com/2184469/84822244-fc15a200-afe1-11ea-81de-2323845d7537.png"
/>
</td>
</tr>
<tr>
<td>
<img
width="256"
alt="Contra"
src="https://user-images.githubusercontent.com/2184469/84822247-fcae3880-afe1-11ea-901d-1ef5e8378989.png"
/>
</td>
<td>
<img
width="256"
alt="Mega Man II"
src="https://user-images.githubusercontent.com/2184469/84822249-fcae3880-afe1-11ea-8271-9e898933e571.png"
/>
</td>
<td>
<img
width="256"
alt="Bubble Bobble"
src="https://user-images.githubusercontent.com/2184469/84822551-79411700-afe2-11ea-9ed6-947d78f29e8f.png"
/>
</td>
</tr>
</table>
# Installation
The preferred installation of `nes-py` is from `pip`:
```shell
pip install nes-py
```
## Debian
Make sure you have the `clang++` compiler installed:
```shell
sudo apt-get install clang
```
## Windows
You'll need to install the Visual-Studio 17.0 tools for Windows installation.
The [Visual Studio Community](https://visualstudio.microsoft.com/downloads/)
package provides these tools for free.
# Usage
To access the NES emulator from the command line use the following command.
```shell
nes_py -r <path_to_rom>
```
To print out documentation for the command line interface execute:
```shell
nes_py -h
```
## Controls
| Keyboard Key | NES Joypad |
|:-------------|:--------------|
| W | Up |
| A | Left |
| S | Down |
| D | Right |
| O | A |
| P | B |
| Enter | Start |
| Space | Select |
## Parallelism Caveats
both the `threading` and `multiprocessing` packages are supported by
`nes-py` with some caveats related to rendering:
1. rendering **is not** supported from instances of `threading.Thread`
2. rendering **is** supported from instances of `multiprocessing.Process`,
but `nes-py` must be imported within the process that executes the render
call
# Development
To design a custom environment using `nes-py`, introduce new features, or fix
a bug, please refer to the [Wiki](https://github.com/Kautenja/nes-py/wiki).
There you will find instructions for:
- setting up the development environment
- designing environments based on the `NESEnv` class
- reference material for the `NESEnv` API
- documentation for the `nes_py.wrappers` module
# Cartridge Mapper Compatibility
0. NROM
1. MMC1 / SxROM
2. UxROM
3. CNROM
You can check the compatibility for each ROM in the following
[list](https://github.com/Kautenja/nes-py/blob/master/nesmapper.txt)
# Disclaimer
**This project is provided for educational purposes only. It is not
affiliated with and has not been approved by Nintendo.**
Python3NES模拟器和OpenAIGym接口.zip
版权申诉
126 浏览量
2023-03-22
21:49:16
上传
评论
收藏 522KB ZIP 举报
Python3NES模拟器和OpenAIGym接口.zip （70个子文件） 
nes-py-master 
makefile 649B .travis.yml 3KB setup.py 3KB .github ISSUE_TEMPLATE feature_request.md 586B bug_report.md 540B PULL_REQUEST_TEMPLATE.md 1KB LICENSE 1KB __main__.py 130B
nesmapper.txt 110KB requirements.txt 76B speedtest.py 353B nes_py __init__.py 165B nes_env.py 15KB nes include mapper.hpp 2KB controller.hpp 1KB cartridge.hpp 2KB palette.hpp 1KB mapper_factory.hpp 1KB log.hpp 422B cpu.hpp 5KB common.hpp 616B ppu.hpp 5KB main_bus.hpp 3KB emulator.hpp 3KB picture_bus.hpp 2KB cpu_opcodes.hpp 3KB mappers mapper_SxROM.hpp 3KB mapper_CNROM.hpp 2KB mapper_NROM.hpp 2KB mapper_UxROM.hpp 2KB src cpu.cpp 17KB ppu.cpp 14KB picture_bus.cpp 3KB controller.cpp 478B main_bus.cpp 4KB emulator.cpp 3KB lib_nes_env.cpp 2KB mappers mapper_CNROM.cpp 474B mapper_SxROM.cpp 4KB mapper_UxROM.cpp 1KB mapper_NROM.cpp 1KB cartridge.cpp 1KB SConstruct 657B app __init__.py 75B play_random.py 858B play_human.py 3KB cli.py 1KB _image_viewer.py 5KB tests __init__.py 41B test_nes_env.py 4KB rom_file_abs_path.py 676B test_multiple_makes.py 3KB test_rom.py 9KB games super-mario-bros-3.nes 384KB super-mario-bros-1.nes 40KB super-mario-bros-lost-levels.nes 40KB empty.nes 0B excitebike.nes 24KB blank 0B super-mario-bros-2.nes 256KB the-legend-of-zelda.nes 128KB _rom.py 6KB wrappers __init__.py 191B joypad_space.py 4KB MANIFEST.in 17B .gitignore 2KB backup_restore.py 456B README.md 5KB .clang_complete 21B scripts run.py 353B资源评论
