Dark Maze Documentation by Mars Entertainments v1.0
Dark Maze Game
Created: 20/6/2023
By: Mars Entertainments
Email: onlineopportunity28@gmail.com
Thank you for purchasing my game. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!
Table of Contents
Game structure
Controls
Layouts
Event sheets
Object Types
Icons
Fonts
Troubleshooting
A) Game structure
Introduction
This documentation describes the maze scape game, a simple game made with Construct 3 engine. The game is played by guiding a character through a maze to find the star gate.
Gameplay
This is a simple 2D game. The game is played using the arrow keys or touch to move the character. Player has to find the scape stars that makes him wins.
Winning
The player wins the game by reaching the star gate.
Losing
The player loses the game if they closed the game.
B) Controls
Arrow keys: Move the character.
Touch by moving tile: Move the character.
C) Layouts
This game has two layouts.
Intro layout, where player gets to select how to control the character
Main layout, where the player move the character and room the maze to escape.
D) Events sheet
The game includes 7 event sheets to adjust the gameplay and the parameters:
eControls
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"every-tick","objectClass":"System"}],"actions":[{"id":"set-text","objectClass":"DebugText","parameters":{"text":"\"Beta: \" & round(Touch.Beta - TiltCenterBeta) & \"; Gamma: \" & round(Touch.Gamma - TiltCenterGamma) & newline & \"TiltCenter: \" & round(TiltCenterBeta) & \", \" & round(TiltCenterGamma)"}},{"id":"set-vector-y","objectClass":"Player","behaviorType":"8Direction","parameters":{"vector-y":"(Touch.Beta - TiltCenterBeta) * SPEED_MULTIPLIER"}},{"id":"set-vector-x","objectClass":"Player","behaviorType":"8Direction","parameters":{"vector-x":"(Touch.Gamma - TiltCenterGamma) * SPEED_MULTIPLIER"}},{"callFunction":"MoveShadowAndActiveCell"}]},{"eventType":"block","conditions":[{"id":"is-moving","objectClass":"Player","behaviorType":"8Direction"},{"id":"is-moving","objectClass":"Player","behaviorType":"MoveTo"}],"actions":[{"callFunction":"MoveShadowAndActiveCell"}],"isOrBlock":true},{"eventType":"block","conditions":[{"id":"on-nth-touch-end","objectClass":"Touch","parameters":{"touch-number":"0"}}],"actions":[{"id":"move-to-position","objectClass":"Player","behaviorType":"MoveTo","parameters":{"x":"Touch.X","y":"Touch.Y","mode":"direct"}}]},{"eventType":"block","conditions":[{"id":"is-moving","objectClass":"Player","behaviorType":"8Direction"}],"actions":[{"id":"stop","objectClass":"Player","behaviorType":"MoveTo"}]}]}
eCredits
eGame
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"include","includeSheet":"eControls"},{"eventType":"include","includeSheet":"eSetup"},{"eventType":"variable","name":"GRID_SIZE","type":"number","initialValue":"128","comment":"","isStatic":false,"isConstant":true},{"eventType":"variable","name":"TiltCenterBeta","type":"number","initialValue":"0","comment":"","isStatic":false,"isConstant":false},{"eventType":"variable","name":"TiltCenterGamma","type":"number","initialValue":"0","comment":"","isStatic":false,"isConstant":false},{"eventType":"variable","name":"TiltControlsOn","type":"boolean","initialValue":"true","comment":"","isStatic":false,"isConstant":false},{"eventType":"block","conditions":[{"id":"on-start-of-layout","objectClass":"System"}],"actions":[{"id":"set-ignoring-input","objectClass":"Player","behaviorType":"8Direction","parameters":{"input":"start-ignoring"}},{"id":"set-enabled","objectClass":"Player","behaviorType":"MoveTo","parameters":{"enabled":false}},{"callFunction":"PlacePlayer"},{"callFunction":"PlaceExit"},{"callFunction":"ResetTilt"}],"children":[{"eventType":"block","conditions":[{"id":"compare-boolean-eventvar","objectClass":"System","parameters":{"variable":"TiltControlsOn"}}],"actions":[{"id":"set-group-active","objectClass":"System","parameters":{"group-name":"\"TiltControls\"","state":"activated"}}]},{"eventType":"block","conditions":[{"id":"else","objectClass":"System"}],"actions":[{"id":"destroy","objectClass":"TiltResetButton"},{"id":"set-ignoring-input","objectClass":"Player","behaviorType":"8Direction","parameters":{"input":"stop-ignoring"}},{"id":"set-enabled","objectClass":"Player","behaviorType":"MoveTo","parameters":{"enabled":true}},{"id":"set-group-active","objectClass":"System","parameters":{"group-name":"\"OtherControls\"","state":"activated"}}]}]},{"eventType":"block","conditions":[{"id":"is-overlapping-another-object","objectClass":"Player","parameters":{"object":"PotentialExit"}}],"actions":[{"callFunction":"WinConditionMet"}]},{"functionName":"WinConditionMet","functionDescription":"","functionCategory":"","functionReturnType":"none","functionCopyPicked":false,"functionIsAsync":false,"functionParameters":[],"eventType":"function-block","conditions":[],"actions":[{"id":"set-layer-visible","objectClass":"System","parameters":{"layer":"\"Win\"","visibility":"visible"}},{"id":"set-ignoring-input","objectClass":"Player","behaviorType":"8Direction","parameters":{"input":"start-ignoring"}},{"id":"set-enabled","objectClass":"Player","behaviorType":"MoveTo","parameters":{"enabled":false}},{"id":"set-group-active","objectClass":"System","parameters":{"group-name":"\"TiltControls\"","state":"deactivated"}},{"id":"set-group-active","objectClass":"System","parameters":{"group-name":"\"OtherControls\"","state":"deactivated"}},{"id":"stop","objectClass":"Player","behaviorType":"8Direction"},{"id":"stop","objectClass":"Player","behaviorType":"MoveTo"}]},{"functionName":"MoveShadowAndActiveCell","functionDescription":"","functionCategory":"","functionReturnType":"none","functionCopyPicked":false,"functionIsAsync":false,"functionParameters":[],"eventType":"function-block","conditions":[],"actions":[{"id":"set-position","objectClass":"ShadowLight","parameters":{"x":"Player.X","y":"Player.Y"}},{"id":"set-position","objectClass":"ActiveCellMarker","parameters":{"x":"floor(Player.X / GRID_SIZE) * GRID_SIZE + (GRID_SIZE / 2)","y":"floor(Player.Y / GRID_SIZE) * GRID_SIZE + (GRID_SIZE / 2)"}}]},{"eventType":"block","conditions":[{"id":"on-tap-object","objectClass":"Touch","parameters":{"object":"TiltResetButton"}}],"actions":[{"callFunction":"ResetTilt"}]},{"functionName":"ResetTilt","functionDescription":"","functionCategory":"","functionReturnType":"none","functionCopyPicked":false,"functionIsAsync":false,"functionParameters":[],"eventType":"function-block","conditions":[],"actions":[{"id":"set-eventvar-value","objectClass":"System","parameters":{"variable":"TiltCenterBeta","value":"Touch.Beta"}},{"id":"set-eventvar-value","objectClass":"System","parameters":{"variable":"TiltCenterGamma","value":"Touch.Gamma"}}]}]}
eIntro
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"on-tap-object","objectClass":"Touch","parameters":{"object":"Button"}}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"Button","parameters":{"instance-variable":"Name","comparison":0,"value":"\"tilt\""}}],"actions":[{"id":"set-boolean-eventvar","objectClass":"System","parameters":{"variable":"TiltControlsOn","value":"true"}}]},{"eventType":"block","conditions":[{"id":"else","objectClass":"System"}],"actions":[{"id":"set-boolean-eventvar","objectClass":"System","parameters":{"variable":"TiltControlsOn","value":"false"}}]},{"eventType":"block","conditions":[],"actions":[{"id":"go-to-layout","objectClass":"System","parameters":{"layout":"Maze 1"}}]}]},{"eventType":"block","conditions":[{"id":"cursor-is-over-object","objectClass":"Mouse","parameters":{"object":"Button"}}],"actions":[{"id":"set-cursor-style","objectClass":"Mouse","parameters":{"cursor-style":"hand"}}]},{"eventType":"block","conditions":[{"id":"else","objectClass":"System"}],"actions":[{"id":"set-cursor-style","objectClass":"Mouse","parameters":{"cursor-style":"normal"}}]},{"eventType":"group","disabled":false,"title":"Permissions","description":"","isActiveOnStart":true,"children":[{"eventType":"block","conditions":[{"id":"on-any-touch-end","objectClass":"Touch"}],"actions":[{"id":"request-permission","objectClass":"Touch","parameters":{"type":"orientation"}}]},{"eventType":"block","conditions":[{"id":"on-permission-granted","objectClass":"Touch","parameters":{"type":"orientation"}}],"actions":[{"callFunction":"ResetTilt"}]}]}]}
eSetup
{"is-c3-clipboard-data":true,"type":"events","items":[{"functionName":"PlacePlayer","functionDescription":"","functionCategory":"","functionReturnType":"none","functionCopyPicked":false,"functionIsAsync":false,"functionParameters":[],"eventType":"function-block","conditions":[],"actions":[],"children":[{"eventType":"variable","name":"PlayerPositionUID","type":"number","initialValue":"0","comment":"","isStatic":false,"isConstant":false},{"eventType":"block","conditions":[{"id":"pick-nth-instance","objectClass":"System","parameters":{"object":"PotentialExit","instance":"random(PotentialExit.Count)"}}],"actions":[{"id":"set-eventvar-value","objectClass":"System","parameters":{"variable":"PlayerPositionUID","value":"PotentialExit.UID"}},{"id":"set-position","objectClass":"Player","parameters":{"x":"PotentialExit.X","y":"PotentialExit.Y"}},{"id":"set-position","objectClass":"ShadowLight","parameters":{"x":"Player.X","y":"Player.Y"}},{"id":"move-to-top","objectClass":"ShadowLight"}]},{"eventType":"block","conditions":[{"id":"pick-by-unique-id","objectClass":"PotentialExit","parameters":{"unique-id":"PlayerPositionUID"}}],"actions":[{"id":"destroy","objectClass":"PotentialExit"}]}]},{"functionName":"PlaceExit","functionDescription":"","functionCategory":"Setup","functionReturnType":"none","functionCopyPicked":false,"functionIsAsync":false,"functionParameters":[],"eventType":"function-block","conditions":[],"actions":[],"children":[{"eventType":"variable","name":"ExitUID","type":"number","initialValue":"0","comment":"","isStatic":false,"isConstant":false},{"eventType":"block","conditions":[{"id":"pick-nth-instance","objectClass":"System","parameters":{"object":"PotentialExit","instance":"random(PotentialExit.Count)"}}],"actions":[{"id":"set-eventvar-value","objectClass":"System","parameters":{"variable":"ExitUID","value":"PotentialExit.UID"}}]},{"eventType":"block","conditions":[{"id":"pick-by-unique-id","objectClass":"PotentialExit","parameters":{"unique-id":"ExitUID"},"isInverted":true}],"actions":[{"type":"comment","text":"get rid of any unused PotentialExits"},{"id":"destroy","objectClass":"PotentialExit"}]}]}]}
eTiltDemo
{"is-c3-clipboard-data":true,"type":"events","items":[{"eventType":"block","conditions":[{"id":"every-tick","objectClass":"System"}],"actions":[{"id":"set-text","objectClass":"DebugText","parameters":{"text":"\"Beta: \" & round(Touch.Beta - TiltCenterBeta) & \"; Gamma: \" & round(Touch.Gamma - TiltCenterGamma) & newline & \"TiltCenter: \" & round(TiltCenterBeta) & \", \" & round(TiltCenterGamma)"}},{"id":"set-vector-y","objectClass":"Player","behaviorType":"8Direction","parameters":{"vector-y":"(Touch.Beta - TiltCenterBeta) * SPEED_MULTIPLIER"}},{"id":"set-vector-x","objectClass":"Player","behaviorType":"8Direction","parameters":{"vector-x":"(Touch.Gamma - TiltCenterGamma) * SPEED_MULTIPLIER"}},{"callFunction":"MoveShadowAndActiveCell"}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Beta - TiltCenterBeta","comparison":2,"second-value":"0"}}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"bottom\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"invisible"}}]},{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"top\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"visible"}}],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Beta - TiltCenterBeta","comparison":2,"second-value":"-1 * MaxTilt"}}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(255, 0, 0, 50)"}}]},{"eventType":"block","conditions":[{"id":"else","objectClass":"System"}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(0, 255, 0, 50)"}}]}]}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Beta - TiltCenterBeta","comparison":4,"second-value":"0"}}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"top\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"invisible"}}]},{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"bottom\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"visible"}}],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Beta - TiltCenterBeta","comparison":4,"second-value":"MaxTilt"}}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(255, 0, 0, 50)"}}]},{"eventType":"block","conditions":[{"id":"else","objectClass":"System"}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(0, 255, 0, 50)"}}]}]}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Gamma - TiltCenterGamma","comparison":2,"second-value":"0"}}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"right\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"invisible"}}]},{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"left\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"visible"}}],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Gamma - TiltCenterGamma","comparison":2,"second-value":"-1 * MaxTilt"}}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(255, 0, 0, 50)"}}]},{"eventType":"block","conditions":[{"id":"else","objectClass":"System"}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(0, 255, 0, 50)"}}]}]}]},{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Gamma - TiltCenterGamma","comparison":4,"second-value":"0"}}],"actions":[],"children":[{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"left\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"invisible"}}]},{"eventType":"block","conditions":[{"id":"compare-instance-variable","objectClass":"TiltWarning","parameters":{"instance-variable":"Side","comparison":0,"value":"\"right\""}}],"actions":[{"id":"set-visible","objectClass":"TiltWarning","parameters":{"visibility":"visible"}}],"children":[{"eventType":"block","conditions":[{"id":"compare-two-values","objectClass":"System","parameters":{"first-value":"Touch.Gamma - TiltCenterGamma","comparison":4,"second-value":"MaxTilt"}}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(255, 0, 0, 50)"}}]},{"eventType":"block","conditions":[{"id":"else","objectClass":"System"}],"actions":[{"id":"set-default-color","objectClass":"TiltWarning","parameters":{"color":"rgba255(0, 255, 0, 50)"}}]}]}]},{"eventType":"block","conditions":[{"id":"on-any-touch-end","objectClass":"Touch"}],"actions":[{"id":"request-permission","objectClass":"Touch","parameters":{"type":"orientation"}}]},{"eventType":"block","conditions":[{"id":"on-permission-granted","objectClass":"Touch","parameters":{"type":"orientation"}}],"actions":[{"callFunction":"ResetTilt"}]},{"eventType":"block","conditions":[{"id":"on-tap-object","objectClass":"Touch","parameters":{"object":"TiltResetButton"}}],"actions":[{"callFunction":"ResetTilt"}]}]}
eTODO
E) Object Types
The following object types have been used, icons or other files as listed.
Music: one track for tilt warning
UI: one button for tilt rest
Wall:
Player:
Star Gates:
Tiled Background
F) Font Used
* Righteous-Regular
G) Troubleshooting
If the game is not working properly, try refresh browser.
If you are still having problems, you can contact me for help.
Once again, thank you so much for purchasing this game. As I said at the beginning, I'd be glad to help you if you have any questions relating to this game. No guarantees, but I'll do my best to assist. If you have a more general question relating to the maze game on, you might consider visiting the forums and asking your question in the "Item Discussion" section.
Mars Entertainment
Intro layout, where player gets to select how to control the character
Main layout, where the player move the character and room the maze to escape.
Player
Star Gate
Tiled Background