Playing music in help and ending

[levellass]

This is something I've had for a few years but someone wanted ported to Keen 5 and 6. Good thing too because I do NOT have the modding time I once did.

This patch adds two new commands to the help\ending text files in Keen galaxy. The most important is the ^M command, which will change the music playing. (An example would be ^M6, which would play level 6's music when executed.) This works in the help sections and ending, meaning you can have multiple songs play even on a single page of the ending sequence. Music will not stop when a help\ending document is finished and putting lots of big song files on a single page can run out of memory.

As a side effect however the ^T command becomes ^A (Animation), so you'll want to back up your mod before trying this as you'll need to find-replace all the ^T commands.

This also adds a ^K (blocK Kolor) command. This changes the color of the ^B command's block so it doesn't have to be just dark red, which is useful. But it may be unwanted, in which case you can delete it by removing th4e '#^B...' line. (Altering the rest of the patch messes stuff up.)

Code: Select all

#The big page command patch -Keen 4:
#New, compact list
%patch $92A0 $0041W
%patch $9296 "A"    #First letter
%patch $929C $0F    #Length
%patch $92A7 $0337W #Location
%patch $9487 $0233W #'A' (Animation, formerly 'T')
             $0159W #'B' (Block of color)
             $01A9W #'C' (Text color)
             $0237W #'D' (Nothing)
             $0199W #'E' (End document)
             $0237W #'F' (Nothing)
             $023DW #'G' (Display graphic)
             $0237W #'H' (Nothing)
             $0237W #'I' (Nothing)
             $0237W #'J' (Nothing)
             $01D7W #'K' (Kolor of ^Boxes -$9327)
             $01FAW #'L' (Draw Line)
             $0327W #'M' (New music)
             $0237W #'N' (Nothing)
             $0237W #'O' (Nothing)
             $0199W #'P' (Start new page)

#Corrupt list for ^G (H-J invalid)
%patch $9495 $5F $5E $8B $E5 $5D $CB

#^M command
%patch $946B $29
%patch $98B0 "A"
%patch $9475 $EB $1E $0E $E8 $FCF2W  $50 $9A $06BD20C7RL     $83 $C4 $02 $E9 $FEE8W

#Add a ^K command: Original color
%patch $2F479 $0004W

#^B reads color from a variable, not a constant
%patch $92C5 $A1 $0609W

#Make space in ^C command
%patch $9316 $1C
%patch $931C $16

#^K command
%patch $9327 $0E $E8 $FE42W  $A3 $0609W  $E9 $003EW  $90 $90

Code: Select all

#The big page command patch -Keen 5:
#New, compact list
%patch $E208 $0041W
%patch $E1FE "A"    #First letter
%patch $E204 $0F    #Length
%patch $E20F $032FW #Location
%patch $E3EF $022BW #'A' (Animation, formerly 'T')
             $0151W #'B' (Block of color)
             $01A1W #'C' (Text color)
             $022FW #'D' (Nothing)
             $0191W #'E' (End document)
             $022FW #'F' (Nothing)
             $0235W #'G' (Display graphic)
             $022FW #'H' (Nothing)
             $022FW #'I' (Nothing)
             $022FW #'J' (Nothing)
             $01CFW #'K' (Kolor of ^Boxes -$9327)
             $01F2W #'L' (Draw Line)
             $031FW #'M' (New music)
             $022FW #'N' (Nothing)
             $022FW #'O' (Nothing)
             $0191W #'P' (Start new page)

#Corrupt list for ^G (H-J invalid)
%patch $E3FD $5F $5E $8B $E5 $5D $CB

#^M command
%patch $E3D3 $29
%patch $E818 "A"
%patch $E3DD $EB $1E $0E $E8 $FCF2W  $50 $9A $06B92083RL     $83 $C4 $02 $E9 $FEE8W

#Add a ^K command: Original color
%patch $3097C $0004W

#^B reads color from a variable, not a constant
%patch $E22D $A1 $063CW

#Make space in ^C command
%patch $E27E $1C
%patch $E284 $16

#^K command
%patch $E28F $0E $E8 $FE42W  $A3 $063CW  $E9 $003EW  $90 $90

Code: Select all

#The big page command patch -Keen 6:
#New, compact list
%patch $DD28 $0041W
%patch $DD1E "A"    #First letter
%patch $DD24 $0F    #Length
%patch $DD2F $032FW #Location
%patch $DF0F $022BW #'A' (Animation, formerly 'T')
             $0151W #'B' (Block of color)
             $01A1W #'C' (Text color)
             $022FW #'D' (Nothing)
             $0191W #'E' (End document)
             $022FW #'F' (Nothing)
             $0235W #'G' (Display graphic)
             $022FW #'H' (Nothing)
             $022FW #'I' (Nothing)
             $022FW #'J' (Nothing)
             $01CFW #'K' (Kolor of ^Boxes -$9327)
             $01F2W #'L' (Draw Line)
             $031FW #'M' (New music)
             $022FW #'N' (Nothing)
             $022FW #'O' (Nothing)
             $0191W #'P' (Start new page)

#Corrupt list for ^G (H-J invalid)
%patch $DF1D $5F $5E $8B $E5 $5D $CB

#^M command
%patch $DEF3 $29
%patch $E2A6 "A"
%patch $DEFD $EB $1E $0E $E8 $FCF2W  $50 $9A $069A20DBRL     $83 $C4 $02 $E9 $FEE8W

#Add a ^K command: Original color
%patch $31364 $0004W

#^B reads color from a variable, not a constant
%patch $DD4D $A1 $30D3W

#Make space in ^C command
%patch $DD9E $1C
%patch $DDA4 $16

#^K command
%patch $DDAF $0E $E8 $FE42W  $A3 $30D3W  $E9 $003EW  $90 $90