Ball Color Switch. Game document and tutorial

Transcription

1 Ball Color Switch Game document and tutorial This template is ready for release. It is optimized for mobile (iphone, ipad, Android, Windows Mobile) standalone (Windows PC and Mac OSX), web player and webgl. It is so easy to re-skin and change. Welcome to Ball Color Switch, a Unity fully game template and ready to make so much money. THIS DOCUMENT COVERS THE BASICS OF HOW TO USE COLOR SPLIT TO MAKE YOUR OWN FAMOUS GAME. YOU CAN SEE MORE DETAILED DOCUMENTATION, WEB DEMO, VIDEO TUTORIALS ON FOLLOWING LINK: Free Music Sound at here: Please rate my file, I d appreciate it

2 CHANGE LOG Version Added Full API In App Purchase for Android and ios Added Lives Engine as the same as Candy Crush Version Fix bugs: empty obstacle and pass through obstacle Optimize Performance Version game modes 500 new levels More 120 obstacles 30 new characters Table of Contents CHANGE LOG... 2 Version Version Version INTRODUCTION... 3 INSTALLATION AND GENERAL USAGE... 4 SCENES AND BUILD SETTINGS... 5 PROJECT SETTINGS... 7 GAME FLOW... 9 FOLDER STRUCTURE... 10

3 HOW GAME WORKS HOW GAME GENERATE LEVEL HOW TO CUSTOMIZE SECTION/OBSTACLE ADD MORE OBSTACLES TO GAME PLAY CUSTOMIZE GEM ITEM IN APP PURCHASE INTEGRATE GOOGLE PLAY SERVICE INTEGRATE ADVERTISING INTRODUCTION Ball Color Switch is a Unity complete template to publish to any Store, supports PC/Mac, ios, Android, and Windows. This reference documentation is a detailed descriptions of all features. Great features will you have when buying the packages: + 06 game modes: Split, Color Fly, Cave, Reverse, Challenge and Normal mode + Generate Level automatically module with scroll view + Characters Selection shopping module with scroll view + Wheel Prize module + Manage upgrading version + Save/Load module + Pooling module + Integration Google Play Service module + Integration Vungle Ads module + Exchange Video Ads to maximize revenue + Integration In-App purchase levels + More 120 obstacles + More 30 player characters

4 INSTALLATION AND GENERAL USAGE This template was built on Unity 5.3.4, GooglePlayGamesPlugin , Vungle SDK for Unity version For best compatible, please Install Unity above before importing the template package. Extract the.zip template file to folder named Ball Color Switch. Then open Unity, open Project, choose folder Ball Color Switch

5 SCENES AND BUILD SETTINGS Scenes: CS_StartMenu: The first scene when start the game CS_Game: Play with normal mode CS_GameChallenge: Play with challenge mode. CS_ GameCave: Play with cave mode. CS_ GameReverse: Play with reverse mode; CS_GameColorFly: Play with Color Fly mode; CS_SelectCharacter: select character shop CS_SelectGameLevel: select game level CS_SelectGameMode: select game modes

6 CS_WheelPrize: try Wheel Prize To build the game, you must add all scenes to File Build Settings

7 PROJECT SETTINGS Go to Edit Project Settings Physics 2D

8 Set gravity Y = -15

9 GAME FLOW Start 1. Show Start GUI 2.1 Choose Shopping 2.2 Choose Characters 3.1 Play 3.2 Show Game Over Play with Normal mode 4 Choose Game Modes 5 Choose Levels 6.1 Play Is finished 6.2 Show Finished UI End Step 1: Start the game, show home GUI. Step 2: You can choose shopping module to buy more characters Step 3: Play with normal mode Step 4: Choose game modes: Challenge, Reverse, Cave, Color Fly, Split Step 5: Choose level of each game mode Step 6: Play with selected game level of the game mode. Click to jump the ball.

10 FOLDER STRUCTURE Animations: Player and UI animations Fonts: Font of game Materials: All materials of the game Prefabs: Game UI, Section, Player, Items, Effect. Scene: Game Scene in C# Scripts: Main scripts in C# Sounds: All sounds in mp3 and.ogg Textures: Textures and Icons Editor: Including some file to setup GooglePlayGame Plugin and Vungle Plugin GooglePlayGames: Main source code of Google Play Store Plugin (please update the latest plugin from Google if you want to publish to Play Store) Plugins: Plugin for Google Play Store and Vungle Let click on each folder to discovery. Now let start how to setup and play the Ball Color Switch.

