Really fix the recording of level 25.
[kxp.git] / README
diff --git a/README b/README
index 52fbf0dd587c2b6178b21747d41254770a9ad846..f7ece150f52b56a11b37934cb0e211c395182017 100644 (file)
--- a/README
+++ b/README
@@ -1,6 +1,9 @@
-First, catch your rabbit. Somehow get KGoldrunner installed. Your 
-GNU/Linux distribution has probably already packaged it for easy 
-installation.
+KXP = KGoldRunner eXpansion Pack. This consists of games I've made for 
+KGoldrunner.
+
+To use them first catch your rabbit: Somehow get KGoldrunner 
+installed. Your GNU/Linux distribution has probably already packaged 
+it for easy installation.
 
 Then place the .grl files in 
 ~/.kde/share/apps/kgoldrunner/user/levels, creating this if it doesn't 
@@ -9,21 +12,51 @@ exist.
 Edit or create ~/.kde/share/apps/kgoldrunner/user/games.dat and add 
 this line:
 
-067 T dm KGoldRunner Expansion Pack
+1 T bl Beginner's Luck
 
-Now run KGoldrunner and when you select New Game from the Game 
-menu, you should see the KGoldrunner Expansion Pack listed.
+Now run KGoldrunner and when you select New Game from the Game menu, 
+you should see Beginner's Luck listed.
 
 Enjoy!
 
-You can redistribute and/or modify these levels under the terms of the GNU 
-General Public License as published by the Free Software Foundation, either 
-version 3 of the License, or (at your option) any later version.
+Surplus Levels Directory
+This contains levels which may be used in other games in the future.
+
+
+SOLUTIONS
+=========
+
+Stuck? Need help? Can't figure out how to pass a level? Normally I'd 
+tell you to select Show A Solution from the Move menu but it appears 
+that KGoldRunner doesn't allow third party level designers to provide 
+their own solutions.
+
+I've come up with a workaround using the fact that KGoldRunner records 
+you as you play levels. The file rec_bl.txt contains recordings of my 
+playing the levels from Beginner's Luck.
+
+If you'd like to see how I did something, move that file into 
+~/.kde/share/apps/kgoldrunner/user. However: Be aware that since 
+KGoldRunner has been recording you playing the levels this will 
+overwrite your recordings. You may want to back up your recordings 
+file if you want to be able to keep it. Also, if you then go play a 
+level it will overwrite my recording with yours. As a result, you may 
+need to keep a "pristine" copy of my recordings file around so that it 
+can be swapped in as needed if you want to see multiple solutions 
+while playing levels in between them.
+
+Hopefully these limitations will be addressed in a future version of 
+KGoldRunner.
+
+You can redistribute and/or modify these levels under the terms of the 
+GNU General Public License as published by the Free Software 
+Foundation, either version 3 of the License, or (at your option) any 
+later version.
 
-The levels are distributed in the hope that they will be useful, but WITHOUT 
-ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 
-FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 
-for more details.
+The levels are distributed in the hope that they will be useful, but 
+WITHOUT ANY WARRANTY; without even the implied warranty of 
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
+General Public License for more details.
 
-You should have received a copy of the GNU General Public License along with 
-these levels. If not, see <http://www.gnu.org/licenses/>.
+You should have received a copy of the GNU General Public License 
+along with these levels. If not, see <http://www.gnu.org/licenses/>.