Home

Awesome

2048 Open Fun Game

2048 game with AI, Bookmarks, Auto Replay, History and other fun features, Open Source, no ads

This is 2048 game multiplatform implementation in Kotlin programming language and KorGe game engine.

Android. The latest Beta Android build is available here.

<img src="doc/images/get-it-on-rustore.png" alt="Get 2048 Open Fun Game on RuStore" height="60" /> <img src="doc/images/5x5.png" width="10"> <img src="doc/images/get-it-on-google-play.png" alt="Get 2048 Open Fun Game on Google Play" height="60" /> <img src="doc/images/5x5.png" width="10"> <img src="doc/images/get-it-on-fdroid.png" alt="Get it on F-Droid" height="60">

Windows X64 zipped executable is here.

<a id="features"/>

How to play

Swipe the game board to move all tiles left, right, up, or down. When two tiles with the same number touch, they merge into one with a double number, i.e. 2+2 merge into 4, 4+4 merge into 8 and so on. The goal is to create a tile with the highest number. Number 2048 is a good first win…

We have quite a long video post at Youtube demonstrating the app features, see User experience.

Features of "2048 Open Fun Game" that are not present in the original game

<p> <img title="Main screen of Game2048 app. Play mode ('Game pad' button in the top left corner). You see Bookmark and Pause buttons" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/1.png" height="400" /> <img src="doc/images/5x5.png" width="5" /> <img title="Dark Theme. Play mode in Landscape orientation. You see Bookmark button. Game2048 app" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/2.png" width="400" /> <img src="doc/images/5x5.png" width="5" /> <img title="6x6 board. Light theme. Watch mode ('Movie' button in the top left corner). Now watching the game movements backwards. Press the 'Movie' button to switch to Play mode. Game2048 app" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/3.png" height="400" /> <img src="doc/images/5x5.png" width="5" /> <img title="Game actions menu of Game2048 app. 'Delete game' option is shown when AI is turned off (and its 'Select AI algorithm' menu item frees a space)" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/4.png" height="400" /> <img src="doc/images/5x5.png" width="5" /> <img title="Open recent game, then watch or play it. Game2048 app" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/5.png" height="400" /> <img src="doc/images/5x5.png" width="5" /> <img title="Game Over in Game2048 app" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/6.png" height="400" /> <img src="doc/images/5x5.png" width="5" /> <img title="Theme selection in Game2048 app" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/7.png" height="400" /> <img src="doc/images/5x5.png" width="5" /> <img title="AI algorithm selection in Game2048 app" src="game2048-android/src/main/play/listings/en-US/graphics/phone-screenshots/8.png" height="400" /> </p>

Privacy policy is here.

If you found the project useful, please donate to the 2048 game development via its lead developer.

About the project

The project started in 2020 from the tutorial RezMike/2048 KorGe tutorial project, and then it was rewritten and is being extended aiming at becoming an open (board) game template that is easy to modify, to extend and to play with using Kotlin programming language and KorGe game engine.

Following this goal:

Contribution

<a id="changelog"/>

Changelog

2023-08-06 v.1.13.2 (37) Different board sizes.

2022-03-20 v.1.12.0 (34) Share and Load huge game histories.

2021-12-21 v.1.11.0 (33) Retries counter and Landscape layout.

How to run the project

Android-specific project

This multiplatform project has additional Android-specific project that is customized to have richer User experience on Android platform. The project is in the game2048-android subfolder and can be opened and run using Android Studio.
It consists of build configuration files, and it reuses common source code.

JVM target

Use "jvmRun" Gradle task to start the game as a Java application (i.e. no need for Android device or emulator).

Additional arguments:

ArgumentDescription
-Duser.color.theme=darkswitch to the Dark Theme
-Duser.language=ruswitch to Russian locale ("zh" - to Chinese Simplified)
-Duser.screen.orientation=landscapelandscape screen orientation ("tall" - taller screen)

Running instructions from Korge template project

The implementation uses the KorGe template project. Below are the compiling and running instructions taken from the template.

You can open this project in IntelliJ IDEA by opening the folder or the build.gradle.kts file.

You can find this template at GitHub: https://github.com/korlibs/korge-hello-world

For Windows, change all the ./gradlew for gradlew.bat.

You should use Gradle 5.5 or greater and Java 8 or greater.

Tasks related to specific targets, might not be available if the target is not enabled, make sure that the required targets are enabled/not commented out in the korge {} section inside build.gradle.kts.

Compiling for the JVM (Desktop)

Inside IntelliJ you can go to the src/commonMain/kotlin/main.kt file and press the green ▶️ icon that appears to the left of the suspend fun main() line.