11 HOW GAME WORKS Game Controller Player Controller Start Obstacle Block End Camera Follow GUI Manager Basically, to run the game, we need 04 main scripts: GameController, PlayerController, CameraFollow and GUIManager. GameController is the most important script to start the game, generate Obstacles, Color Ball for each game modes, control player by using PlayerController, control game state (running, game over, finished). PlayerController: to jump player, switch color for player. CameraFollow: to move camera with the player GUIManager: to process event when user click on button..etc. ObstacleBlock: to moving or rotate the obstacle Other scripts use for controlling music, color ball, generate level and game mode.

12 The game is designed in a way that allows you to setup the list of colors. By default, the Game Controller has 4 defined colors, like this: Each of these colors has an element number in the list is Color Index, so the first color (red) is indexed at 0, while the second color (yellow) is indexed at 1, and so on. There are three objects which have color lists: Player, Color Ball and Obstacle Block. Principle is that when color index of the Player is same with color index of the Obstacle, Player will pass the Obstacle. Another, player will fail. When Player collide Color Ball, the Player s color index will be changed. HOW GAME GENERATE LEVEL Please check on GameController.cs. We defined 03 difficult level on each obstacle. Check on Update event to understand how to spawn obstacle

13 HOW TO CUSTOMIZE SECTION/OBSTACLE To customize Section/Obstacle (adding new or edit), let go to Prefabs folder Section. There are some type of Sections:

14 + Circle + Rectangle + Line + Finish + Obstacle There are two main scripts in each Obstacle: + SectionItem: including definition for each obstacle such as: Section Gap: the distance between previous area and obstacle. IsSectionFinished: is the finished section DifficultLevel: the difficult level Is Obstacle: some case section is not obstacle Radial: the behind gap after obstacle + DestroyAfterDistance: to improve performance and memory garbage, obstacles will be deytroyed after the defined distance. Basically, each section include three components: + GemItem: generate gem star + ColorItem: generate Color Ball + Wall (Circle, Line, Rectangle, Triangle etc): Moving, rotating wall. To change the speed and direction, let go to inside it.

15 ADD MORE OBSTACLES TO GAME PLAY Step 1: Add obstacles prefabs to GameController Step 2: Add obstacles prefabs to TrashMan at CS_StartMenu by drag and drop prefabs to TrashMan Object

16

17 CUSTOMIZE GEM ITEM Gem Item is a star which included in each obstacle to collect point. To customize Gem Item, let go to Prefab Folder Items Gem. Change star image as you want. Change Function Parameter to add more point when player collide GEM ITEM. You should duplicate prefab and then change above things. Drag GemItem prefab to Section prefab.

18 CUSTOMIZE LIVES ENGINE Lives Engine (special) as the same as Candy Crush to make your game to more addictive and increase re-venue. User has limited lives on every day. If reaching limited, show pop up to implement In App Purchase or Share to get more lives. You can disable or enable and edit some parameter. On StartManager object in CS_StartMenu scene, there are 04 paramters: Lives in N mode: number limited lives in normal mode which the mode when user click play button on the Home scene. Default is 10 lives in a day. Lives in L mode: number limited lives in other level mode (Challenge, Cave, Color Fly, Split, Reversed etc.). Default is 5 lives in a day. Days in Lives: the number of days which lives will be effected. 0 mean that 5 lives at every day. 1 mean that 5 lives in 02 day

19 You can customize the events of each button:

20 IN APP PURCHASE Drag the IAPService prefab to the Game mode scene. Change your product id and purchased event on the script IAPService.cs Call the API function as the following picture:

21 Change your logic code on purchased event as the following: INTEGRATE GOOGLE PLAY SERVICE For the best compatible, let go to download the latest plugin from Google. Currently, the template use GooglePlayGamesPlugin version. Setup Google Play Service: go to Windows Google Play Games Setup. After that, let copy and paste the game resource code from Developer Console of Google Play.

22 To build for Android and ios, let take more detail at here: You must download and install Android SDK before build app to Android platform. INTEGRATE ADVERTISING To use Vungle Advertising, you need to create a new account on Vungle.com and then add new app to get AppId on your platform (Android, ios, Windows). On CS_StartMenu scene, choose ServiceManager object and then change Vungle App Id. Also, you can integrate easily with another advertising provider.