source: trunk/game/README @ 684

Revision 525, 7.4 KB checked in by barra_parpg, 10 years ago (diff)

Patch by mvbarracuda:

  • Removing redundant line from README
  • Property svn:eol-style set to native
Line 
1=================================================================================
2                            PARPG TECHDEMO 1 README
3                          Last Updated: 10 March 2010
4=================================================================================
5
6== Introduction ==
7Welcome to the first official release of the open source post-apocalyptic RPG undertaking PARPG. This release is based on PARPG SVN trunk revison 522. Built against and tested with FIFE SVN trunk revision 3236.
8
9== Table of contents ==
1001 Preamble
1102 License
1203 Supported operating systems
1304 How to run PARPG
1405 Keybinds
1506 Settings
1607 Map editor
1708 Known bugs / limitations
1809 How to provide feedback
1910 Acknowlegements
20
21== 01 Preamble ==
22This preamble has been written to give you an upfront overview of the current status of the project. In the last months the project slowed down considerably and we basically decided that we'll rather release what we have right now instead of trying to implement more features and add more content, risking to collapse before we reach the finish line of the first release.
23
24This said: we didn't manage to fix a number of bugs and didn't reach the original aim to implement a couple of quests that you can actually play through. You can walk around, talk to other characters, change to different (placeholder) maps, listen to background audio tracks and play around with the settings. That's it. It's possible that this is the first and last official PARPG release due the issues we are facing lately. Hopefully this release will help to attract some fresh blood that will get the project back on track. If not, it was at least fun for us to spend a year of our life on such a project and release what we have achieved to the public. And move on after that.
25
26== 02 License ==
27* All Python code is licensed under GPL 3.0. For the full license see: <PARPG>/game/license/gpl30.license
28* Assets are either licensed under Creative Commons 3.0 BY-SA or public domain. For the full licenses see: <PARPG>/game/license/cc30_by_sa.license & <PARPG>/game/license/public_domain.license
29* Most directories contain an <asset>.license file that states under which license the specific assets in the directory are released under and who created them. Use this file to properly attribute developers in case you reuse PARPG assets in your project
30
31== 03 Supported operating systems ==
32PARPG is officially supported in combination with these operating systems:
33* Linux (32 & 64bit)
34* Win32 (32 & 64bit)
35
36PARPG should nevertheless also work with (prolly some tweaks required):
37* FreeBSD (use Linux install instructions)
38* Mac OSX
39* OpenBSD (use Linux install instructions)
40
41== 04 How to run PARPG ==
42=== 04.1 Linux ===
43* Unpack the fife_r3236_src.tar.gz archive to a folder of your choice (called <FIFE> from now on)
44* Install scons using your package manager
45* Install swig using your package manager
46* Install Python 2.5 or 2.6 and a matching version of PyYAML if you don't have them installed yet
47* cd into the <FIFE> directory and run: scons ext && sudo scons install-python
48* In case you encounter any build errors, install the necessary libraries and try these pointers http://wiki.fifengine.de/Building:Linux:SCons
49* Unpack the parpg_td1_r522_src.tar.gz archive to a folder of your choice (called <PARPG> from now on)
50* cd into the <PARPG> directory and run: ./run.py
51
52=== 04.2 Mac ===
53* Unpack the fife_r3236_src.tar.gz archive to a folder of your choice (called <FIFE> from now on)
54* Install scons using macports
55* Install swig using macports
56* Install guichan using macports
57* Install Python 2.5 or 2.6 and a matching version of PyYAML if you don't have them installed yet
58* cd into the <FIFE> directory and run: scons ext && sudo scons install-python
59* In case you encounter any build errors, install the necessary libraries and try these pointers http://wiki.fifengine.de/Building:Mac:Scons
60* Unpack the parpg_td1_r522_src.tar.gz archive to a folder of your choice (called <PARPG> from now on)
61* cd into the <PARPG> directory and run: ./run.py
62
63=== 04.3 Win32 ===
64* Run parpg_td1_r522_win32.exe and install PARPG to a location of your choice (called <PARPG> from now on)
65* Make sure that you've installed (Active)Python 2.6, PyYAML and FIFE (they either ship with the installer or can be downloaded with the help of it)
66* To run PARPG itself, cd into the <PARPG> directory and execute run.py (should be automatically associated with your Python 2.6 interpreter)
67* To run PARPG with file logging, cd into the <PARPG> directory and execute log_parpg.bat; the log will be written to logfile.txt
68
69== 05 Keybinds ==
70* <i> toggles the inventory on and off
71* <t> shows the grid layout
72* <m> toggles music on and off
73* <q> shows quit dialog
74* <F5> shows the grid coordinates
75* <F7> takes a screenshot
76* <F10> shows a debug console
77* <ESC> shows the main menu
78* <PAUSE> (un)pauses the game
79
80== 06 Settings ==
81There are two ways to change the ingame settings like used renderer, resolution, etc.:
82* Press <ESC> and select Options from the menu
83* Edit <PARPG>/game/settings.xml manually, entries are mostly self-explanatory
84
85== 07 Map editor ==
86* To run the PARPG map editor, cd into the PARPG directory and execute parpg_editor.py
87* A work in progress map editor tutorial can be found at http://wiki.parpg.net/Map_editor_tutorial
88
89== 08 Known bugs / limitations ==
90* FPS rate tends to be rather slow on some systems; the FIFE team is working to address this in their view_performance branch, for details see http://forums.parpg.net/index.php?topic=570.0
91* While it's possible to talk to the NPCs, you can't solve any of the quests without using the ingame console (see ticket #229)
92* Some unit tests are broken (see ticket #253)
93* Random music playback hasn't been implemented (see ticket #250)
94* PARPG crashes on exit in combination with Windows Vista 64bit if FIFE is built via MSVC 2005/2008 (see ticket #114 for a workaround)
95* There is no regular main menu, you'll have to use the <ESC> key to access the placeholder menu (see ticket #118)
96* Containers don't support taking everything out of them at once (see ticket #225)
97* You can't drop items onto the ground (see ticket #223)
98* Some map objects are semi-transparent while they should have been rendered opaque (see ticket #251)
99* Full list of open tickets can be found at http://parpg-trac.cvsdude.com/parpg/report/1
100
101== 09 How to provide feedback ==
102You can reach the development team in a couple of ways and provide feedback:
103* PARPG forums: http://forums.parpg.net/
104* PARPG IRC channel: #parpg @ irc.freenode.net (visit http://irc.parpg.net to join the channel via your web browser)
105* PARPG bug tracker: http://bugs.parpg.net
106* PARPG blog: http://blog.parpg.net/
107
108All feedback is welcome!
109
110== 10 Acknowlegements ==
111We thank everyone who supported the project and believed in the idea of creating an old school isometric 2d RPG despite the general trend of more and more higher budget cross platform (read: consoles and win32) 3d RPGs. We do especially want to thank qubodup, a loyal follower who supported the project since its first steps and has helped us by spreading the word about PARPG with his ingame videos and his continued news coverage at http://freegamer.blogspot.com/
112
113Furthermore we want to thank the developers of FIFE, the engine of our choice. Without you this project would not have been possible at all and we're glad that the project is finally in good hands again now. If you want to find out more about FIFE, check out their website http://www.fifengine.net/
114
115The PARPG developers,
116http://www.parpg.net
Note: See TracBrowser for help on using the repository browser.