Using gradle tasks on the terminal:

./gradlew runJvm                    # Runs the program
./gradlew packageJvmFatJar          # Creates a FAT Jar with the program
./gradlew packageJvmFatJarProguard  # Creates a FAT Jar with the program and applies Proguard to reduce the size

Fat JARs are stored in the /build/libs folder.

Compiling for the Web

Using gradle tasks on the terminal:

./gradlew jsWeb                     # Outputs to /build/web
./gradlew jsWebMin                  # Outputs to /build/web-min (applying Dead Code Elimination)
./gradlew jsWebMinWebpack           # Outputs to /build/web-min-webpack (minimizing and grouping into a single bundle.js file)
./gradlew runJs                     # Outputs to /build/web, creates a small http server and opens a browser

You can use any HTTP server to serve the files in your browser. For example using: npm -g install http-server and then executing hs build/web.

You can also use ./gradlew -t jsWeb to continuously building the JS sources and running hs build/web in another terminal. Here you can find a testJs.sh script doing exactly this for convenience.

You can run your tests using Node.JS by calling jsTest or in a headless chrome with jsTestChrome.

Compiling for Native Desktop (Windows, Linux and macOS)

Using gradle tasks on the terminal:

./gradlew linkDebugExecutableMacosX64         # Outputs to /build/bin/macosX64/mainDebugExecutable/main.kexe
./gradlew linkDebugExecutableLinuxX64         # Outputs to /build/bin/linuxX64/mainDebugExecutable/main.kexe
./gradlew linkDebugExecutableMingwX64         # Outputs to /build/bin/mingwX64/mainDebugExecutable/main.exe

Note that windows executables doesn't have icons bundled. You can use ResourceHacker to add an icon to the executable for the moment. Later this will be done automatically.

Cross-Compiling for Linux/Windows

If you have docker installed, you can generate native executables for linux and windows using the cross-compiling gradle wrappers:

./gradlew_linux linkDebugExecutableLinuxX64   # Outputs to /build/web
./gradlew_win   linkDebugExecutableMingwX64   # Outputs to /build/web

Generating MacOS .app

./gradlew packageMacosX64AppDebug             # Outputs to /build/unnamed-debug.app

You can change Debug for Release in all the tasks to generate Release executables.

You can use the strip tool from your toolchain (or in the case of windows found in the ``~/.konan` toolchain) to further reduce Debug and Release executables size by removing debug information (in some cases this will shrink the EXE size by 50%).

In windows this exe is at: %USERPROFILE%\.konan\dependencies\msys2-mingw-w64-x86_64-gcc-7.3.0-clang-llvm-lld-6.0.1\bin\strip.exe.

Linux notes

Since linux doesn't provide standard multimedia libraries out of the box, you will need to have installed the following packages: freeglut3-dev and libopenal-dev.

In ubuntu you can use apt-get: sudo apt-get -y install freeglut3-dev libopenal-dev.

Compiling for Android

You will need to have installed the Android SDK in the default path for your operating system or to provide the ANDROID_SDK environment variable. The easiest way is to install Android Studio.

Using gradle tasks on the terminal:

Native Android (JVM)

./gradlew installAndroidDebug             # Installs an APK in all the connected devices
./gradlew runAndroidEmulatorDebug         # Runs the application in an emulator

Triggering these tasks, it generates a separate android project into build/platforms/android. You can open it in Android Studio for debugging and additional tasks. The KorGE plugin just delegates gradle tasks to that gradle project.

Apache Cordova (JS)

./gradlew compileCordovaAndroid           # Just compiles cordova from Android
./gradlew runCordovaAndroid               # Runs the application (dce'd, minimized and webpacked) in an Android device
./gradlew runCordovaAndroidNoMinimized    # Runs the application in Android without minimizing (so you can use `chrome://inspect` to debug the application easier)

Compiling for iOS

You will need XCode and to download the iOS SDKs using Xcode.

Using gradle tasks on the terminal:

Native iOS (Kotlin/Native) + Objective-C

Note that the necessary bridges are built using Objective-C instead of Swift, so the application won't include Swift's runtime.

./gradlew iosBuildSimulatorDebug          # Creates an APP file
./gradlew installIosSimulatorDebug        # Installs an APP file in the simulator
./gradlew runIosSimulatorDebug            # Runs the APP in the simulator

These tasks generate a xcode project in build/platforms/ios, so you can also open the project with XCode and do additional tasks there.

It uses XCodeGen for the project generation and ios-deploy for deploying to real devices.

JS-game deployment to GitHub Pages