Initial commit

bugs

@@ -0,0 +1,51 @@
+Contents
+
+* Bugs in the MS game logic emulation
+* Bugs in the Lynx game logic emulation
+* Other bugs and misfeatures
+___________________________________________________________________________
+
+Bugs in the MS game logic emulation
+
+* There are numerous situations in the MS game that cause a moused goal to
+  be cancelled for which TW will keep trying. A clearer understanding of
+  those situations is needed.
+* The MS game checks for input more than once per tick. Probably this was
+  done to catch last-minute keyboard events, but it has the effect that by
+  having more than one input event in the queue, Chip can, under certain
+  circumstances, have the latter keystroke processed after he has moved but
+  before any other creatures move.
+* In TW, the keyboard is scanned twice per tick, once at the beginning and
+  once in the middle. As a result, if Chip makes a move at the beginning of
+  a tick, the game does not update the display twice in a row (once after
+  the creatures move and once after Chip moves), but just does it once. I
+  do not believe that this optimization has a real effect on the gameplay.
+  It does, however, make it easier to examine the screen when pushing
+  against a force floor.
+* There are a number of miscellaneous emulation bugs, mostly involving
+  "illegal" tile combinations. These are documented more thoroughly in the
+  msbugs.txt file on the website.
+___________________________________________________________________________
+
+Bugs in the Lynx game logic emulation
+
+* Under the real Lynx game it is possible to push a block diagonally
+  without moving at all. This is done by pushing against a wall, and then
+  pushing diagonally against a neighboring block very briefly. The block
+  will get pushed, but Chip doesn't follow. This is impossible to do in TW.
+* Under the real Lynx game it is possible, with carefully constructed
+  circumstances, for Chip to push a block away from him as it's heading
+  towards him. That is, a block starts moving into the square that Chip
+  occupies, but in the same frame, Chip starts pushing the block in the
+  opposite direction. This is impossible to do in TW.
+* There are a number of miscellaneous emulation bugs, mostly involving Chip
+  being stuck on teleports. These are documented more thoroughly in the
+  lxbugs.txt file on the website.
+___________________________________________________________________________
+
+Other bugs and misfeatures
+
+* TW ignores field 8 entries in the .dat file unless they are exactly five
+  bytes long. In this case, it simply ignores the field 6 password. The MS
+  game will remember both passwords and allow either one to be used
+  (although if both are present it will only show the field 8 password).

readme_1st_Tile_World_for_Handhelds.txt

