License information: ==================== Check the COPYING.txt file for the license, it is zlib/libpng based so it is highly flexible. Game information ================= http://xye.sourceforge.net Linux Users =========== Linux users should refer to the README file instead of this readme.txt file which is for win32 users. The Source ========== Should use Code::blocks to open and GCC / mingw32 to compile. (project file "src\xye.cbp") Also header files , and its libraris. Playing Xye =========== Using the executable file will make you enter automatically to the level specified in xyeconf.xml . In case xyeconf.xml is missing / it does not specify a level file, the game will open a very primitive and limited level list to allow you to choose levels. About XyeGUI ============ You can edit xyeconf.xml to your likes or you can use XyeGUI a program that requires the .net framework 1.1 or greater and that is a GUI for our game. The win32 distribution comes with XyeGUI , as long as you meet the framework requirement you can use XyeGUI.exe directly to open the game. xyegui.exe is recommended for win32 users, xye.exe's level browser has some limitations, the worst of them is that it does not support subfolders in the levels folder. Another noticeable disadvantage is that it cannot allow you to choose. Only use xye.exe with #browse# option in case you cannot run xyegui.exe. XyeGUI is a .net application that offers an interface for you to select files and other options and to launch Xye, it is not required but if your system is capable of executing it I recommend you to use it, the win32 distribution comes with it already. XyeGUI will offer you a list of level files, if you click a level file with more than 1 level you will note that a [+] button has been enabled, if you expand that node you will get a list of the levels and choose the one you want. Otherwise you can just use the file's node and it will launch the first level. You can change Xye's color to your likes and you can also select an skin file for the game. The game comes with 2 predefined skin files default.xml and classic.xml , default is Xye's look and classic is a look that is SIMILAR to original Kye note that default has a 20×20 grid size and classic a 16×16 one. On older systems with low resolutions you might preffer classic over default, also classic is supposed to execute faster because less pixels to draw means less work for your CPU/memory card. xyeconf.xml guide ================= You do not need to know about this if you use xyegui. It has a unique tag , options. options has some possible attributes: - levelfile : the location of the level file that you want to play (relative to [xye location]/levels/ ) - levelnumber : the number of level (optional, default is 1) - skinfile : the skin file (relative to [xye location]/res/ ) use either "default.xml" or "classic.xml" - red,green,blue : the RGB color for xye (optional , default is pure green) Game instructions ================= Check out the GAMEINTRO.txt for instructions about how to play xye. More ==== It is possible to make new skins for the game, check out the default.xml and classic.xml in the res subfolder, you require an editor with the capability of making PNG graphics with transparency. Charity ======= Kye was a charityware, although Xye targets to be completelly free software, it is fair to add these lines to the readme: if you really enjoy this game and want to give me a good reason to continue improving it. Instead of asking for donations I am gonna ask you to donate to any Children Charity. Credits and Special thanks =========================== This information lies in the AUTHORS file Version Info ============ Details about version updates lie in the NEWS file