Jumper - An Arcade Bouncing Game Game Template

This documentation will help you familiarise yourself with the 'Jumper' Android App. The aim of the player in the game is to tilt his device and keep jumping up as high as he could. The game features coins, powerups and bombs. Thanks for buying this template! Hope you have as much fun customising it as I did building it.

Before You Start

1. Make sure your have Android Studio 3.3.1 installed and in the Android SDK Manager make sure you have the following installed:

   • Build tools v28.0.3
   • Google USB Driver
   • Android API 28 SDK

2. Try to place the project file as close to root (C:/) as possible as windows has a path character limit of 240chars. So, if you get the error:"Failed to crunch file...", reduce the path length.

Importing and running

• Step 1 - Open up Android Studio and click 'open an existing Android Studio project'.

  



• Step 2 - Drag and drop the 'Jumper' folder in the dialog to go quickly to the folder.

• Step 3 - Make sure 'Jumper' is highlighted and click 'ok'.

  



• Step 4 - Press the Play button to test the app on the emulator or connect your phone via usb to your computer to try it on your phone.

  

Changing Package name

This step must be done else you will have problems uploading to Google play and the Rate feature will not work.

• Step 1 - Make sure the 'Compact Empty Middle Packages' option is deselected as shown below.

  



• Step 2 - Rename the package id by right clicking on 'neurondigital' and selecting 'refactor' and 'rename' as shown below.

  



• Step 3 - Click Rename package.

  



• Step 4 - In the popup menu type in your company name. Then press 'refactor' and in the next popup window press 'Do Refactor'. Do the same for 'jumper'. The package name should be in this format: com.yourcompany.AppName

  



• Step 5 - Open Jumper/build.gradle and put in the same package id as before instead of the 'com.neurondigital.jumper'. This is shown below.

  

Replace icon and Images

1. The images can be found under jumper/res/drawable. To replace the images just copy/paste the image in the drawable folder to replace the other.

   

Replace Audio and Music

1. The audio can be found under jumper/res/raw. To replace the audio just copy/paste the sound file in the raw folder to replace the other. These are the used placeholder audio in the demo:

   1. Falling - http://audiojungle.net/item/falling/5732400
   2. Game Over - http://audiojungle.net/item/comedic-game-over-sound/5951327
   3. Bounce and beep - http://audiojungle.net/item/cartoon-bounces/1848773
   4. Coin - http://audiojungle.net/item/collected-coin/5031219
   5. music - http://audiojungle.net/item/happy-game/409203

Add AdMob interstitial Ads (optional)

• Create an interstitial Ad on AdMob and paste the AD unit Id and App Unit Id in the strings.xml file. The Ad displays when the user clicks a property in the home screen. Make sure to add this to start making money from your App. The display rate can be changed from strings.xml from the ad_shows_every_X_clicks parameter.

  

Add AdMob Banner Ads (optional)

• Like the interstitial Ad, create a Banner Ad on AdMob and paste the AD unit Id and App unit Id in the strings.xml file. The Ad displays in the bottom of the screen. Ideally to not annoy the user, it's either the banner or the interstitial ad, so you may wish to leave one of the Ad IDs in strings.xml empty.

Translation

• All translatable text is contained within the strings.xml file.

  

Modifing Bar Positions

• Open MainGame.java in eclipse and go to line 103:

  

  Here you can modify the bar positions and add special items on any bar. To add a bar just add a line to the bar_positions[][] array :

  { , , ,  },

  Bar types: BAR_NORMAL, BAR_BREAKS, BAR_MOVE

  Special item types: NOTHING, COIN1, COIN5, COIN9, BOMB, TRAMPOLIN, ROCKET1, ROCKET2, BALLOON

Export your App as a .APK for Google Play

• Go to Build| Generate Signed APK... and export the .APK file.