@@ -0,0 +1,60 @@
+LIST OF IMRPOVEMENTS OF TILEWORLD FOR HANDHELDS OVER ORIGINAL TILEWORLD:
+ (Courtesy of programmer Senor Quack, aka Dan Silsby dansilsby<AT>gmail.com):
+
+
+* Simplified, menu-driven interface.
+
+* All sprites graphics have been hand-shrunk and optimized for 320x240 screens.  
+	The new game interface is reminescent of the Amiga/Lynx versions of Chip's 
+	Challenge.  The sprites and blitting code have been modified to allow
+	32-bit alpha-blended shadows instead of the ugly checkerboard shadows of
+	the original Tileworld.
+
+* Automatic configuration of level packs: No more editing configuration files!
+	When first running the program, a folder is created in $HOME/.tworld containing 
+	both $HOME/.tworld/data/ and $HOME/.tworld/sets/ folders.  
+
+	As with the original PC Tileworld, you can place additional level packs,
+	including the CHIPS.DAT file from the original Windows version of Chip's
+	Challenge, into the $HOME/.tworld/data/ folder.
+
+	Normally you would need to then manually create configuration files in
+	the $HOME/.tworld/sets/ folder for this new levelset, one for running
+	with the MS rulset and one for the Lynx rulset.
+
+	Now, the game automatically creates these two configuration files for you
+	and there is no need at all to even touch the sets/ folder and I recommend
+	you do not.  Additionally, the game will now detect if the original
+	CHIPS.DAT file is encountered and automatically add the "fixlynx=y" option
+	to its Lynx configuration file (to fix a few minor glitches introduced by
+	Microsoft's version of the levelset)
+
+* You can control Chip from both the GCW DPAD, the A/B/X/Y buttons, as well 
+	as the analog stick (after enabling it from the main menu).
+
+* There is a optional > 30-minute musical soundtrack added from the chipmusic 
+	artist Am-Fm (menu music from Chaozz of gp32x.com)
+
+* Automatically remembers last levelpack and level played, so no need to 
+	remember and go back to it. Automatically keeps track of scores and times 
+	and number of levels in levels completed.
+
+* Improved death sound.  The original death sound was much to distorted and 
+	grating for my tastes.
+
+* NOTE: The original Chip's Challenge level pack cannot be included because 
+	of copyright restrictions. Instead, a few very good user-created levelpacks 
+	have been included, including the best-of levelpacks CCLP2 and CCLP3.  
+	A CCLP1 (replacement in spirit for original Chip's Challenge levelpack) 
+	level pack is also in the works to be released sometime soon. 
+
+	IF YOU WOULD LIKE TO PLAY THE ORIGINAL CHIP'S CHALLENGE: 
+	you can find it by googling the term WITH QUOTES: 
+	"Original Chip's Challenge Download".  Unzip the archive and upload the 
+	CHIPS.DAT file inside to your $HOME/.tworld/data/ folder via FTP.  
+
+	Many hundreds of community-created levelsets have been created and are
+	available for download. The Chip's Challenge community is quite active
+	and new levels are created every day.  You can enter your scores in
+	online score-tracking sites and compete against the best.
+

readme_GP2X_OBSOLETE.txt

@@ -0,0 +1,107 @@
+-=TileWorld2X Beta 1=-
+Copyright (c)2007 Dan Silsby
+GNU GPL license, source may be found on
+gp2x.de
+
+******BETA RELEASE, BUGS MIGHT BE PRESENT******
+
+Tileworld2X Ported by Dan Silsby 11/07/2007
+(Senor Quack on gp32x.com and #gp2xdev on EFNET)
+Music files written by chaozz of gp32x.com
+and am-fm's music is used under Creative Commons
+License.
+
+-=WHAT IS IT?=-
+
+TileWorld is an open source interpreter for
+Chip's Challenge levels.  Chip's Challenge remains
+a popular game today, despite having been 
+introduced in 1989 on the Lynx handheld.  The
+version that truly launched Chip's Challenge,
+however, was the Microsoft Entertainment Pack
+version released in the early nineties. 
+
+Tileworld boasts improved tile graphics and
+sound and fluid animation that the MS version
+did not.
+
+I have carefully ported TileWorld to the small
+screen of the GP2X, and basically rewritten the
+entire GUI, as well as a lot of the file handling
+code and all of the sound code.  TileWorld2x 
+boasts improvements over the desktop version of
+TileWorld, including music support, improved
+sound samples (OK, one), a simplified and prettier 
+GUI, and automated handling of configuration files.
+
+For more info on TileWorld and Chip's Challenge, 
+visit the main TileWorld page or Wikipedia:
+
+http://www.muppetlabs.com/~breadbox/software/tworld/
+http://en.wikipedia.org/wiki/Chip's_Challenge
+
+NOTICE: The original Chip's Challenge game is 
+	NOT OK to redistribute.  If you wish to
+	play the original levels from the game,
+	(and why wouldn't you?) you will have 
+	to copy the original CHIPS.DAT file
+	into the data/ folder yourself.  It 
+	is best to locate the Windows version.
+	TileWorld2x includes over a dozen end-user 
+	created	levels, including CCLP2, the 
+	unofficial fan-made "sequel" to the 
+	original game.  Thus, there is no need 
+	to obtain the original game to have some 
+	fun. ;)
+
+-=OK, WHAT DO I NEED TO KNOW?=-
+
+If you need to learn how to play Chip's Challenge,
+there is an introductory level at the top of the
+level selection list in TileWorld2X.
+
+You can move Chip about using either the joystick
+or the 4 buttons on the right side of the GP2X.
+
+There are thousands of user-created levels
+easily found on the Internet:
+http://www.pillowpc2001.net/chips/levels.htm
+http://www.ecst.csuchico.edu/~pieguy/chips/main.php
+http://games.groups.yahoo.com/group/chips_challenge/
+http://chips.kaseorg.com/
+
+Some are crappy, some are quite fun.  I have included
+some fun ones already.  If you want to
+add more to the ones already included, it is very easy.
+Simply copy the levelset data file into the data/
+folder under tileworld2x.  That's it, just make sure
+to unzip it first!  File extension, upper/lower case
+do not matter at all, but it is important to
+place it in data/, not sets/ and do not place it
+in its own subfolder.
+
+Tileworld2x is more intelligent than the original 
+TileWorld and will automatically create two 
+configuration  files for you, one named
+LEVELSETNAME-MS.DAC, and the other 
+LEVELSETNAME-LYNX.DAC.  You may now select these
+from the main menu.
+
+Why *two* configurations?  Because 
+TileWorld is capable of emulating either system, 
+Microsoft or Lynx.  Unfortunately, MS changed
+some of the allowed behavior in their version 
+and so frequently a user-created level 
+cannot be played under Lynx mode.  This 
+is unfortunate, because Lynx mode allows fluid 
+animation and improved sounds.  Since many users
+were MS users, you will sometimes have to use
+MS mode and forego some fancier graphics in the
+name of completing all the levels in a set.
+
+-=CONTACT INFO=-
+You can reach me via PM at GP32X.COM forums, or by
+email at dansilsby <AT> gmail <DOT> com
+
+Have fun and report bugs, remember this is a 
+beta release, anything could happen!