Game Maker
Description:	Amiga Player & Maldita Castilla
Download:	gmap.lha       (TIPS: Use the right click menu if your browser takes you back here all the time)
Size:	45Mb
Version:	1.1
Date:	30 Jul 16
Author:	Alain Thellier
Submitter:	uploader
Email:	thellier/free fr
Requirements:	AmigaOS 4.x
Category:	emulation/misc
Replaces:	emulation/misc/gmap.lha
License:	Other
Distribute:	yes
Min OS Version:	4.0
FileID:	9929
Snapshots:
Comments:	2
Snapshots:	3
Videos:	0
Downloads:	4  (Current version)
	4  (Accumulated)

HISTORY 
The Game-Maker Amiga Player was created to allow the great game "Maldita
Castilla" ro run on an Amiga
Maldita Castilla is a free game from LocoMalito in the spirit of "Ghost'n
Goblins"
http://www.locomalito.com/maldita_castilla.php

NEW IN THIS VERSION
Still buggy but less....
Aros port from OS3 version :-) 
( Due to bytes ordering this version has needed some adjustements in bytecode
engine and variables/functions relocating )
Fix the background draw a "black area" OS4 bug : still buggy but less visible
Fix the cybergraphics/p96 mess : now OS3 need cybergraphics / OS4 use Picasso96
Fix the "memory-tracker output when quitting" bug (just disabled)
Fix for GML bytecode: access StackId/StackIdArray variables correctly when value
is now on top of stack after an operation
Fix for GML bytecode: "dup" now works correctly also in sub programs
Fix for GML bytecode: "div" floats now works correctly
Fix for GMAP-os3 running on OS4 :no more purple background (related to PNG
datatype)
More explanations in this ReadMe about localisation & other games & FAQ
Added a list of supported GML variables & functions

LICENSE 
Private Sources

DESCRIPTION
GMAP the "Game Maker Amiga Player" is a kind of emulator that allow to run games
(currently one game) made for the PC directly on an Amiga
Game-Maker is a PC application for creating games.
The OS3 version need RTG, a fast CPU for blitting and so only works inside
WinUAE
The OS4 version use compositing for blitting/display
Both versions need loooots of RAM (min 128MB) : not my fault the game is
designed this way with Game Maker :-(

FEATURES
GMAP regroup several features :
1) A native Amiga game engine that draw maps made from tiles, display instances
of objects (hero,ennemies,platform,...)
made from sprites(animations) detect collisions, manage sound, timing, keyboard,
joystick, etc....
2) A Game-Maker loader that load data from an existing GM game
(sprites,objects,maps,sounds,textures,songs,...)
Only binary games archives (game app) that contain the keyword FORM are loaded
3) A partial implementation of the GML langage. GML is the programmer API to
make games with Game-Maker
: now 130 functions are implemented. 
All the functions needed for Maldita Castilla are here. But other games may miss
some critical(or not) functions
4) A virtual machine for playing Game Maker byte-code. 
Games are compiled in a pseudo assembler format called GML bytecode
This virtual machine is able to execute GML bytecode operations
(push,pop,computation,tests,branch,strings,etc..)
It can also access Game-Maker engine's variables and GML functions. 
It implement also the needed special features like hierarchic
instances(parent/child), with, all, other, self,etc....

So as you can read GMAP is more an emulator than a simple game engine
Also Maldita Castilla is not an Amiga port but the original PC game running in
this emulator

NOTES
Many things dont works as they should but I am giving up
It is an emulator made from a single man : a too big task even for me :-/

USAGE
Check if you have datatypes for .WAV .PNG and lots of RAM
OS3 version use/need cybergraphics
OS4 version use picasso96
Start GMAP 
Select maldita_castilla.exe
Open a screen or else will use a window (32 bits screen preferred)

key ' ' (space) is fire
key <-- (backspace) is jump
arrow keys are up,down,right,left

key 'J' use a joystick

key 'z' frameskip 1 to 5
key 'b' goto previous room 
key 'n' goto next room 
key 'm' goto room+2 
key 'g' grab a room (screen grab)
key 'q' quit
key 'w' window/full screen
key 'p' pause
key 'P' pixels filtering (OS4)
key 's' Sound On/Off
key '+' Sound ++
key '-' Sound --

Included are some scripts for testing GMAP options
s  dont load/play sounds (no sound version) so use less memory
o  load/play OggVorbis sounds with oggdec conversion (full version)
w  use Warp3D as renderer but is buggy(w3d version)

MALDITA CASTILLA
Levels "Route des harpies" and "Nuberu" are bugged so skip them with 'n'
Some bugs may prevents to finish some levels so skip them with 'n'
The game is localized in French in data/maldita_castilla.loc
English users can remove this file
You can also translate maldita_castilla.loc or maldita_castilla.eng to your own
langage
and save it as data/maldita_castilla.loc 

OTHER GAMES
Other games may works to some extent but they will certainly miss
some GML functions or variables not implemented in GMAP
GMAP reports at game startup what is missing 
So you just need to:
- download a game maker game (try PC or Linux version or whatever) 
- then unpack it
- You should obtain several files (player, dll, icons, readme, etc...)
- among them the biggest is the game archive: the only file you need for GMAP
- but only game archive that contain the keyword FORM are in the supported
format compatible with GMAP
Abbaye des Morts,Gaurodan,EFMB are games that works a few with GMAP but are not
playable

FAQ
Q: Which Screen mode ?
A: As it is an old school game but made from 32 bits textures so I use
320x240x32bits

Q: Why Maldita Castilla open a screen 2 times ?
A: GMAP ask naturally for the screen mode for his Engine then Maldita Castilla
GML code contain itself a choose screen mode call

Q: Why no AGA version ?
A: All textures are 32 bits alpha. 
   Yes, they can be converted to 256 colors or even 64 colors
   But the sprite sheets are 2048x2048 so will not fit in a basic Amiga RAM
anyway ...
   
Q: Yes but ?
A: All the sprites and tiles in Maldita Castilla are stored in only 3
spritesheets as big as 2048x2048 pixels or 1024*2048. 
They will need be to be reorganised/stored in smallest spritesheets (one per
level) : this is a huge works to make code smart enough to do that

Q: Yes but but ?
A: There are more than 43MB of .wav files used in Maldita Castilla for
sounds/musics.

Q: So we should better port Maldita Castilla as a pure Amiga port ?
A: Maldita Castilla sources are not available. So feel free to rewrite it
yourself (all from scratch) if you want

Q: Using a joystick ?
key 'J' allow to use a joystick
Just adjust your OS4 or WinUAE preferences to use your pad and it will works
Specifically on OS4 plug your Trustmaster pad then adjust it in
Prefs/AmigaInput/LowLevel:Port n - Pad

Q: Can I use Game Maker PC to write a game that will works with GMAP on an Amiga
?
Yes Theorically but you will need to use only the supported GML variables &
functions