version 0.97: weapon fixes and updates
[nemesis.git] / nemesis.z80
index 24c7366fd00d6fd0378474c933fa3664520bb575..9e8bcfa2db38c15a008e1995caa514bee757147d 100644 (file)
@@ -1,25 +1,24 @@
-;------------------------------------------------------------------------------
-;---------------------- NEMESIS -----------------------------------------------
-;------------------------------------------------------------------------------
-;      >>> NEMESIS <<<         Version 0.96 BETA       by SHIAR
-; - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
+;----------------------------------------------------------------------------
+;---------------------- NEMESIS ---------------------------------------------
+;----------------------------------------------------------------------------
+
 ; Title                                : Nemesis
-; Version                      : 0.96
-; Release Date                 : 30.X.99
-; Filename                     : nemesis.86p (4836) nemesis0.86p (888)
+; Version                      : 0.97
+; Release Date                 : 25.VI.00
+; Filename                     : nemesis.86p (6kb)
 ; Author(s)                    : Shiar
 ; Email Address                        : shiar0@hotmail.com
 ; ICQ                          ; #43840958
-; Web Page                     : come.to/shiar
-; Description                  : cool arcade-shoot-em-up-game (release 12/99)
-; Where to get this game       : www.ticalc.org
-; Other games by author                : N/A
+; Web Page                     : www.shiar.org
+; Description                  : cool arcade-shoot-em-up-game
+; Where to get this game       : www.shiar.org | www.ticalc.org
+; Other games by author                : Worm
 
-; ABOUT:       This source should only be used for learning practises, do not
-;              alter it, and certainly do not distribute an altered version!!
+; ABOUT:       This source should only be used for learning practises, do not
+;             alter it, and certainly do not distribute an altered version!!
 ; NOTE:                                &&& marks uncertainties or things to optimize
 
-;---------------------- nemesis.z80 start -------------------------------------
+;---------------------- nemesis.z80 start -----------------------------------
 
 #include       "asm86.h"
 #include       "ti86asm.inc"   ;standard ti86 romcalls
@@ -31,6 +30,7 @@
 #define                  psh   push    ; ^:D
 #define                  dnz   djnz    ;Dec&Jump while NonZero becomes Do w.Non-Zero
 
+;GRAPH_MEM     = $C9FA         ;display buffer
 TEXT_MEM       = _textShadow   ;167 bytes ($A7): C0F9-C1A0
 _clrWindow     = $4a86         ;a new procedure from AsmStudio86 inc. files
 _ex_ahl_bde    = $45f3
@@ -41,42 +41,36 @@ _asapvar    = $d6fc
 storepos       = _asm_exec_ram+6000            ;120 OF 165
 storepos2      = _asm_exec_ram+6200            ;141 OF 167
 
-;---------------------- in-game vars ------------------------------------------
-
-just_fired     = storepos+2            ; +2    ;counts how long a blast lasts
-curline                = storepos+2            ; +2    ;used to display SFX
-menuitem       = storepos+2            ; +2    ;used to store menu location
-hiscorepos     = storepos+2            ; +2
-RanPos         = storepos+3            ; +3    ;used for making random values
-timer          = storepos+4            ; +4    ;frame counter
-                                               ;--------YOU
-x              = storepos+5            ; +5    ;your ship's position
-y              = x+1                   ; +6    ;your y-pos
-firex          = y+1                   ; +7    ;(1 byte)
-firey          = firex+1               ; +8    ;(1 byte)
-                                       ; **
-                                               ;--------LEVEL
-eventtime      = storepos+10           ;+10    ;enemy frequency
-eventleft      = eventtime+1           ;+11    ;nr. of enemies still to come
-nextevent      = eventleft+1           ;+12    ;time to next event
-level_enemy    = nextevent+1           ;+13    ;enemy type
-level_info     = level_enemy+1         ;+14    ;info (see below)
-level_move     = level_info+1          ;+15    ;=
-level_fire     = level_move+1          ;+16
-                                       ; **
-                                               ;--------OBJECTS
+;---------------------- in-game vars ----------------------------------------
+
+just_fired     = storepos              ; +0    ;counts how long a blast lasts
+menuitem       = storepos              ; +0    ;used to store menu location
+hiscorepos     = storepos              ; +0    ;entering hiscore name
+                                       ;       ;--------YOU
+x              = storepos+1            ; +1    ;your ship's position
+y              = x+1                   ; +2    ;your y-pos
+firex          = y+1                   ; +3    ;(1 byte)
+firey          = firex+1               ; +4    ;(1 byte)
+                                       ;       ;--------LEVEL
+eventleft      = storepos+5            ; +5    ;nr. of enemies still to come
+nextevent      = eventleft+1           ; +6    ;time to next event
+level_enemy    = nextevent+1           ; +7    ;enemy type
+level_info     = level_enemy+1         ; +8    ;info (see below)
+level_move     = level_info+1          ; +9    ;=
+level_fire     = level_move+1          ;+10
+                                       ;       ;--------OBJECTS
 spacespace     = storepos+19           ;+19
 groundinfo     = spacespace+1          ;+20
 groundpos      = groundinfo+1          ;+21    $10
 ceilingpos     = groundpos+16          ;+37    $10
-                                       ; ^^    ;--------STARS
+                                       ;       ;--------STARS
 stars1         = ceilingpos+16         ;+53
 stars2         = stars1+1              ;+54
 nrstars1       = 7
 starx1         = storepos+55           ;+55
 nrstars2       = 7
 starx2         = starx1+(nrstars1*2)   ;+69
-                                       ; ^^    ;--------MULTIPLES
+                                       ;       ;--------MULTIPLES
 mx             = starx2+(nrstars2*2)   ;+83    ;position of multiple#1
 my             = mx+1                  ;+84    ;multiple y-pos
 m2x            = my+1                  ;+85
@@ -86,17 +80,15 @@ your_prevpos        = your_locpos+1         ;+88    ;save previous positions (32d)
 
 ;^-----------------------------------<1        ;-120=$78
 
-enemies                = storepos2             ;  +0   ;info about each enemy (6byt)
-enemysize      = 7
-nrenemies      = 10                            ;max. nr of enemies
+enemies                = storepos2             ;  +0   ;info about each enemy
+enemysize      = 7                             ;infobytes per enemy
+nrenemies      = 16                            ;max. nr of enemies
 
-ybullets       = enemies+(nrenemies*enemysize) ;60 bytes = 20(state,x,y)
-nrybuls                = 32                    ; +80\
-ebullets       = ybullets+(nrybuls*3)  ;+110   ;30 bytes = 10(state,x,y)
+ybullets       = enemies+(nrenemies*enemysize) ;60 bytes = 20(state,damg,x,y)
+nrybuls                = 64                    ; +80\
+ebullets       = ybullets+(nrybuls*4)  ;+110   ;30 bytes = 10(state,x,y)
 nrebuls                = 16
-
-ybuls          = ebullets+(nrebuls*3)  ;+140
-maxbullets = 32
+lvlenemies     = ebullets+(nrebuls*3)
 
 ;^-----------------------------------<2        ;-141=$8D
 ;level_info:
@@ -105,7 +97,7 @@ maxbullets = 32
 ;      [HP64] [000000:HP left 00:(00=no enemy 01=exploding 10=normal 11=moving)]
 ;      [ship type or explosion frame] [x] [y] [move] [fire]
 
-;---------------------- introduction ------------------------------------------
+;---------------------- introduction ----------------------------------------
 
         nop                    ;hello yas/ase/rascall/whathever
         jp init                ;here's the program, but first: a description
@@ -113,7 +105,7 @@ maxbullets = 32
        .dw Title               ;pointer to description (all shells)
        .dw Icon                ;pointer to YAS icon
 
-Title: .db "Nemesis v0.96 by Shiar",0
+Title: .db "Nemesis v0.97 by SHIAR",0
 
 Icon:  .db 8,1                 ;icon for YAS: width = 1byte; height = 9bytes
        .db %11100000           ; ███
@@ -125,9 +117,7 @@ Icon:       .db 8,1                 ;icon for YAS: width = 1byte; height = 9bytes
        .db %11100000           ; ███             ;recommend 80x50 screen mode
        .DB 0   ;clear stupid YAS-line
 
-;---------------------- init --------------------------------------------------
-
-level_name: .db 8,"nemesis0"
+;---------------------- init ------------------------------------------------
 
 int_handler:
        ex  af,af'
@@ -142,9 +132,8 @@ int_end:
 init:  cal BUSY_OFF            ;turns the run-indicator off, obviously
        cal _clrScrn            ;clean the screen
        xor a                   ;ld a,0
-       ld (iy+13),a            ;don't affect TEXT_MEM and don't scroll screen
+       res 2,(iy+13)           ;don't scroll the screen
        cal _flushallmenus      ;remove TI menus
