This article relates to the game "Portal". Click here for more information.
This article relates to the game "Half-Life 2". Click here for more information.
This article's documentation is for anything that uses the Source engine. Click here for more information.

Source on Android

From Valve Developer Community
Jump to navigation Jump to search
English (en)Hrvatski (hr)Translate (Translate)

Source Engine on Android is an unofficial port of the Source Source Engine to other Android devices. Initial versions were based off the leaked source code of NVIDIA's Shield port of Half-Life 2 Half-Life 2 and Portal Portal, which were built specifically for NVIDIA Tegra hardware (which runs on Android).
Before the Source Engine code was leaked, this was the only way of playing these games on an Android based system.
Newer Releases use the leaked Source Engine 2018 code and have abandoned the Nvidia Shield version.

History

In 2019 a user named "nillerusr" started uploading development videos to YouTube showing off a modified version of the NVIDIA Shield version of Half-Life 2 running on a standard Android device.
In his first video on the topic he shows off the touch capabilities of the mod.

Later versions of the port were based on leaked Source Engine code (specifically Team Fortress 2 version of Source 2013 Multiplayer) dated back to 2017-2018 (which was leaked in 2020). This allows more games to be ported and graphics & shaders will be rendered correctly on other devices without NVIDIA Tegra chip.

A public build would be released on October 30, 2020. This build included playable versions of Half-Life 2 Half-Life 2, Half-Life 2: Episode One Half-Life 2: Episode One, Half-Life 2: Episode Two Half-Life 2: Episode Two and Portal Portal.

Since then many other games have been ported such as Half-Life 2: Deathmatch Half-Life 2: Deathmatch, Half-Life: Source Half-Life: Source, Day of Defeat: Source Day of Defeat: Source, Counter-Strike: Source Counter-Strike: Source and Half-Life Deathmatch: Source Half-Life Deathmatch: Source

Installation

The main Source Engine app
Icon-Important.pngImportant:While the game files can be copied over from your PC it is highly recommended to use the download script since it is faster and avoids corruption.

Windows

  1. Download the latest Source Engine apk and then the game apk of your choosing (the Source Engine app launches base Half-Life 2); see the External links section below.
  2. In the phone's storage create a folder called 🖿srceng (or anything really)
  3. Launch Steam, then click here to open Steam developer console.
  4. Download the game using this command as an example: download_depot 220 221 401613439882517483 - this example here downloads Half-Life 2 pre-Anniversary version.
  5. Go to 🖿Steam folder\steamapps\content\app_220\depot_221 and copy the 🖿hl2 (or other games) folder to 🖿srceng (or whatever you named it).
  6. Optionally set any parameters (launch options) and launch.

From your phone

  1. Download the latest Source Engine apk and then the game apk of your choosing (the Source Engine app launches base Half-Life 2); see the External links section below.
  2. In the phone's storage create a folder called 🖿srceng (or anything really)
  3. Install Termux.
  4. Once inside Termux, install Depot Downloader
  5. Download the games using this command as an example: depotdownloader -username user -password pass -app 220 -depot 221 -dir HL2 -validate -branch steam_legacy - this exmaple here downloads Half-Life 2 pre-Anniversary version.
  6. Verify with the Steam Mobile app or your email (if you use Steam Guard).
  7. Go to your Downloads folder, find "depotdownload" directory and copy the 🖿hl2 (or other games) folder to 🖿srceng (or whatever you named it).
  8. Optionally set any parameters (launch options) and launch.
Tip.pngTip:If the gallery app picks up the images from the game files, place a ".nomedia" file in the srceng folder
Note.pngNote:(Half-Life 2 & TF2 branch only) This port is currently only compatible with pre-20th anniversary version files, these parameters have to be used -branch steam_legacy to choose the steam_legacy build for Half-Life 2. For TF2 branch based game (Counter-Strike: Source, Day of Defeat: Source), switch to -branch previous_build.

Installing Other Games

To install games besides Half-Life 2, simply copying the folder of the same name as the game to the srceng folder is all that is needed.
For example, to install Portal, these parameters can be used -app 400 -depot 401 for Portal's resources which have to then simply be copied to the srceng folder. Then Portal can be launched from the separate Portal app.

The following diagram showcases the game folder structure:

srceng
|
├── hl2         -->  Half-Life 2, (REQUIRED FOR ALL GAMES)
├── platform    -->  Files related to VGUI, (REQUIRED FOR ALL GAMES)
|
├── hl2mp       -->  Half-Life 2: Deathmatch
├── episodic    -->  Half-Life 2: Episode 1
├── ep2         -->  Half-Life 2: Episode 2
|
├── hl1         -->  Half-Life: Source
├── dod         -->  Day of Defeat: Source
├── cstrike     -->  Counter-Strike: Source
└── portal      -->  Portal
Note.pngNote:If help is needed, questions can be asked on the official Discord server: niIlerusr's Discord server
Portal running on a Redmi Note 9 Pro

Installing on an SD Card

Warning.pngWarning:Installing the game files on a SD Card is not recommended by the developers.


Installing all the game files on a SD Card can be beneficial if the internal storage is full or has slow read-write speeds.
However, since the app only allows for the selection of directories from the internal storage, the SD Card path has to be entered manually.


Getting the path to the SD Card alone can be challenging since regular file managers just report it as "SD Card" and don't give the actual path to it.

The easiest and least "ad-riddled" way of getting the SD Card's path is to connect the device to a computer loaded with ADB (Android Debug Bridge)

To use ADB, USB debugging has to be enabled which varies depending on your Android variant.

Tip.pngTip:Simply look up your device on the internet for instructions on enabling USB debugging.

Once all that has been done, a command prompt has to be opened in the folder in which ADB is located in (this can be done by typing cmd in the address bar)

Then to confirm that the device is recognized by the system, typing in adb devices will show all attached devices.

If a string of numbers and letters followed with device shows up, that means that it has been detected.

Note.pngNote:A pop-up will show up on the phone asking you to authorize the PC, press yes.

Next, type adb shell

Then, type df. This will list all directories on a root level. The directories we are interested in are usually at the bottom. There should be 2 directories starting with 🖿/storage/.
The internal storage will always be 🖿/storage/emulated while the SD-Card is usually 🖿/storage/ followed by a 8 character string divided into two by a dash (-)

For example:

/dev/fuse			109783884 53449520 56203292   49%  /storage/emulated		<- The Internal Storage
/dev/fuse			124835840 35815296 89020544   29%  /storage/9257-194E		<- The SD-Card

The path specified (in this example 🖿/storage/9257-194E) is what we will write in the "Path to game resources" dialog in the app.

External Links

niIlerusr's Discord server

See Also