{"id":17329461,"url":"https://github.com/zrax/tworld2","last_synced_at":"2025-10-30T23:14:35.333Z","repository":{"id":9046470,"uuid":"10810840","full_name":"zrax/tworld2","owner":"zrax","description":"My fork of Madhav Shanbhag's fork of Brian Raiter's Tile World","archived":false,"fork":false,"pushed_at":"2013-06-20T02:45:44.000Z","size":1080,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T10:42:06.482Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zrax.png","metadata":{"files":{"readme":"README","changelog":"Changelog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-06-20T02:45:21.000Z","updated_at":"2017-03-04T21:49:31.000Z","dependencies_parsed_at":"2022-07-09T22:30:30.687Z","dependency_job_id":null,"html_url":"https://github.com/zrax/tworld2","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zrax%2Ftworld2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zrax%2Ftworld2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zrax%2Ftworld2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zrax%2Ftworld2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zrax","download_url":"https://codeload.github.com/zrax/tworld2/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245791902,"owners_count":20672666,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-15T14:48:11.554Z","updated_at":"2025-10-30T23:14:35.245Z","avatar_url":"https://github.com/zrax.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n  Welcome to Tile World\n\nTile World is an emulation of the game \"Chip's Challenge\" for the Atari\nLynx, created by Chuck Sommerville, and later ported to MS Windows by\nMicrosoft (among other ports).\n\n  Important Note\n\nTile World is an emulation of the \"Chip's Challenge\" game engines only. It\ndoes not come with the chips.dat file that contains the original level set.\nThat file, which is copyrighted and cannot be freely distributed, was\noriginally distributed with the MS version of \"Chip's Challenge\". If you\nhave a copy of this version of the game, you can use that file to play the\noriginal games in Tile World. If you do not have a copy of this file,\nhowever, you can still play Tile World with the many freely available level\nfiles created by fans of the original game.\n\n  Installing Tile World under Windows\n\nFirst of all, you'll want to store the files contained in this archive into\nits own separate directory. If you're using the self-extracting executable,\nyou can create a new directory during the installation. Otherwise, you'll\nneed to create a new directory beforehand -- something like c:\\tworld --\nand extract the files in there.\n\nIf you have a copy of the chips.dat data file, copy it to the data\nsubdirectory. This will allow you to play the original levels under Tile\nWorld (for the MS ruleset and the Lynx ruleset both).\n\nIf you have other data files that you would like to try out in Tile World,\ncopy those to the sets directory.\n\nThe shell commands to do the above would look something like:\n\n  cd c:\\wherever\\my\\copy\\of\\chips\\challenge\\is\\at\n  copy chips.dat c:\\tworld\\data\n  cd c:\\my\\collection\\of\\dat\\files\n  copy *.dat c:\\tworld\\sets\n\nThat's all that needs to be done to set it up. Run the program as\nc:\\tworld\\tworld2, or create a shortcut for it.\n\n  Installing Tile World under Linux (or building from source on Windows)\n\nTile World 2 has not yet been extensively tested on Linux.\n\nBefore proceeding, ensure that you have Qt 4 and SDL installed on your machine.\n(If you don't have SDL, you can get it by visiting\nhttp://www.libsdl.org/download.html. If you download a precompiled version\n-- i.e., an .rpm or .deb file -- note that you will need the development\nruntime, as opposed to the binary runtime.)\nTile World has been tested with Qt 4.7.2, although any Qt 4.4 or later should\nalso work.  Earlier versions of Qt may not work.\n\nInstalling Tile World involves the following steps:\n\nAssuming that the Qt and SDL development libraries are properly installed,\ncmake will try to figure out the necessary flags internally.\n\n  cmake /path/to/tworld2-sources\n\nIf you encounter any warnings or errors from cmake, you may need to provide\na manual path to your compatible qmake.exe or libsdl includes and libraries.\n\nFor a makefile-based compile (the default for Linux, OSX and MinGW), run:\n\n  make\n  make install\n\nIf you used an IDE generator (e.g. Visual Studio or XCode), you can open\nthe generated project files and compile normally.  The special \"INSTALL\"\nbuild target will perform the equivalent of a \"make install\".\n\nRunning \"make install\" as root will do the following:\n\n* Copy the tworld2 binary to /usr/local/games.\n* Copy the tworld2.6 manpage to /usr/local/man/man6.\n* Create /usr/local/share/tworld if it does not exist.\n* Copy the external resources (i.e., the bitmaps and wave files) to\n  /usr/local/share/tworld/res.\n* Create the directories /usr/local/share/tworld/data and\n  /usr/local/share/tworld/sets.\n\nThe sets directory is where you will generally store the .dat files that\nyou want to use. However, if you want to make use of a configuration file\nwith a particular data file, then you will need to store the data file in\nthe data directory, and the configuration file goes into the sets directory\ninstead. See the documentation for more information.\n\n  Level Sets\n\nAs mentioned above, the original \"Chip's Challenge\" level set does not come\nwith Tile World, for reasons of copyright. If you do not already have a\ncopy of Microsoft's Windows version of \"Chip's Challenge\", you might still\nbe able to find a copy. Search the links listed below, under \"Resources on\nthe Internet\", for helpful hints on finding the game online.\n\nIf and when you do, you can copy the chips.dat file from there into Tile\nWorld's data directory. You will then be able to play the levels of the\noriginal set (both in MS mode and in Lynx mode).\n\nThere are also many \"user-created\" level sets. These are sets of levels\nwhich have been invented by fans of the game. These sets are freely\navailable for downloading. If you have a .dat file that contains a level\nset and you wish to use it, just copy it to Tile World's sets directory.\nThe next time you start Tile World, the new .dat should appear in the list\nof available level sets.\n\nAt http://groups.yahoo.com/group/chips_challenge/files/ is a repository of\nthe available level sets that have been created. The biggest fans of the\ngame try to provide a copy of every known user-created level set at this\nplace. I have not included any of these level sets in this distribution, as\nthe authors continue to add new levels to their sets over time.\n\nActually, this distribution does contain one small level set. This is\nincluded so that even if you don't have the original level set, you can\nstill get a brief glimpse of how the game works, and what some of the most\nbasic challenges are. Also, the same set of levels can be played with both\nthe MS and Lynx ruleset, so you can see how they differ.\n\nFinally, there are some special level sets that deserve particular mention.\nThey are CCLP2.dat and CCLP3.dat, or \"Chip's Challenge Level Pack 2 and 3\".\nThese sets were assembled by the fans, who voted on all of the user-created\nlevels that existed at the time when each was compiled. The levels that were\nvoted as being the most fun were then all put together. They are the closest\nthings we have to sequels for the original game.\n(But be careful: they are both much harder than the original!)\nYou can download a copy of Tile World with these sets already\ninstalled. If instead you download them separately, you will want to store them\nin your data directory instead of your sets directory. (This is because\nTile World comes with special configuration files for CCLP2 and CCLP3.)\nNote that only some levels in CCLP2 can be played under the Lynx ruleset.\nCCLP3, on the other hand, had compatibility with both rulesets as a criterion,\nand hence all of its levels can be enjoyed in the ruleset of your choice.\n\n  The Complete Documentation\n\nThe full documentation for Tile World is included with the distribution, in\nthe file tworld2.html. There you will find information on how to play the\ngame, adding new level sets, customizing Tile World, and more.\n\n  Creating New Level Sets\n\nThe most widely used program for creating new level sets is ChipEdit. It\ncomes with excellent documentation, and you should have little trouble\nlearning how to use it. Some other editors have recently been made\navailable, such as CCEdit and Chip's Workshop.\n\nNormally, ChipEdit creates levels for the MS ruleset. If you wish to make a\nlevel set for the Lynx ruleset, you have a few options:\n\n* A very simple command-line utility is included with Tile World, called\n  mklynxcc. This program will change a normal .dat file to one that will\n  use the Lynx ruleset instead of the MS ruleset. Running mklynxcc foo.dat\n  will change foo.dat's ruleset from MS to Lynx.\n* You can use a configuration file to override the builtin ruleset. This\n  method requires creating an extra file, but does allows you to avoid\n  making changes to the .dat file. See the complete documentation for\n  information on how to set up a configuration file.\n* Finally, ChipEdit has an obscure feature which allows you to control the\n  signature of the data file. This is done by adding a SIGNATURE entry to\n  the chipedit.ini file. The default signature value is 0x0002AAAC, which\n  indicates a data file that uses the MS ruleset. If you set the SIGNATURE\n  to be 0x0102AAAC, then ChipEdit will create data files marked to use the\n  Lynx ruleset instead.\n\n  Resources on the Internet\n\nThere is quite a bit of information about \"Chip's Challenge\" available on\nthe internet. Much of it is focused on maximizing your score on the\noriginal level set for the MS game, but you will also find lots of general\nhelp and useful information as well.\n\nJimmy Vermeer maintains a site that tracks people's scores on the original\nlevel set and CCLP2, as well as information on other levels and links to\nmany other pages. (But it hasn't been updated in a long time.)\n\n  http://www.geocities.com/purpletentacle1977ca/\n  \nMike L's Chip's Challenge hosts CCLP2 and CCLP3 and has links to almost\nevery custom level set available.\n\n  http://www.pillowpc2001.net/\n\nAnders Kaseorg's site contains the Chip's Challenge FAQ, as well as the AVI\nrepository and a web interface to the newsgroup:\n\n  http://chips.kaseorg.com/\n\nThe grand repository of user-created level sets can be found at the\nchips_challenge Yahoo group:\n\n  http://groups.yahoo.com/group/chips_challenge/files/\n\nChipEdit's home page is at:\n\n  http://www.stage62.com/chipedit/chipedit.htm\n\nFinally, the original Tile World home page is at:\n\n  http://www.muppetlabs.com/~breadbox/software/tworld/\n  \nThis latest version - Tile World 2 - is being maintained at:\n\n  http://madhavshanbhag.sitesled.com/Landlubber/TileWorld/index.html\n\n  License\n\nTile World is copyright (C) 2001-2010 by Brian Raiter and Madhav Shanbhag.\nThis program is free software; you can redistribute it and/or modify it under\nthe terms of the GNU General Public License as published by the\nFree Software Foundation; either version 2 of the License, or (at your option)\nany later version.\nThis program is distributed in the hope that it will be useful, but WITHOUT\nANY WARRANTY; without even the implied warranty of MERCHANTABILITY or\nFITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License,\nincluded in this distribution in the file COPYING, for more details.\n\n  Bugs\n\nBug reports are always appreciated, and can be sent to Madhav Shanbhag at\nCrapulentCretin@Yahoo.com. The list of known bugs is at\nhttp://www.muppetlabs.com/~breadbox/software/tworld/BUGS.html. Please check\nhere before sending a bug report, to to make sure the bug has not already\nbeen documented.\n\n  Credits\n\nTile World was written by Brian Raiter.\n\nTile World 2 - which simply improves upon the user interface of the original\nTile World program - was developed by Madhav Shanbhag.\n\nThe sound effects included in this distribution were created by Brian\nRaiter, with assistance from SoX. Brian Raiter has explictly placed these\nfiles in the public domain.\n\nThe tile images included in this distribution were created by Anders\nKaseorg, with assistance from POV-Ray. Anders Kaseorg has explicitly placed\nthese files in the public domain.\n\nThe introductory set of levels included in this distribution were created\nby Brian Raiter. Brian Raiter has explictly placed these levels in the\npublic domain.\n\nThomas Harte and Michael Hansen have developed Mac OSX ports of Tile World and\nTile World 2 respectively.\n\nThanks to \"The Architect\" for his corrections to the font bitmap file.\n\n\"Chip's Challenge\" was designed by Chuck Sommerville, who is also the\nauthor of the original Lynx program.\n\n\"Chip's Challenge\" is a registered trademark of Alpha Omega Publications.\n\nCreating this program would have been flatly impossible without the help of\nseveral fans of \"Chip's Challenge\". The author would particularly like to\nacknowledge Anders Kaseorg for sharing the fruits of his investigations\ninto the game logic of the MS version and for being an effective bug\nhunter, Chuck Sommerville for his pointers regarding the game logic of the\nLynx version and his unfailing support of this project, and \"CCExplore\" for\nhis in-depth investigations of esoteric game behavior.\n\nMany other regulars of the annexcafe.chips.challenge newsgroup assisted\nwith bug reports, suggestions, and all-around encouragement. Their help is\ngratefully acknowledged.\n\nThe anonymous author of the document describing the .dat file format, Don\nGregory, the \"Charter Chipsters\", and the contributors to the CC AVI\nlibrary all deserve mention as well -- this program would never have been\nwritten without the information they made freely available.\n\nLast but not least, a tip of the hat to John K. Elion for writing ChipEdit.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzrax%2Ftworld2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzrax%2Ftworld2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzrax%2Ftworld2/lists"}