8c6afb9fb16344043ed097dfb6c0a147d0174ca0
[kxp.git] / README
1 First, catch your rabbit. Somehow get KGoldrunner installed. Your 
2 GNU/Linux distribution has probably already packaged it for easy 
3 installation.
4
5 Then place the .grl files in 
6 ~/.kde/share/apps/kgoldrunner/user/levels, creating this if it doesn't 
7 exist.
8
9 Edit or create ~/.kde/share/apps/kgoldrunner/user/games.dat and add 
10 this line:
11
12 200 T kxp KGoldRunner Expansion Pack
13
14 Now run KGoldrunner and when you select New Game from the Game menu, 
15 you should see the KGoldrunner Expansion Pack listed.
16
17 Enjoy!
18
19 SOLUTIONS
20 =========
21
22 Stuck? Need help? Can't figure out how to pass a level? Normally I'd 
23 tell you to select Show A Solution from the Move menu but it appears 
24 that KGoldRunner doesn't allow third party level designers to provide 
25 their own solutions.
26
27 I've come up with a workaround using the fact that KGoldRunner records 
28 you as you play levels. The file rec_kxp.txt contains recordings of my 
29 playing the levels from the KGoldrunner Expansion Pack. It currently 
30 contains recordings of the first 165 levels but recordings for all 
31 levels will be added.
32
33 If you'd like to see how I did something, move that file into 
34 ~/.kde/share/apps/kgoldrunner/user but be aware that since KGoldRunner 
35 has been recording you playing the levels this will overwrite your 
36 recordings you may want to back up your recordings file if you want to 
37 be able to keep that. Also, if you then go play a level it will 
38 overwrite my recording with yours. As a result, you may need to keep a 
39 "pristine" copy of my recordings around and swap the files around 
40 multiple times if you want to see multiple solutions while playing 
41 levels in between them.
42
43 Hopefully these limitations will be addressed in a future version of 
44 KGoldRunner.
45
46 You can redistribute and/or modify these levels under the terms of the 
47 GNU General Public License as published by the Free Software 
48 Foundation, either version 3 of the License, or (at your option) any 
49 later version.
50
51 The levels are distributed in the hope that they will be useful, but 
52 WITHOUT ANY WARRANTY; without even the implied warranty of 
53 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
54 General Public License for more details.
55
56 You should have received a copy of the GNU General Public License 
57 along with these levels. If not, see <http://www.gnu.org/licenses/>.