-       ld (_asapvar+1),a       ;Asm( thinks it's the first time it runs Nems.
 
 FixKeys:                       ;fixes some key problems like left+down bug
        im  1
@@ -166,7 +155,7 @@ FixKeys:                    ;fixes some key problems like left+down bug
        ld  i,a
        im  2
 
-;---------------------- main menu ---------------------------------------------
+;---------------------- main menu -------------------------------------------
 
 LogoPut:
        xor a                   ;white bitmask (a=0)
@@ -177,30 +166,28 @@ AboveLogo:
        ld  (de),a              ;clear/n byte
        inc de                  ;next
        dnz AboveLogo           ;repeat for the first line
-
        ld  bc,16*19            ;logo size
        ldir                    ;display one line of logo
 
-       ld  hl,VIDEO_MEM+(16*$39)+4     ;$39 rows down, 4 cols right (4*8=$20)
-       ld  b,8                 ;draw 8x one byte = 8*8 = 64 pixels wide
+       ld  hl,16*$33+VIDEO_MEM ;$33 rows down
+       ld  b,16*7              ;draw black 7 lines
        ld  a,%11111111         ;horizontal line mask
 underline:
        ld  (hl),a              ;draw one piece of the divider-line
        inc hl                  ;move right (8 pixels = 1 byte)
        dnz underline           ;repeat
 
-       set 3,(iy+5)            ;set white on black
-       ld  hl,$3320            ;near the bottom of the screen
-       ld  (_penCol),hl
-       ld  hl,txt_about        ;display version and author (yes, that's me!)
-       cal _vputs              ;useful procedure if you want to display somtn
-       res 3,(iy+5)            ;return to default black on white
-
-       ld  hl,$3a1e            ;below previous stuff
+       ld  hl,_txt_email       ;at the very bottom of tha screen
        ld  (_penCol),hl
        ld  hl,txt_email        ;hey, my e-mail address so SEND ME SOMETHING!!
        cal _vputs              ;VERY important, so display in small font ?:}
 
+       set 3,(iy+5)            ;set white on black
+       ld  de,_txt_about       ;near the bottom of the screen
+       ld  (_penCol),de        ;hl=txt_email++=txt_about
+       cal _vputs              ;display version + me
+       res 3,(iy+5)            ;return to default black on white
+
 dispmenu:
        ld  de,$0304
        ld  (_curRow),de
@@ -242,7 +229,7 @@ menuloop:
        cp  K_DOWN
        jr  z,menuchange
        cp  K_EXIT
-       jp  z,game_over_nopop
+       jr  z,menuexit
        ld  hl,_invert
        cp  K_F1
        cal z,undo_invert
@@ -253,9 +240,13 @@ menuloop:
 
        ld  a,(menuitem)
        dec a
-       jr  nz,startnewgame
-       cal samelevel
-       jr  game_main_loop
+       cal nz,New_game
+       jp  samelevel           ;game_main_loop
+
+menuexit:
+       ld  hl,0
+       ld  (your_score),hl
+       jp  game_over
 
 menuchange:
        ld  a,(menuitem)
@@ -270,48 +261,35 @@ undo_invert
        ld  (hl),$B7 ;or a
        ret
 
-startnewgame:
-       cal New_game
-
-;------------------------------------------------------------------------------
-;---------------------- game loop ---------------------------------------------
-;------------------------------------------------------------------------------
+;----------------------------------------------------------------------------
+;---------------------- game loop -------------------------------------------
+;----------------------------------------------------------------------------
 
 game_main_loop:                        ;REPEATS FROM HERE EVERY FRAME
        ld  hl,timer            ;update time
        inc (hl)                ;increase by 1
-       ld  b,(hl)              ;new time, save for rand# upd. (no flag change)
-       jr  nz,updaterandom     ;continue when new time <> 0
+       jr  nz,Clear_screen     ;continue when new time <> 0
        ld  hl,1                ;once every 256 frames, increase score by 1
        cal scoreInc            ;do it
 
-updaterandom:
-       ld  hl,RanPos           ;random counter
-       ld  a,r                 ;add r register to randomize
-       add a,(hl)              ;add previous random value
-       add a,b                 ;even more random by adding timer
-       ld  (hl),a              ;save even more random value back
-
 Clear_screen:
        ld  hl,GRAPH_MEM        ;move from (hl) = top left
        ld  (hl),$00            ;first pixel will be copied all over the screen
        ld  de,GRAPH_MEM+1      ;(de) = next pixel, thus clearing whole screen
        ld  bc,896              ;loop 896 times = (128/8) * (64-8 for scorebar)
-       ldir                    ;clear!
+       ldir                    ;all clear!
 
-       ld  a,(timer)
-       and %11
+       ld  a,0                 ;current frame/turn 0-255
+timer =$-1
+       and %11                 ;a=0 once every 4 turns
        jr  z,movestarsdone     ;don't move stars once every 4 frames
-
        cal movestars1          ;move the stars on the FRONT layer
        cal movestars2          ;move the distant stars
-
 movestarsdone:
        ld  a,(stars1)          ;star positions (the missing byte...)
        ld  b,nrstars1          ;how many stars? now we know.
        ld  hl,starx1           ;points to the position of the stars
        cal DisplayStars        ;display front layer stars
-
        ld  a,(stars2)          ;weren't you paying attention five lines ago?
        ld  b,nrstars2          ;that many?! whow!
        ld  hl,starx2           ;and there they are
@@ -321,21 +299,15 @@ movestarsdone:
        and %00000110           ;isolate ground&ceiling
        jr  z,game_stuff        ;both non-present
        and %00000010           ;bit representing the presence of any ceiling
-       cal nz,Handle_ceiling   ;scroll the ceiling (if any)
-       cal Handle_ground       ;scroll the ground
+       cal nz,Handle_ceiling   ;scroll the ceiling (if any) +check4collision
+       cal Handle_ground       ;scroll the ground and check if we're dead
 
 game_stuff:
+       cal Handle_Ship         ;move you
        ld  a,(your_occ)        ;are you 100% OK?
        or  a                   ;a=0??
        jr  nz,_gamestuff1      ;then don't check for movements/fires/...
 
-       ld  a,(level_info)      ;the same level info
-       and %00000110           ;isolate ground&ceiling again
-       jr  z,check_keys        ;no ceiling nor ground
-       and %00000010           ;this bit will tell us if there is a ceiling
-       cal nz,CheckCeiling     ;if there is, check it
-       cal CheckGround         ;check for collision with the ground
-
 check_keys:
        ld  a,%10111111         ;function keys (MORE,EXIT,2ND,F1,F2,F3,F4,F5)
        out (1),a               ;ask for them
@@ -344,7 +316,7 @@ check_keys:
 
 check_exitkey:
        bit 6,a                 ;test bit 6 = exit-key = EXIT
-       jp  z,game_over_nopop   ;<exit> pressed, so be it
+       jp  z,game_over         ;<exit> pressed, so be it
 check_morekey:                 ;another unused label... poor compiler
        bit 7,a                 ;test bit 7 = more-key = PAUSE
        cal z,Pause             ;yes, go to pause
@@ -374,35 +346,45 @@ check_selkey:
        cal inc_weapdamage
 
 _gamestuff1:
-       cal Handle_Ship         ;move you
-       cal Handle_bullets      ;move your bullets
-       cal Handle_torp         ;move your torpedo
-
        cal Handle_enemies      ;move enemies
+
+       cal Handle_bullets      ;move your bullets + check for hits
        cal Enemy_bullets       ;move enemy bullets
+       cal Handle_torp         ;the same for your torpedo (assuming u have 1)
 
        cal Level_event         ;insert enemies
        cal Display_Screen      ;display all
-       halt                    ;delay
 
+       halt                    ;delay
        jp  game_main_loop      ;LOOP ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 inc_weapdamage:
        ld  a,0
 weapincs =$-1
        inc a
-       cp  31
-       ret nc                  ;return if increased 16 times or more already
-       ld  (weapincs),a
+       cp  97                  ;max. 96 times (=96/16=6 increases)
+       ret nc                  ;return if already maxed
+       ld  (weapincs),a        ;save new incs
 
-       ld  b,1
+       and %11110000           ;clear last 4 bits so no cf when rotating
+                               ;btw: AND resets cf
+       rra                     ;rotate acting as shift (srl a) but just 1B
+       rra
+       rra
+       rra                     ;increase once just every 16 turns
+       ld  b,a                 ;times to increase
+incthedamage:
+       add  a,1                ;increase damage for one increase
+weapdaminc =$-1
+       dnz incthedamage        ;a=total increase damage
+       ld  b,1                 ;minimal damage
 weapdamage =$-1
-       add a,b
-
-       ld  (curweapdamage),a
+       add a,b                 ;a=total damage
+       ld  (curweapdamage),a   ;safe the current damage
+       cal disp_charge
        ret
 
-;--------------------------- ground -------------------------------------------
+;--------------------------- ground -----------------------------------------
 
 Handle_ground:
        ld  a,(timer)
@@ -416,48 +398,36 @@ Handle_ground:
        ld  a,(groundinfo)      ;what kind of ground
        dec a                   ;type 1:
        jr  z,ground_tunnel     ;tunnel effect
-       jr  ground_boring
+ground_boring:
+       ld  a,(groundpos)       ;type 0
 
 ground_tunnel:
        ld  a,(groundpos+14)
-       ld  (groundpos+15),a
+       ld  d,a
        ld  hl,spacespace
 
-       ld  a,(RanPos)
-       ld  b,a
-       bit 1,a
-       jr  z,ground_previous
-       bit 2,a
-       jr  z,gtunneldown
-gtunnelup:
+       ld  bc,$201             ;range=1..3
+       cal Random              ;a=1-3
+       dec a
+       jr  z,newground         ;same if a=1
+       dec a
+       jr  z,gtunneldown       ;down if a=2
+gtunnelup:                     ;up   if a=3
        ld  a,(hl)
        or  a
-       jr  z,ground_previous   ;a>=0 (a=0 actually)
+       jr  z,newground         ;a>=0 (a=0 actually)
        inc (hl)
-       ld  a,(groundpos+15)
-       inc a
+       inc d
        jr  newground
 gtunneldown:
-       ld  a,(groundpos+15)
-       dec a
-       jr  z,ground_previous
+       ld  a,1
+       cp  d
+       jr  z,newground
+       dec d
        dec (hl)
-       jr  newground
-
-ground_previous:
-       ld  a,(groundpos+14)    ;type 1
-       jr  newground
-ground_boring:
-       ld  a,(groundpos)       ;type 0
 newground:
+       ld  a,d
        ld  (groundpos+15),a    ;save new byte on the right
-       ld  a,(hl)
-       cp  -25
-       jr  nc,Display_ground
-       ld  a,b
-       and %1
-       ld  b,0
-       jr  nz,gtunnelup
 
 Display_ground:
        ld  b,16                ;screen width
@@ -485,7 +455,6 @@ groundloopup:
        ld  b,c                 ;pop b used by groundloopup
        dnz groundloopright     ;loop right for entire screen (16x)
        pop hl \ pop hl         ;restore stack
-       ret
 
 CheckGround:                   ;check for collision with the ground
        ld  a,(x)
@@ -505,7 +474,7 @@ CheckGround:                        ;check for collision with the ground
        ld  b,5
        jp  damage_you
 
-;--------------------------- ceiling ------------------------------------------
+;--------------------------- ceiling ----------------------------------------
 
 Handle_ceiling:
        ld  a,(timer)
@@ -514,54 +483,40 @@ Handle_ceiling:
        ld  bc,15               ;scroll all 15 bytes (16th is new position)
        ld  hl,ceilingpos+1     ;from..
        ld  de,ceilingpos       ;to (one byte to the left)
-       ld  a,(de)              ;load byte on left (will be lost after scroll)
        ldir                    ;LoaDIncreaseRepeat = scroll!
 
        ld  a,(groundinfo)      ;what kind of ceiling
        dec a                   ;type 1:
        jr  z,ceiling_tunnel    ;tunnel effect
-       jr  ceiling_boring
+ceiling_boring:
 
 ceiling_tunnel:
        ld  a,(ceilingpos+14)
-       ld  (ceilingpos+15),a
+       ld  d,a                 ;d=new ceiling
        ld  hl,spacespace
 
-       ld  a,(RanPos)
-       ld  b,a
-       bit 4,a
-       jr  z,ceiling_previous
-       bit 5,a
-       jr  z,ctunnelup
-ctunneldown:
+       ld  bc,$201             ;range=1..3
+       cal Random              ;a=1-3
+       dec a
+       jr  z,newceiling        ;1:same
+       dec a
+       jr  z,ctunnelup         ;2:up
+ctunneldown:                   ;3:down
        ld  a,(hl)
-       or  a
-       jr  z,ceiling_previous
+       or  a                   ;(spacespace)=0:
+       jr  z,newceiling+2      ;keep same ceiling
        inc (hl)
-       ld  a,(ceilingpos+15)
-       inc a
+       inc d
        jr  newceiling
 ctunnelup:
-       ld  a,(ceilingpos+15)
-       dec a
-       jr  z,ceiling_previous
+       ld  a,1
+       cp  d                   ;if size=1 then don't
+       jr  z,newceiling
+       dec d
        dec (hl)
-       jr  newceiling
-
-ceiling_previous:
-       ld  a,(ceilingpos+14)   ;type 1
-       jr  newceiling
-ceiling_boring:
-       ld  a,(ceilingpos)      ;type 0
 newceiling:
+       ld  a,d
        ld  (ceilingpos+15),a   ;save the new byte
-       ld  a,(hl)
-       cp  -25
-       jr  nc,Display_ceiling
-       ld  a,b
-       and %1
-       ld  b,0
-       jr  nz,ctunneldown
 
 Display_ceiling:
        ld  b,16                ;screen width
@@ -589,7 +544,6 @@ ceilingloopdown:
        ld  b,c                 ;pop b used by groundloopup
        dnz ceilingloopright    ;loop right for entire screen (16x)
        pop hl \ pop hl         ;restore stack
-       ret
 
 CheckCeiling:                  ;check for collision with the ground
        ld  a,(x)               ;your x
@@ -609,7 +563,7 @@ CheckCeiling:                       ;check for collision with the ground
        ld  b,5
        jp  damage_you          ;otherwise you don't wanna be in that ship
 
-;--------------------------- move stars ---------------------------------------
+;--------------------------- move stars -------------------------------------
 
 DisplayStars:                  ;inputs: hl=starx# a=stars# b=nrstars#
        ld  e,(hl)
@@ -649,7 +603,7 @@ movestars_loop:
        and %00001111
        cp  9                   ;(GRAPH_MEM&%00001111)-- = $C9FAand15-1 = $A-1
        jr  nz,newstarok
-       cal Random5016
+       cal RandomY
 
 newstarok:
        ld  (ix),l
@@ -658,7 +612,7 @@ newstarok:
        dnz movestars_loop
        ret                     ;for stupid people, here's another comment...
 
-;--------------------------- pause --------------------------------------------
+;--------------------------- pause ------------------------------------------
 
 Pause:
        ld  hl,$0200            ;top left
@@ -671,7 +625,7 @@ pause:
        jr  nz,pause            ;no, wait some more
        ret                     ;continue
 
-;--------------------------- teacher ------------------------------------------
+;--------------------------- teacher ----------------------------------------
 
 Teacher:
        ld  (iy+12),5           ;enable flashing cursor
@@ -701,26 +655,25 @@ teacherans:
        jr  teacherloop
 
 
-;--------------------------- exit ---------------------------------------------
-
-quit:
-       im  1                   ;release keyfix procedure
-       ld  (iy+13),3           ;use textshadow (TEXT_MEM) and scrolling
+;--------------------------- exit -------------------------------------------
 
+quit:  im  1                   ;release keyfix procedure
+       set 2,(iy+13)           ;set back screen scrolling
+       xor a
+       ld (_asapvar+1),a       ;next Asm( run will reload the program
        ld  hl,GRAPH_MEM        ;graph-screen location
        ld  de,GRAPH_MEM+1
-       ld  (hl),0
+       ld  (hl),a
        ld  bc,1024-1           ;do it 1024 times = entire screen
        ldir
-
        jp  _clrWindow          ;as _clrLCD but also clears TEXT_MEM (like the
                                ;_clrScrn) AND also executes _homeup and ret
 
-;--------------------------- display ------------------------------------------
+;--------------------------- display ----------------------------------------
 
 Display_Screen:
-       ld  hl,GRAPH_MEM        ;from storage (top left)
-       ld  de,VIDEO_MEM        ;to screen (top left)
+       ld  hl,GRAPH_MEM        ;from buffer (top left)
+       ld  de,VIDEO_MEM        ;to real screen (top left)
        ld  c,56                ;display height = 64 bytes (minus 8 for bar)
 displayloop:
        ld  b,16                ;display width = 16 bytes (16*8bits=256pixels)
@@ -736,7 +689,7 @@ _invert:
 
        ld  hl,$396b            ;Display Score
        ld  (_penCol),hl        ;bottom right of screen
-       ld  hl,(score)
+       ld  hl,(your_score)
 
 _D_HL_DECI:                    ;------- display 5-digit value -------
        ld  de,savestr+4        ;savenr saves number string
@@ -753,7 +706,7 @@ ldhld:      cal UNPACK_HL           ;one digit of hl
 savestr:                       ;@here the score will be stored
        .db "00000",0           ;don't worry, it's just temporary
 
-;------------------------- handle ship ----------------------------------------
+;------------------------- handle ship --------------------------------------
 
 Handle_Ship:
        ld  a,(your_occ)        ;are
@@ -769,6 +722,7 @@ Handle_Ship:
        jp  z,You_die           ;yes = game over
        ret                     ;don't display anything
 
+;----move----
 ok:                            ;we are
        ld  a,%01111110         ;get arrow keys
        out (1),a               ;it's cold outside
@@ -817,7 +771,7 @@ no_left:
        jr  nc,no_right
        ld  (hl),a
 no_right:
-       ld  d,(hl)
+       ld  d,(hl)              ;d=x
        inc hl
        rr  b
        jr  c,no_up
@@ -826,12 +780,12 @@ no_right:
        jr  c,no_up             ;-1 = top of screen
        ld  (hl),a              ;save new y
 
-no_up: ld  e,(hl)
-       ld  ix,spr_ship01       ;ship sprite
+no_up: ld  e,(hl)              ;e=y
+       ld  ix,spr_ship01       ;normal ship sprite
        ld  hl,your_inv         ;invulnerable?
        ld  a,(hl)              ;load time in a
        or  a                   ;is it 0?
-       jr  z,handle_multiples  ;yes so ship = normal (display \ continue)
+       jr  z,disp_ship         ;yes so ship = normal (display \ continue)
 
        ld  a,(timer)           ;load frame nr.
        and %00000111           ;a=0 once every four frames
@@ -839,26 +793,29 @@ no_up:    ld  e,(hl)
        dec (hl)                ;decrease inv-time left
 not_time:
        and %00000100           ;a switches 0<->1 every 2 frames
-       jr  z,handle_multiples  ;show normal ship
+       jr  z,disp_ship         ;show normal ship
 inv_flicker:
-       ld  ix,spr_ship01i      ;don't display ship
-
-handle_multiples:
+       ld  ix,spr_ship01i      ;display invulnerable ship
+disp_ship:
+       psh de                  ;save your position for multiples
        cal putsprite           ;display your ship
+       pop de
+
+;----multiples----
 
+handle_multiples:
        ld  a,(your_multiples)  ;do you have multiples
        ld  b,a                 ;save a for 2nd check
        and %11                 ;no? (last two bits = nr of multiples)
        ret z                   ;then don't handle them either
 
-       ld  hl,y
        ld  a,b                 ;restore a (your_multiples)
-       and %100                ;move the multiples???
-       jr  z,mult_adv          ;nope, just let them (saves (y) in y, (x) in x)
+       and %100                ;move the multiples??? (=move bit set?)
+       jr  z,mult_adv          ;nope, just let them (saves (y)in y, (x)in x)
 
        ld  hl,your_locpos      ;location to save this position
        ld  a,(hl)              ;load a
-       inc a                   ;a=a+1
+       inc a                   ;a=a+1 (next position)
        and %00001111           ;if a>15 then a=a-16
        ld  (hl),a              ;save new a
        add a,a                 ;a=a*2
@@ -867,41 +824,44 @@ handle_multiples:
 
        ld  hl,your_prevpos     ;previous positions
        add hl,bc               ;16 turns ago
-       ld  d,(hl)              ;old x-pos
+       ld  b,(hl)              ;old x-pos
        inc hl                  ;and
-       ld  e,(hl)              ;old y-pos
-       ld  (mx),de             ;save multiple position in (mx)
-
-       ld  a,(y)               ;load new y-pos
-       ld  (hl),a              ;save it for 16 turns in the future
-       dec hl                  ;and
-       ld  a,(x)               ;load new x-pos
-       ld  (hl),a              ;save that too
+       ld  c,(hl)              ;old y-pos
+       ld  (mx),bc             ;save multiple position in (mx)
+       ld  (hl),d              ;save current pos. for 16 turns into the future
+       dec hl                  ;yes...
+       ld  (hl),e              ;...both
 
 mult_adv:
- ld de,(mx)
+       ld  de,(mx)
+       ld  a,d
+       ld  d,e
+       ld  e,a                 ;ex d,e
        ld  ix,spr_multiple     ;sprite of the multiple
        jp  putsprite           ;display it + <ret>
 
+;----explode----
+
 exploding_you:
        srl a                   ;half the framerate
        dec a                   ;first frame is 1>inc>srl>dec = 0
        ld  hl,x-1
 
-explosion_stuff:
-       rra
-       add a,a
-       add a,a
+explosion_stuff:               ;in:a=frame*2+(0 to 1); (hl)=xpos--
+       and %11111110
        add a,a
+       add a,a                 ;frame*8
        ld  c,a
-       ld  b,0
-       ld  ix,spr_explosion
-       add ix,bc
+       ld  b,0                 ;bc=a
+       ld  ix,spr_explosion    ;base sprite
+       add ix,bc               ;go to correct sprite (each spr. is 8 bytes)
        inc hl
-       ld  d,(hl)
+       ld  d,(hl)              ;load xpos
        inc hl
-       ld  e,(hl)
-       jp  putsprite
+       ld  e,(hl)              ;and y
+       jp  putsprite           ;and display it too
+
+;----hit----
 
 damage_you:                    ;damages you B points
        ld  a,(your_inv)        ;invulnerability left?
@@ -912,29 +872,13 @@ damage_you:                       ;damages you B points
        sub b                   ;decrease hp by B
        jp  m,no_armor          ;<0hp left so explode
        ld  (hl),a              ;no, so save decreased hp
-       cal disp_armor          ;and display new value
-
-       ld  a,(your_pickup)     ;how many pickups do you have?
-       dec a                   ;is the armor-icon selected
-       ret nz                  ;return if not
-
-       psh de \ psh ix         ;&&& just2Bsave
-       ld  hl,VIDEO_MEM+(16*56)
-       ld  (PutWhere),hl
-       ld  ix,spr_icon         ;if so, highlight armorIcon again
-       ld  de,$1901            ;position
-       cal putwidesprite       ;display icon
-       ld  hl,GRAPH_MEM
-       ld  (PutWhere),hl
-       pop ix \ pop de
-       ret                     ;and return
-
+       jp  disp_armor          ;and display new value
 no_armor:
        ld  a,%01               ;occ %xxxxxx01 = explode
-       ld  (your_occ),a        ;set to explode
+       ld  (your_occ),a        ;too bad, you're dead meat
        ret
 
-;------------------------- place multiples ------------------------------------
+;------------------------- place multiples ----------------------------------
 
 Place_multiples:
        ld  (mx),de             ;set last multiple-position
@@ -948,7 +892,7 @@ place_multiples:
        dnz place_multiples     ;repeat
        ret
 
-;------------------------- select upgrade -------------------------------------
+;------------------------- select upgrade -----------------------------------
 
 select:
        ld  hl,your_pickup      ;select pickups
@@ -981,10 +925,10 @@ select3:
        ld  hl,your_weapon
        ld  a,(hl)
        inc a
-       cp  10
-       jp  nc,disp_icons       ;>=10
-       ld  (hl),a
-        cal loadweapon
+       cp  maxnrweapons
+       jp  nc,disp_icons       ;weapon maxed out
+       ld  (hl),a              ;set new weapon
+        cal loadweapon         ;load it (damage and stuff)
        jp  disp_icons          ;display n return
 select4:
        dec a                   ;is it 4?
@@ -1006,7 +950,7 @@ select6:
        ld  (hl),0              ;reset pickups
        jp  disp_icons          ;display/return
 
-;------------------------- fire bullet ----------------------------------------
+;------------------------- fire bullet --------------------------------------
 
 Fire_bullet:
        ld  hl,just_fired
@@ -1022,66 +966,51 @@ Fire_bullet:
 
 fireOK:
        ld  hl,(x)              ;yes: first fire from ship position (x)
-       ld  (firex),hl          ;set firepos
        ld  a,(your_multiples)  ;any multiples?
        and %11                 ;nope?
        jr  z,fireany           ;then just fire somethin'
        cal fireany             ;and blast
-       ld  hl,(my)             ;then, fire from multiple position (mx)
-       ld  a,(mx)              ;<ex h,l>
-       ld  h,a                 ; ^^^^^^
-       ld  (firex),hl          ;set firepos
+       ld  hl,(mx)             ;then, fire from multiple position (mx)
+       dec h                   ;one up (-2 height: keeps weapons centered)
                                ;blast again and <ret>
-fireany:
+fireany:                       ;HL=(x,y)
+       ld  (firex),hl          ;set position to fire from
        cal fire_torp           ;&&&
 
        ld  a,(your_weapon)     ;do you have laser?
-       dec a                   ;1=yes
-       jr  z,fire_laser
-
-       ld  ix,weapondata-6
+       ld  ix,weapondata-6-(256*3)
        add a,a                 ;weap*2
        add a,a                 ;    *4
        add a,a                 ;    *8
        ld  c,a
-       ld  b,0
+       ld  b,3                 ;go to current weapon (bc=a)
        add ix,bc
 
-       ld  c,(ix)
-       cal fire_ybullet
-       inc ix
-       inc ix
-       ld  c,(ix)
-       xor a
-       cp  c
+fire_weapon:                   ;b=3
+       psh bc                  ;save counter
+       ld  a,(ix)              ;load this weapon
+       cp  %11110000           ;%11110000=laser
+       cal z,fire_laser        ;fire laser (will set a=0 when done)
+       or  a                   ;<>0=bullet
        cal nz,fire_ybullet
        inc ix
        inc ix
-       ld  c,(ix)
-       xor a
-       cp  c
-       cal nz,fire_ybullet
-       ret
-
-fire_torp:
-       ld  de,(firex)
-       ld  hl,torp_occ         ;torpedo...
-       ld  a,(hl)              ;load torpInfo
-       dec a                   ;do you have (unused) torpedoes?
-       ret nz                  ;nope (a must be 1)
-       ld  (hl),2              ;yes; use torpedo
-       ld  (torp_pos),de       ;save torpedo position (in de)
+       pop bc                  ;weapon counter (do 3 weapons)
+       dnz fire_weapon
        ret
 
+;-----fire LASER-----
 
-fire_laser:                    ;yes, fire that laser instead
-       ld  a,(firex)           ;a = your x-pos
-       ld  d,a
+fire_laser:
+       ld  b,0                 ;overflow counter
+       ld  hl,firex
+       ld  d,(hl)              ;d = your x-pos
+       inc hl
 
-       ld  hl,GRAPH_MEM        ;save-location
-       ld  a,(firey)           ;y-coord
-       add a,3                 ;at middle of your ship (y+3)
+       ld  a,(hl)              ;base y-coord (firey)
+       add a,(ix+1)            ;at specified offset (most likely the middle)
        ld  e,a                 ;save laser-y in e
+       psh de                  ;save unmodified (x,y)
        add a,a                 ;y*2
        add a,a                 ;y*4
        add a,a                 ;y*8
@@ -1094,11 +1023,12 @@ fire_laser:                     ;yes, fire that laser instead
        srl d                   ;X/4
        srl d                   ;X/8
        add a,d                 ;a = (Y*16+X/8) mod 256 (c set on overflow)
+
        jr  nc,_nolc            ;jump if no carry = no overflow = a<=255
        inc b                   ;a>255 so increase bc by 256
 _nolc: ld  c,a                 ;c = (Y*16+X/8) mod 256
-       add hl,bc               ;bc = Y*16+X/8
-
+       ld  hl,GRAPH_MEM        ;save-location
+       add hl,bc               ;bc = Y*16+X/8: hl=screen address
        ld  a,15                ;128/8=16=screen width ** minus one (inc a ^^)
        sub d                   ;minus x-start (d=X/8)
        ld  b,a
@@ -1106,61 +1036,65 @@ drawlaser:
        ld  (hl),%11111111
        inc hl                  ;Go to next byte
        dnz drawlaser
-
-;      ld  a,(just_fired)      ;fired for how long
-;      cp  4                   ;if 4th turn
-;      ret nz                  ;then do damage, otherwise quit
-
 handle_laser:
-       ld  a,(firex)
-       ld  d,a                 ;d was divided, so reload the laser-x
+       pop de                  ;de=(firex): x-pos unmodified
 
 check_laserhits:               ;de = (x,y)
-       ld  b,nrenemies
-       ld  hl,enemies+1
-
-laserhits:                     ;Hits with normal enemies
+       ld  b,nrenemies         ;check all enemies
+       ld  hl,enemies+1        ;enemy#1+occ/hp00
+laserhits:                     ;hits with normal enemies
        psh hl
-
-       ld  a,(hl)
-       and %00000010
+       ld  a,(hl)              ;occ+hp00
+       and %00000010           ;normal/moving occ.=%1x
        jr  z,nolashit          ;no hit when enemy_occ <> 2/3
-
        inc hl                  ;enemy type
        ld  a,(hl)
        or  a                   ;enemy #0 = pickup
        jr  z,nolashit          ;yes: don't destroy
-
        inc hl
        ld  a,(hl)              ;check x
        sub d
        jp  m,nolashit          ;no hit when enemy is left of you
-
        inc hl
        ld  a,(hl)              ;check y
        sub e
        jr  z,enemy_lashit      ;a-e=0 = laser on top line of enemy = hit
        jr  nc,nolashit         ;a-e>0 = enemy above laser = no hit
-       add a,5                 ;add enemy height
-       jp  p,enemy_lashit      ;a-e>0 = hit
-
+       add a,5                 ;add enemy height&&&
+       jp  m,nolashit          ;a-e>0 = hit
+enemy_lashit:
+       ld  a,(curweapdamage)   ;damage
+       cal enemy_hit           ;hl=enemy+y
 nolashit:
-       pop hl
+       pop hl                  ;enemy+1
        ld  a,b                 ;psh bc
        ld  bc,enemysize
        add hl,bc               ;go to next enemy
        ld  b,a                 ;pop bc
        dnz laserhits           ;check all enemies
+       xor a                   ;a=0 otherwise weird things might happen :P
+       ld  (weapincs),a        ;reset damage
        ret
 
-enemy_lashit: ;&&&before nolashit
-       cal enemy_hit
-       jr  nolashit
+;-----misc-----
+
+fire_torp:
+       ld  de,(firex)
+       ld  hl,torp_occ         ;torpedo...
+       ld  a,(hl)              ;load torpInfo
+       dec a                   ;do you have (unused) torpedoes?
+       ret nz                  ;nope (a must be 1)
+       ld  (hl),2              ;yes; use torpedo
+       ld  (torp_pos),de       ;save torpedo position (in de)
+       ret
+
+;-----fire BULLETs-----
 
 fire_ybullet:
-       ld  hl,ybullets
-       ld  de,3
-       ld  b,maxbullets
+       ld  c,a                 ;save bulletType in c
+       ld  hl,ybullets         ;check for unused bullet
+       ld  de,4
+       ld  b,nrybuls
 find_ybullet:
        ld  a,(hl)
        or  a
@@ -1172,6 +1106,9 @@ find_ybullet:
 
 found_ybullet:
        ld  (hl),c              ;use the bullet and set correct bullet-type
+       inc hl                  ;@damage
+       ld  (hl),1              ;set bullet damage
+curweapdamage =$-1
        ld  a,(firex)           ;your x-pos
        add a,5                 ;place bullet in front of you
        inc hl                  ;go to bullet-x
@@ -1186,7 +1123,7 @@ found_ybullet:
        ld  (weapincs),a        ;reset damage
        ret
 
-;------------------------ handle bullets --------------------------------------
+;------------------------ handle bullets ------------------------------------
 
 bullet_left:
        ld  a,124
@@ -1199,7 +1136,7 @@ bullet_left:
        ld  (hl),a              ;save new pos.
        ld  d,a                 ;d = X
 
-       inc hl                  ;to y-pos
+       inc hl                  ;@y-pos
        ld  a,c
        cal _shracc
        dec a
@@ -1235,62 +1172,69 @@ bullet_noymove:
        ret
 
 remove_bullet:
-       dec hl
+       pop hl                  ;cal bullet_left
+       pop hl                  ;enemy+type
        ld  (hl),0              ;dump this bullet!
-       pop hl
-       jr  next_ybullet
+       jr  next_ybullet+1      ;+1:skip pop hl at next_ybullet
 
 Handle_bullets:
        ld  hl,ybullets
-       ld  b,maxbullets
+       ld  b,nrybuls
 scan_bullets:
-       psh bc
-       psh hl
+       psh bc                  ;bullet counter
+       psh hl                  ;save enemy+type
        ld  (temp1),hl          ;needed for check_bullethits
-       ld  a,(hl)
-       inc hl
+       ld  a,(hl)              ;@bulletType
+       inc hl                  ;@damage
+       inc hl                  ;@x
 
        or  a
        jp  z,next_ybullet      ;bulletType=0 >> no bullet
 
-       ld  c,a
+       ld  c,a                 ;c=type
        and %1111
-       ld  b,a
+       ld  b,a                 ;b=0000type
        cal bullet_left         ;move bullet left
 
 display_bullet:
-       psh de
+       psh de                  ;save de =position
+       dec hl                  ;@x
+       dec hl                  ;@damage
+       ld  a,(hl)              ;bullet damage=size
        ld  hl,XLbullettable    ;pointer to first bullet
-       ld  a,(curweapdamage)   ;bullet damage=size
        srl a
        srl a                   ;per 4
-       inc a                   ;must be at least 1
-nextbulletlook:
-       inc hl                  ;next bullet
-       dec a
-       jr  nz,nextbulletlook
-       ld  a,(hl)              ;load pointer offset
        ld  d,0
-       ld  e,a                 ;convert to 16bit
+       ld  e,a                 ;->16bit (de=a)
+       add hl,de               ;point to correct bullet offset
+       ld  a,(hl)              ;load bullet offset
+       ld  e,a                 ;convert to 16bit (d=0)
        ld  ix,spr_bullet01     ;first sprite
        add ix,de               ;add offset (go to correct sprite)
-       pop de                  ;position saved
+       pop de                  ;saved position
+
+       ld  a,(ix)              ;bullet x-size
+        ld  (bulletxsize),a    ;used at check_bullethits
+       ld  a,(ix+1)            ;bullet y-size...
+       ld  (bulletysize),a     ;...too
+
        psh de                  ;but will be altered so save again
        cal putsprite           ;display bullet
-       pop de
+       pop de                  ;position (used for check_bullethits)
 
        cal check_bullethits
 
 next_ybullet:
-       pop hl
-       pop bc
+       pop hl                  ;restore enemy+type
        inc hl
        inc hl
        inc hl
+       inc hl                  ;skip type,dam,x,y: next enemy+type
+       pop bc                  ;b=counter
        dnz scan_bullets        ;next bullet (loop)
        ret
 
-;--------------------------- check bullethits --------------------------------
+;--------------------------- check bullethits -------------------------------
 
 check_bullethits:              ;INPUT: de=X,Y; (temp1)=bullet
        ld  b,nrenemies
@@ -1309,59 +1253,61 @@ hit_enemies:                    ;Hits with normal enemies
        or  a                   ;enemy #0 = pickup
        jr  z,nohit             ;yes: don't destroy
 
-       psh de
-       cal find_sprite
-       pop de
+       cal find_sprite         ;set ix to the sprite of this enemy
 
-       inc hl
+       inc hl                  ;@x
        ld  a,(hl)              ;check x
-       sub d
-       sub 5
-       jp  p,nohit
-       add a,5
-       add a,(ix)
-       jp  m,nohit
+       sub d                   ;minus bullet x-position
+       ld  b,a                 ;psh a
+       sub 5                   ;minus bullet x-size
+bulletxsize =$-1
+       jp  p,nohit             ;miss
+       ld  a,b                 ;pop a
+       add a,(ix)              ;add enemy width
+       jp  m,nohit             ;miss
 
-       inc hl
+       inc hl                  ;@y
        ld  a,(hl)              ;check y
-       sub e
-       sub 3
-       jp  p,nohit
-       add a,3
-       add a,(ix+1)
-       jp  m,nohit
-
+       sub e                   ;minus bullet y-position
+       ld  b,a                 ;psh a
+       sub 3                   ;substract bullet height
+bulletysize =$-1
+       jp  p,nohit             ;nope, missed it
+       ld  a,b                 ;pop a
+       add a,(ix+1)            ;add enemy height
+       jp  m,nohit             ;missed after all
+
+                               ;---bullet hits enemy (auch-time!)---
        psh hl
-       xor a
-       ld  (0),a               ;remove bullet
+       ld  hl,0                ;@bulletType
 temp1 =$-2
-       pop hl
-
+       ld  (hl),0              ;remove bullet
+       inc hl                  ;@damage
+       ld  a,(hl)              ;set damage
+       pop hl                  ;enemy+y
        cal enemy_hit
 nohit:
        pop hl
        ld  bc,enemysize
        add hl,bc
        pop bc
-       dnz hit_enemies ;check next enemy
+       dnz hit_enemies         ;check next enemy
        ret
 
-enemy_hit:
-       dec hl
-       dec hl
-       dec hl
-
-       ld  a,1                 ;damage to inflict
-curweapdamage =$-1
-       rla
-       rla                     ;*4
+enemy_hit:                     ;*in:a=damage;hl=enemy+y
+       add a,a                 ;a=damage to inflict
+       add a,a                 ;first 2 bits used for occ.
        ld  b,a
-       ld  a,(hl)              ;load occ
-       sub b                   ;decrease HP (if <0 then c is set)
+
+       dec hl                  ;@x
+       dec hl                  ;@type
+       dec hl                  ;@hp00 (occ)
+       ld  a,(hl)              ;load hp00
+       sub b                   ;decrease HP (if <0xx then c is set)
        ld  (hl),a              ;save (no flag-changes)
-       dec hl                  ;goto hp64; no change in c
+       dec hl                  ;@hp64; no change in c
        ld  a,(hl)              ;load; no c-change
-       sbc a,0                 ;if c then decrease a
+       sbc a,0                 ;if cf then decrease a
        ld  (hl),a              ;save back the new value
        ret nc                  ;if a>=0 then return, otherwise explode
 
@@ -1380,7 +1326,7 @@ pickupdone:
        ld  hl,1                ;increase score by one
        jp  scoreInc            ;+ret
 
-;--------------------------- handle torpedo ----------------------------------
+;--------------------------- handle torpedo ---------------------------------
 
 Handle_torp:
        ld  a,(torp_occ)
@@ -1414,7 +1360,7 @@ remove_torp:
        ld  (torp_occ),a
        ret
 
-;--------------------------- level events -------------------------------------
+;--------------------------- level events -----------------------------------
 
 Level_event:
        ld  hl,nextevent        ;time to next event     <ld  a,(nextevent)
@@ -1423,7 +1369,8 @@ Level_event:
        or  a                   ;has it reached zero?
        ret nz                  ;nope: get outta here!
 
-       ld  a,(eventtime)       ;enemy frequency (lvl)
+       ld  a,0                 ;enemy frequency (lvl)
+eventtime =$-1
        ld  (nextevent),a       ;set time to next event
        ld  hl,eventleft
        dec (hl)                ;update enemy-counter
@@ -1442,10 +1389,12 @@ Level_event:
        ret                     ;don't place any more enemies
 
 place_boss:
+       ld  a,1
+       ld  (nrlvlenemies),a    ;just one enemy: the BOSS
        ld  hl,(levelp)         ;the leveldata (including the boss)
        dec hl                  ;points to leveldata\boss\enemynr
        ld  a,(hl)              ;load it
-       ld  (level_enemy),a     ;set new enemy (boss)
+       ld  (lvlenemies),a      ;set new enemy (boss)
        dec hl                  ;points to level\boss\movement
        ld  a,(hl)              ;load
        ld  (level_move),a      ;set boss movement
@@ -1482,12 +1431,18 @@ chk_noenemy:
        ex  de,hl               ;de=hl=usable enemy
 
 place_enemy:
-       ld  a,(level_enemy)     ;enemy type to place (lvl)
+       ld  bc,0                ;0..0
+nrlvlenemies =$-1              ;=nr of enemies minus 1
+       cal Random              ;random enemy b..b+c = 0..nrenemies-1
+       ld  b,0
+       ld  c,a                 ;bc=a
+       ld  hl,lvlenemies
+       add hl,bc               ;go to a random enemy
+       ld  a,(hl)              ;load enemy nr of this mysterious random enemy
        ld  hl,XLenemyinfos-4   ;enemy "0" specs (1 before enemy #1)
        add a,a                 ;a=type*2
        add a,a                 ;a=type*4
-       ld  c,a                 ;c=type
-       ld  b,0                 ;bc = enemy nr.&&&XX
+       ld  c,a                 ;b=0; c=bc=type
        add hl,bc               ;hl = enemy specs
        ld  a,(hl)              ;load hitpoints+occ of this enemy class
        ld  (de),a              ;save occ
@@ -1504,9 +1459,7 @@ place_enemy:
        ld  (de),a              ;save enemy type
 
        inc de                  ;set x-pos
-       psh de
        cal find_sprite
-       pop de
        ld  a,128               ;appear at right edge of screen
        sub (ix)                ;minus the width of this enemy (not offscreen)
        ld  (de),a              ;= x-position (save)
@@ -1526,11 +1479,9 @@ halflure_enemy:                  ;yes (of course it is): pick one (50% lure)
 lure_enemy:                    ;2nd possibility: luring enemy
        ld  a,(y)               ;place at same y-pos as YOUR ship
        jr  ypos_OK
-
 random_enemy:
-       ld  b,e                 ;b will be added to random-value
-       cal Random50            ;make a (in a) random value 0-51
-
+       ld  bc,256*51           ;range=0..51
+       cal Random
 ypos_OK:                       ;random value successfully created
        ld  (de),a              ;save y-position
 
@@ -1546,7 +1497,7 @@ ypos_OK:                  ;random value successfully created
 ffireOK:ld  (de),a             ;save fire
        ret                     ;return
 
-;--------------------------- enemy fires --------------------------------------
+;--------------------------- enemy fires ------------------------------------
 
 Enemy_fires:                   ;de = x,y
        dec d
@@ -1597,7 +1548,7 @@ bulletok:
        ld  (hl),e              ;set y-pos
        ret
 
-;----------------------------- enemy bullets ----------------------------------
+;----------------------------- enemy bullets --------------------------------
 
 Enemy_bullets:
        ld  hl,ebullets
@@ -1696,7 +1647,7 @@ remove_ebullet:
        ld  (hl),0              ;bullet > unused
        jr  next_bullet+1       ;next bullet (SKIP THE <POP HL> = one byte)
 
-;--------------------------- handle enemies -----------------------------------
+;--------------------------- handle enemies ---------------------------------
 
 Handle_enemies:
        ld  hl,enemies+1
@@ -1777,19 +1728,15 @@ remove_enemy:
 
 exploding_enemy:
        inc hl
-       psh hl
        ld  a,(hl)
-       cal explosion_stuff     ;display explosion
-       pop hl
-
-       ld  a,(hl)
-       cp  15
+       cp  16
        jr  z,remove_enemy      ;remove when at last frame
        inc a
        ld  (hl),a              ;next frame
+       cal explosion_stuff     ;display explosion
        jr  next_enemy
 
-;--------------------------- moving enemies -----------------------------------
+;--------------------------- moving enemies ---------------------------------
 
 moving_enemy:
        ld  a,(level_move)
@@ -1906,7 +1853,7 @@ movedown:
        inc e                   ;otherwise save new position
        ret                     ;and return
 
-;--------------------------- check collision ----------------------------------
+;--------------------------- check collision --------------------------------
 
 Enemies_hit:
        ld  hl,(x)              ;e = X, d = Y
@@ -1925,16 +1872,14 @@ check_collision:
        inc hl
 
 collide_enemy:                 ;&&& include in Handle_enemy proc
-       psh de
        cal find_sprite
-       pop de
 
        inc hl
        ld  a,(hl)              ;check x match
        sub e                   ;enemy position minus yours minus 7
        jp  p,check_next
        add a,6
-       add a,(ix)
+       add a,(ix)              ;enemy width
        jp  m,check_next
 
        inc hl
@@ -1942,7 +1887,7 @@ collide_enemy:                    ;&&& include in Handle_enemy proc
        sub d                   ;same as with x-check
        jp  p,check_next
        add a,6
-       add a,(ix+1)
+       add a,(ix+1)            ;enemy height
        jp  m,check_next
        dec hl
        dec hl
@@ -1986,10 +1931,10 @@ collide:
        and %11111100
        jr  z,destroy_enemy
        ld  a,(hl)
-       sub %00000100
+       sub collidedamage
        ld  (hl),a
 collide_done:
-       ld  b,4                 ;damage
+       ld  b,collidedamage     ;damage
        cal damage_you
 
 check_next:
@@ -2001,7 +1946,7 @@ check_next:
        dnz check_collision
        ret
 
-;--------------------------- story -------------------------------------------
+;--------------------------- story ------------------------------------------
 
 storyPage:
        psh hl
@@ -2021,9 +1966,9 @@ storyLine:
        jr  z,storyLine
 
        psh hl
-       ld  hl,VIDEO_MEM
-       ld  de,GRAPH_MEM
-       ld  bc,1024
+       ld  hl,VIDEO_MEM        ;copy text
+       ld  de,GRAPH_MEM        ;to GRAPH_MEM
+       ld  bc,1024             ;entire screen
        ldir
        cal _clrLCD
        pop hl
@@ -2051,68 +1996,60 @@ dostory:
        ld  (levelp),hl                 ;set the level-pointer
        ret                             ;and return
 
-;--------------------------- SFX ---------------------------------------------
+;--------------------------- SFX --------------------------------------------
 
-CDoSFX:
-       ld  hl,VIDEO_MEM
-       ld  de,GRAPH_MEM
-       ld  bc,1024
-       ldir
-       ld  b,64
-       ld  a,-1
-
-DoSFX:                         ;ins: a=beginLine b=nrOfLines
+DoSFX:                         ;in:a=beginLine;b=nrOfLines
        ld  (curline),a
 SFXframe:
        psh bc
 
-       ld  a,(curline)         ;get line number
+       ld  a,0                 ;get line number
+curline =$-1
        inc a                   ;go to the next line
        ld  (curline),a         ;update
 
        ld  l,a
-       ld  h,0
-       add hl,hl
+       ld  h,0                 ;hl=a
        add hl,hl
        add hl,hl
        add hl,hl
+       add hl,hl               ;*16 (a pixels down=a*16)
 
        ld  b,h                 ;save hl for later
        ld  c,l
 
-       ld  de,VIDEO_MEM
+       ld  de,VIDEO_MEM        ;where to put sfx
        add hl,de               ;go to ymin
-       ld  d,h
-       ld  e,l
+       ex  de,hl               ;put into de again
 
        ld  hl,GRAPH_MEM
        add hl,bc               ;hl->logo
 
-       ld  a,(curline)         ;Calculate how many lines to draw
-       ld  c,a
-       ld  a,64
-       sub c
-       ld  b,a
+       sub 64                  ;a=a-64
+       neg                     ;a=64-a (lines from bottom)
+
+;      ld  c,a                 ;c=a=(curline)
+;      ld  a,64
+;      sub c                   ;lines from bottom
 
 SFXdisp:                       ;display this frame on screen
-       ld  a,b                 ;psh b (a will not be used)
        ld  bc,16               ;one line (=16 bytes, you'd know by now)
        ldir                    ;display (copy actually)
        ld  bc,-16              ;go up one line (not on screen)
        add hl,bc               ;so the same line will be displayed
-       ld  b,a                 ;pop b
-       dnz SFXdisp             ;repeat until whole screen is displayed
+       dec a                   ;counter
+       jr  nz,SFXdisp          ;repeat until whole screen is displayed
 
        ld  b,8
 SFXdelay:
-       halt
-       dnz SFXdelay
+       halt                    ;delay
+       dnz SFXdelay            ;8x
 
-       pop bc
+       pop bc                  ;counter
        dnz SFXframe
        ret
 
-;--------------------------- show icon ----------------------------------------
+;--------------------------- show icon --------------------------------------
 
 drawline:
        ld  (hl),a              ;draw one piece of the divider-line
@@ -2149,15 +2086,20 @@ no_torp:
        ld  de,$2901            ;icon #2
        cal putwidesprite       ;display
 
-       ld  ix,spr_icon03       ;bulletIcon
-       ld  de,$3901            ;icon #3
-       cal putwidesprite       ;display icon
+       ld  ix,spr_icon00
+       ld  a,(your_weapon)     ;ur weapon
+       dec a                   ;1=laser
+       jr  z,no_bullets
        ld  hl,$3945            ;position to display bullet-type digit
        ld  a,(your_weapon)     ;digit
        dec a                   ;minus one (1=laser)
        ld  (_penCol),hl        ;set location
        add a,'0'               ;make digit
        cal _vputmap            ;display char
+       ld  ix,spr_icon03       ;bulletIcon
+no_bullets:
+       ld  de,$3901            ;icon #3
+       cal putwidesprite       ;display icon
 
        ld  ix,spr_icon00       ;emptyIcon
        ld  a,(your_weapon)
@@ -2212,7 +2154,7 @@ armorbarclr:
        ld  c,a                 ;psh a
        srl a                   ;/2
        srl a                   ;/4
-       srl a                   ;/8: don't display last 2 bits of a (later)
+       srl a                   ;/8: don't display last 3 bits of a (later)
        jr  z,noarmorbar        ;if a=0 then it would loop 256x so skip it
        ld  b,a                 ;loop b=a times
 armorbar:                      ;starting at ($39*16)+VIDEO_MEM
@@ -2234,6 +2176,40 @@ armorbarready:                   ;               (an if B=3 then a=%11100000)
        ld  (hl),a              ;draw this last byte
        ret
 
+disp_charge:
+       ld  hl,(58*16)+VIDEO_MEM+3
+       ld  b,3
+chargebarclr:
+       dec hl
+       ld  (hl),0
+       dnz chargebarclr
+       ld  a,(weapincs)        ;load bar size (0-80)
+       srl a                   ;half the size (0-40)
+       srl a                   ;again half that size (0-20 pixels)
+       ld  c,a                 ;psh a
+       srl a                   ;/2
+       srl a                   ;/4
+       srl a                   ;/8: don't display last 3 bits of a (later)
+       jr  z,nochargebar       ;if a=0 then it would loop 256x so skip it
+       ld  b,a                 ;loop b=a times
+chargebar:                     ;starting at ($39*16)+VIDEO_MEM
+       ld  (hl),%11111111      ;draw a piece of the bar
+       inc hl                  ;next position
+       dnz armorbar            ;loop it b times
+nochargebar:
+       ld  a,c                 ;pop a
+       and %111                ;display last bits of chargebar
+       ret z                   ;if armor=0 then bit = %00000000 (don't disp)
+       ld  b,a                 ;into B
+       xor a                   ;bit = %00000000
+chargebarbit:
+       scf                     ;set carry flag
+       rra                     ;rotates A right and sets bit 7 (c-flag)
+       dnz chargebarbit        ;repeat B times (so if B=6 then a=%11111100)
+chargebarready:                        ;               (an if B=3 then a=%11100000)
+       ld  (hl),a              ;draw this last byte
+       ret
+
 disp_lives:
        ld  hl,$3A00            ;display Lives
        ld  (_penCol),hl        ;bottom left
@@ -2249,62 +2225,52 @@ disp_lives:
        dec hl \ dec hl
        jp  _vputs              ;display on screen +ret
 
-;--------------------------- proc ---------------------------------------------
+;--------------------------- proc -------------------------------------------
+
+Random:                                ;a=c<random<b+c; destr:none
+       ld a,r
+       add a,0                 ;increase last value by 0-255 (r)
+ranseed =$-1
+       ld (ranseed),a          ;save for next time
+       cp b                    ;a>=b
+       jr nc,Random            ;then add again
+       add a,c                 ;a<b; a=a+c
+       ret
 
-Random5016:
-       cal Random50            ; a = 0..50
-       inc a                   ; a = 1..51
+RandomY:                       ;HL = random Y 0..50 right side ((1..51)*16-1)
+       psh bc
+       ld  bc,1+50*256         ;range=1..51
+       cal Random              ;a = 1..51
        ld  h,0
        ld  l,a                 ;hl = 1..51
-       add hl,hl               ;hl = 1..51 * 2
-       add hl,hl               ;hl = 1..51 * 4
-       add hl,hl               ;hl = 1..51 * 8
+       add hl,hl
+       add hl,hl
+       add hl,hl
        add hl,hl               ;hl = 1..51 * 16 (left side at random y)
-       dec hl                  ;hl = 1..51 * 16 (" at right side of screen)
+       dec hl                  ;hl = 0..50 * 16 (" at right side of screen)
        ld  de,GRAPH_MEM
        add hl,de               ;position on screen
+       pop bc
        ret
 
-Random50:
-       cal Random
-       cp  51                  ;y may not be more than 50
-       ret c                   ;OK if a<51
-       and %00111111           ;a = 0..63
-       sub 13                  ;a = -13..50
-       ret nc                  ;OK if a>=0
-       add a,13+(50-12)        ;a = -13..-1 >=> 0..12 >=> 39..50
-       ret
-
-Random:
-       ld  a,(RanPos)          ;a handy random-var.
-       ld  hl,x                ;add your x-coord for randomness
-       adc a,(hl)
-       inc hl                  ;add your y-coord for randomness
-       adc a,(hl)
-       ld  (RanPos),a          ;save altered random-var
-       ret                     ;RanPos also in #a
-
 scoreInc:
        psh bc
-       ld  bc,(score)
+       ld  bc,(your_score)
        add hl,bc
-       ld  (score),hl
+       ld  (your_score),hl
        pop bc
        ret
 
-find_sprite:                   ;destroyed: de ix
+find_sprite:                   ;in:hl=enemy+type | out:ix=sprite to enemy
+       psh de
        psh hl
-       ld  e,(hl)              ;e = enemy type
+       ld  e,(hl)              ;e = enemy offset/2
        ld  d,0                 ;de = e
-       ld  hl,XLenemytable     ;hl = @sprites offset-table
-       add hl,de               ;points to offset of current enemy offset
-       ld  e,(hl)              ;de = @enemy offset
-       ld  d,0
-
-       ld  ix,XLsprenemies     ;first enemy sprite
+       ld  ix,spr_enemy00      ;first enemy sprite
        add ix,de               ;add offset for current enemy
        add ix,de               ;twice (offset stored as offset/2)
        pop hl
+       pop de
        ret
 
 BLACKLCD:
@@ -2316,63 +2282,28 @@ BLACKLCD:
        set 3,(iy+5)            ;set white on black
        ret
 
-waitnokeypressed:
-       halt \ halt
-       cal GET_KEY
-       or  a
-       jr  nz,waitnokeypressed
+releasekeys:
+       halt
+       ld  a,%10000000         ;all key-masks
+       out (1),a
+       in  a,(1)
+       inc a                   ;cp %11111111 (no keys pressed)
+       jr  nz,releasekeys      ;keep waitin
+       cal GET_KEY             ;clear buffer
        ret
 
-Decompress:                    ;hl=source(compressed) de=dest(decompressed)
-       ld  a,(hl)
-       bit 7,a
-       jr  z,compressed
-       inc hl
-       and %01111111
-       ld  b,0
-       ld  c,a
-       ldir
-       jr  Decompress
-compressed:
-       psh af
-       or  %11111100
-       ld  b,a
-       inc hl
-       ld  c,(hl)
-       inc hl
-       pop af
-       and %01111100
-       rrca
-       rrca
-       or  a
-       ret z
-       psh hl
-       ld  h,d
-       ld  l,e
-       add hl,bc
-       inc a
-       inc a
-       ld  b,0
-       ld  c,a
-       ldir
-       pop hl
-       jr  Decompress
-
-;--------------------------- game over / new game / death ---------------------
+;--------------------------- game over / new game / death -------------------
 chartable:
-       .db 0,"!<>^",0,0,0,0
-       .db 0,"xtoje0",0        ;enter..clear
-       .db " wsnid9",0         ;(-)..custom
-       .db "zvrmhc8",0         ;dot..del
-       .db "yuqlgb7x"          ;0..xvar
-       .db 0,"-pkfa6'"         ;on..alpha
-       .db "54321.",0,0        ;F5..more
-
-own_name:
-       .db 7,"nemesis"
+       .db 0,".<>!",0,0,0,0  ;down,L,R,up
+       .db 0,"xtoje0",0      ;enter..clear
+       .db " wsnid9",0       ;(-)..custom
+       .db "zvrmhc8",0       ;dot..del
+       .db "yuqlgb7#"        ;0..xvar
+       .db $D9,"-pkfa6'"     ;on..alpha
+       .db "54321*",0,$D0    ;F5..more
 
 save_hi:
-       ld  hl,own_name-1       ;find own variable
+       ld  hl,_asapvar         ;find own variable
        rst 20h                 ;cal _ABS_MOV10TOOP1
        rst 10h                 ;cal _FINDSYM
        ret c                   ;not found? who cares...
@@ -2391,7 +2322,7 @@ save_hi:
        jp  _RAM_PAGE_1
 
 save_lvl:
-       ld  hl,own_name-1       ;find own variable
+       ld  hl,_asapvar         ;find own variable
        rst 20h                 ;cal _ABS_MOV10TOOP1
        rst 10h                 ;cal _FINDSYM
        ret c                   ;not found? who cares...
@@ -2409,20 +2340,18 @@ save_lvl:
        cal _mm_ldir            ;save done (cal \ ret)
        jp  _RAM_PAGE_1
 
-game_over:
-       pop hl                  ;=ret (game_over was called from a procedure)
-game_over_nopop:
+game_over:                     ;stack=+0
        cal BLACKLCD            ;clear screen
-       cal waitnokeypressed
        ld  hl,$0603
        ld  (_curRow),hl        ;center
        ld  hl,txt_gameover
        cal _puts               ;display "GAME OVER"
+       cal releasekeys         ;wait for all keys to be released
 
        ld  hl,$0007
        ld  (_curRow),hl
 
-       ld  de,(score)
+       ld  de,(your_score)
        ld  hl,(hiscore)
        cal CP_HL_DE
        jr  nc,no_hiscore
@@ -2467,7 +2396,7 @@ nokeypressed:
        ld  (ix),a
        cal _putc
        inc ix
-       cal waitnokeypressed
+       cal releasekeys
        jr  enter_name_loop
 
 backup:
@@ -2501,7 +2430,7 @@ hiscoredone:
        xor a                   ;clear a (Ahl will be displayed)
        ld  hl,$1006            ;bottom-1 right
        ld  (_curRow),hl        ;set
-       ld  hl,(score)          ;your score
+       ld  hl,(your_score)     ;your score
        cal _dispahl            ;display it (a=0)
 
        ld  hl,$314b            ;bottom-1 right before score ^^
@@ -2530,17 +2459,17 @@ restore_line:
        cal _getkey             ;wait for keypress
        jp  quit                ;restore some things and return to TI-OS/shell
 
-New_game:
+New_game:                      ;stack must be +1 (so change the jp in cal :)
        xor a                   ;ld a,0
-       ld  (score),a           ;reset score
-       ld  (score+1),a         ;reset score (0)
+       ld  (your_score),a      ;reset score
+       ld  (your_score+1),a    ;reset score (0)
        ld  (torp_occ),a        ;no torpedoes
        ld  (your_weapon),a     ;no laser
        ld  (your_pickup),a     ;reset pickups
        ld  (your_multiples),a  ;no multiples
        inc a                   ;ld a,1
        ld  (level),a           ;reset level nr (#1)
-       ld  hl,XLlevelsdata     ;set level pointer to level#1
+       ld  hl,level00          ;set level pointer to level#1
        ld  (levelp),hl         ;reset level pointer
        inc a                   ;ld a,2
        ld  (your_weapon),a     ;default weapon
@@ -2548,18 +2477,21 @@ New_game:
        ld  (your_lives),a      ;3 lives (4 will be decreased @ You_die)
        ld  (pickuptimer),a     ;next pickup after 4 enemies destroyed
 
-You_die:
+You_die:                       ;stack must be +1
+       pop hl                  ;restore stack
        ld  a,12
        ld  (your_armor),a      ;12 HPs/shields
        ld  a,(your_lives)      ;load lives left
        dec a                   ;decrease lives
        ld  (your_lives),a      ;if lives=0ffh GO
-       jp  c,game_over
+       inc a                   ;if -1 then zf set now
+       jp  z,game_over         ;and game's over
        jr  samelevel
 
-;--------------------------- next level ---------------------------------------
+;--------------------------- next level -------------------------------------
 
-Next_level:
+Next_level:                    ;stack must be +1
+       pop hl
        ld  a,(your_armor)      ;load current armor
        cp  25-8                ;may not become >=25
        jr  c,addok             ;ok then just add 8
@@ -2582,7 +2514,10 @@ addok:
        cal scoreInc            ;update score
 
        ld  hl,(levelp)         ;level pointer
-       ld  bc,5+32+4+4         ;advance one level
+       ld  c,0                 ;advance one level
+       ld  b,(hl)
+       add hl,bc               ;passed the enemies
+       ld  b,7+32+2
        add hl,bc               ;update to point to next level
        ld  (levelp),hl         ;save
 
@@ -2595,16 +2530,20 @@ samelevel:
        cp  (hl)
        cal z,dostory
 
-       ld  a,(hl)              ;load new level-enemy type
-       ld  (level_enemy),a     ;set level-enemy
+       ld  a,(hl)              ;number of (different) enemies in this level
        inc hl
+       ld  c,a
+       ld  (nrlvlenemies),a    ;set nr of enemies-1
+       ld  b,0                 ;bc=c so we can use ldir
+       ld  de,lvlenemies       ;table of enemies
+       ldir                    ;load enemies to table
        ld  a,(hl)              ;load new appearance-time
        ld  (eventtime),a       ;set
        inc hl
        ld  a,(hl)              ;load nr of enemies in this level
        ld  (eventleft),a       ;set nr of events left
        inc hl
-       ld  a,(hl)              ;
+       ld  a,(hl)
        ld  (level_info),a      ;
        inc hl
        ld  a,(hl)              ;movement of enemies in this level
@@ -2615,14 +2554,12 @@ samelevel:
 
        inc hl
        ld  de,spacespace
-       ld  bc,17+17+2
+       ld  c,17+17+2           ;b=0
        ldir
 
        ld  ix,starx1
        ld  b,nrstars1
        cal placestars
-       ld  hl,RanPos
-       inc (hl)
        ld  ix,starx2
        ld  b,nrstars2
        cal placestars
@@ -2633,11 +2570,9 @@ samelevel:
        ld  (hl),a              ;reset your ship (not exploding)
        inc hl                  ;hl = your_inv
        ld  (hl),25             ;set 25*4=100 frames invulnerable
-       ld  hl,x                ;begin position x=...
-       ld  (hl),a              ;...=a=0=left
-       inc hl                  ;y=...
-       ld  a,24                ;...=24=middle
-       ld  (hl),a              ;your y
+       ld  de,$1800
+       ld  (x),de              ;begin position (x,y)
+       cal Place_multiples     ;place all multiple-positions at that (0,24)
 
        ld  a,(torp_occ)
        or  a                   ;no torpedoes?
@@ -2645,60 +2580,64 @@ samelevel:
        ld  a,1                 ;if so, set to "ready to fire" (=1)
 torpsclear:
 
-       ld  de,$0018            ;x=0, y=24 (like you..)
-;      cal Place_multiples     ;place all multiple-positions at (0,24)
-
        ld  hl,enemies          ;remove all enemies and bullets
        ld  (hl),0              ;clear first byte
        ld  de,enemies+1        ;copy this to the next byte
-       ld  bc,(nrenemies*enemysize)+((nrybuls+nrebuls)*3)-1
+       ld  bc,(nrenemies*enemysize)+(nrybuls*4)+(nrebuls*3)-1
        ldir                    ;clear enemies + bullets (y/e)
 
-;--------------------------- setup game ---------------------------------------
+;--------------------------- setup game -------------------------------------
 
 game_setup:
-       cal BLACKLCD
-       ld  hl,$0703
-       ld  (_curRow),hl        ;center
+       cal BLACKLCD            ;white on black
        ld  hl,txt_level
+       ld  de,$0703
+       ld  (_curRow),de        ;center
        cal _puts               ;display "LEVEL "
 
-       ld  a,(level)
+       ld  a,(level)           ;current level
        ld  l,a
-       ld  h,$00
-
-       cal UNPACK_HL
-       add a,'0'
-       ld  b,a
-       cal UNPACK_HL
-       add a,'0'
+       ld  h,0                 ;in hl
+       cal UNPACK_HL           ;create first digit
+       add a,'0'               ;0-9
+       ld  b,a                 ;into b
+       cal UNPACK_HL           ;second digit
+       add a,'0'               ;0-9
        cal _putc               ;display second digit
        ld  a,b
        cal _putmap             ;display first digit
 
-       ld  hl,$0904
-       ld  (_curRow),hl        ;display lives left below level nr
        ld  hl,txt_lives        ;bar text: "Lx0"...
+       ld  de,$0904
+       ld  (_curRow),de        ;display lives left below level nr
+       cal _puts
        ld  a,(your_lives)      ;lives left
-       add a,'0'               ;make value
-       ld  (txt_lives+3),a     ;add to text
-       cal _puts               ;display the string
-       res 3,(iy+5)            ;set white on black
+       add a,'0'               ;make value 0='0'
+       cal _putc
+
+       cal releasekeys         ;wait for user to release all keys
+       ld  hl,txt_savekey      ;"Press [F1] to save"
+       ld  de,$3A46            ;bottom-right
+       ld  (_penCol),de
+       cal _vputs
 
+       res 3,(iy+5)            ;set white on black
        cal _getkey             ;wait for keypress
        cp  kF1
        cal z,save_lvl
 
        cal _clrLCD             ;clear screen
-       jp  disp_icons          ;display bottom icons +ret
+       cal disp_icons          ;display bottom icons +ret
+       jp  game_main_loop
 
 placestars:
-       cal Random5016          ;a = (0..50)*16 = random y-pos
+       cal RandomY             ;a = random y-pos 1..bottom
        ld  a,b                 ;a =  b = star nr. = 1..7
        add a,a                 ;a = 2b = 2..14
        ld  d,0
        ld  e,a                 ;de = a = 2-14
-       add hl,de               ;add to random y => random pos anywhere
+       or  a
+       sbc hl,de               ;substract from random y => random pos anywhere
 
        ld  (ix),l              ;save x-pos (l)
        ld  (ix+1),h            ;save y-pos (h)
@@ -2719,11 +2658,11 @@ loadweapon:
        ld  (weapdamage),a      ;damage of bullets
         inc hl
         ld  a,(hl)
-;        ld  (weapdaminc),a    ;damage increase
+        ld  (weapdaminc),a     ;damage increase
        ret
 
-;--------------------------- putsprite ----------------------------------------
-;--------------------------- de =(X,Y) ----------------------------------------
+;--------------------------- putsprite --------------------------------------
+;--------------------------- de =(X,Y) --------------------------------------
 
 offsets_table:
        .db $80,$40,$20,$10,8,4,2,1
@@ -2780,7 +2719,7 @@ _notedge:
        dnz _oloop
        ret                     ;<jp>s are used instead of <jr> = faster
 
-;--------------------------- putbigsprite -------------------------------------
+;--------------------------- putbigsprite -----------------------------------
 
 putwidesprite:
        ld  a,d
@@ -2852,78 +2791,95 @@ wover_1:
        dnz woloop
        ret
 
-;------------------------------------------------------------------------------
-;------------------------------- sprites --------------------------------------
-;------------------------------------------------------------------------------
+;----------------------------------------------------------------------------
+;------------------------------- sprites ------------------------------------
+;----------------------------------------------------------------------------
 
 spr_ship01:
        .db 7,7         ;ship alpha class
-       .db %01111000   ;  ████
-       .db %11100000   ; ███
-       .db %01111100   ;  █████
-       .db %11110010   ; ████  █
-       .db %01111100   ;  █████
-       .db %11100000   ; ███
-       .db %01111000   ;  ████
+       .db %01111000   ; ████
+       .db %11100000   ;███
+       .db %01111100   ; █████
+       .db %11110010   ;████  █
+       .db %01111100   ; █████
+       .db %11100000   ;███
+       .db %01111000   ; ████
 spr_ship01i:
-       .db 7,7         ;ship alpha class
-       .db %01010000   ;  █ █
-       .db %10100000   ; █ █
-       .db %01010100   ;  █ █ █
-       .db %10100010   ; █ █   
-       .db %01010100   ;  █ █ █
-       .db %10100000   ; █ █
-       .db %01010000   ;  █ █
+       .db 8,7
+       .db %01111010   ; ████ █
+       .db %11100001   ;███    █
+       .db %01111101   ; █████ █
+       .db %11110011   ;████  █
+       .db %01111101   ; █████ █
+       .db %11100001   ;███    █
+       .db %01111010   ; ████ █
 
 spr_ship02:
-;      .db 7,7         ;ship beta class
-;      .db %11100000   ; ███
-;      .db %11110000   ; ████
-;      .db %01111100   ;  █████
-;      .db %01110010   ;  ███  █
-;      .db %01111100   ;  █████
-;      .db %11110000   ; ████
-;      .db %11100000   ; ███
+       .db 7,7         ;ship beta class
+       .db %11100000   ;███
+       .db %11110000   ;████
+       .db %01111100   ; █████
+       .db %01110010   ; ███  █
+       .db %01111100   ; █████
+       .db %11110000   ;████
+       .db %11100000   ;███
 spr_ship02i:
-;      .db 7,7         ;ship beta class
-;      .db %01000000   ;  █
-;      .db %10100000   ; █ █
-;      .db %01010100   ;  █ █ █
-;      .db %00100010   ;   █   █
-;      .db %01010100   ;  █ █ █
-;      .db %10100000   ; █ █
-;      .db %01000000   ;  █
-
-spr_multiple:
-       .db 6,4         ;multiples
-       .db %01111000   ;  ████
+       .db 8,7
+       .db %11100010   ;███   █
+       .db %11110001   ;████   █
+       .db %01111101   ; █████ █
+       .db %01110011   ; ███  ██
+       .db %01111101   ; █████ █
+       .db %11110001   ;████   █
+       .db %11100010   ;███   █
+
+spr_ship03:
+       .db 7,7         ;ship gamma class
+       .db %11111000   ;█████
+       .db %01100000   ; ██
+       .db %11111100   ;██████
+       .db %11100110   ;███  ██
+       .db %11111100   ;██████
+       .db %01100000   ; ██
+       .db %11111000   ;█████
+spr_ship03i:
+       .db 8,7
+       .db %11111010   ;█████ █
+       .db %01100001   ; ██    █
+       .db %11111101   ;██████ █
+       .db %11100111   ;███  ███
+       .db %11111101   ;██████ █
+       .db %01100001   ; ██    █
+       .db %11111010   ;█████ █
+
+spr_ship04:
+       .db 7,7         ;ship delta class
+       .db %11000000   ; ██
+       .db %11110000   ; ████
        .db %11111100   ; ██████
+       .db %01100010   ;  ██   █
        .db %11111100   ; ██████
-       .db %01111000   ;  ████
-
-spr_bullet01:
-       .db 5,3         ;your bullets
-       .db %00110000   ;   ░▒▓█▒
-       .db %11111000   ; ░▒▓████▒
-       .db %00110000   ;   ░▒▓█▒
-spr_bullet02:
-       .db 5,3
-       .db %11110000   ; ░▒▓███▒
-       .db %11111000   ; ░▒▓████▒
-       .db %11110000   ; ░▒▓███▒
-spr_bullett1:
-       .db 4,3         ;▒▒▒
-       .db %11100000   ;▒███
        .db %11110000   ; ████
-       .db %01110000   ;  ███
+       .db %11000000   ; ██
+spr_ship04i:
+       .db 8,7
+       .db %11000010   ; ██    █
+       .db %11110001   ; ████   █
+       .db %11111101   ; ██████ █
+       .db %01100011   ;  ██   ██
+       .db %11111101   ; ██████ █
+       .db %11110001   ; ████   █
+       .db %11000010   ; ██    █
 
-spr_bullete1:
-       .db 4,3         ;enemy bullets
-       .db %01100000   ;  ▒█▓▒░
-       .db %11110000   ; ▒███▓▒░
-       .db %01100000   ;  ▒█▓▒░
+spr_multiple:
+       .db 6,5         ;multiples
+       .db %01111000   ;  ████
+       .db %11001100   ; ██  ██
+       .db %10000100   ; █    █
+       .db %11001100   ; ██  ██
+       .db %01111000   ;  ████
 
-;---------------------------------------- explosion -------------------------------------------
+;-------------------------------- explosion ---------------------------------
 
 spr_explosion:
        .db 8,6         ;1
@@ -2999,17 +2955,126 @@ spr_yexplosion:
        .db %00000000   ;
        .db %00000000   ;
 
-;--------------------------------------- bar -----------------------------------
-
-spr_iconhalf:
-       .db 16,7        ;selected .......:
-       .db %11111111           ; ████████
-       .db %00000001           ;        █
-       .db %00000001           ;        █
-       .db %00000001           ;        █
-       .db %00000001           ;        █
-       .db %00000001           ;        █
-       .db %11111111           ; ████████
+;--------------------------------- bullets ----------------------------------
+
+spr_bullet01:
+       .db 2,1
+       .db %11000000   ;▒██
+spr_bullet02:
+       .db 4,2
+       .db %11110000   ;▒████
+spr_bullet03:
+       .db 2,2
+       .db %11000000   ;▒██
+       .db %11000000   ;▒██
+spr_bullet04:
+       .db 3,2
+       .db %11100000   ;▒███
+       .db %11100000   ;▒███
+spr_bullet05:
+       .db 4,3
+       .db %01100000   ; ▒██
+       .db %11110000   ;▒████
+       .db %01100000   ; ▒██
+spr_bullet06:
+       .db 5,3
+       .db %00110000   ;  ▒██
+       .db %11111000   ;▒█████
+       .db %00110000   ;  ▒██
+spr_bullet07:
+       .db 5,3
+       .db %01110000   ; ▒███
+       .db %11111000   ;▒█████
+       .db %01110000   ; ▒███
+spr_bullet08:
+       .db 5,3
+       .db %11110000   ;▒████
+       .db %11111000   ;▒█████
+       .db %11110000   ;▒████
+spr_bullet09:
+       .db 5,4
+       .db %00010000   ;   ▒█
+       .db %10111000   ;▒█▒███
+       .db %01111000   ; ▒████
+       .db %00010000   ;   ▒█
+spr_bullet10:
+       .db 6,4
+       .db %00111000   ;  ▒███
+       .db %01111100   ; ▒█████
+       .db %11111100   ;▒██████
+       .db %00110000   ;  ▒██
+spr_bullet11:
+       .db 7,5
+       .db %00011000   ;   ▒██
+       .db %11111100   ;▒██████
+       .db %00111110   ;  ▒█████
+       .db %01111100   ; ▒█████
+       .db %00011000   ;   ▒██
+spr_bullet12:
+       .db 7,6
+       .db %00110000   ;  ▒██
+       .db %11111100   ;▒██████
+       .db %00111110   ;  ▒█████
+       .db %01111110   ; ▒██████
+       .db %11111100   ;▒██████
+       .db %00111000   ;  ▒███
+spr_bullet13:
+       .db 8,8
+       .db %00111100   ;  ▒████
+       .db %11111110   ;▒███████
+       .db %01111111   ; ▒███████
+       .db %00011111   ;   ▒█████
+       .db %01111111   ; ▒███████
+       .db %11111110   ;▒███████
+       .db %00111100   ;  ▒████
+spr_bullett1:
+       .db 4,3         ;▒▒▒
+       .db %11100000   ;▒███
+       .db %11110000   ; ████
+       .db %01110000   ;  ███
+
+spr_bullete1:
+       .db 4,3         ;enemy bullets
+       .db %01100000   ; ██▒
+       .db %11110000   ;████▒
+       .db %01100000   ; ██▒
+
+XLbullettable:
+       .db (spr_bullet01-spr_bullet01) ;0
+       .db (spr_bullet02-spr_bullet01) ;4
+       .db (spr_bullet03-spr_bullet01) ;8
+       .db (spr_bullet04-spr_bullet01) ;12
+       .db (spr_bullet05-spr_bullet01) ;16
+       .db (spr_bullet06-spr_bullet01) ;20
+       .db (spr_bullet07-spr_bullet01) ;24
+       .db (spr_bullet08-spr_bullet01) ;28
+       .db (spr_bullet09-spr_bullet01) ;32
+       .db (spr_bullet10-spr_bullet01) ;36
+       .db (spr_bullet11-spr_bullet01) ;40
+       .db (spr_bullet12-spr_bullet01) ;44
+       .db (spr_bullet13-spr_bullet01) ;48
+       .db (spr_bullet13-spr_bullet01) ;52
+       .db (spr_bullet13-spr_bullet01) ;56
+       .db (spr_bullet13-spr_bullet01) ;60
+
+;format:[min.damage] [dam.inc] [0000:direction 0000:speed] [offset]
+;damage = min.damage + dam.inc*incs (0<=incs<=6)
+maxnrweapons = 8+1
+weapondata:
+       .db 1,1,%11110000,0,%11110000,6,%00000000,0     ;LASER
+       .db 1,1,%00000010,2,%00000000,0,%00000000,0     ;single fire
+       .db 3,1,%00000011,2,%00000000,0,%00000000,0     ;fast single
+       .db 1,1,%00000010,0,%00000010,5,%00000000,0     ;double
+       .db 1,1,%00010010,2,%00110010,2,%01000010,2     ;triple
+       .db 3,2,%00010011,2,%00110011,2,%01000011,2
+       .db 5,3,%00010011,2,%00110011,2,%01000100,2
+       .db 7,4,%00010100,2,%00110100,2,%01000100,2
+       .db 12,5,%00010110,2,%00110110,2,%01000110,2
+
+collidedamage = 4
+
+;------------------------------------ bar -----------------------------------
+
 spr_icon:
        .db 16,7        ;selected .......:.......:
        .db %11111111,%11111111 ; ████████████████
@@ -3077,37 +3142,29 @@ spr_dividerline:
        .db 8,7
        .db 128,128,128,128,128,128,128 ;128 = %10000000
 
-;-------------------------- weapondata ----------------------------------------
+;---------------------------- texts -----------------------------------------
 
-;format:[unused] [ybuls(max.bullets)] [0000:direction 0000:speed] [offset]
-weapondata:
-       .db 2,1,%00000010,2,%00000000,0,%00000000,0     ;single fire
-       .db 2,1,%00000011,2,%00000000,0,%00000000,0     ;fast single
-       .db 16,2,%00000010,0,%00000010,5,%00000000,0    ;double
-       .db 16,1,%00010010,2,%00110010,2,%01000010,2    ;triple
-       .db 16,1,%00010011,2,%00110011,2,%01000011,2
-       .db 16,1,%00010011,2,%00110011,2,%01000100,2
-       .db 16,1,%00010100,2,%00110100,2,%01000101,2
-       .db 16,1,%00010100,2,%00110100,2,%01000101,2
-
-;---------------------------- texts -------------------------------------------
-
-txt_about:     .db " v0.96.A30",127,"by Shiar",0
-txt_email:     .db "shiar0@hotmail.com",0
+txt_email:     .db "www.shiar.org ",127 ;title screen
+               .db " shiar0@hotmail.com",0
+_txt_email = $3A01 ;$3A1E=just email
+txt_about:     .db " v0.97.625 ",127," by Shiar",0 ;right behind txt_email
+_txt_about = $331F
 txt_menu1:     .db "NEW GAME",0
 txt_menu2:     .db "CONTINUE",0
 
-txt_level:     .db "LEVEL ",0
-txt_gameover:  .db "GAME OVER!",0
+txt_level:     .db "LEVEL ",0 ;new level screen
+txt_lives:     .db   "Lx0",0
+txt_savekey:   .db "Press [F1] to save",0
+
+txt_gameover:  .db "GAME OVER!",0 ;game over screen
 txt_score:     .db "Score",0
 txt_hiscore:   .db "Hiscore",0
-txt_lives:     .db "Lx0?",0
 
-txt_pressenter:        .db "Enter to continue",0
-txt_teacher:   .db "(2",Lpi,"*.95)/sin 13",0
+txt_pressenter:        .db "Enter to continue",0 ;pause
+txt_teacher:   .db "(2",Lpi,"*.95)/sin 13",0 ;boss
 txt_teacherans:        .db Lneg,"14.2063168184",0
 
-;---------------------------- save data ---------------------------------------
+;---------------------------- save data -------------------------------------
 
 PutWhere       .dw GRAPH_MEM           ;where to put the wide sprites
 laserlasts     .db 5
@@ -3119,11 +3176,11 @@ storehi_end:
 
 storesave_start:
 level          .db $01                 ;level number
-levelp         .dw XLlevelsdata        ;pointer to level data
+levelp         .dw level01             ;pointer to level data
 pickuptimer    .db $04                 ;counts when to place a pickup
-score          .dw $0000
+your_score     .dw $0000
 
-your_pickup    .db $00
+your_pickup    .db $04
 your_occ       .db $00                 ;0=normal 1..16=exploding
 your_inv       .db $00                 ;invincibility left
 your_armor     .db $0a                 ;HP left
@@ -3136,9 +3193,9 @@ torp_pos  .dw $0000               ;torpedo position (x,y)
 storesave_end:
 
 
-;XLlevelsdata:----------------------------------------------------------------
-XLlevelsdata:
+;XLlevelsdata:---------------------------------------------------------------
 
+level00:
        .db 0
        .db $21,$1d,"Cosmic year 6716"          ,0,0,$1d,$06
        .db $1b,$1d,"storyline coming soon..."  ,0,0,$1d,$06
@@ -3147,18 +3204,23 @@ XLlevelsdata:
        .db $52,$36,"by Shiar"                  ,0,0,$19,$23
        .db $ff
 
-;format:[enemy nr] [enemy frequency] [next lvl]
+;format:[nr.dif.enemies]x [enemy nr]
+;      [enemy frequency] [next lvl]
 ;      [level_info: 0000:damage 0:directfire 0:ground 0:ceiling 0:diagfire]
-;      [level_move] [level_fire] [tunnel size] [groundtype] [16_ground]
-;      [16_ceiling] [stars1] [stars2]
+;      [level_move] [level_fire] [tunnel size] [groundtype]
+;      [16_ground] [16_ceiling] [stars1] [stars2]
 
        .db $15,$07,$08                 ;fireFreq; moveType; enemyType
 level01:                               ;efrequency must be odd if halfluring!
-       .db $01,$1b,$2f,%00010001,0,255,0,0 ;0f>>2f             ; 7
-       .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1                     ;16
-       .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1                     ;16
-       .db 1,1                                                 ; 2
-       .db $10,$07,$09                                         ; 3
+       .db 3,$01,$02,$03
+       .db $1b,$2f,%00010001
+       .db 0,255
+       .db 0,0
+       .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1     ;16
+       .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
+       .db 1,1
+
+       .db $10,$07,$09
 
        .db 0
        .db $01,01,"And the storyline conti",
@@ -3169,122 +3231,58 @@ level01:                               ;efrequency must be odd if halfluring!
                .db "anet =)",0,0,1,20
        .db $FF
 
-       .db $10,$07,$09                                         ; 3
-level02:                                                       ;44
-       .db $02,$13,$4b,%00100101,0,064,0,0
+       .db $10,$07,$09
+level02:
+       .db 1,$02
+       .db $13,$4b,%00100101,0,064,0,0
        .db 1,2,3,4,5,6,6,5,4,3,4,5,4,3,2,1
        .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
        .db 1,1
-       .db $0E,$07,$09
 
        .db 0
        .db $01,01,"Blablabla...",0,1
        .db $01,34,"this storyline sux",0,0,1,39
-       .DB $FF
+       .db $FF
 
        .db $0E,$07,$09
 level03:
-       .db $03,$2d,$3f,%00010110,0,255,-9,1
+       .db 1,$03
+       .db $2d,$3f,%00010110,0,255,-9,1
        .db 3,2,4,3,2,2,1,1,1,1 ,1,1,21,17,18,20
        .db 1,1,1,1,1,1,1,3,6,12,9,1,21,19,18,18
-       .db -1,-1
+       .db -1,-1 ;=%11111111=line
 
        .db $0D,$07,$08
 level04:
-       .db $04,$11,$41,%00100001,0,057,0,0
+       .db 1,$04
+       .db $11,$41,%00100001,0,057,0,0
        .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
        .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
        .db 1,1
        .db $0C,$07,$09
 level05:
-       .db $05,$11,$45,%00100101,%10,031,-7,1
+       .db 1,$05
+       .db $11,$45,%00100101,%10,031,-7,1
        .db 14,12,11,9,10,7,7,5,4,3,4,4,2,3,1,2
        .db 1, 1, 1, 1,1, 1,1,1,1,1,1,1,1,1,1,1
        .db 1,1
        .db $0B,$07,$08
 level06:
-       .db $06,$19,$3a,%00100111,0,255,-4,1
+       .db 1,$06
+       .db $19,$3a,%00100111,0,255,-4,1
        .db 20,22,18,15,9,1,1,1,1,1,1,1,1,1,1,1
        .db 20,22,18,15,9,1,1,1,1,1,1,1,1,1,1,1
        .db 1,1
 
        .db $08,$07,$09
 level07:
-       .db $07,$09,$ff,%00100001,0,043,0,0
+       .db 1,$07
+       .db $09,$ff,%00100001,0,043,0,0
        .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
        .db 1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1
        .db 1,1
 
-;XLenemytable:----------------------------------------------------------------
-XLbullettable:
-       .db (spr_bullet01-spr_bullet01)
-       .db (spr_bullet01-spr_bullet01)
-       .db (spr_bullet01-spr_bullet01)
-       .db (spr_bullet01-spr_bullet01)
-       .db (spr_bullet01-spr_bullet01)
-       .db (spr_bullet01-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-       .db (spr_bullet02-spr_bullet01)
-
-XLenemytable:
-       .db $00                         ;00
-       .db (spr_enemy01-spr_enemy00)/2 ;01
-       .db (spr_enemy02-spr_enemy00)/2 ;02
-       .db (spr_enemy03-spr_enemy00)/2 ;03
-       .db (spr_enemy04-spr_enemy00)/2 ;04
-       .db (spr_enemy05-spr_enemy00)/2 ;05
-       .db (spr_enemy06-spr_enemy00)/2 ;06
-       .db (spr_enemy07-spr_enemy00)/2 ;07
-       .db (spr_boss01 -spr_enemy00)/2 ;08
-       .db (spr_boss02 -spr_enemy00)/2 ;09
-       .db (spr_enemy08-spr_enemy00)/2 ;0A
-       .db (spr_enemy00-spr_enemy00)/2 ;0B
-       .db (spr_enemy00-spr_enemy00)/2 ;0C
-       .db (spr_enemy00-spr_enemy00)/2 ;0D
-       .db (spr_enemy00-spr_enemy00)/2 ;0E
-       .db (spr_enemy00-spr_enemy00)/2 ;0F
-
-;XLenemyinfos:----------------------------------------------------------------
-XLenemyinfos:
-
-;format: [000000:HP 00:occ] [HP64] [appearance(ypos)] [unused]
-
-       .db %00100110,0,1,1     ;#1     HP:1    app:random
-       .db %00101010,0,2,3     ;#2     HP:1    app:halflure
-       .db %00001111,0,3,2     ;#3     HP:1    app:lure
-
-       .db %00000110,0,4,2     ;#4     HP:2    app:lure
-       .db %00000111,0,5,3     ;#5     HP:2    app:random      moving
-       .db %00001011,0,6,2     ;#6     HP:3    app:lure        moving
-
-       .db %00011011,0,7,3     ;#7     HP:7    app:halflure    moving
-
-       .db %00110011,1,8,1     ;boss1
-       .db %00111011,0,9,3     ;boss2
-
-       .db %00000000,0,0,0
-       .db %00000000,0,0,0
-       .db %00000000,0,0,0
-       .db %00000000,0,0,0
-       .db %00000000,0,0,0
-       .db %00000000,0,0,0
-       .db %00000000,0,0,0
-
-;XLsprenemies:----------------------------------------------------------------
-XLsprenemies:
+;------------------------------ enemies -------------------------------------
 
 spr_enemy00:
        .db 8,8                         ;pickup
@@ -3353,8 +3351,16 @@ spr_enemy07:
        .db %10011100                   ; █  ███
        .db %01111111                   ;  ███████
        .db %00011110                   ;    ████
+spr_enemy08:
+       .db 8,6                         ;enemy type seven
+       .db %00011110                   ;    ████
+       .db %01111111                   ;  ███████
+       .db %10011100                   ; █  ███
+       .db %10011100                   ; █  ███
+       .db %01111111                   ;  ███████
+       .db %00011110                   ;    ████
 
-spr_boss01:
+spr_boss0_1:
        .db 16,10                       ;boss type one
        .db %00000001,%11111111         ;        █████████
        .db %00001111,%11111110         ;     ███████████
@@ -3366,7 +3372,7 @@ spr_boss01:
        .db %00111111,%11110000         ;   ██████████
        .db %00001111,%11111110         ;     ███████████
        .db %00000001,%11111111         ;        █████████
-spr_boss02:
+spr_boss0_2:
        .db 16,10                       ;boss type:one   :
        .db %11111110,%00000000         ; ███████
        .db %00001111,%10001111         ;     █████   ████
@@ -3379,18 +3385,32 @@ spr_boss02:
        .db %00001111,%10001111         ;     █████   ████
        .db %11111110,%00000000         ; ███████
 
+;format: [000000:HP 00:occ] [HP64] [appearance(ypos)] [unused]
+XLenemyinfos:
+       .db %00100110,0,(spr_enemy01-spr_enemy00)/2,1   ;#1
+       .db %00101010,0,(spr_enemy02-spr_enemy00)/2,3   ;#2
+       .db %00001111,0,(spr_enemy03-spr_enemy00)/2,2   ;#3
 
-spr_enemy08:
-       .db 8,6         ;enemy type eight
-       .db %00011110   ;    ████
-       .db %01111111   ;  ███████
-       .db %10011100   ; █  ███
-       .db %10011100   ; █  ███
-       .db %01111111   ;  ███████
-       .db %00011110   ;    ████
+       .db %00000110,0,(spr_enemy04-spr_enemy00)/2,2   ;#4
+       .db %00000111,0,(spr_enemy05-spr_enemy00)/2,3   ;#5
+       .db %00001011,0,(spr_enemy06-spr_enemy00)/2,2   ;#6
 
-;-----------------------------------------------------------------------------
-;----------------------------- logo -------------------------------------------
+       .db %00011011,0,(spr_enemy07-spr_enemy00)/2,3   ;#7
+
+       .db %00110011,1,(spr_boss0_1-spr_enemy00)/2,1   ;boss1
+       .db %01001011,1,(spr_boss0_2-spr_enemy00)/2,3   ;boss2
+
+       .db %00000000,0,0,0
+       .db %00000000,0,0,0
+       .db %00000000,0,0,0
+       .db %00000000,0,0,0
+       .db %00000000,0,0,0
+       .db %00000000,0,0,0
+       .db %00000000,0,0,0
+
+;----------------------------------------------------------------------------
+;----------------------------- logo ------------------------------------------
+;----------------------------------------------------------------------------
 
 logo_nemesis:
 .db %11111111,%11111111,%11111111,%11111110,%11111111,%11110111,%11111111,%11111110,%11111111,%111101111,%11111111,%00001011,%11111111,%11111111,%11111111,%11111000
@@ -3413,60 +3433,46 @@ logo_nemesis:
 .db %00000000,%00000000,%00001111,%00011110,%11111111,%11110111,%10001111,%00011110,%11111111,%111101111,%11111111,%01111011,%11111111,%11000000,%00000001,%00010101
 .db %00000000,%00000000,%00001111,%00011110,%11111111,%11110111,%10001111,%00011110,%11111111,%111101111,%11111111,%01111011,%11111111,%11000000,%00000001,%00010001
 
-;----------------------------- end --------------------------------------------
+;----------------------------- end ------------------------------------------
 
        .end
 .end
 
 
-;------------------------------------------------------------------------------
+;----------------------------------------------------------------------------
+;----------------------------------------------------------------------------
+;----------------------------------------------------------------------------
 
-; 0.95.A22 -- 22.X.99 -- size 5321
-;
-;      * total size of enemy-sprites can now be 510 bytes (space = doubled!)
-;      # bullets hit enemies correctly that aren't 6x6; even the 16x10 bosses!
-;      * at g/o or nextlevel checks for keys released instead of waiting abit
-;      + name stored with hiscore (max. 8 chars, Shiar.95 by default)
-;      + when entering hi-name DEL goes back one char (with check 4 no chars)
-;      # program is reloaded at start so some score-bugs solved! (_asapvar=0)
-;      * at death, upgrades and pickups AREN'T removed! (just armor=0)
-;      # bullet is not displayed after being removed anymore
-;      # armor-icon stays hilighted when armor is decreased
-;      * when stars move off screen, they are placed at a NEW y-pos!
-;      * the starting x-positions of stars are not random, so the stars are
-;        spread all over screen. y is still random and changes during game
-;      * make_random functions smaller and used by different procs
-;      # MAJOR BUG! a "random" value was placed somewhere in mem thus
-;        creating bugs like unexplained loss of armor and stuff! (I think)
-;
-; 0.96.A31 -- 31.X.99 -- size 4836 + 888
-;
-;      # if you were hit when armor-icon selected, prog did weird stuff
-;      + armor-bar (shows armor as a black line left at bottom)
-;      # bugs involving armor-bar changing armor to a wrong value
-;      # YES!!! the saving-bugs were caused by mmldir: it reset all data
-;        at mem $8000, so data is now stored at asmexecram+6000 instead!
-;      * external levels. All leveldata is loaded from "nemesis0"-var
-;      * some optimization (like cal\ret>jp + unused code removed/shortened)
-;      * storyline is loaded from level-file (will be compressed later..)
-;      + story can be _between_ levels, not only at the start of a new game
-;      * "new game" and "continue" in main menu are swapped (new comes 1st)
-;      * enemy bullets can do more than one damage: differs per level
-;      * collision does 4 damage, ground does 5, you start with 12 armor
-;      # running the level-file no longer crashes your calc but just returns
-;      * you now move 1.5 pixels per frame! this way you can outrun enemies
-;      * hellofajob but enemy-data is now stored at one location in 6 bytes,
-;        instead of two 4-byte spaces 40 bytes apart! (cleaner code; faster)
-;      * ground/ceiling/stars are continued when at boss (c00l level 3 boss)
-;
-; 0.97.B12 -- 12.XI.99 -- size
+; 0.97.625 -- 25.VI.00 -- size 5753
 ;
 ;      # bullets do damage in all levels
 ;      * more armor at armor-upgrade and extra armor at end of a level
-;      - internal levels again (no need, safer/smaller)
+;      - internal levels again (no need 4 external, safer/smaller)
 ;      # some registers not correctly pushed/popped
 ;      * several optimizations (init.procs some bytes smaller)
+;      # enemies hit with hitpoints left disappeared (one pop too much...)
+;      + bullets "charge up" (more damage) when not firing
+;      + more powerful bullets have different sprites (larger=more damage)
+;      # multiples appear at your position (begin level/just selected)
+;      # when invulnerable multiples acted weird
+;      # no more error at activation after APD off after running Nemesis
+;      # saves correctly if own name ain't "nemesis" + some bytes smaller
+;      # screen wasn't always entirely cleared after quit
+;      * waits until all keys have been released after death
+;      + different bullets sizes will miss if they're too small
+;      + at level start "press F1 to save"-text will be displayed
+;      * w3.shiar.org displayed at title screen, black bar behind version nr
+;      # score to 0 when exit pressed at main menu
+;      # no residual story-text in first frame of game
+;      # game doesn't continue again after death (stack messed up)
+;      # game over when lives<0 (didn't work in v0.96+)
+;      * using some self-modifiing code (so it's smaller)
+;      # new random procedure: stars don't appear on one line anymore
+;      * weapons appear centered at multiples
+;      * laser properties can be changed (damage, charge)
+;      + weapon can be combination of bullets/lasers (max. of 3 per weapon)
+;      * bullet-icon is removed when laser is selected
+;      * enemy sprite table integrated in enemy specs (-1 byte/enemy)
 ;
 ;
-;       + added        - removed       * changed       # bug fixed
-
+;       + added        - removed       * changed       # bug fixed
\ No newline at end of file