Skip to content

Crazy-Marvin/EllaTheGame

Repository files navigation

Ella - The Game

Ella - The Game is an open source endless runner for Android, Linux, Windows, macOS & WebGL.

Travis License Last commit Uptime GitHub All Releases Translation status

About

Ella, the smart and adorable dog, is lost and is doing whatever it takes to find the way out. In this free jumping and running dog game, Ella is running automatically and as the screen is moving forward you need to jump over the obstacles and collect as many coins and gifts as you can. So, you’ve got two objectives in this side-scrolling adventure game: avoid hitting obstacles and hurdles and collect coins.

Ella - The Game GIF

Installation

The focus is on Android and web.
We may update desktop builds (Linux, Windows and macOS) from time to time.
It is not planned to support other platforms than Android, Linux, Windows, macOS & WebGL from my side, but Unity offers the possibility to build the game for many other platforms too and there might be one or another experimental build from the community.

Get it on Google Play Get it on WebGL

Legacy:

Get it on Linux Get it on Windows Get it on macOS

Experimental:

Those experimental builds are done and uploaded by a third party.

Get it on Xbox Get it on iOS Get it on macOS

Building

Building for ANDROID

Setting up the Android SDK Tools

NEXT WE NEED TO INSTALL THE ANDROID SDK TOOLS

  • Go to http://developer.android.com/sdk/index.html
  • Download the Android SDK Tools or (the command line tools), not the full android studio just the command line tools
  • Unzip the downloaded file, put the directory in an accessible location, you’ll need to tell Unity where is this directory later
  • Open the directory that contains the Android SDK Tools, and navigate to tools. Double click the file called android to run it.
  • Click Install [x] packages to start the installation process. You will be prompted to accept the licenses for these packages.
  • The installation will take some time to complete.

Now we will tell Unity where we installed the Android SDK Tools.

  • Go to top menu, navigate to Unity > Preferences (on OSX) or Edit > Preferences (on Windows).
  • In the Preferences window, navigate to External Tools, and scroll down to Android section.
  • Where it says SDK, click Browse, navigate to where you put the directory containing Android SDK Tools and click Choose the path may look like this (C:/Users/[userName]/AppData/Local/Android/sdk).
  • Where it says JDK, click Browse, navigate to where you put the directory containing JDK Tools and click Choose the path may look like this (C:/Program Files/Java/jdk1.8.0_121).

Finally, Preparing your Unity project for building to Android

  • In Unity, open the Build Settings from the top menu (File > Build Settings).
  • Select Android from the list of platforms on the left and choose Switch Platform at the bottom of the window.
  • Open the player settings in the inspector panel (Edit > Project Settings > Player).
  • Expand the section at the bottom called Other Settings, and enter your chosen Package Name where it says Package Name.
  • Now comeback open the Build Settings from the top menu (File > Build Settings), and click on Build. for detailed tutorial about building to ANDROID visit this link https://unity3d.com/learn/tutorials/topics/mobile-touch/building-your-unity-game-android-device-testing

Google Play Game Services

Make sure that the SHA-1 certificate fingerprint from Google Play is identically to the one listed in Google Cloud. Otherwise the players won't be able to access Google Play Game Services like leaderboard or achievements.

ella_sha1_gc ella_sha1

Building for iOS

Building for iOS is a long process, but Unity created a good Guide for building for iOS.

Building for WINDOWS

  • In Unity, open the Build Settings from the top menu (File > Build Settings).
  • In Platforms Make sure to select (PC, MAC & LinuxStabdalone)
  • In Target Platform Select Windows then click Build.

Building for LINUX

  • In Unity, open the Build Settings from the top menu (File > Build Settings).
  • In Platforms Make sure to select (PC, MAC & LinuxStabdalone)
  • In Target Platform Select Linux then click Build.

Building for MAC OS X

  • In Unity, open the Build Settings from the top menu (File > Build Settings).
  • In Platforms Make sure to select (PC, MAC & LinuxStabdalone)
  • In Target Platform Select MACOSX then click Build.

Building for WEBGL

  • In Unity, open the Build Settings from the top menu (File > Build Settings).
  • In Platforms Make sure to select Webgl and click switch platform
  • Click Build.

Contributing

The development or a feature branch is used while developing the code, and pushed into the master branch trunk afterwards for releases. PRs to the trunk need at least one approving review before getting merged.

Help translate the app at Hosted Weblate.

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Check out the contribution guidelines for details please.

License

MIT © Crazy Marvin