Initial import
[alienbashii.git] / AlienBash_src.readme
1 Short:        Assembly sourcecodes for "Alien Bash II"
2 Author:       Glenn Cumming
3 Uploader:     aminet aminet net
4 Type:         game/shoot
5 Architecture: generic
6
7 These are the assembly sources (and graphics, sounds, level data etc.) for the
8 "Chaos Engine" clone Alien Bash II:
9
10 http://hol.abime.net/5406
11
12 The data was found by "Higgy" on an old nearly dead Amiga harddrive he
13 he got his hands on in January 2014. When he googled the name "Glen Cumming",
14 he stumbled across a thread on an Amiga forum, where Amiga user Prowler was
15 undertaking heroic efforts to rescue the Alien Bash II sources from a stack of
16 190 partially corrupted or dead floppy disks:
17
18 http://eab.abime.net/showthread.php?p=934914#post934914
19
20 Together, Higgy and Prowler managed to backup the five partitions to the PC
21 and make sure all the files are intact.
22
23 This archives contains the contents of the "Code" and "Scratch" partitions.
24 The other partitions ("Workbench", "Tools", "Games") were left out, because
25 they contained copyrighted works from other sources (a complete Workbench
26 distribution, compilers and linkers, DPaint, Audiomaster...).
27
28 Note that this archive contains complete and unchecked backups of the two
29 partitions mentioned above, there is at least one unreleased game demo
30 (Scratch/exe/squizdemo) in there, including full source code (Code/platform/).
31 This should be split down into different archives, but this mess needs to be
32 tackled by somebody with assembly skills who can verify if anything is missing.
33
34 This code is available under the following license, as stated by Mr. Glen
35 Cumming in the above thread:
36
37 "I am happy for every scrap of code on my disks to be made available to
38 whoever wants it - I only ask that the really embarassing stuff is erased
39 (lots) and any potentially libelous messages (or swears) in any of the
40 code/scrolling messages are removed."
41
42 The following notes are from Glen Cummings, after he reviewed the contents of
43 this archive:
44
45 =========
46 ggcumming
47 =========
48
49 Hi all,
50
51 First thanks to Prowler for sorting all this out - a very dedicated Amiga
52 enthusiast indeed!
53
54 Just some quick notes from what I can remember after looking at the code.
55
56 1) I started mucking around with linking before I finished - the code that
57 gets linked can be brought back into the main assemble but for now to build
58 the code you need to :
59
60 i) Assemble main.s as a linkable file
61 ii) Asemble the four files in glens_code/link_code seperately (as linkable)
62 iii) You will then have five files which can be linked - see the scratch:link
63 directory - that's where the bits went and there is a link.bat file to create
64 the final executable - that can be run as is (picks ups data from
65 scratch:game_files)
66
67 2) The maps are all in scratch:ABII_MAPS - you can load the prj/level1.prj
68 into the map editor which loads level1 and the graphics block pages. There is
69 some documentation on the map editor in the code:newmaptool/docs directory -
70 note the overview function is useful as it shows the entire map - a point on
71 the overview can then be clicked to centre there - once the functions are
72 understood maps can be chucked together really quickly
73
74 An alienbashII map is two parts - a 16-bit word map for the blocks and an
75 additional 8-bit map (of the same size) for aliens - these are editable in the
76 tool - the aliens appear as numbers over the map.
77
78 The only bit missing at the moment is the special versions of the block pages
79 which indicate specific blocks for walking over which trigger scripts in the
80 code - however the code could be examined and the numbers added back in.
81
82 So the code assembles (note need 2mb extra ram for stock 1200), the maps are
83 editable - final bit is compressing (not looked at that yet but code is on
84 there) and modifying the in-game data to support the map - and trying to make
85 the game more interesting to play!
86
87 Happy hacking
88
89 ps. play squizdemo - much more fun (quite hard with keyboard - need to get
90 speed up before jumping over things, pull down for crushing enemies and second
91 fire button will throw balls when picked up)