2018-09-26 11:06:23 -04:00
|
|
|
# punyverse [](https://travis-ci.org/quantum5/punyverse) [](https://ci.appveyor.com/project/quantum5/punyverse) [](https://pypi.org/project/punyverse/) [](https://pypi.org/project/punyverse/) [](https://pypi.org/project/punyverse/)
|
2013-10-22 17:53:53 -04:00
|
|
|
|
2017-07-23 16:49:40 -04:00
|
|
|
Python simulator of a puny universe. (How many words can I stick into one?)
|
|
|
|
|
2018-08-29 16:54:55 -04:00
|
|
|

|
2013-10-30 19:29:33 -04:00
|
|
|
|
2018-08-22 17:15:05 -04:00
|
|
|
## Installation
|
2013-10-30 19:29:33 -04:00
|
|
|
|
2018-08-22 02:00:32 -04:00
|
|
|
To install, run `pip install punyverse`.
|
2013-10-30 19:29:33 -04:00
|
|
|
|
2018-08-27 02:53:05 -04:00
|
|
|
If you are on Windows, run `punyverse_make_launcher`. This should create special launchers that runs `punyverse` on
|
|
|
|
your dedicated graphics card, should it exist.
|
|
|
|
|
2018-08-29 16:54:55 -04:00
|
|
|
Your graphics card might not support some of the larger textures used by `punyverse`, and so startup might fail.
|
|
|
|
To solve this problem, run `punyverse_small_images`. It will do nothing if your graphics card supports all the
|
|
|
|
textures, so when in doubt, run `punyverse_small_images` after installation.
|
|
|
|
|
2018-08-22 02:00:32 -04:00
|
|
|
Then, run `punyverse` to launch the simulator, or `punyversew` to launch without the console.
|
2013-10-30 19:29:33 -04:00
|
|
|
|
2018-08-29 16:54:55 -04:00
|
|
|
### Summary
|
|
|
|
|
|
|
|
```bash
|
|
|
|
pip install punyverse
|
|
|
|
punyverse_make_launcher
|
|
|
|
punyverse_small_images
|
|
|
|
# Installation finished. Run:
|
|
|
|
punyverse
|
|
|
|
```
|
|
|
|
|
|
|
|
## Troubleshooting
|
|
|
|
|
|
|
|
If `punyverse` does not work, try upgrading your graphics card drivers.
|
2013-10-30 19:29:33 -04:00
|
|
|
|
2018-08-29 16:54:55 -04:00
|
|
|
If your graphics card does not appear to support OpenGL 3.3, then you cannot run the latest version of `punyverse`.
|
|
|
|
You can try `pip install -U punyverse==0.5` to install the last version of `punyverse` to support legacy devices.
|
|
|
|
You can download the wheels manually from [the PyPI page](https://pypi.org/project/punyverse/0.5/).
|
2013-10-30 19:29:33 -04:00
|
|
|
|
2018-08-29 16:54:55 -04:00
|
|
|
If the problem is unrelated to your graphics card, and it persists, try running punyverse under debug mode. To do this,
|
|
|
|
run `punyverse` as `punyverse --debug`. Then paste the entirety of the output into a new GitHub issue
|
|
|
|
[here](https://github.com/quantum5/punyverse/issues/new).
|