Merge pull request #769 from arianne/dependabot/npm_and_yarn/npm_and_yarn-53cbaf2a5b

Bump esbuild from 0.27.2 to 0.28.1 in the npm_and_yarn group across 1 directory

.classpath

@@ -25,5 +25,5 @@
 	<classpathentry kind="lib" path="libs/jakarta.annotation-api-2.1.1.jar"/>
 	<classpathentry exported="true" kind="lib" path="libs/tomcat-embed-core-10.1.13.jar"/>
 	<classpathentry kind="lib" path="libs/tomcat-embed-websocket-10.1.13.jar"/>
-	<classpathentry kind="output" path="bin"/>
+	<classpathentry kind="output" path="build/eclipse"/>
 </classpath>

.github/workflows/android-build.yml

@@ -0,0 +1,62 @@
+name: Android Build Test
+
+on:
+  push:
+    paths:
+      - 'app/android/**'
+  pull_request:
+    paths:
+      - 'app/android/**'
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - id: job_info
+        uses: daleyjem/gh-job-id@v1
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          job_name: 'build'
+
+      - name: Checkout Repository
+        uses: actions/checkout@v3
+
+      - name: Set Up JDK
+        uses: actions/setup-java@v3
+        with:
+          java-version: '17'
+          distribution: 'adopt'
+
+      - name: Validate Gradle Wrapper .jar
+        run: |
+          cd app/android/gradle/wrapper
+          curl --location --output gradle-wrapper.jar.sha256 \
+            https://services.gradle.org/distributions/gradle-7.5.1-wrapper.jar.sha256
+          echo " gradle-wrapper.jar" >> gradle-wrapper.jar.sha256
+          sha256sum --check gradle-wrapper.jar.sha256
+
+      - name: Build APKs with Ant
+        uses: cedx/setup-ant@v6
+        with:
+          version: '1.10'
+      - run: ant -noinput -buildfile build.xml android -Dgradle.params="assembleDebug assembleRelease"
+
+      - name: Failure Report
+        uses: sarisia/actions-status-discord@v1
+        if: failure()
+        env:
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK_DEVELOPMENT }}
+        with:
+          title: 'Android Build Failed'
+          description: '${{ steps.job_info.outputs.html_url }}'
+          nodetail: true
+      - uses: sarisia/actions-status-discord@v1
+        if: failure()
+        env:
+          DISCORD_WEBHOOK: ${{ secrets.DISCORD_WEBHOOK_DEVLOG }}
+        with:
+          title: 'Android Build Failed'
+          description: '${{ steps.job_info.outputs.html_url }}'
+          nodetail: true

.github/workflows/codeql-analysis.yml

@@ -29,15 +29,15 @@ jobs:
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@v2
+      uses: github/codeql-action/init@v3
       # Override language selection by uncommenting this and choosing your languages
       # with:
       #   languages: go, javascript, csharp, python, cpp, java
 
     # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
     # If this step fails, then you should remove it and run the build manually (see below)
-    - name: Autobuild
-      uses: github/codeql-action/autobuild@v2
+    #- name: Autobuild
+    #  uses: github/codeql-action/autobuild@v3
 
     # ℹ️ Command-line programs to run using the OS shell.
     # 📚 https://git.io/JvXDl
@@ -46,9 +46,7 @@ jobs:
     #    and modify them (or add more) to build your code if your project
     #    uses a compiled language
 
-    #- run: |
-    #   make bootstrap
-    #   make release
+    - run: ant -noinput -f build.xml clean compile
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@v2
+      uses: github/codeql-action/analyze@v3

.github/workflows/prerelease_webview_client.yml

@@ -39,7 +39,7 @@ jobs:
       - name: Build APKs
         run: >
           ant -noinput -buildfile build.xml dist_android_client
-          -Dgradle.params="--no-daemon -Pandroid.ver=${{ steps.ver.outputs.value }} assembleDebug assemblePrerelease"
+          -Dgradle.params="-Pandroid.ver=${{ steps.ver.outputs.value }} assembleDebug assembleRelease"
 
       - name: Publish
         uses: softprops/action-gh-release@v1

.gitignore

@@ -40,7 +40,6 @@ javadocs
 statserver_stats.xml
 /*.ks
 build_client_data
-/bin
 .byecycle
 build_server_xmlconf
 *.umlproject
@@ -49,3 +48,5 @@ build_server_xmlconf
 /map.map
 /hs_err_*.log
 /node_modules/
+/log/
+/build-archive/

.project

@@ -20,4 +20,15 @@
 		<nature>org.eclipse.jdt.core.javanature</nature>
 		<nature>org.eclipse.wst.common.project.facet.core.nature</nature>
 	</natures>
+	<filteredResources>
+		<filter>
+			<id>1771748271774</id>
+			<name></name>
+			<type>30</type>
+			<matcher>
+				<id>org.eclipse.core.resources.regexFilterMatcher</id>
+				<arguments>node_modules|\.git|__CREATED_BY_JAVA_LANGUAGE_SERVER__</arguments>
+			</matcher>
+		</filter>
+	</filteredResources>
 </projectDescription>

README.md

@@ -20,19 +20,38 @@ So what are you waiting for?! A whole new world awaits...
 
 ## How to play
 
-[![Play now](https://arianne-project.org/images/playbutton.png)](https://stendhalgame.org/account/mycharacters.html)        
+### Web Browser
+
+[![Play now](https://arianne-project.org/images/playbutton.png)](https://stendhalgame.org/account/mycharacters.html)
+
+Play in any web browser for desktop or mobile with JavaScript support. Click on the "play now"
+button to create or log in to your account.
+
+### Mobile
+
+Play using the [progressive web app](https://en.wikipedia.org/wiki/Progressive_web_app). Just visit
+[stendhalgame.org](https://stendhalgame.org/) in your mobile browser and click "install" when prompted.
+
+[<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" height="75">](https://f-droid.org/packages/org.stendhalgame.client/)
+
+Play on your Android device using the dedicated app. You can get it from the
+[F-Droid App Store](https://f-droid.org/) or download it from [stendhalgame.org](https://stendhalgame.org/download.html).
+
+### Classic Desktop
+
 [![Download](https://stendhalgame.org/images/downloadbutton.png)](https://arianne-project.org/download/stendhal.zip)
 
-You need Java which you can download from [https://www.java.com](https://www.java.com/en/download) on Microsoft Windows. Java is included in most Linux distributions. Both Oracle Java and OpenJDK are supported.
+Play using the classic desktop client. You will need Java which you can download from
+[java.com](https://www.java.com/en/download) on Microsoft Windows. Java is included in
+most Linux distributions. Both Oracle Java and OpenJDK are supported.
 
-Please download Stendhal from [https://stendhalgame.org](https://stendhalgame.org)<br>
-You can double click on stendhal-starter.jar and the client will run.<br>
-If you prefer to run from command line, then just execute this command
-in the stendhal folder:
+Please download Stendhal from [stendhalgame.org](https://stendhalgame.org/download.html).<br>
+You can double click on `stendhal-starter.jar` and the client will run.<br>
+If you prefer to run from command line, then just execute this command in the stendhal folder:
 
 `java -jar stendhal-starter.jar`
 
-There is a  [manual](https://stendhalgame.org/wiki/Stendhal_Manual), and there is Help from the client menu icons in the upper right hand side of the game screen.
+There is a [manual](https://stendhalgame.org/wiki/Stendhal_Manual), and there is Help from the client menu icons in the upper right hand side of the game screen.
 
 
 ## Development environment
@@ -44,13 +63,18 @@ There is a  [manual](https://stendhalgame.org/wiki/Stendhal_Manual), and there i
 
 
 ## Legal
-The server and java client are free software; you can redistribute it and/or modify it under the terms of the **GNU General Public License** 2 or later as published by the Free Software Foundation.
 
-The web client is free software; you can redistribute it and/or modify it under the terms of the **GNU Affero General Public License** 3 or later as published by the Free Software Foundation.
+Stendhal is free software. You can redistribute it and/or modify under the following terms:
 
-This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the [LICENSE.txt](LICENSE.txt) file for more details.
+- The **server**, **java client**, and **Android client**: *GNU General Public License* 2 or later as published by the Free Software Foundation
+- The **web client** and **native client**: *GNU Affero General Public License* 3 or later as published by the Free Software Foundation with the definition of "System libraries" being extended to include authentication providers and software distribution platforms.
+- The **nativehelper** extensions: *GNU Lesser General Public License* 3 or later as published by the Free Software Foundation 
+
+This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without
+even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+[LICENSE.txt](LICENSE.txt) and [src/js/LICENSE.html](src/js/LICENSE.html) file for more details.
 
 Stendhal(c) is copyright of Miguel Angel Blanch Lardin, 2005-2008, arianne_rpg at users dot sourceforge dot net and others<br>
-Stendhal(c) is copyright of the Arianne Project, 2006-2023, arianne-general at lists dot sourceforge dot net
+Stendhal(c) is copyright of the Arianne Project, 2006-2026, arianne-general at lists dot sourceforge dot net
 
-Please have a look at the list of [contributors](https://github.com/arianne/stendhal/blob/master/doc/contributors.md#contributors).
+Please have a look at the list of [contributors](doc/contributors.md#contributors).

android/TODO.txt

@@ -1,13 +0,0 @@
-
-TODO:
-- show input preview when typing
-- scale page to fit inside view
-- create activity for about information
-- add credits to about information
-- switch to Log4j for logging (maybe)
-- use center of d-pad for setting position
-- d-pads need to be different sizes for different resolutions
-  - either use unique PNGs or convert to scalable SVGs
-
-BUILD TODO:
-- script to download Android SDK

android/app/build.gradle

@@ -1,79 +0,0 @@
-plugins {
-	id 'com.android.application'
-}
-
-android {
-	compileSdk 32
-
-	def buildDate = new Date().format("yyyyMMdd")
-
-	def appVer
-	if (project.hasProperty("android.ver") && project["android.ver"]) {
-		appVer = project["android.ver"]
-	} else {
-		appVer = "${buildDate}"
-	}
-
-	if (project.hasProperty("android.rev") && project["android.rev"]) {
-		appVer += "-" + project["android.rev"]
-	}
-
-	def outputName = "stendhal-webview-${appVer}"
-
-	defaultConfig {
-		applicationId "org.arianne.stendhal.client"
-		minSdk 21
-		targetSdk 32
-		versionCode 1
-		versionName "${appVer}"
-		setProperty("archivesBaseName", "${outputName}")
-		setProperty("buildDir", "${projectDir}/../../build/build_android_client")
-
-		testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
-		targetSdkVersion 32
-		minSdkVersion 21
-	}
-
-	buildTypes {
-		release {
-			minifyEnabled false
-			proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
-		}
-
-		prerelease {
-			versionNameSuffix "-pre"
-			signingConfig signingConfigs.debug
-		}
-
-		debug {
-			applicationIdSuffix ".debug"
-			versionNameSuffix "-debug"
-		}
-	}
-
-	buildTypes.all { type ->
-		if (!type.name.equals("debug")) {
-			sourceSets[type.name].java { srcDirs "src/shared/java/" }
-		}
-	}
-
-	compileOptions {
-		sourceCompatibility JavaVersion.VERSION_1_8
-		targetCompatibility JavaVersion.VERSION_1_8
-	}
-	compileSdkVersion 32
-	buildToolsVersion '32.0.0'
-
-	lintOptions {
-		abortOnError false
-	}
-}
-
-dependencies {
-	implementation 'androidx.appcompat:appcompat:1.4.1'
-	implementation 'com.google.android.material:material:1.4.0'
-	//testImplementation 'junit:junit:4.+'
-	//androidTestImplementation 'androidx.test.ext:junit:1.1.2'
-	//androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
-	implementation files('../../libs/marauroa.jar')
-}

android/app/src/debug/AndroidManifest.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-  package="org.arianne.stendhal.client">
-  <application android:usesCleartextTraffic="true">
-  </application>
-</manifest>

android/app/src/debug/java/org/arianne/stendhal/client/DebugLog.java

@@ -1,157 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client;
-
-import android.app.AlertDialog;
-import android.content.DialogInterface;
-import android.util.Log;
-import androidx.appcompat.app.AppCompatActivity;
-
-import java.io.BufferedWriter;
-import java.io.File;
-import java.io.FileWriter;
-import java.io.IOException;
-import java.text.SimpleDateFormat;
-import java.util.Date;
-
-
-/**
- * A class to output debugging information to logcat file.
- */
-public class DebugLog {
-
-	private static File logsDir;
-
-	private static AppCompatActivity mainActivity;
-
-	public static enum DebugLevel {
-		INFO("INFO"),
-		WARN("WARN"),
-		ERROR("ERROR"),
-		DEBUG("DEBUG");
-
-		private final String label;
-
-		private DebugLevel(final String label) {
-			this.label = label;
-		}
-
-		public String getLabel() {
-			return label;
-		}
-	}
-
-	private static DebugLog instance;
-
-
-	public static DebugLog get() {
-		if (instance == null) {
-			instance = new DebugLog();
-		}
-
-		return instance;
-	}
-
-	public static void init(final File dir, final AppCompatActivity activity) {
-		logsDir = new File(dir.getPath() + "/logs");
-		mainActivity = activity;
-
-		writeLine("\n  // -- debugging initialized -- //", null);
-		writeLine("logs directory: " + logsDir.getPath());
-	}
-
-	public static void writeLine(final String text) {
-		writeLine(text, DebugLevel.DEBUG);
-	}
-
-	public static void writeLine(String text, final DebugLevel level) {
-		if (logsDir == null) {
-			System.err.println("ERROR: DebugLog not initialized. Call DebugLog.init.");
-			return;
-		}
-
-		if (!logsDir.exists()) {
-			logsDir.mkdirs();
-		}
-
-		if (level != null) {
-			text = new SimpleDateFormat("yyyy.MM.dd.HH.mm.ss").format(new Date())
-				+ ": " + level.label + ": " + text;
-		}
-		text = text + "\n";
-
-		final String logFile = logsDir.getPath() + "/debug-"
-			+ new SimpleDateFormat("yyyy.MM.dd").format(new Date()) + ".txt";
-
-		BufferedWriter buffer;
-		try {
-			buffer = new BufferedWriter(new FileWriter(logFile, true));
-			buffer.write(text);
-			if (buffer != null) {
-				buffer.close();
-			}
-		} catch (final IOException e) {
-			System.err.println("ERROR: " + e.getMessage());
-		}
-	}
-
-	public static void info(final String text) {
-		Log.i("DebugLog", text);
-		writeLine(text, DebugLevel.INFO);
-	}
-
-	public static void warn(final String text) {
-		Log.w("DebugLog", text);
-		writeLine(text, DebugLevel.WARN);
-	}
-
-	public static void error(final String text) {
-		Log.e("DebugLog", text);
-		writeLine(text, DebugLevel.ERROR);
-	}
-
-	public static void debug(final String text) {
-		Log.d("DebugLog", text);
-		writeLine(text, DebugLevel.DEBUG);
-	}
-
-	public static void notify(final String message) {
-		notify(message, DebugLevel.DEBUG);
-	}
-
-	public static void notify(final String message, DebugLevel level) {
-		if (mainActivity == null) {
-			System.err.println("ERROR: DebugLog not initialized. Call DebugLog.init.");
-			return;
-		}
-
-		if (level == null) {
-			level = DebugLevel.DEBUG;
-		}
-
-		final AlertDialog.Builder builder = new AlertDialog.Builder(mainActivity);
-		builder.setTitle(level.label);
-		builder.setMessage(message);
-
-		builder.setPositiveButton("Ok", new DialogInterface.OnClickListener() {
-			public void onClick(final DialogInterface dialog, final int id) {
-				dialog.cancel();
-			}
-		});
-
-		builder.create().show();
-	}
-
-	public static String getLogsDir() {
-		return logsDir.getPath();
-	}
-}

android/app/src/main/AndroidManifest.xml

@@ -1,41 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<manifest xmlns:android="http://schemas.android.com/apk/res/android"
-  package="org.arianne.stendhal.client">
-
-  <uses-permission android:name="android.permission.INTERNET" />
-  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
-  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
-
-  <application
-    android:allowBackup="true"
-    android:icon="@mipmap/ic_launcher"
-    android:label="@string/app_name"
-    android:roundIcon="@mipmap/ic_launcher_round"
-    android:supportsRtl="true"
-    android:theme="@style/Theme.Stendhal.FullScreen">
-    <activity
-      android:name=".MainActivity"
-      android:label="@string/app_name"
-      android:exported="true"
-      android:configChanges="orientation|screenSize|keyboardHidden">
-      <intent-filter>
-        <action android:name="android.intent.action.MAIN" />
-
-        <category android:name="android.intent.category.LAUNCHER" />
-      </intent-filter>
-    </activity>
-
-    <activity
-      android:name=".PreferencesActivity"
-      android:label="Preferences"
-      android:exported="true"
-      android:configChanges="orientation|screenSize|keyboardHidden">
-
-      <intent-filter>
-        <action android:name="preferences" />
-      </intent-filter>
-    </activity>
-  </application>
-
-</manifest>

android/app/src/main/java/org/arianne/stendhal/client/ClientView.java

@@ -1,572 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022-2023 - Arianne                     *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client;
-
-import android.app.AlertDialog;
-import android.content.pm.ApplicationInfo;
-import android.content.Context;
-import android.content.DialogInterface;
-import android.content.Intent;
-import android.graphics.Bitmap;
-import android.net.Uri;
-import android.os.Build;
-import android.util.AttributeSet;
-import android.view.inputmethod.BaseInputConnection;
-import android.view.inputmethod.EditorInfo;
-import android.view.inputmethod.InputMethodManager;
-import android.view.inputmethod.InputConnection;
-import android.view.KeyEvent;
-import android.view.MotionEvent;
-import android.view.View;
-import android.webkit.DownloadListener;
-import android.webkit.WebChromeClient;
-import android.webkit.WebSettings;
-import android.webkit.WebView;
-import android.webkit.WebViewClient;
-import android.widget.ImageView;
-
-import marauroa.common.Pair;
-
-import org.arianne.stendhal.client.input.DPad;
-import org.arianne.stendhal.client.js.JSInterface;
-import org.arianne.stendhal.client.sound.MusicPlayer;
-
-
-public class ClientView extends WebView {
-
-	private static ClientView instance;
-
-	private ImageView splash;
-
-	private final String defaultServer = "https://stendhalgame.org/";
-	private String clientUrlSuffix = "client";
-
-	private boolean testClient = false;
-	private boolean testServer = false;
-	private Boolean debugging;
-	private static PageId currentPage;
-	// denotes previous touch was remapped to mouse event
-	private boolean touchOverridden = false;
-
-
-	/**
-	 * Retrieves the static instance.
-	 */
-	public static ClientView get() {
-		return instance;
-	}
-
-	public ClientView(final Context ctx) {
-		super(ctx);
-		onInit();
-	}
-
-	public ClientView(final Context ctx, final AttributeSet attrs) {
-		super(ctx, attrs);
-		onInit();
-	}
-
-	public ClientView(final Context ctx, final AttributeSet attrs, final int style) {
-		super(ctx, attrs, style);
-		onInit();
-	}
-
-	public ClientView(final Context ctx, final AttributeSet attrs, final int style,
-			final boolean prvtBrowse) {
-		super(ctx, attrs, style, prvtBrowse);
-		onInit();
-	}
-
-	private void onInit() {
-		instance = this;
-
-		setBackgroundColor(android.graphics.Color.TRANSPARENT);
-
-		final WebSettings viewSettings = getSettings();
-		viewSettings.setJavaScriptEnabled(true);
-		viewSettings.setDomStorageEnabled(true);
-
-		// keep elements in position in portrait mode
-		viewSettings.setLayoutAlgorithm(WebSettings.LayoutAlgorithm.SINGLE_COLUMN);// <-- SINGLE_COLUMN deprecated
-		viewSettings.setLoadWithOverviewMode(true);
-		viewSettings.setUseWideViewPort(true);
-
-		// disable zoom
-		viewSettings.setSupportZoom(false);
-		viewSettings.setBuiltInZoomControls(false);
-		viewSettings.setDisplayZoomControls(false);
-
-		// allow autoplay of music
-		viewSettings.setMediaPlaybackRequiresUserGesture(false);
-
-		if (debugEnabled()) {
-			// make WebView debuggable for debug builds
-			setWebContentsDebuggingEnabled(true);
-		}
-
-		initWebViewClient();
-		initTouchHandler();
-		initJSInterface();
-		initDownloadHandler();
-	}
-
-	private void initWebViewClient() {
-		// XXX: not sure setting WebChromClient is doing anything, was recommended to
-		//      fix touchmove events not registering
-		setWebChromeClient(new WebChromeClient());
-
-		setWebViewClient(new WebViewClient() {
-			/* handle changing URLs */
-			@Override
-			public boolean shouldOverrideUrlLoading(final WebView view, final String url) {
-				if (!isInternalUrl(url)) {
-					// open external links in default browser/app
-					// FIXME: should we ask for confirmation?
-					MainActivity.get().startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse(url)));
-					return true;
-				}
-
-				view.loadUrl(checkClientUrl(url));
-				return false;
-			}
-
-			@Override
-			public void onPageStarted(final WebView view, final String url, final Bitmap favicon) {
-				DebugLog.debug("loading URL: " + url);
-
-				MusicPlayer.stopMusic();
-				super.onPageStarted(view, url, favicon);
-			}
-
-			@Override
-			public void onPageFinished(final WebView view, final String url) {
-				super.onPageFinished(view, url);
-
-				if (isClientUrl(url)) {
-					currentPage = PageId.WEBCLIENT;
-				} else if (url.equals("") || url.equals("about:blank")) {
-					currentPage = PageId.TITLE;
-					if (PreferencesActivity.getBoolean("title_music", true)) {
-						playTitleMusic();
-					}
-				} else {
-					currentPage = PageId.OTHER;
-				}
-				Menu.get().updateButtons();
-
-				// only show d-pad on client screen
-				final DPad pad = DPad.getCurrentPad();
-				if (pad != null && PreferencesActivity.getBoolean("show_dpad", false)) {
-					if (isGameActive()) {
-						pad.show();
-					} else {
-						pad.hide();
-					}
-				}
-
-				DebugLog.debug("page id: " + currentPage);
-			}
-		});
-	}
-
-	private void initTouchHandler() {
-		setOnTouchListener(new View.OnTouchListener() {
-			@Override
-			public boolean onTouch(final View view, final MotionEvent event) {
-				if (touchOverridden) {
-					// reset touch event state
-					touchOverridden = false;
-					return false;
-				}
-
-				final MotionEvent.PointerProperties[] props = {new MotionEvent.PointerProperties()};
-				event.getPointerProperties(0, props[0]);
-
-				if (isGameActive() && PreferencesActivity.getBoolean("map_touches", false)
-						&& (props[0].toolType == MotionEvent.TOOL_TYPE_FINGER
-							|| props[0].toolType == MotionEvent.TOOL_TYPE_STYLUS)) {
-					Integer action = event.getAction();
-
-					/*
-					switch (action) {
-						case MotionEvent.ACTION_DOWN:
-							action = MotionEvent.ACTION_BUTTON_PRESS;
-							break;
-						case MotionEvent.ACTION_UP:
-							action = MotionEvent.ACTION_BUTTON_RELEASE;
-							break;
-					}
-					*/
-
-					DebugLog.debug("mapping touch to mouse event");
-
-					props[0].toolType = MotionEvent.TOOL_TYPE_MOUSE;
-
-					final MotionEvent.PointerCoords[] coords = {new MotionEvent.PointerCoords()};
-					event.getPointerCoords(0, coords[0]);
-
-					touchOverridden = true;
-
-					view.dispatchTouchEvent(MotionEvent.obtain(event.getDownTime(),
-						event.getEventTime(), event.getAction(), event.getPointerCount(), props,
-						coords, event.getMetaState(), MotionEvent.BUTTON_PRIMARY,
-						event.getXPrecision(), event.getYPrecision(), event.getDeviceId(),
-						event.getEdgeFlags(), event.getSource(), event.getFlags()));
-
-					return true; // consume old event
-				}
-
-				return false;
-			}
-		});
-	}
-
-	@Override
-	public InputConnection onCreateInputConnection(final EditorInfo outAttrs) {
-		// allows capturing soft keyboard events
-		return new BaseInputConnection(this, false);
-	}
-
-	@Override
-	public boolean dispatchKeyEvent(final KeyEvent event) {
-		final boolean ret = super.dispatchKeyEvent(event);
-
-		// hide keyboard when "enter" pressed
-		if (isGameActive() && event.getAction() == KeyEvent.ACTION_UP
-				&& event.getKeyCode() == KeyEvent.KEYCODE_ENTER) {
-			((InputMethodManager) MainActivity.get()
-				.getSystemService(Context.INPUT_METHOD_SERVICE))
-				.hideSoftInputFromWindow(this.getWindowToken(), 0);
-		}
-
-		return ret;
-	}
-
-	private void initJSInterface() {
-		addJavascriptInterface(JSInterface.get(), "jsi");
-	}
-
-	/**
-	 * Handles downloading screenshot created by web client.
-	 */
-	private void initDownloadHandler() {
-		setDownloadListener(new DownloadListener() {
-			@Override
-			public void onDownloadStart(final String url, final String userAgent,
-					final String contentDisposition, final String mimetype,
-					final long contentLength) {
-
-				final Pair<Boolean, String> res = new DownloadHandler().download(url, mimetype);
-				if (res.first()) {
-					final String msg = "Downloaded file: " + res.second();
-					DebugLog.debug(msg);
-					Notifier.toast(msg);
-				} else {
-					final String msg = res.second();
-					DebugLog.error(msg);
-					Notifier.toast("ERROR: " + msg);
-				}
-			}
-		});
-	}
-
-	public String getSelectedClient() {
-		if (ClientView.onTitleScreen()) {
-			return "none";
-		}
-		return testClient ? "test" : "main";
-	}
-
-	public String getSelectedServer() {
-		if (ClientView.onTitleScreen()) {
-			return "none";
-		}
-		return testServer ? "test" : "main";
-	}
-
-	private void reset() {
-		testClient = false;
-		testServer = false;
-		clientUrlSuffix = "client";
-	}
-
-	/**
-	 * Shows initial title screen.
-	 */
-	public void loadTitleScreen() {
-		reset();
-		setSplashResource(R.drawable.splash);
-		loadUrl("about:blank");
-		Menu.get().show();
-	}
-
-	/**
-	 * Attempts to connect to client host.
-	 */
-	public void loadLogin() {
-		if (debugEnabled() && PreferencesActivity.getString("client_url").trim().equals("")) {
-			// debug builds support choosing between main & test client/server
-			selectClient();
-		} else {
-			onSelectServer();
-		}
-	}
-
-	/**
-	 * Sets the background image.
-	 *
-	 * @param resId
-	 *     Resource ID.
-	 */
-	private void setSplashResource(final int resId) {
-		if (splash == null) {
-			splash = (ImageView) MainActivity.get().findViewById(R.id.splash);
-			splash.setBackgroundColor(android.graphics.Color.TRANSPARENT);
-		}
-
-		splash.setImageResource(resId);
-	}
-
-	/**
-	 * Opens a message dialog for user to choose between main & test clients.
-	 */
-	private void selectClient() {
-		final AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.get());
-		builder.setMessage("Select client");
-
-		builder.setPositiveButton("Main", new DialogInterface.OnClickListener() {
-			public void onClick(final DialogInterface dialog, final int id) {
-				testClient = false;
-				clientUrlSuffix = "client";
-				// skip server confirmation as only test client has this option
-				onSelectServer();
-				dialog.cancel();
-			}
-		});
-
-		builder.setNegativeButton("Test", new DialogInterface.OnClickListener() {
-			public void onClick(final DialogInterface dialog, final int id) {
-				testClient = true;
-				clientUrlSuffix = "testclient";
-				selectServer();
-				dialog.cancel();
-			}
-		});
-
-		builder.create().show();
-	}
-
-	/**
-	 * Opens a message dialog for user to choose between main & test servers.
-	 */
-	private void selectServer() {
-		final AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.get());
-		builder.setMessage("Select server");
-
-		builder.setPositiveButton("Main", new DialogInterface.OnClickListener() {
-			public void onClick(final DialogInterface dialog, final int id) {
-				testServer = false;
-				dialog.cancel();
-				onSelectServer();
-			}
-		});
-
-		builder.setNegativeButton("Test", new DialogInterface.OnClickListener() {
-			public void onClick(final DialogInterface dialog, final int id) {
-				testServer = true;
-				dialog.cancel();
-				onSelectServer();
-			}
-		});
-
-		builder.create().show();
-	}
-
-	private void onSelectServer() {
-		// remove splash image
-		setSplashResource(android.R.color.transparent);
-
-		final String custom_page = checkCustomServer();
-		if (custom_page != null) {
-			DebugLog.debug("Connecing to custom page: " + custom_page);
-
-			loadUrl(custom_page);
-		} else {
-			// initial page
-			loadUrl(defaultServer + "account/mycharacters.html");
-
-			if (testServer) {
-				DebugLog.debug("Connecting to test server");
-			} else {
-				DebugLog.debug("Connecting to main server");
-
-				Notifier.showMessage("CAUTION: This software is in early development and not recommended"
-					+ " for use on the main server. Proceed with caution.", false);
-			}
-		}
-
-		currentPage = PageId.OTHER;
-		// hide menu after exiting title screen
-		Menu.get().hide();
-	}
-
-	private String checkCustomServer() {
-		final String cs = PreferencesActivity.getString("client_url", "").trim();
-
-		if (cs.equals("")) {
-			return null;
-		}
-
-		return cs;
-	}
-
-	/**
-	 * Checks if a URL is a link to one of the web clients.
-	 *
-	 * @param url
-	 *     URL to be checked.
-	 * @return
-	 *     <code>true</code> if url links to "client" or "testclient".
-	 */
-	private boolean isClientUrl(final String url) {
-		final String custom_client = PreferencesActivity.getString("client_url").trim();
-		if (!custom_client.equals("")) {
-			return url.contains(custom_client);
-		}
-
-		return url.contains("stendhalgame.org/client/")
-			|| url.contains("stendhalgame.org/testclient/");
-	}
-
-	/**
-	 * Formats client URL for currently selected server.
-	 *
-	 * @param url
-	 *     URL to be checked.
-	 * @return
-	 *     URL to be loaded.
-	 */
-	private String checkClientUrl(String url) {
-		if (isClientUrl(url)) {
-			String replaceSuffix = "/testclient/";
-			if (testClient) {
-				replaceSuffix = "/client/";
-			}
-			// ensure website directs to configured client
-			url = url.replace(replaceSuffix, "/" + clientUrlSuffix + "/");
-			url = formatCharName(url);
-			if (testClient && !testServer) {
-				// connect test client to main server
-				url += "&server=main";
-			}
-		}
-
-		return url;
-	}
-
-	/**
-	 * Extracts character name from URL fragment identifier & converts to query string.
-	 */
-	private String formatCharName(String url) {
-		final int idx = url.indexOf("#");
-		if (idx > -1) {
-			url = url.substring(0, idx) + "?char=" + url.substring(idx+1);
-		}
-		return url;
-	}
-
-	/**
-	 * Checks if requested URL is whitelisted to be opened within WebView client.
-	 *
-	 * @param url
-	 *     URL to be checked.
-	 * @return
-	 *     <code>true</code> if URL is under domain stendhalgame.org or localhost.
-	 */
-	private boolean isInternalUrl(final String url) {
-		final String domain = getDomain(url);
-		final String cs = checkCustomServer();
-
-		if (cs != null) {
-			return domain.startsWith(getDomain(cs));
-		} else {
-			return domain.startsWith("stendhalgame.org") || domain.startsWith("localhost");
-		}
-	}
-
-	private String getDomain(final String url) {
-		return url.replaceAll("^https://", "").replaceAll("^http://", "")
-			.replaceAll("^www\\.", "");
-	}
-
-	public static boolean onTitleScreen() {
-		return currentPage == PageId.TITLE;
-	}
-
-	public static boolean isGameActive() {
-		return currentPage == PageId.WEBCLIENT;
-	}
-
-	public static PageId getCurrentPageId() {
-		return currentPage;
-	}
-
-	public static void playTitleMusic(String musicId) {
-		if (musicId == null) {
-			musicId = PreferencesActivity.getString("song_list");
-		}
-
-		int id = R.raw.title_01;
-		switch (musicId) {
-			case "title_02":
-				id = R.raw.title_02;
-				break;
-			case "title_03":
-				id = R.raw.title_03;
-				break;
-			case "title_04":
-				id = R.raw.title_04;
-				break;
-			case "title_05":
-				id = R.raw.title_05;
-				break;
-		}
-
-		DebugLog.debug("playing music: " + musicId);
-
-		MusicPlayer.playMusic(id, true);
-	}
-
-	public static void playTitleMusic() {
-		playTitleMusic(null);
-	}
-
-	/**
-	 * Checks if this is a debug build.
-	 *
-	 * @return
-	 *     <code>true</code> if debug flag set.
-	 */
-	public boolean debugEnabled() {
-		if (debugging != null) {
-			return debugging;
-		}
-
-		if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
-			debugging = (MainActivity.get().getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE) != 0;
-		} else {
-			debugging = false;
-		}
-
-		return debugging;
-	}
-}

android/app/src/main/java/org/arianne/stendhal/client/DownloadHandler.java

@@ -1,105 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client;
-
-import android.net.Uri;
-import android.os.Environment;
-import android.util.Base64;
-
-import java.io.File;
-import java.io.FileOutputStream;
-
-import marauroa.common.Pair;
-
-
-/**
- * The main purpose of this class is to handle downloading screenshots
- * created by the web client page.
- */
-public class DownloadHandler {
-
-	public Pair<Boolean, String> download(final String url, final String mimetype) {
-		final Pair<Boolean, String> res = new Pair<Boolean, String>(false, null);
-
-		final Uri uri = Uri.parse(url);
-		final String scheme = uri.getScheme();
-		final String storageState = Environment.getExternalStorageState();
-
-		if (!ClientView.get().isGameActive()) {
-			res.setSecond("downloading from this page not supported");
-		} else if (!"data".equals(scheme)) {
-			res.setSecond("download type \"" + scheme + "\" not supported");
-		} else if (!"image/png".equals(mimetype) || !url.startsWith("data:image/png;base64,")) {
-			res.setSecond("mimetype not supported: " + mimetype);
-		} else if (!Environment.MEDIA_MOUNTED.equals(storageState)) {
-			res.setSecond("storage not available for writing (state: " + storageState + ")");
-		} else {
-			final File targetDir = new File(Environment.getExternalStorageDirectory()
-					+ "/Pictures/Screenshots");
-			// TODO: format output name using YYYYMMDD_HH.MM.SS.MS
-			final String targetName = "stendhal_" + System.currentTimeMillis() + ".png";
-
-			DebugLog.debug("Saving screenshot: " + targetDir.getPath()
-					+ "/" + targetName + " (" + mimetype + ")");
-
-			String msg;
-			String stacktrace = null;
-			try {
-				if (!targetDir.exists()) {
-					targetDir.mkdirs();
-				}
-
-				final byte[] data = Base64.decode(url.split("base64,")[1], Base64.DEFAULT);
-				final FileOutputStream fos = new FileOutputStream(new File(targetDir, targetName));
-				fos.write(data);
-				fos.close();
-
-				res.setFirst(true);
-				msg = "saved screenshot to " + targetDir.getPath() + "/" + targetName;
-			} catch (final java.lang.NoClassDefFoundError e) {
-				msg = "an error occurred while decoding data (see debug log for more info)";
-				stacktrace = stackTraceToString(e);
-			} catch (java.io.IOException e) {
-				msg = "an error occurred while attempting to write file (see debug log for more info)";
-				stacktrace = stackTraceToString(e);
-			}
-
-			res.setSecond(msg);
-			if (stacktrace != null) {
-				DebugLog.error(stacktrace.toString());
-			}
-		}
-
-		return res;
-	}
-
-	/**
-	 * Converts an exception stacktrace to string.
-	 *
-	 * @param e
-	 *     The error with stacktrace information.
-	 * @return
-	 *     String formatted stacktrace.
-	 */
-	private String stackTraceToString(final Throwable e) {
-		final StringBuilder sb = new StringBuilder();
-		sb.append(e.toString());
-		for (final StackTraceElement ste: e.getStackTrace()) {
-			if (sb.length() > 0) {
-				sb.append("\n");
-			}
-			sb.append(ste.toString());
-		}
-
-		return sb.toString();
-	}
-}

android/app/src/main/java/org/arianne/stendhal/client/MainActivity.java

@@ -1,161 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022-2023 - Arianne                     *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client;
-
-import android.app.AlertDialog;
-import android.content.DialogInterface;
-import android.content.Intent;
-import android.content.res.Configuration;
-import android.os.Bundle;
-import androidx.appcompat.app.AppCompatActivity;
-import androidx.constraintlayout.widget.ConstraintLayout;
-
-import org.arianne.stendhal.client.input.DPad;
-import org.arianne.stendhal.client.input.DPadArrows;
-import org.arianne.stendhal.client.input.DPadJoy;
-
-
-public class MainActivity extends AppCompatActivity {
-
-	private static MainActivity instance;
-
-	private ConstraintLayout layout;
-	private ClientView client;
-	private Menu menu;
-
-
-	public static MainActivity get() {
-		return instance;
-	}
-
-	@Override
-	protected void onCreate(final Bundle savedInstanceState) {
-		try {
-			super.onCreate(savedInstanceState);
-			instance = this;
-
-			// initialize debug logging mechanism
-			DebugLog.init(getExternalFilesDir(null), this);
-
-			setContentView(R.layout.activity_main);
-			layout = (ConstraintLayout) findViewById(R.id.content);
-			menu = new Menu(this);
-			client = (ClientView) findViewById(R.id.clientWebView);
-
-			// initialize d-pads
-			// TODO: remove on-screen joystick/dpad support after 1.45 release as it is now built
-			//       into the web client
-			final DPad arrowPad = DPadArrows.get();
-			final DPad joyPad = DPadJoy.get();
-
-			if (PreferencesActivity.getBoolean("dpad_joy", true)) {
-				DPad.setCurrentPad(joyPad);
-			} else {
-				DPad.setCurrentPad(arrowPad);
-			}
-
-			layout.addView(arrowPad.getLayout());
-			layout.addView(joyPad.getLayout());
-
-			client.loadTitleScreen();
-		} catch (final Exception e) {
-			e.printStackTrace();
-			DebugLog.error(e.toString());
-			DebugLog.error("// -- //");
-			for (final StackTraceElement ste: e.getStackTrace()) {
-				DebugLog.error(ste.toString());
-			}
-			DebugLog.error("// -- //");
-			Notifier.showPrompt(
-				"An unhandled exception has occurred: " + e.getMessage()
-				+ "\n\nYou can report this error at: https://stendhalgame.org/development/bug.html",
-				new Notifier.Action() {
-					protected void onCall() {
-						finish();
-					}
-				});
-		}
-	}
-
-	@Override
-	public void onBackPressed() {
-		menu.toggleVisibility();
-	}
-
-	/**
-	 * Attempts to connect to client host.
-	 */
-	public void loadLogin() {
-		client.loadLogin();
-	}
-
-	/**
-	 * Opens a dialog confirm exiting activity.
-	 */
-	public void onRequestQuit() {
-		final AlertDialog.Builder builder = new AlertDialog.Builder(this);
-		builder.setMessage("Quit Stendhal?");
-
-		builder.setPositiveButton("Yes", new DialogInterface.OnClickListener() {
-			public void onClick(final DialogInterface dialog, final int id) {
-				finish();
-				android.os.Process.killProcess(android.os.Process.myPid());
-			}
-		});
-
-		builder.setNegativeButton("No", new DialogInterface.OnClickListener() {
-			public void onClick(final DialogInterface dialog, final int id) {
-				dialog.cancel();
-			}
-		});
-
-		final AlertDialog confirmQuit = builder.create();
-		confirmQuit.show();
-	}
-
-	@Override
-	protected void onResume() {
-		super.onResume();
-
-		DPadArrows.get().onRefreshView();
-		DPadJoy.get().onRefreshView();
-	}
-
-	/**
-	 * Updates direction pad position when screen orientation changes.
-	 */
-	@Override
-	public void onConfigurationChanged(final Configuration config) {
-		super.onConfigurationChanged(config);
-
-		DPadArrows.get().onRefreshView();
-		DPadJoy.get().onRefreshView();
-	}
-
-	@Override
-	public void finish() {
-		DebugLog.debug(MainActivity.class.getName() + ".finish() called");
-
-		super.finish();
-	}
-
-	@Override
-	protected void onDestroy() {
-		DebugLog.debug(MainActivity.class.getName() + ".onDestroy() called");
-
-		super.onDestroy();
-	}
-
-	public void showSettings() {
-		startActivity(new Intent(MainActivity.this, PreferencesActivity.class));
-	}
-}

android/app/src/main/java/org/arianne/stendhal/client/input/DPad.java

@@ -1,62 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client.input;
-
-import android.view.View;
-import androidx.constraintlayout.widget.ConstraintLayout;
-
-import marauroa.common.Pair;
-
-
-public abstract class DPad {
-
-	public static enum Dir {
-		NONE,
-		LEFT,
-		RIGHT,
-		UP,
-		DOWN;
-	}
-
-	private static DPad currentPad = null;
-
-
-	public abstract ConstraintLayout getLayout();
-
-	public abstract void setVisibility(final int vis);
-
-	public abstract boolean isVisible();
-
-	public void show() {
-		setVisibility(View.VISIBLE);
-	}
-
-	public void hide() {
-		setVisibility(View.GONE);
-	}
-
-	public abstract void setPosition(final int x, final int y);
-
-	public abstract Pair<Integer, Integer> getPosition();
-
-	public abstract Pair<Integer, Integer> getSize();
-
-	public abstract void onRefreshView();
-
-	public static void setCurrentPad(final DPad pad) {
-		currentPad = pad;
-	}
-
-	public static DPad getCurrentPad() {
-		return currentPad;
-	}
-}

android/app/src/main/java/org/arianne/stendhal/client/input/DPadArrows.java

@@ -1,253 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client.input;
-
-import android.content.Context;
-import android.graphics.Point;
-import android.view.Display;
-import android.view.KeyEvent;
-import android.view.MotionEvent;
-import android.view.View;
-import android.widget.ImageView;
-import androidx.constraintlayout.widget.ConstraintLayout;
-import androidx.constraintlayout.widget.ConstraintLayout.LayoutParams;
-
-import java.util.LinkedList;
-import java.util.List;
-
-import marauroa.common.Pair;
-import org.arianne.stendhal.client.DebugLog;
-import org.arianne.stendhal.client.MainActivity;
-import org.arianne.stendhal.client.PreferencesActivity;
-import org.arianne.stendhal.client.R;
-
-
-/**
- * A directional pad on the screen.
- *
- * TODO: Option to use joystick style d-pad. Currently setting "dpad_joy"
- *   is disabled in preferences manager.
- */
-public class DPadArrows extends DPad {
-
-	private static DPadArrows instance;
-
-	private static Context ctx;
-
-	private final List<ArrowView> arrows;
-	private final ConstraintLayout layout;
-
-
-	public static DPadArrows get() {
-		if (instance == null) {
-			instance = new DPadArrows();
-		}
-
-		return instance;
-	}
-
-	private DPadArrows() {
-		ctx = (Context) MainActivity.get();
-
-		arrows = new LinkedList<>();
-		layout = new ConstraintLayout(ctx);
-		layout.setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
-
-		final ArrowView arrow_l = new ArrowView(ctx, Dir.LEFT);
-		final ArrowView arrow_r = new ArrowView(ctx, Dir.RIGHT);
-		final ArrowView arrow_u = new ArrowView(ctx, Dir.UP);
-		final ArrowView arrow_d = new ArrowView(ctx, Dir.DOWN);
-
-		arrows.add(arrow_l);
-		arrows.add(arrow_r);
-		arrows.add(arrow_u);
-		arrows.add(arrow_d);
-
-		for (final ArrowView av: arrows) {
-			layout.addView(av);
-		}
-
-		// hidden by default
-		hide();
-	}
-
-	public ConstraintLayout getLayout() {
-		return layout;
-	}
-
-	public void setVisibility(final int vis) {
-		for (final ArrowView av: arrows) {
-			av.setVisibility(vis);
-		}
-	}
-
-	public boolean isVisible() {
-		for (final ArrowView av: arrows) {
-			if (av.getVisibility() != View.VISIBLE) {
-				return false;
-			}
-		}
-
-		return true;
-	}
-
-	public void setPosition(final int x, final int y) {
-		ArrowView av = arrows.get(0);
-		av.setX(x);
-		av.setY(y + 60);
-
-		av = arrows.get(1);
-		av.setX(x + 150);
-		av.setY(y + 60);
-
-		av = arrows.get(2);
-		av.setX(x + 60);
-		av.setY(y);
-
-		av = arrows.get(3);
-		av.setX(x + 60);
-		av.setY(y + 150);
-	}
-
-	private int getX() {
-		return (int) arrows.get(0).getX();
-	}
-
-	private int getY() {
-		return (int) arrows.get(2).getY();
-	}
-
-	public Pair<Integer, Integer> getPosition() {
-		return new Pair<Integer, Integer>(getX(), getY());
-	}
-
-	private int getWidth() {
-		final ArrowView aRight = arrows.get(1);
-		final int absX = ((int) aRight.getX()) + aRight.getWidth();
-
-		return absX - getX();
-	}
-
-	private int getHeight() {
-		final ArrowView aDown = arrows.get(3);
-		final int absY = ((int) aDown.getY()) + aDown.getHeight();
-
-		return absY - getY();
-	}
-
-	public Pair<Integer, Integer> getSize() {
-		return new Pair<Integer, Integer>(getWidth(), getHeight());
-	}
-
-	public void onRefreshView() {
-		final Point size = new Point();
-		final Display disp = MainActivity.get().getWindowManager().getDefaultDisplay();
-		disp.getSize(size);
-
-		final PreferencesActivity prefs = PreferencesActivity.get();
-		final int x = prefs.getInt("dpad_offset_x", 100);
-		final int y = size.y - prefs.getInt("dpad_offset_y", 300);
-
-		setPosition(x, y);
-
-		if (isVisible()) {
-			DebugLog.debug("DPadArrows: pos (" + getX() + "," + getY() + "), size ("
-				+ getWidth() + "," + getHeight() + ")");
-			DebugLog.debug("DPadArrows: left arrow: x (" + arrows.get(0).getX() + "), width ("
-				+ arrows.get(0).getWidth() + ")");
-			DebugLog.debug("DPadArrows: down arrow: y (" + arrows.get(3).getY() + "), height ("
-				+ arrows.get(3).getHeight() + ")");
-		}
-	}
-
-
-	private static class ArrowView extends ImageView {
-
-		private final Dir dir;
-		private final int id;
-		private final int id_active;
-
-		private boolean keyDown = false;
-
-
-		public ArrowView(final Context ctx, final Dir dir) {
-			super(ctx);
-
-			this.dir = dir;
-
-			switch (dir) {
-				case LEFT:
-					id = R.drawable.dpad_left;
-					id_active = R.drawable.dpad_left_active;
-					break;
-				case RIGHT:
-					id = R.drawable.dpad_right;
-					id_active = R.drawable.dpad_right_active;
-					break;
-				case UP:
-					id = R.drawable.dpad_up;
-					id_active = R.drawable.dpad_up_active;
-					break;
-				default:
-					id = R.drawable.dpad_down;
-					id_active = R.drawable.dpad_down_active;
-					break;
-			}
-
-			setBackgroundColor(android.graphics.Color.TRANSPARENT);
-			setImageResource(id);
-
-			setOnTouchListener(new View.OnTouchListener() {
-				@Override
-				public boolean onTouch(final View view, final MotionEvent event) {
-					final int action = event.getAction();
-
-					Integer newAction = null;
-					Integer keyCode = null;
-
-					if (action == MotionEvent.ACTION_DOWN && !keyDown) {
-						setImageResource(id_active);
-						newAction = KeyEvent.ACTION_DOWN;
-						keyDown = true;
-					} else if (action == MotionEvent.ACTION_UP && keyDown) {
-						setImageResource(id);
-						newAction = KeyEvent.ACTION_UP;
-						keyDown = false;
-					}
-
-					if (newAction != null) {
-
-						switch (dir) {
-							case LEFT:
-								keyCode = KeyEvent.KEYCODE_DPAD_LEFT;
-								break;
-							case RIGHT:
-								keyCode = KeyEvent.KEYCODE_DPAD_RIGHT;
-								break;
-							case UP:
-								keyCode = KeyEvent.KEYCODE_DPAD_UP;
-								break;
-							case DOWN:
-								keyCode = KeyEvent.KEYCODE_DPAD_DOWN;
-								break;
-						}
-
-						MainActivity.get().dispatchKeyEvent(new KeyEvent(newAction, keyCode));
-						return true; // consume event
-					}
-
-					return false;
-				}
-			});
-		}
-	}
-}

android/app/src/main/java/org/arianne/stendhal/client/input/DPadJoy.java

@@ -1,332 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client.input;
-
-import android.content.Context;
-import android.graphics.Point;
-import android.view.Display;
-import android.view.KeyEvent;
-import android.view.MotionEvent;
-import android.view.View;
-import androidx.constraintlayout.widget.ConstraintLayout;
-import androidx.constraintlayout.widget.ConstraintLayout.LayoutParams;
-
-import java.util.ArrayList;
-import java.util.List;
-
-import marauroa.common.Pair;
-import org.arianne.stendhal.client.DebugLog;
-import org.arianne.stendhal.client.MainActivity;
-import org.arianne.stendhal.client.PreferencesActivity;
-import org.arianne.stendhal.client.R;
-
-
-public class DPadJoy extends DPad {
-
-	private static DPadJoy instance;
-
-	private static Context ctx;
-
-	private static ConstraintLayout layout;
-
-	private static OuterButton outerButton;
-	private static int sensitivity;
-
-
-	public static DPadJoy get() {
-		if (instance == null) {
-			instance = new DPadJoy();
-		}
-
-		return instance;
-	}
-
-	private DPadJoy() {
-		ctx = (Context) MainActivity.get();
-		layout = new ConstraintLayout(ctx);
-		layout.setLayoutParams(new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT));
-
-		outerButton = new OuterButton(ctx);
-		outerButton.addToLayout();
-
-		setSensitivity(PreferencesActivity.getInt("joypad_sensitivity", 25));
-
-		// hidden by default
-		hide();
-	}
-
-	public ConstraintLayout getLayout() {
-		return layout;
-	}
-
-	public void setVisibility(final int vis) {
-		outerButton.setVisibility(vis);
-	}
-
-	public boolean isVisible() {
-		return outerButton.isVisible();
-	}
-
-	public void setPosition(final int x, final int y) {
-		outerButton.setPosition(x, y);
-	}
-
-	private int getX() {
-		return (int) outerButton.getX();
-	}
-
-	private int getY() {
-		return (int) outerButton.getY();
-	}
-
-	public Pair<Integer, Integer> getPosition() {
-		return new Pair<Integer, Integer>(getX(), getY());
-	}
-
-	private int getWidth() {
-		return outerButton.getWidth();
-	}
-
-	private int getHeight() {
-		return outerButton.getHeight();
-	}
-
-	public Pair<Integer, Integer> getSize() {
-		return new Pair<Integer, Integer>(getWidth(), getHeight());
-	}
-
-	public void setSensitivity(final int value) {
-		sensitivity = value;
-	}
-
-	public void onRefreshView() {
-		final Point size = new Point();
-		final Display disp = MainActivity.get().getWindowManager().getDefaultDisplay();
-		disp.getSize(size);
-
-		final PreferencesActivity prefs = PreferencesActivity.get();
-		final int x = prefs.getInt("dpad_offset_x", 100);
-		final int y = size.y - prefs.getInt("dpad_offset_y", 300);
-
-		setPosition(x, y);
-
-		if (isVisible()) {
-			DebugLog.debug("DPadJoy: pos (" + getX() + "," + getY() + "), size ("
-				+ getWidth() + "," + getHeight() + ")");
-		}
-	}
-
-
-	private static class OuterButton extends JoyPadButton {
-
-		private final InnerButton innerButton;
-
-		private DPad.Dir currentDir = DPad.Dir.NONE;
-		private boolean keyDown = false;
-		private final List<Integer> pressedKeys;
-
-
-		public OuterButton(final Context ctx) {
-			super(ctx);
-
-			pressedKeys = new ArrayList<>();
-
-			setBackgroundColor(android.graphics.Color.TRANSPARENT);
-			setImageResource(R.drawable.joystick_outer);
-
-			innerButton = new InnerButton(ctx);
-			innerButton.setBackgroundColor(android.graphics.Color.TRANSPARENT);
-			innerButton.setImageResource(R.drawable.joystick_inner);
-
-			setOnTouchListener(new View.OnTouchListener() {
-				@Override
-				public boolean onTouch(final View view, final MotionEvent event) {
-					final int action = event.getAction();
-
-					DebugLog.debug("joypad action: " + action);
-
-					if (action == MotionEvent.ACTION_DOWN && !keyDown) {
-						keyDown = true;
-						innerButton.setImageResource(R.drawable.joystick_inner_active);
-						innerButton.setRelativeX(event.getX());
-						innerButton.setRelativeY(event.getY());
-
-						final DPad.Dir newDir = getTouchDirection();
-						if (newDir != currentDir) {
-							currentDir = newDir;
-							onDirectionChange(KeyEvent.ACTION_DOWN);
-						}
-					} else if (action == MotionEvent.ACTION_UP && keyDown) {
-						keyDown = false;
-						innerButton.setImageResource(R.drawable.joystick_inner);
-						innerButton.centerOn((JoyPadButton) view);
-
-						clearPresses();
-						currentDir = DPad.Dir.NONE;
-					} else if (action == MotionEvent.ACTION_MOVE && keyDown) {
-						innerButton.setRelativeX(event.getX());
-						innerButton.setRelativeY(event.getY());
-
-						final DPad.Dir newDir = getTouchDirection();
-						if (newDir != currentDir) {
-							currentDir = newDir;
-							onDirectionChange(KeyEvent.ACTION_DOWN);
-						}
-					}
-
-					return true;
-				}
-			});
-		}
-
-		public void addToLayout() {
-			layout.addView(this);
-			layout.addView(innerButton);
-
-			// FIXME: inner button not centering at startup
-			innerButton.centerOn(this);
-		}
-
-		@Override
-		public void setVisibility(final int vis) {
-			innerButton.setVisibility(vis);
-			super.setVisibility(vis);
-		}
-
-		public boolean isVisible() {
-			return getVisibility() == View.VISIBLE
-				&& innerButton.getVisibility() == View.VISIBLE;
-		}
-
-		public void setPosition(final int x, final int y) {
-			setX(x);
-			setY(y);
-
-			innerButton.centerOn(this);
-		}
-
-		/**
-		 * Determines pressed direction based on inner button position
-		 * relative to outer button position.
-		 */
-		private DPad.Dir getTouchDirection() {
-			final float outerX = getCenterX();
-			final float outerY = getCenterY();
-			final float innerX = innerButton.getCenterX();
-			final float innerY = innerButton.getCenterY();
-			final float offsetX = outerX - innerX;
-			final float offsetY = outerY - innerY;
-
-			final int absX = (int) Math.abs(offsetX);
-			final int absY = (int) Math.abs(offsetY);
-
-			if (absX < sensitivity && absY < sensitivity) {
-				return DPad.Dir.NONE;
-			}
-
-			// horizontal directions take precedence if they are the same as vertical
-			if (absX >= absY) {
-				if (innerX < outerX) {
-					return DPad.Dir.LEFT;
-				} else if (innerX > outerX) {
-					return DPad.Dir.RIGHT;
-				}
-			} else {
-				if (innerY < outerY) {
-					return DPad.Dir.UP;
-				} else if (innerY > outerY) {
-					return DPad.Dir.DOWN;
-				}
-			}
-
-			return DPad.Dir.NONE;
-		}
-
-		private void clearPresses() {
-			for (final int key: pressedKeys) {
-				MainActivity.get().dispatchKeyEvent(new KeyEvent(KeyEvent.ACTION_UP, key));
-			}
-		}
-
-		/**
-		 * Sends a direction key press event to client.
-		 */
-		private void onDirectionChange(final int action) {
-			Integer keyCode = null;
-
-			switch (currentDir) {
-				case LEFT:
-					keyCode = KeyEvent.KEYCODE_DPAD_LEFT;
-					break;
-				case RIGHT:
-					keyCode = KeyEvent.KEYCODE_DPAD_RIGHT;
-					break;
-				case UP:
-					keyCode = KeyEvent.KEYCODE_DPAD_UP;
-					break;
-				case DOWN:
-					keyCode = KeyEvent.KEYCODE_DPAD_DOWN;
-					break;
-			}
-
-			if (keyCode != null) {
-				// clear pressed keys before dispatching new key press
-				clearPresses();
-
-				if (action == KeyEvent.ACTION_DOWN) {
-					MainActivity.get().dispatchKeyEvent(new KeyEvent(action, keyCode));
-					pressedKeys.add(keyCode);
-				}
-			}
-		}
-	}
-
-
-	private static class InnerButton extends JoyPadButton {
-
-		public InnerButton(final Context ctx) {
-			super(ctx);
-		}
-
-		/**
-		 * Sets X coordinate relative to OuterButton.
-		 */
-		public void setRelativeX(float x) {
-			x = x + outerButton.getX();
-
-			final float maxL = outerButton.getX();
-			final float maxR = maxL + outerButton.getWidth();
-
-			// don't move outside bounds of outer button
-			if (x >= maxL && x <= maxR) {
-				// use circle center
-				setX(x - (getWidth() / 2));
-			}
-		}
-
-		/**
-		 * Sets Y coordinate relative to OuterButton.
-		 */
-		public void setRelativeY(float y) {
-			y = y + outerButton.getY();
-
-			final float maxT = outerButton.getY();
-			final float maxB = maxT + outerButton.getHeight();
-
-			// don't move outside bounds of outer button
-			if (y >= maxT && y <= maxB) {
-				// use circle center
-				setY(y - (getHeight() / 2));
-			}
-		}
-	}
-}

android/app/src/main/res/layout/activity_main.xml

@@ -1,98 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<androidx.constraintlayout.widget.ConstraintLayout
-  xmlns:android="http://schemas.android.com/apk/res/android"
-  xmlns:app="http://schemas.android.com/apk/res-auto"
-  xmlns:tools="http://schemas.android.com/tools"
-  android:id="@+id/content"
-  android:layout_width="match_parent"
-  android:layout_height="match_parent"
-  tools:context="org.arianne.stendhal.client.StendhalWebView">
-
-  <ImageView
-    android:id="@+id/splash"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    android:scaleType="centerCrop"
-    app:layout_constraintTop_toTopOf="parent"
-    app:layout_constraintStart_toStartOf="parent"
-  />
-
-  <org.arianne.stendhal.client.ClientView
-    android:id="@+id/clientWebView"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-    app:layout_constraintBottom_toBottomOf="parent"
-    app:layout_constraintLeft_toLeftOf="parent"
-    app:layout_constraintRight_toRightOf="parent"
-    app:layout_constraintTop_toTopOf="parent"
-  />
-
-  <Toolbar
-    android:id="@+id/menu_main"
-    android:layout_width="match_parent"
-    android:layout_height="wrap_content"
-    android:background="#80ffffff"
-    android:logo="@mipmap/ic_launcher_round"
-    android:title="Menu"
-    app:layout_constraintLeft_toLeftOf="parent"
-    app:layout_constraintBottom_toBottomOf="parent">
-
-    <LinearLayout
-      android:layout_width="match_parent"
-      android:layout_height="wrap_content"
-      android:gravity="right">
-
-      <Button
-        android:id="@+id/btn_connect"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="Connect"
-        android:background="#00000000"
-      />
-
-      <Button
-        android:id="@+id/btn_title"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="Title"
-        android:background="#00000000"
-      />
-
-      <Button
-        android:id="@+id/btn_reload"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="Reload"
-        android:background="#00000000"
-      />
-
-      <Button
-        android:id="@+id/btn_settings"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="Settings"
-        android:background="#00000000"
-      />
-
-      <Button
-        android:id="@+id/btn_about"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="About"
-        android:background="#00000000"
-      />
-
-      <Button
-        android:id="@+id/btn_quit"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:text="Quit"
-        android:background="#00000000"
-      />
-
-    </LinearLayout>
-
-  </Toolbar>
-
-</androidx.constraintlayout.widget.ConstraintLayout>

android/app/src/main/res/layout/activity_preferences.xml

@@ -1,18 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<androidx.constraintlayout.widget.ConstraintLayout
-  xmlns:android="http://schemas.android.com/apk/res/android"
-  xmlns:app="http://schemas.android.com/apk/res-auto"
-  xmlns:tools="http://schemas.android.com/tools"
-  android:id="@+id/preferences"
-  android:layout_width="match_parent"
-  android:layout_height="match_parent"
-  tools:context="org.arianne.stendhal.client.PreferencesActivity">
-
-  <FrameLayout
-    android:id="@+id/preferencesFrame"
-    android:layout_width="match_parent"
-    android:layout_height="match_parent"
-  />
-
-</androidx.constraintlayout.widget.ConstraintLayout>

android/app/src/main/res/values/array.xml

@@ -1,21 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<resources>
-
-  <string-array name="titleMusic">
-    <item>Treasure Hunter</item>
-    <item>Woodland Fantasy</item>
-    <item>Land of Fearless</item>
-    <item>Medieval: Rejoicing</item>
-    <item>Medieval: The Old Tower Inn</item>
-  </string-array>
-
-  <string-array name="titleMusicId">
-    <item>title_01</item>
-    <item>title_02</item>
-    <item>title_03</item>
-    <item>title_04</item>
-    <item>title_05</item>
-  </string-array>
-
-</resources>

android/app/src/main/res/values/strings.xml

@@ -1,7 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<resources>
-
-	<string name="app_name">Stendhal</string>
-
-</resources>

android/app/src/main/res/xml/preferences.xml

@@ -1,107 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-
-<PreferenceScreen
-  xmlns:android="http://schemas.android.com/apk/res/android">
-
-  <PreferenceCategory android:title="General">
-
-    <EditTextPreference
-      android:key="client_url"
-      android:inputType="text"
-      android:maxLines="1"
-      android:title="Client URL"
-      android:summary="Custom URL pointing to web client."
-      android:selectAllOnFocus="true"
-    />
-
-  </PreferenceCategory>
-
-  <PreferenceCategory android:title="Input">
-
-    <CheckBoxPreference
-      android:key="show_dpad"
-      android:defaultValue="false"
-      android:title="Show D-Pad"
-      android:summary="Show on-screen directional pad."
-    />
-
-    <CheckBoxPreference
-      android:key="dpad_joy"
-      android:defaultValue="true"
-      android:title="Joystick Style D-Pad (experimental)"
-      android:summary="Use a joystick style directional pad."
-      android:dependency="show_dpad"
-    />
-
-    <EditTextPreference
-      android:key="joypad_sensitivity"
-      android:inputType="numberDecimal"
-      android:digits="0123456789"
-      android:defaultValue="25"
-      android:title="Joypad Sensitivity"
-      android:summary="Threshold, in pixels, at which joypad will dispatch move event (lower = more sensitive)."
-      android:dependency="dpad_joy"
-      android:selectAllOnFocus="true"
-    />
-
-    <EditTextPreference
-      android:key="dpad_offset_x"
-      android:inputType="numberDecimal"
-      android:digits="0123456789"
-      android:defaultValue="100"
-      android:title="D-Pad Offset X"
-      android:summary="Horizontal offset of directional pad (from left)."
-      android:dependency="show_dpad"
-      android:selectAllOnFocus="true"
-    />
-
-    <EditTextPreference
-      android:key="dpad_offset_y"
-      android:inputType="numberDecimal"
-      android:digits="0123456789"
-      android:defaultValue="300"
-      android:title="D-Pad Offset Y"
-      android:summary="Vertical offset of directional pad (from bottom)."
-      android:dependency="show_dpad"
-      android:selectAllOnFocus="true"
-    />
-
-    <CheckBoxPreference
-      android:key="map_touches"
-      android:defaultValue="false"
-      android:title="Remap Touches (experimental)"
-      android:summary="Map touches to mouse click events."
-    />
-
-  </PreferenceCategory>
-
-  <PreferenceCategory android:title="Audio">
-
-    <CheckBoxPreference
-      android:key="title_music"
-      android:defaultValue="true"
-      android:title="Title Music"
-      android:summary="Play title screen music."
-    />
-
-    <ListPreference
-      android:key="song_list"
-      android:dependency="title_music"
-      android:title="Songs"
-      android:entries="@array/titleMusic"
-      android:entryValues="@array/titleMusicId"
-    />
-
-  </PreferenceCategory>
-
-  <PreferenceCategory android:title="Meta">
-
-    <Preference
-      android:key="reset"
-      android:title="Restore Defaults"
-      android:summary="Restore all preferences default values."
-    />
-
-  </PreferenceCategory>
-
-</PreferenceScreen>

android/app/src/shared/java/org/arianne/stendhal/client/DebugLog.java

@@ -1,83 +0,0 @@
-/***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
- ***************************************************************************
- ***************************************************************************
- *                                                                         *
- *   This program is free software; you can redistribute it and/or modify  *
- *   it under the terms of the GNU General Public License as published by  *
- *   the Free Software Foundation; either version 2 of the License, or     *
- *   (at your option) any later version.                                   *
- *                                                                         *
- ***************************************************************************/
-package org.arianne.stendhal.client;
-
-import java.io.File;
-
-import androidx.appcompat.app.AppCompatActivity;
-
-
-/**
- * Dummy class for release builds.
- */
-public class DebugLog {
-
-	private static File logsDir;
-
-	public static enum DebugLevel {
-		INFO,
-		WARN,
-		ERROR,
-		DEBUG
-	}
-
-	private static DebugLog instance;
-
-
-	public static DebugLog get() {
-		if (instance == null) {
-			instance = new DebugLog();
-		}
-
-		return instance;
-	}
-
-	public static void init(final File dir, final AppCompatActivity activity) {
-		logsDir = new File(dir.getPath() + "/logs");
-	}
-
-	public static void writeLine(final String text) {
-		// do nothing
-	}
-
-	public static void writeLine(final String text, final DebugLevel level) {
-		// do nothing
-	}
-
-	public static void info(final String text) {
-		// do nothing
-	}
-
-	public static void warn(final String text) {
-		// do nothing
-	}
-
-	public static void error(final String text) {
-		// do nothing
-	}
-
-	public static void debug(final String text) {
-		// do nothing
-	}
-
-	public static void notify(final String message) {
-		// do nothing
-	}
-
-	public static void notify(final String message, final DebugLevel level) {
-		// do nothing
-	}
-
-	public static String getLogsDir() {
-		return logsDir.getPath();
-	}
-}

android/gradlew

@@ -1,185 +0,0 @@
-#!/usr/bin/env sh
-
-#
-# Copyright 2015 the original author or authors.
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#      https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-#
-
-##############################################################################
-##
-##  Gradle start up script for UN*X
-##
-##############################################################################
-
-# Attempt to set APP_HOME
-# Resolve links: $0 may be a link
-PRG="$0"
-# Need this for relative symlinks.
-while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-        PRG="$link"
-    else
-        PRG=`dirname "$PRG"`"/$link"
-    fi
-done
-SAVED="`pwd`"
-cd "`dirname \"$PRG\"`/" >/dev/null
-APP_HOME="`pwd -P`"
-cd "$SAVED" >/dev/null
-
-APP_NAME="Gradle"
-APP_BASE_NAME=`basename "$0"`
-
-# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
-DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
-
-# Use the maximum available, or set MAX_FD != -1 to use that value.
-MAX_FD="maximum"
-
-warn () {
-    echo "$*"
-}
-
-die () {
-    echo
-    echo "$*"
-    echo
-    exit 1
-}
-
-# OS specific support (must be 'true' or 'false').
-cygwin=false
-msys=false
-darwin=false
-nonstop=false
-case "`uname`" in
-  CYGWIN* )
-    cygwin=true
-    ;;
-  Darwin* )
-    darwin=true
-    ;;
-  MINGW* )
-    msys=true
-    ;;
-  NONSTOP* )
-    nonstop=true
-    ;;
-esac
-
-CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
-
-
-# Determine the Java command to use to start the JVM.
-if [ -n "$JAVA_HOME" ] ; then
-    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
-        # IBM's JDK on AIX uses strange locations for the executables
-        JAVACMD="$JAVA_HOME/jre/sh/java"
-    else
-        JAVACMD="$JAVA_HOME/bin/java"
-    fi
-    if [ ! -x "$JAVACMD" ] ; then
-        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
-
-Please set the JAVA_HOME variable in your environment to match the
-location of your Java installation."
-    fi
-else
-    JAVACMD="java"
-    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
-
-Please set the JAVA_HOME variable in your environment to match the
-location of your Java installation."
-fi
-
-# Increase the maximum file descriptors if we can.
-if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
-    MAX_FD_LIMIT=`ulimit -H -n`
-    if [ $? -eq 0 ] ; then
-        if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
-            MAX_FD="$MAX_FD_LIMIT"
-        fi
-        ulimit -n $MAX_FD
-        if [ $? -ne 0 ] ; then
-            warn "Could not set maximum file descriptor limit: $MAX_FD"
-        fi
-    else
-        warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
-    fi
-fi
-
-# For Darwin, add options to specify how the application appears in the dock
-if $darwin; then
-    GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
-fi
-
-# For Cygwin or MSYS, switch paths to Windows format before running java
-if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
-    APP_HOME=`cygpath --path --mixed "$APP_HOME"`
-    CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
-
-    JAVACMD=`cygpath --unix "$JAVACMD"`
-
-    # We build the pattern for arguments to be converted via cygpath
-    ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
-    SEP=""
-    for dir in $ROOTDIRSRAW ; do
-        ROOTDIRS="$ROOTDIRS$SEP$dir"
-        SEP="|"
-    done
-    OURCYGPATTERN="(^($ROOTDIRS))"
-    # Add a user-defined pattern to the cygpath arguments
-    if [ "$GRADLE_CYGPATTERN" != "" ] ; then
-        OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
-    fi
-    # Now convert the arguments - kludge to limit ourselves to /bin/sh
-    i=0
-    for arg in "$@" ; do
-        CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
-        CHECK2=`echo "$arg"|egrep -c "^-"`                                 ### Determine if an option
-
-        if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then                    ### Added a condition
-            eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
-        else
-            eval `echo args$i`="\"$arg\""
-        fi
-        i=`expr $i + 1`
-    done
-    case $i in
-        0) set -- ;;
-        1) set -- "$args0" ;;
-        2) set -- "$args0" "$args1" ;;
-        3) set -- "$args0" "$args1" "$args2" ;;
-        4) set -- "$args0" "$args1" "$args2" "$args3" ;;
-        5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
-        6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
-        7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
-        8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
-        9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
-    esac
-fi
-
-# Escape application args
-save () {
-    for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
-    echo " "
-}
-APP_ARGS=`save "$@"`
-
-# Collect all arguments for the java command, following the shell quoting and substitution rules
-eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
-
-exec "$JAVACMD" "$@"

app/.gitignore

@@ -0,0 +1 @@
+/godot/

app/android/.gitignore

@@ -8,3 +8,4 @@
 .externalNativeBuild
 .cxx
 local.properties
+/deps/

app/android/TODO.txt

@@ -0,0 +1,7 @@
+
+TODO:
+- create activity for about information
+- add credits to about information
+- switch to Log4j for logging (maybe)
+- write debugging logs to sub-directory in user's home instead of ~/Android/data/org.stendhalgame.client
+- replace title_03 (Land of Fearless), title_04 (Rejoicing), & title_05 (The Old Tower Inn) music with non-looping versions or fix loops

app/android/build.gradle

@@ -5,7 +5,7 @@ buildscript {
 		mavenCentral()
 	}
 	dependencies {
-		classpath "com.android.tools.build:gradle:7.1.1"
+		classpath 'com.android.tools.build:gradle:7.4.2'
 
 		// NOTE: Do not place your application dependencies here; they belong
 		// in the individual module build.gradle files

app/android/client/build.gradle

@@ -0,0 +1,149 @@
+plugins {
+	id 'com.android.application'
+}
+
+android {
+	namespace "org.stendhalgame.client"
+	compileSdk 32
+
+	defaultConfig {
+		applicationId namespace
+		minSdk 21
+		targetSdk 32
+		versionCode 1049005
+		versionName "1.49.5"
+		testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
+		targetSdkVersion 32
+		minSdkVersion 21
+	}
+
+	// F-Droid doesn't allow encrypted DependencyInfoBlock in APK
+	dependenciesInfo {
+		// disables dependency metadata when building APKs
+		includeInApk = false
+		// disables dependency metadata when building Android App Bundles
+		includeInBundle = false
+	}
+
+	// build output
+	project.setProperty("archivesBaseName", "${namespace}-${defaultConfig.versionName}")
+	project.setProperty("buildDir", "${projectDir}/../../../build/build_android_client")
+
+	/* A keystore.properties file can be placed in the root Android project directory and must
+	 * include the following values:
+	 *   storeFile=<path-to-keystore-file>
+	 *   storePassword=<store-password>
+	 *   keyPassword=<key-password>
+	 *   keyAlias=<key-alias>
+	 * The `storeFile` path value must use double backslashes (\\) on Windows.
+	 */
+	def keystorePropertiesFile = rootProject.file("keystore.properties")
+	def keystoreProperties = new Properties()
+	if (keystorePropertiesFile.exists()) {
+		keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
+	}
+
+	// denotes whether a signing key is found/configured
+	def unsigned = true;
+	// property to force use of ~/.android/debug.keystore signing key & generate if not found
+	def generateDebugKey = project.properties["generate-debug-key"] != null;
+
+	signingConfigs {
+		main {
+			if (keystorePropertiesFile.exists()) {
+				// use key configured in keystore.properties file
+				storeFile file(keystoreProperties["storeFile"])
+				storePassword keystoreProperties["storePassword"]
+				keyPassword keystoreProperties["keyPassword"]
+				keyAlias keystoreProperties["keyAlias"]
+				unsigned = false;
+			} else if (signingConfigs.debug.storeFile.exists()) {
+				// use debug key
+				initWith signingConfigs.debug
+				unsigned = false;
+			}
+		}
+
+		if (generateDebugKey && signingConfigs.main != signingConfigs.debug) {
+			// force using debug key
+			main {
+				initWith signingConfigs.debug
+			}
+			unsigned = false;
+		}
+	}
+
+	if (!unsigned && !generateDebugKey && !signingConfigs.main.storeFile.exists()) {
+		throw new Error("Signing key not found: " + signingConfigs.main.storeFile);
+	}
+
+	buildTypes {
+		debug {
+			applicationIdSuffix ".debug"
+			versionNameSuffix "-debug"
+			// prevent automatic generation of ~/.android/debug.keystore
+			signingConfig null
+		}
+
+		release {
+			minifyEnabled false
+			proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
+		}
+
+		if (generateDebugKey) {
+			// force using debug key & generate if not found
+			debug.signingConfig signingConfigs.debug
+			release.signingConfig signingConfigs.debug
+		} else if (!unsigned) {
+			// apply configured signing key to builds
+			debug.signingConfig signingConfigs.main
+			release.signingConfig signingConfigs.main
+		}
+	}
+
+	buildTypes.all { type ->
+		if (!type.name.equals("debug")) {
+			sourceSets[type.name].java { srcDirs "src/shared/java/" }
+		}
+	}
+
+	applicationVariants.all { variant ->
+		variant.outputs.all {
+			def buildRoot = "../../../../"
+			if (variant.name.equals("release")) {
+				// exclude "-release" suffix
+				outputFileName = outputFileName.replaceAll("(-release)(?!.*-release)", "")
+			}
+			// output to <source_root>/build
+			outputFileName = new File("${buildRoot}", "${outputFileName}")
+		}
+	}
+
+	compileOptions {
+		sourceCompatibility JavaVersion.VERSION_11
+		targetCompatibility JavaVersion.VERSION_11
+	}
+	compileSdkVersion 32
+	buildToolsVersion '32.0.0'
+
+	lintOptions {
+		abortOnError false
+	}
+
+	// print some build info for debugging
+	println("Package:         " + namespace)
+	println("Application ID:  " + defaultConfig.applicationId)
+	println("Version:         " + defaultConfig.versionCode)
+	println("Output basename: " + archivesBaseName)
+	println("Signing key:     " + (unsigned ? "unsigned" : signingConfigs.main.storeFile))
+	println("Build directory: " + project.buildDir)
+}
+
+dependencies {
+	implementation "androidx.appcompat:appcompat:1.4.1"
+	implementation "com.google.android.material:material:1.4.0"
+	implementation "androidx.preference:preference-ktx:1.2.0"
+	//testImplementation 'junit:junit:4.+'
+	//androidTestImplementation 'androidx.test.ext:junit:1.1.2'
+	//androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
+}

app/android/client/src/debug/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+	<!-- allow client url http://localhost:xxxx via Chrome forwarding to a local server -->
+	<application android:usesCleartextTraffic="true">
+	</application>
+</manifest>

app/android/client/src/debug/java/org/stendhalgame/client/Logger.java

@@ -0,0 +1,277 @@
+/***************************************************************************
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+package org.stendhalgame.client;
+
+import java.io.BufferedWriter;
+import java.io.File;
+import java.io.FileWriter;
+import java.io.IOException;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+import android.app.AlertDialog;
+import android.content.DialogInterface;
+import android.util.Log;
+
+
+/**
+ * A class to output debugging information to logcat file.
+ */
+public class Logger {
+
+	/** Attribute denoting state of initialization. */
+	private static boolean initialized = false;
+	/** Logs directory. */
+	private static File logsDir;
+
+	/** Singleton instance. */
+	private static Logger instance;
+
+
+	/**
+	 * Retrieves singleton instance.
+	 */
+	public static Logger get() {
+		if (Logger.instance == null) {
+			Logger.instance = new Logger();
+		}
+		return Logger.instance;
+	}
+
+	/**
+	 * Hidden singleton constructor.
+	 */
+	private Logger() {
+		// do nothing
+	}
+
+	/**
+	 * Initializes logs directory.
+	 */
+	public static void init(final File dir) {
+		if (Logger.initialized) {
+			Logger.warn(true, "tried to re-initialize logger");
+			return;
+		}
+		Logger.initialized = true;
+		logsDir = new File(dir.getPath() + "/logs");
+		writeLine("\n  // -- debugging initialized -- //", null);
+		writeLine("logs directory: " + logsDir.getPath());
+	}
+
+	/**
+	 * Writes a line of text to log file.
+	 *
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void writeLine(final String text) {
+		writeLine(text, LogLevel.DEBUG);
+	}
+
+	/**
+	 * Writes a line of text to log file.
+	 *
+	 * @param text
+	 *   Text to be written.
+	 * @param level
+	 *   Logging verbosity level.
+	 */
+	public static void writeLine(String text, final LogLevel level) {
+		if (logsDir == null) {
+			System.err.println("ERROR: Logger not initialized. Call Logger.init.");
+			return;
+		}
+
+		if (!logsDir.exists()) {
+			logsDir.mkdirs();
+		}
+
+		if (level != null) {
+			text = new SimpleDateFormat("yyyy.MM.dd.HH.mm.ss").format(new Date())
+				+ ": " + level.label + ": " + text;
+		}
+		text = text + "\n";
+
+		final String logFile = logsDir.getPath() + "/debug-"
+			+ new SimpleDateFormat("yyyy.MM.dd").format(new Date()) + ".txt";
+
+		BufferedWriter buffer;
+		try {
+			buffer = new BufferedWriter(new FileWriter(logFile, true));
+			buffer.write(text);
+			if (buffer != null) {
+				buffer.close();
+			}
+		} catch (final IOException e) {
+			System.err.println("ERROR: " + e.getMessage());
+		}
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.INFO` verbosity.
+	 *
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void info(final String text) {
+		Log.i("Logger", text);
+		writeLine(text, LogLevel.INFO);
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.INFO` verbosity.
+	 *
+	 * @param notify
+	 *   If `true` a toast notification is displayed to user.
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void info(final boolean notify, final String text) {
+		Logger.info(text);
+		if (notify) {
+			Logger.notify(text, LogLevel.INFO);
+		}
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.WARN` verbosity.
+	 *
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void warn(final String text) {
+		Log.w("Logger", text);
+		writeLine(text, LogLevel.WARN);
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.WARN` verbosity.
+	 *
+	 * @param notify
+	 *   If `true` a toast notification is displayed to user.
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void warn(final boolean notify, final String text) {
+		Logger.warn(text);
+		if (notify) {
+			Logger.notify(text, LogLevel.WARN);
+		}
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.ERROR` verbosity.
+	 *
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void error(final String text) {
+		Log.e("Logger", text);
+		writeLine(text, LogLevel.ERROR);
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.ERROR` verbosity.
+	 *
+	 * @param notify
+	 *   If `true` a toast notification is displayed to user.
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void error(final boolean notify, final String text) {
+		Logger.error(text);
+		if (notify) {
+			Logger.notify(text, LogLevel.ERROR);
+		}
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.DEBUG` verbosity.
+	 *
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void debug(final String text) {
+		Log.d("Logger", text);
+		writeLine(text, LogLevel.DEBUG);
+	}
+
+	/**
+	 * Writes a line of text to log file at `LogLevel.DEBUG` verbosity.
+	 *
+	 * @param notify
+	 *   If `true` a toast notification is displayed to user.
+	 * @param text
+	 *   Text to be written.
+	 */
+	public static void debug(final boolean notify, final String text) {
+		Logger.debug(text);
+		if (notify) {
+			Logger.notify(text, LogLevel.DEBUG);
+		}
+	}
+
+	/**
+	 * Displays a toast notification to user.
+	 *
+	 * @param text
+	 *   Text to display in notification.
+	 */
+	public static void notify(final String text) {
+		notify(text, LogLevel.INFO);
+	}
+
+	/**
+	 * Displays a toast notification to user.
+	 *
+	 * Does not output to log file.
+	 *
+	 * @param text
+	 *   Text to display in notification.
+	 * @param level
+	 *   Logging verbosity level.
+	 */
+	public static void notify(final String text, LogLevel level) {
+		if (!Logger.initialized) {
+			System.err.println("ERROR: Logger not initialized. Call Logger.init.");
+			return;
+		}
+
+		if (level == null) {
+			level = LogLevel.INFO;
+		}
+
+		final AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.get());
+		builder.setTitle(level.label);
+		builder.setMessage(text);
+
+		builder.setPositiveButton("Ok", new DialogInterface.OnClickListener() {
+			@Override
+			public void onClick(final DialogInterface dialog, final int id) {
+				dialog.cancel();
+			}
+		});
+
+		builder.create().show();
+	}
+
+	/**
+	 * Retrieves logs directory.
+	 *
+	 * @return
+	 *   Directory path to outpu logs.
+	 */
+	public static String getLogsDir() {
+		return logsDir.getPath();
+	}
+}

app/android/client/src/debug/res/values/strings.xml

@@ -3,5 +3,7 @@
 <resources>
 
 	<string name="app_name">Stendhal (debug)</string>
+	<string name="intent_url_scheme">stendhaldebug8gps5y99pu</string>
+	<string name="build_type">debug</string>
 
 </resources>

app/android/client/src/main/AndroidManifest.xml

@@ -0,0 +1,52 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+	<uses-permission android:name="android.permission.INTERNET" />
+
+	<application
+		android:allowBackup="true"
+		android:icon="@mipmap/ic_launcher"
+		android:label="@string/app_name"
+		android:roundIcon="@mipmap/ic_launcher_round"
+		android:supportsRtl="true"
+		android:theme="@style/Theme.Stendhal.FullScreen">
+
+		<activity
+			android:name=".MainActivity"
+			android:exported="true"
+			android:configChanges="orientation|screenSize|keyboardHidden">
+
+			<intent-filter>
+				<action android:name="android.intent.action.MAIN" />
+				<category android:name="android.intent.category.LAUNCHER" />
+			</intent-filter>
+		</activity>
+
+		<activity
+			android:name=".PreferencesActivity"
+			android:label="Preferences"
+			android:exported="true"
+			android:configChanges="orientation|screenSize|keyboardHidden">
+
+			<intent-filter>
+				<action android:name="preferences" />
+			</intent-filter>
+		</activity>
+
+		<activity
+				android:name=".OpenAppByUrl"
+				android:exported="true">
+
+			<intent-filter>
+				<action android:name="android.intent.action.VIEW" />
+				<category android:name="android.intent.category.DEFAULT" />
+				<category android:name="android.intent.category.BROWSABLE" />
+				<data android:scheme="@string/intent_url_scheme"
+						android:host="callback" />
+			</intent-filter>
+		</activity>
+
+	</application>
+
+</manifest>

app/android/client/src/main/java/org/stendhalgame/client/AppInfo.java

@@ -0,0 +1,41 @@
+/***************************************************************************
+ *                    Copyright © 2024 - Faiumoni e. V.                    *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+
+package org.stendhalgame.client;
+
+
+/**
+ * App configuration information.
+ */
+class AppInfo {
+
+	/**
+	 * Retrieves configured build type string.
+	 */
+	public static String getBuildType() {
+		return MainActivity.get().getResources().getString(R.string.build_type);
+	}
+
+	/**
+	 * Retrieves configured build version string.
+	 */
+	public static String getBuildVersion() {
+		return MainActivity.get().getResources().getString(R.string.build_version);
+	}
+
+	/**
+	 * Retrieves configured intent URL scheme string.
+	 */
+	public static String getIntentUrlScheme() {
+		return MainActivity.get().getResources().getString(R.string.intent_url_scheme);
+	}
+}

app/android/client/src/main/java/org/stendhalgame/client/ClientView.java

@@ -0,0 +1,603 @@
+/***************************************************************************
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+package org.stendhalgame.client;
+
+import java.util.Random;
+
+import android.app.AlertDialog;
+import android.content.ActivityNotFoundException;
+import android.content.Context;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.pm.ApplicationInfo;
+import android.graphics.Bitmap;
+import android.graphics.Color;
+import android.net.Uri;
+import android.os.Build;
+import android.util.AttributeSet;
+import android.view.KeyEvent;
+import android.view.ViewGroup;
+import android.view.inputmethod.InputMethodManager;
+import android.webkit.DownloadListener;
+import android.webkit.WebChromeClient;
+import android.webkit.WebResourceRequest;
+import android.webkit.WebSettings;
+import android.webkit.WebView;
+import android.webkit.WebViewClient;
+
+
+/**
+ * Interface to handle web content.
+ */
+public class ClientView extends WebView {
+
+	/** Client URL path. */
+	private String clientUrlSuffix = "client";
+
+	/** Determines type of client to connect to. */
+	private boolean testClient = false;
+	/** Determines type of server to connect to. */
+	private boolean testServer = false;
+	private Boolean debugging;
+	/** ID of page currently loaded. */
+	private PageId currentPage;
+	/** ID of page previously loaded. */
+	private PageId previousPage;
+
+	private String stateId = "";
+	private String seed = "";
+
+
+	/**
+	 * Creates a new view.
+	 *
+	 * @param ctx
+	 *   Activity Context to access application assets.
+	 */
+	public ClientView(final Context ctx) {
+		super(ctx);
+		onInit();
+	}
+
+	/**
+	 * Creates a new view.
+	 *
+	 * @param ctx
+	 *   Activity Context to access application assets.
+	 * @param attrs
+	 *   AttributeSet passed to parent (may be `null`).
+	 */
+	public ClientView(final Context ctx, final AttributeSet attrs) {
+		super(ctx, attrs);
+		onInit();
+	}
+
+	/**
+	 * Creates a new view.
+	 *
+	 * @param ctx
+	 *   Activity Context to access application assets.
+	 * @param attrs
+	 *   AttributeSet passed to parent (may be `null`).
+	 * @param style
+	 *   Attribute in the current theme that contains a reference to a style resource that supplies
+	 *   default values for the view (can be 0 to not look for defaults).
+	 */
+	public ClientView(final Context ctx, final AttributeSet attrs, final int style) {
+		super(ctx, attrs, style);
+		onInit();
+	}
+
+	/**
+	 * Initializes client WebView interface.
+	 */
+	private void onInit() {
+		setActive(false); // main activity manages initial visibility
+		setBackgroundColor(Color.TRANSPARENT);
+
+		// expand to size of parent constraints
+		setLayoutParams(new ViewGroup.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT,
+				ViewGroup.LayoutParams.MATCH_PARENT));
+
+		final WebSettings viewSettings = getSettings();
+		viewSettings.setJavaScriptEnabled(true);
+		viewSettings.setDomStorageEnabled(true);
+
+		// keep elements in position in portrait mode
+		viewSettings.setLoadWithOverviewMode(true);
+		viewSettings.setUseWideViewPort(true);
+
+		// zoom controls
+		viewSettings.setSupportZoom(true);
+		viewSettings.setBuiltInZoomControls(true);
+		viewSettings.setDisplayZoomControls(false);
+
+		// allow autoplay of music
+		viewSettings.setMediaPlaybackRequiresUserGesture(false);
+
+		if (debugEnabled()) {
+			// make WebView debuggable for debug builds
+			setWebContentsDebuggingEnabled(true);
+		}
+
+		initWebViewClient();
+		initDownloadHandler();
+	}
+
+	/**
+	 * Sets active state of this client view.
+	 *
+	 * @param active
+	 *   If `true` shows this client view, otherwise hides it.
+	 */
+	public void setActive(final boolean active) {
+		if (active) {
+			setVisibility(ClientView.VISIBLE);
+			return;
+		}
+		setVisibility(ClientView.GONE);
+	}
+
+	/**
+	 * Checks active state of client view.
+	 *
+	 * @return
+	 *   `true` is this view is visible.
+	 */
+	public boolean isActive() {
+		return getVisibility() == ClientView.VISIBLE;
+	}
+
+	/**
+	 * Initializes method overrides to handle page loading.
+	 */
+	private void initWebViewClient() {
+		// XXX: not sure setting WebChromClient is doing anything, was recommended to
+		//      fix touchmove events not registering
+		setWebChromeClient(new WebChromeClient());
+
+		setWebViewClient(new WebViewClient() {
+			/**
+			 * Handles pages loaded indirectly.
+			 *
+			 * @param view
+			 *   The default WebView instance handling the request.
+			 * @param request
+			 *   Web request including the URL to be loaded.
+			 * @return
+			 *   `true` to abort default loading.
+			 */
+			@Override
+			public boolean shouldOverrideUrlLoading(final WebView view, final WebResourceRequest request) {
+				Uri uri = request.getUrl();
+				final Uri.Builder builder = uri.buildUpon();
+				if (UrlHelper.isLoginUri(uri)) {
+					builder.appendQueryParameter("build", AppInfo.getBuildType());
+					builder.appendQueryParameter("version", AppInfo.getBuildVersion());
+					builder.appendQueryParameter("state", stateId);
+					builder.appendQueryParameter("seed", seed);
+				}
+				uri = builder.build();
+				if (!UrlHelper.isInternalUri(uri)) {
+					// open external links in default browser/app
+					// FIXME: should we ask for confirmation?
+					try {
+						MainActivity.get().startActivity(new Intent(Intent.ACTION_VIEW, uri));
+					} catch (final ActivityNotFoundException e) {
+						Notifier.toast("No app found to open this link");
+					}
+					return true;
+				}
+				view.loadUrl(UrlHelper.checkClientUrl(uri.toString()));
+				return true;
+			}
+
+			/**
+			 * Called before a URL is loaded.
+			 *
+			 * @param view
+			 *   WebView instance handling page contents.
+			 * @param url
+			 *   HTTP string of target page.
+			 * @param favicon
+			 *   Favicon bitmap image.
+			 */
+			@Override
+			public void onPageStarted(final WebView view, final String url, final Bitmap favicon) {
+				MusicPlayer.stopMusic();
+				super.onPageStarted(view, url, favicon);
+			}
+
+			/**
+			 * Called after a URL is loaded.
+			 *
+			 * @param view
+			 *   WebView instance handling page contents.
+			 * @param url
+			 *   HTTP string of target page.
+			 */
+			@Override
+			public void onPageFinished(final WebView view, final String url) {
+				super.onPageFinished(view, url);
+				if (UrlHelper.isClientUrl(url)) {
+					setPage(PageId.WEBCLIENT);
+				} else if (url.equals("") || url.equals("about:blank")) {
+					setPage(PageId.TITLE);
+					if (PreferencesActivity.getBoolean("title_music", true)) {
+						MusicPlayer.playTitleMusic();
+					}
+				} else {
+					setPage(PageId.OTHER);
+				}
+				Menu.get().updateButtons();
+				Logger.debug("page id: " + currentPage);
+			}
+		});
+	}
+
+	/**
+	 * deprecated?
+	 */
+	@Override
+	public boolean dispatchKeyEvent(final KeyEvent event) {
+		final boolean ret = super.dispatchKeyEvent(event);
+		// hide keyboard when "enter" pressed
+		if (isGameActive() && event.getAction() == KeyEvent.ACTION_UP
+				&& event.getKeyCode() == KeyEvent.KEYCODE_ENTER) {
+			((InputMethodManager) MainActivity.get()
+				.getSystemService(Context.INPUT_METHOD_SERVICE))
+				.hideSoftInputFromWindow(this.getWindowToken(), 0);
+		}
+		return ret;
+	}
+
+	/**
+	 * Initializes interface for handling screenshots.
+	 */
+	private void initDownloadHandler() {
+		setDownloadListener(new DownloadListener() {
+			/**
+			 * Handles downloading screenshot created by web client.
+			 *
+			 * TODO: get filename to pass to `DownloadHandler.download` from "download" property of
+			 *       anchor
+			 *
+			 * @param url
+			 *   Content URL to the screenshot image.
+			 * @param userAgent
+			 *   User agent used for download.
+			 * @param contentDisposition
+			 *   Content-disposition HTTP header, if present.
+			 * @param mimetype
+			 *   Content type reported by server (web client creates PNG image).
+			 * @param contentLength
+			 *   File size reported by server.
+			 */
+			@Override
+			public void onDownloadStart(final String url, final String userAgent,
+					final String contentDisposition, final String mimetype, final long contentLength) {
+				final DownloadHandler handler = new DownloadHandler();
+				handler.download(url, mimetype);
+				if (handler.getResult()) {
+					final String msg = "Downloaded file: " + handler.getMessage();
+					Logger.debug(msg);
+					Notifier.toast(msg);
+				} else {
+					final String msg = handler.getMessage();
+					Logger.error(msg);
+					Notifier.toast("ERROR: " + msg);
+				}
+			}
+		});
+	}
+
+	/**
+	 * Verifies intent state & parses & loads target URL.
+	 *
+	 * @param intent
+	 *   Called login intent with state verification.
+	 */
+	public void checkLoginIntent(final Intent intent) {
+		final Uri intentUri = intent.getData();
+		final String url = intentUri.getQueryParameter("url");
+		final String loginseed = intentUri.getQueryParameter("loginseed");
+		final String intentStateId = intentUri.getQueryParameter("state");
+		if (stateId == null || intentStateId == null || url == null || "".equals(stateId) || !stateId.equals(intentStateId)) {
+			final String err = "There was an error verifying login";
+			Logger.error(err + " (\"" + stateId + "\" == \"" + intentStateId + "\")");
+			Notifier.showMessage(err);
+			if (currentPage == null || PageId.TITLE.equals(previousPage)) {
+				// reload title
+				loadTitleScreen();
+			}
+			return;
+		}
+		String completeUrl = url + "&loginseed=" + loginseed + seed;
+		loadUrl(UrlHelper.checkClientUrl(completeUrl));
+	}
+
+	/**
+	 * Determines if URL to load is test web client.
+	 */
+	public boolean isTestClient() {
+		return testClient;
+	}
+
+	/**
+	 * Determines if connection is to test server.
+	 */
+	public boolean isTestServer() {
+		return testServer;
+	}
+
+	/**
+	 * Retrieves a string representing the selected client.
+	 *
+	 * @return
+	 *   One of "main", "test", or "none".
+	 */
+	public String getSelectedClient() {
+		if (onTitleScreen()) {
+			return "none";
+		}
+		return testClient ? "test" : "main";
+	}
+
+	/**
+	 * Retrieves a string representing the selected server.
+	 *
+	 * @return
+	 *   One of "main", "test", or "none".
+	 */
+	public String getSelectedServer() {
+		if (onTitleScreen()) {
+			return "none";
+		}
+		return testServer ? "test" : "main";
+	}
+
+	/**
+	 * Resets selected client & server values to default.
+	 */
+	private void reset() {
+		testClient = false;
+		testServer = false;
+		clientUrlSuffix = "client";
+		stateId = "";
+		seed = "";
+	}
+
+	/**
+	 * Retrieves client type string.
+	 *
+	 * @return
+	 *   Either "client" or "testclient".
+	 */
+	public String getClientUrlSuffix() {
+		return clientUrlSuffix;
+	}
+
+	/**
+	 * Generates a random string for identifying state.
+	 */
+	private String generateRandomString() {
+		// ensure state is reset before generating
+		String result = "";
+
+		// useable characters
+		String charList = "0123456789";
+		for (char c = 'A'; c <= 'Z'; c++) {
+			charList += c;
+		}
+		for (char c = 'a'; c <= 'z'; c++) {
+			charList += c;
+		}
+
+		// generate random state
+		final Random rand = new Random();
+		final int ccount = charList.length();
+		for (int idx = 0; idx <= 20 ; idx++) {
+			result += charList.charAt(rand.nextInt(ccount));
+		}
+		return result;
+	}
+
+	/**
+	 * Opens location in client WebView.
+	 *
+	 * @param url
+	 *   URL to load.
+	 */
+	@Override
+	public void loadUrl(final String url) {
+		Logger.debug("Loading URL: " + url);
+		super.loadUrl(url);
+	}
+
+	/**
+	 * Shows initial title screen.
+	 */
+	public void loadTitleScreen() {
+		reset();
+		setPage(PageId.TITLE);
+		SplashUtil.get().setVisible(true);
+		loadUrl("about:blank");
+		Menu.get().show();
+	}
+
+	/**
+	 * Attempts to connect to client host.
+	 *
+	 * FIXME: rename as it may cause confusion in regards to loading page "account/login.html"
+	 */
+	public void loadLogin() {
+		if (debugEnabled() && PreferencesActivity.getString("client_url").trim().equals("")) {
+			// debug builds support choosing between main & test client/server
+			selectClient();
+		} else {
+			onSelectServer();
+		}
+	}
+
+	/**
+	 * Opens a message dialog for user to choose between main & test clients.
+	 */
+	private void selectClient() {
+		final AlertDialog.Builder builder = new AlertDialog.Builder(getContext());
+		builder.setMessage("Select client");
+
+		builder.setPositiveButton("Main", new DialogInterface.OnClickListener() {
+			@Override
+			public void onClick(final DialogInterface dialog, final int id) {
+				testClient = false;
+				clientUrlSuffix = "client";
+				// skip server confirmation as only test client has this option
+				onSelectServer();
+				dialog.cancel();
+			}
+		});
+
+		builder.setNegativeButton("Test", new DialogInterface.OnClickListener() {
+			@Override
+			public void onClick(final DialogInterface dialog, final int id) {
+				testClient = true;
+				clientUrlSuffix = "testclient";
+				selectServer();
+				dialog.cancel();
+			}
+		});
+
+		builder.create().show();
+	}
+
+	/**
+	 * Opens a message dialog for user to choose between main & test servers.
+	 */
+	private void selectServer() {
+		final AlertDialog.Builder builder = new AlertDialog.Builder(getContext());
+		builder.setMessage("Select server");
+
+		builder.setPositiveButton("Main", new DialogInterface.OnClickListener() {
+			@Override
+			public void onClick(final DialogInterface dialog, final int id) {
+				testServer = false;
+				dialog.cancel();
+				onSelectServer();
+			}
+		});
+
+		builder.setNegativeButton("Test", new DialogInterface.OnClickListener() {
+			@Override
+			public void onClick(final DialogInterface dialog, final int id) {
+				testServer = true;
+				dialog.cancel();
+				onSelectServer();
+			}
+		});
+
+		builder.create().show();
+	}
+
+	/**
+	 * Connects to server & loads initial page.
+	 */
+	private void onSelectServer() {
+		// create a unique state
+		stateId = generateRandomString();
+		seed = generateRandomString();
+		// hide splash image
+		SplashUtil.get().setVisible(false);
+
+		final String initialPage = UrlHelper.getInitialPageUrl();
+		Logger.debug("Loading initial page: " + initialPage);
+		loadUrl(initialPage);
+		setPage(PageId.OTHER);
+		// hide menu after exiting title screen
+		Menu.get().hide();
+	}
+
+	/**
+	 * Checks if user has specified a URL pointing to a custom server/client.
+	 *
+	 * @return
+	 *   Server address specified in preferences or `null`.
+	 */
+	public String checkCustomServer() {
+		final String cs = PreferencesActivity.getString("client_url", "").trim();
+		if (cs.equals("")) {
+			return null;
+		}
+		return cs;
+	}
+
+	/**
+	 * Checks if title page is currently loaded.
+	 *
+	 * @return
+	 *   `true` if current page matches `PageId.TITLE`.
+	 */
+	public boolean onTitleScreen() {
+		return currentPage == PageId.TITLE;
+	}
+
+	/**
+	 * Checks if web client page is currently loaded.
+	 *
+	 * @return
+	 *   `true` if current page matches `PageId.WEBCLIENT`.
+	 */
+	public boolean isGameActive() {
+		return currentPage == PageId.WEBCLIENT;
+	}
+
+	/**
+	 * Retrieves ID of current page.
+	 *
+	 * @return
+	 *   Current `PageId`.
+	 */
+	public PageId getCurrentPageId() {
+		return currentPage;
+	}
+
+	/**
+	 * Sets current page ID.
+	 *
+	 * @param newPage
+	 *   Page ID to be used.
+	 */
+	private void setPage(final PageId newPage) {
+		previousPage = currentPage;
+		currentPage = newPage;
+		if (previousPage == null) {
+			previousPage = currentPage;
+		}
+	}
+
+	/**
+	 * Checks if this is a debug build.
+	 *
+	 * @return
+	 *   `true` if debug flag set.
+	 */
+	public boolean debugEnabled() {
+		if (debugging != null) {
+			return debugging;
+		}
+		if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
+			debugging = (MainActivity.get().getApplicationInfo().flags & ApplicationInfo.FLAG_DEBUGGABLE) != 0;
+		} else {
+			debugging = false;
+		}
+		return debugging;
+	}
+}

app/android/client/src/main/java/org/stendhalgame/client/DownloadHandler.java

@@ -0,0 +1,228 @@
+/***************************************************************************
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+package org.stendhalgame.client;
+
+import java.io.File;
+import java.io.FileOutputStream;
+import java.net.URLDecoder;
+import java.nio.charset.StandardCharsets;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+
+import android.net.Uri;
+import android.os.Environment;
+import android.util.Base64;
+
+
+/**
+ * The main purpose of this class is to handle downloading screenshots
+ * created by the web client page.
+ */
+public class DownloadHandler {
+
+	private static enum DownloadType {
+		IMAGE_PNG("image/png"),
+		TEXT_PLAIN("text/plain"),
+		UNSUPPORTED(null);
+
+		private String value;
+
+		private DownloadType(final String value) {
+			this.value = value;
+		}
+
+		public static DownloadType fromString(final String value) {
+			for (final DownloadType v: DownloadType.values()) {
+				if (v.value != null && v.value.equals(value)) {
+					return v;
+				}
+			}
+			return DownloadType.UNSUPPORTED;
+		}
+	}
+
+	private boolean result = false;
+	private String message = null;
+
+
+	/**
+	 * Checks for a supported MIME type.
+	 *
+	 * @param url
+	 *   File or data URL.
+	 * @param mimetype
+	 *   Detected MIME type.
+	 * @return
+	 *   Download type or unsupported.
+	 */
+	private DownloadType checkMimeType(final String url, final String mimetype) {
+		final DownloadType dtype = DownloadType.fromString(mimetype);
+		if (DownloadType.UNSUPPORTED.equals(dtype) && url.startsWith("data:image/png;base64,")) {
+			return DownloadType.IMAGE_PNG;
+		}
+		return dtype;
+	}
+
+	/**
+	 * Writes file data to device storage.
+	 *
+	 * @param dir
+	 *   Directory where new file is to be created.
+	 * @param basename
+	 *   Filename of new file.
+	 * @param data
+	 *   File contents to be written to storage.
+	 */
+	private void downloadInternal(final File dir, final String basename, final byte[] data) {
+		String stacktrace = null;
+		try {
+			if (!dir.exists()) {
+				dir.mkdirs();
+			}
+			final FileOutputStream fos = new FileOutputStream(new File(dir, basename));
+			fos.write(data);
+			fos.close();
+			this.result = true;
+		} catch (final java.lang.NoClassDefFoundError e) {
+			this.message = "an error occurred while decoding data (see debug log for more info)";
+			stacktrace = stackTraceToString(e);
+		} catch (java.io.IOException e) {
+			this.message = "an error occurred while attempting to write file (see debug log for more info)";
+			stacktrace = stackTraceToString(e);
+		}
+
+		if (stacktrace != null) {
+			Logger.error(stacktrace.toString());
+		}
+	}
+
+	/**
+	 * Writes file data to device storage.
+	 *
+	 * @param url
+	 *   A data URL.
+	 * @param mimetype
+	 *   Detected MIME type.
+	 * @param targetName
+	 *   Filename for new file.
+	 */
+	public void download(final String url, final String mimetype, String targetName) {
+
+		final Uri uri = Uri.parse(url);
+		final String scheme = uri.getScheme();
+		final String storageState = Environment.getExternalStorageState();
+		final DownloadType dtype = checkMimeType(url, mimetype);
+
+		if (!MainActivity.get().getActiveClientView().isGameActive()) {
+			this.message = "downloading from this page not supported";
+		} else if (!"data".equals(scheme)) {
+			// only data URL supported
+			this.message = "download type \"" + scheme + "\" not supported";
+		} else if (DownloadType.UNSUPPORTED.equals(dtype)) {
+			this.message = "mimetype not supported: " + mimetype;
+		} else if (!Environment.MEDIA_MOUNTED.equals(storageState)) {
+			this.message = "storage not available for writing (state: " + storageState + ")";
+		} else if (DownloadType.IMAGE_PNG.equals(dtype)) {
+			final File targetDir = new File(Environment.getExternalStorageDirectory()
+					+ "/Pictures/Screenshots");
+			if (targetName == null) {
+				// default filename
+				targetName = "stendhal_" + new SimpleDateFormat("yyyy-MM-dd_HH.mm.ss").format(new Date())
+						+ ".png";
+			}
+
+			Logger.debug("Saving screenshot: " + targetDir.getPath()
+					+ "/" + targetName + " (" + mimetype + ")");
+
+			final byte[] data = Base64.decode(url.split("base64,")[1], Base64.DEFAULT);
+			downloadInternal(targetDir, targetName, data);
+			if (this.result) {
+				this.message = "saved screenshot to " + targetDir.getPath() + "/" + targetName;
+			}
+		} else if (DownloadType.TEXT_PLAIN.equals(dtype)) {
+			// `Environment.DIRECTORY_DOWNLOADS` fails on newer Android versions
+			//final File targetDir = new File(Environment.DIRECTORY_DOWNLOADS);
+			final File targetDir = new File(Environment.getExternalStorageDirectory() + "/Download");
+			if (targetName == null) {
+				// default filename
+				targetName = "stendhal_" + new SimpleDateFormat("yyyy-MM-dd_HH.mm.ss").format(new Date())
+						+ ".txt";
+			}
+
+			Logger.debug("Saving file: " + targetDir.getPath()
+			+ "/" + targetName + " (" + mimetype + ")");
+
+			final String[] parts = url.split(",");
+			byte[] data;
+			if (parts[0].endsWith(";base64")) {
+				data = Base64.decode(parts[1], Base64.DEFAULT);
+			} else {
+				try {
+					data = URLDecoder.decode(parts[1], StandardCharsets.UTF_8.name())
+							.getBytes(StandardCharsets.UTF_8);
+				} catch (final java.io.UnsupportedEncodingException e) {
+					this.message = "an error occurred while attempting to decode data URL (see debug log for more info)";
+					Logger.error(stackTraceToString(e));
+					return;
+				}
+			}
+
+			downloadInternal(targetDir, targetName, data);
+			if (this.result) {
+				this.message = "file saved to " + targetDir.getPath() + "/" + targetName;
+			}
+		} else {
+			this.message = "an unknown error occurred";
+		}
+	}
+
+	/**
+	 * Writes file data to device storage.
+	 *
+	 * @param url
+	 *   A data URL.
+	 * @param mimetype
+	 *   Detected MIME type.
+	 */
+	public void download(final String url, final String mimetype) {
+		download(url, mimetype, null);
+	}
+
+	public boolean getResult() {
+		return result;
+	}
+
+	public String getMessage() {
+		return message;
+	}
+
+	/**
+	 * Converts an exception stacktrace to string.
+	 *
+	 * @param e
+	 *     The error with stacktrace information.
+	 * @return
+	 *     String formatted stacktrace.
+	 */
+	private String stackTraceToString(final Throwable e) {
+		final StringBuilder sb = new StringBuilder();
+		sb.append(e.toString());
+		for (final StackTraceElement ste: e.getStackTrace()) {
+			if (sb.length() > 0) {
+				sb.append("\n");
+			}
+			sb.append(ste.toString());
+		}
+
+		return sb.toString();
+	}
+}

app/android/client/src/main/java/org/stendhalgame/client/LogLevel.java

@@ -1,5 +1,5 @@
 /***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
+ *                    Copyright © 2024 - Faiumoni e. V.                    *
  ***************************************************************************
  ***************************************************************************
  *                                                                         *
@@ -9,29 +9,31 @@
  *   (at your option) any later version.                                   *
  *                                                                         *
  ***************************************************************************/
-package org.arianne.stendhal.client.js;
-
-import android.webkit.JavascriptInterface;
+package org.stendhalgame.client;
 
 
+/**
+ * Logger verbosity levels.
+ */
+public enum LogLevel {
 
-public class JSInterface {
+	// available verbosity levels
+	INFO("INFO"),
+	WARN("WARN"),
+	ERROR("ERROR"),
+	DEBUG("DEBUG");
 
-	/** Singleton instance. */
-	private static JSInterface instance;
+	/** String identifier. */
+	public final String label;
 
 
 	/**
-	 * Retrieves the singleton instance.
+	 * Creates a new logging verbosity level.
+	 *
+	 * @param label
+	 *   String identifier.
 	 */
-	public static JSInterface get() {
-		if (instance == null) {
-			instance = new JSInterface();
-		}
-		return instance;
-	}
-
-	private JSInterface() {
-		// singleton
+	private LogLevel(final String label) {
+		this.label = label;
 	}
 }

app/android/client/src/main/java/org/stendhalgame/client/MainActivity.java

@@ -0,0 +1,282 @@
+/***************************************************************************
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+package org.stendhalgame.client;
+
+import java.util.LinkedList;
+import java.util.List;
+
+import android.app.AlertDialog;
+import android.content.DialogInterface;
+import android.content.Intent;
+import android.content.pm.ActivityInfo;
+import android.content.res.Configuration;
+import android.os.Bundle;
+import android.view.ViewGroup;
+import androidx.appcompat.app.AppCompatActivity;
+
+
+/**
+ * Main app activity.
+ */
+public class MainActivity extends AppCompatActivity {
+
+	/** Menu instance. */
+	private Menu menu;
+	/** Active clients. **/
+	private ViewGroup clientList;
+
+	/** Static activity instance. */
+	private static MainActivity instance;
+
+
+	/**
+	 * Retrieves activity instance.
+	 *
+	 * NOTE: This may not be necessary if Android has built-in methods to retrieve current activity.
+	 */
+	public static MainActivity get() {
+		return MainActivity.instance;
+	}
+
+	/**
+	 * Called when main activity is created.
+	 */
+	@Override
+	protected void onCreate(final Bundle savedInstanceState) {
+		try {
+			super.onCreate(savedInstanceState);
+			// FIXME: may be considered unsafe as this is not technically a singleton
+			MainActivity.instance = this;
+
+			// initialize debug logging mechanism
+			Logger.init(getExternalFilesDir(null));
+
+			setContentView(R.layout.activity_main);
+			clientList = findViewById(R.id.clientList);
+			createClientView();
+			// NOTE: client view instance must be created before initializing menu
+			menu = Menu.get();
+			updateOrientation();
+		} catch (final Exception e) {
+			// TODO: add option to save to file or copy to clipboard the error
+			e.printStackTrace();
+			Logger.error(e.toString());
+			Logger.error("// -- //");
+			final StringBuilder sb = new StringBuilder();
+			for (final StackTraceElement ste: e.getStackTrace()) {
+				final String traceLine = ste.toString();
+				if (sb.length() > 0) {
+					sb.append("\n");
+				}
+				sb.append(traceLine);
+				Logger.error(traceLine);
+			}
+			Logger.error("// -- //");
+			Notifier.showPrompt(
+				"An unhandled exception has occurred: \"" + e.getMessage() + "\""
+				+ "\n\nYou can report this error at: https://stendhalgame.org/development/bug.html"
+				+ "\n\nStack trace:\n" + sb.toString(),
+				new Notifier.Action() {
+					@Override
+					protected void onCall() {
+						finish();
+					}
+				});
+		}
+	}
+
+	/**
+	 * Handles toggling menu when the system "back" button is pressed.
+	 */
+	@Override
+	public void onBackPressed() {
+		menu.toggleVisibility();
+	}
+
+	/**
+	 * Creates view to host a client instance.
+	 */
+	private void createClientView() {
+		final ClientView clientView = new ClientView(this);
+		setActiveClientView(clientView);
+		clientList.addView(clientView);
+		clientView.loadTitleScreen();
+		// show splash when a new view is created
+		SplashUtil.get().setVisible(true);
+	}
+
+	/**
+	 * Sets client view to be shown and hides all others.
+	 *
+	 * @param clientView
+	 *   The `ClientView` instance to be visible.
+	 */
+	private void setActiveClientView(final ClientView clientView) {
+		for (int idx = 0; idx < clientList.getChildCount(); idx++) {
+			((ClientView) clientList.getChildAt(idx)).setActive(false);
+		}
+		clientView.setActive(true);
+	}
+
+	/**
+	 * Sets client view to be shown and hides all others.
+	 *
+	 * @param clientIndex
+	 *   The index of `ClientView` instance to be visible.
+	 */
+	private void setActiveClientView(final int clientIndex) {
+		if (clientIndex < 0 || clientIndex >= clientList.getChildCount()) {
+			Logger.error(true, "Tried to access invalid client index: " + clientIndex);
+			return;
+		}
+		setActiveClientView((ClientView) clientList.getChildAt(clientIndex));
+	}
+
+	/**
+	 * Retrieves active client view.
+	 *
+	 * @return
+	 *   `ClientView` instance that is visible.
+	 */
+	public ClientView getActiveClientView() {
+		for (int idx = 0; idx < clientList.getChildCount(); idx++) {
+			final ClientView clientView = (ClientView) clientList.getChildAt(idx);
+			if (clientView.isActive()) {
+				return clientView;
+			}
+		}
+		// default to first client view
+		return (ClientView) clientList.getChildAt(0);
+	}
+
+	/**
+	 * Retrieves list of available client views.
+	 *
+	 * @return
+	 *   List containing all created `ClientView` instances.
+	 */
+	public List<ClientView> getClientViewList() {
+		final List<ClientView> available = new LinkedList<>();
+		for (int idx = 0; idx < clientList.getChildCount(); idx++) {
+			available.add((ClientView) clientList.getChildAt(idx));
+		}
+		return available;
+	}
+
+	/**
+	 * Attempts to connect to client host.
+	 */
+	public void loadLogin() {
+		getActiveClientView().loadLogin();
+	}
+
+	/**
+	 * Retrieves app orientation.
+	 *
+	 * @return
+	 *   One of `Configuration.ORIENTATION_PORTRAIT` (1), `Configuration.ORIENTATION_LANDSCAPE` (2),
+	 *   or `Configuration.ORIENTATION_UNDEFINED` (0).
+	 */
+	public int getOrientation() {
+		return getResources().getConfiguration().orientation;
+	}
+
+	/**
+	 * Sets screen orientation to user setting or locks in landscape or portrait.
+	 */
+	public void updateOrientation() {
+		final String value = PreferencesActivity.getString("orientation");
+		int orient = ActivityInfo.SCREEN_ORIENTATION_USER;
+		switch (value) {
+			case "landscape":
+				orient = ActivityInfo.SCREEN_ORIENTATION_SENSOR_LANDSCAPE;
+				break;
+			case "portrait":
+				orient = ActivityInfo.SCREEN_ORIENTATION_PORTRAIT;
+				break;
+		}
+		// set orientation for main & sub activities
+		setRequestedOrientation(orient);
+		final PreferencesActivity preferencesActivity = PreferencesActivity.get();
+		if (preferencesActivity != null) {
+			preferencesActivity.setRequestedOrientation(orient);
+		}
+	}
+
+	/**
+	 * Opens a dialog to confirm exiting activity.
+	 */
+	public void onRequestQuit() {
+		final AlertDialog.Builder builder = new AlertDialog.Builder(this);
+		builder.setMessage("Quit Stendhal?");
+
+		builder.setPositiveButton("Yes", new DialogInterface.OnClickListener() {
+			@Override
+			public void onClick(final DialogInterface dialog, final int id) {
+				finish();
+				android.os.Process.killProcess(android.os.Process.myPid());
+			}
+		});
+
+		builder.setNegativeButton("No", new DialogInterface.OnClickListener() {
+			@Override
+			public void onClick(final DialogInterface dialog, final int id) {
+				dialog.cancel();
+			}
+		});
+
+		final AlertDialog confirmQuit = builder.create();
+		confirmQuit.show();
+	}
+
+	//~ @Override
+	//~ protected void onResume() {
+		//~ super.onResume();
+	//~ }
+
+	/**
+	 * Listens for changes to orientation.
+	 */
+	@Override
+	public void onConfigurationChanged(final Configuration config) {
+		super.onConfigurationChanged(config);
+		final ClientView clientView = getActiveClientView();
+		if (clientView != null && PageId.TITLE.equals(clientView.getCurrentPageId())) {
+			SplashUtil.get().update();
+		}
+	}
+
+	/**
+	 * Called when main activity ends.
+	 */
+	@Override
+	public void finish() {
+		Logger.debug(MainActivity.class.getName() + ".finish() called");
+		super.finish();
+	}
+
+	/**
+	 * Called when main activity is destroyed.
+	 */
+	@Override
+	protected void onDestroy() {
+		Logger.debug(MainActivity.class.getName() + ".onDestroy() called");
+		super.onDestroy();
+	}
+
+	/**
+	 * Creates preferences activity.
+	 */
+	public void showSettings() {
+		startActivity(new Intent(this, PreferencesActivity.class));
+	}
+}

app/android/client/src/main/java/org/stendhalgame/client/Menu.java

@@ -1,5 +1,5 @@
 /***************************************************************************
- *                     Copyright © 2022-2023 - Arianne                     *
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
  ***************************************************************************
  ***************************************************************************
  *                                                                         *
@@ -9,40 +9,45 @@
  *   (at your option) any later version.                                   *
  *                                                                         *
  ***************************************************************************/
-package org.arianne.stendhal.client;
+package org.stendhalgame.client;
 
-import android.app.Activity;
-import android.app.AlertDialog;
-import android.content.Context;
-import android.content.DialogInterface;
 import android.view.View;
 import android.view.ViewTreeObserver;
 import android.widget.Button;
 import android.widget.Toolbar;
 
 
+/**
+ * Main menu for navigation & configuration.
+ */
 public class Menu {
 
-	private static Menu instance;
-
-	private final Context ctx;
+	/** Toolbar representing menu. */
 	private final Toolbar nav;
 
 	private Button btn_connect;
 	private Button btn_title;
 	private Button btn_reload;
 
+	/** Singleton instance. */
+	private static Menu instance;
 
+
+	/**
+	 * Retrieves menu singleton instance.
+	 */
 	public static Menu get() {
+		if (Menu.instance == null) {
+			Menu.instance = new Menu();
+		}
 		return instance;
 	}
 
-	public Menu(final Context ctx) {
-		instance = this;
-		this.ctx = ctx;
-
-		nav = (Toolbar) ((Activity) ctx).findViewById(R.id.menu_main);
-
+	/**
+	 * Hidden singleton constructor.
+	 */
+	private Menu() {
+		nav = (Toolbar) MainActivity.get().findViewById(R.id.menu_main);
 		nav.setTag(nav.getVisibility());
 		nav.getViewTreeObserver().addOnGlobalLayoutListener(
 				new ViewTreeObserver.OnGlobalLayoutListener() {
@@ -53,20 +58,30 @@ public class Menu {
 				}
 			}
 		});
-
 		initButtonHandlers();
-
-		DebugLog.debug("menu initialized");
+		Logger.debug("menu initialized");
 	}
 
+	/**
+	 * Retrieves the menu toolbar.
+	 */
 	public Toolbar getInternal() {
 		return nav;
 	}
 
+	/**
+	 * Shows or hides menu.
+	 *
+	 * @param vType
+	 *   Visibility type. One of `View.VISIBLE`, `View.INVISIBLE`, or `View.GONE`.
+	 */
 	public void setVisibility(final int vType) {
 		nav.setVisibility(vType);
 	}
 
+	/**
+	 * Toggles visible state of menu.
+	 */
 	public void toggleVisibility() {
 		if (nav.getVisibility() == View.GONE) {
 			nav.setVisibility(View.VISIBLE);
@@ -75,16 +90,25 @@ public class Menu {
 		}
 	}
 
+	/**
+	 * Sets menu visibility to visible.
+	 */
 	public void show() {
 		nav.setVisibility(View.VISIBLE);
 	}
 
+	/**
+	 * Sets menu visibility to hidden.
+	 */
 	public void hide() {
 		nav.setVisibility(View.GONE);
 	}
 
+	/**
+	 * Refreshes displayed menu buttons.
+	 */
 	public void updateButtons() {
-		final PageId page = ClientView.getCurrentPageId();
+		final PageId page = MainActivity.get().getActiveClientView().getCurrentPageId();
 
 		btn_connect.setVisibility(View.GONE);
 		btn_title.setVisibility(View.GONE);
@@ -102,10 +126,11 @@ public class Menu {
 	 * Sets actions when buttons are pressed.
 	 */
 	private void initButtonHandlers() {
-		final MainActivity activity = (MainActivity) ctx;
+		final MainActivity activity = MainActivity.get();
 
 		btn_connect = (Button) activity.findViewById(R.id.btn_connect);
 		btn_connect.setOnClickListener(new View.OnClickListener() {
+			@Override
 			public void onClick(final View v) {
 				activity.loadLogin();
 			}
@@ -113,17 +138,20 @@ public class Menu {
 
 		btn_title = (Button) activity.findViewById(R.id.btn_title);
 		btn_title.setOnClickListener(new View.OnClickListener() {
+			@Override
 			public void onClick(final View v) {
 				nav.setVisibility(View.GONE);
 
 				Notifier.showPrompt("Return to title screen?",
 					new Notifier.Action() {
+						@Override
 						protected void onCall() {
-							ClientView.get().loadTitleScreen();
+							MainActivity.get().getActiveClientView().loadTitleScreen();
 							updateButtons();
 						}
 					},
 					new Notifier.Action() {
+						@Override
 						protected void onCall() {/* do nothing */}
 					}
 				);
@@ -132,6 +160,7 @@ public class Menu {
 
 		btn_reload = (Button) activity.findViewById(R.id.btn_reload);
 		btn_reload.setOnClickListener(new View.OnClickListener() {
+			@Override
 			public void onClick(final View v) {
 				nav.setVisibility(View.GONE);
 
@@ -139,7 +168,7 @@ public class Menu {
 					new Notifier.Action() {
 						@Override
 						protected void onCall() {
-							ClientView.get().reload();
+							MainActivity.get().getActiveClientView().reload();
 						}
 					},
 					new Notifier.Action() {
@@ -153,43 +182,57 @@ public class Menu {
 
 		final Button btn_settings = (Button) activity.findViewById(R.id.btn_settings);
 		btn_settings.setOnClickListener(new ClickListener() {
+			@Override
 			public void onClick(final View v) {
 				super.onClick(v);
 
-				((MainActivity) ctx).showSettings();
+				activity.showSettings();
 			}
 		});
 
+		/*
 		final Button btn_about = (Button) activity.findViewById(R.id.btn_about);
 		btn_about.setOnClickListener(new ClickListener() {
+			@Override
 			public void onClick(final View v) {
 				super.onClick(v);
 
 				// TODO: create proper about activity
 
-				String server_ver = "unavailable";
-				if (!(ClientView.getCurrentPageId() == PageId.WEBCLIENT)) {
-					server_ver = "not connected";
+				final ClientView client = MainActivity.get().getCurrentView();
+				final AlertDialog.Builder builder = new AlertDialog.Builder(MainActivity.get());
+				final String buildType = AppInfo.getBuildType();
+				String msg = "Android client version: " + AppInfo.getBuildVersion();
+				if (!"prod".equals(buildType)) {
+					msg += "\nAndroid client build: " + AppInfo.getBuildType();
 				}
-				// FIXME: how to find server version if connected?
-
-				final ClientView client = ClientView.get();
-				final AlertDialog.Builder builder = new AlertDialog.Builder((Activity) ctx);
-				String msg = "WebView client version: " + BuildConfig.VERSION_NAME;
 				if (client.debugEnabled()) {
-					msg += "\nSelected client: " + client.getSelectedClient()
-							+ "\nSelected server: " + client.getSelectedServer();
+					msg += "\nClient type: " + client.getSelectedClient()
+							+ "\nServer type: " + client.getSelectedServer()
+							+ "\nLogs directory: " + Logger.getLogsDir();
 				}
-				msg += "\nServer version: " + server_ver
-						+ "\n\nTitle Music:"
-						+ "\n- \"Treasure Hunter\": Tad Miller (TAD)"
-						+ "\n- \"Woodland Fantasy\": Matthew Pablo http://www.matthewpablo.com/"
-						+ "\n- \"Land of Fearless\": Alexandr Zhelanov https://soundcloud.com/alexandr-zhelanov"
-						+ "\n- \"Medieval: Rejoicing\": RandomMind"
-						+ "\n- \"Medieval: The Old Tower Inn\": RandomMind";
+				msg += "\n\nTitle Music:"
+						+ "\n\n- Treasure Hunter"
+						+ "\n  by Tad Miller (TAD)"
+						+ "\n  - opengameart.org/node/127124"
+						+ "\n\n- Woodland Fantasy"
+						+ "\n  by Matthew Pablo"
+						+ "\n  - matthewpablo.com"
+						+ "\n  - opengameart.org/node/31929"
+						+ "\n\n- Land of Fearless"
+						+ "\n  by Alexandr Zhelanov"
+						+ "\n  - soundcloud.com/alexandr-zhelanov"
+						+ "\n  - opengameart.org/node/79931"
+						+ "\n\n- Rejoicing"
+						+ "\n  by RandomMind"
+						+ "\n  - opengameart.org/node/100213"
+						+ "\n\n- The Old Tower Inn"
+						+ "\n  by RandomMind"
+						+ "\n  - opengameart.org/node/87510";
 				builder.setMessage(msg);
 
 				builder.setPositiveButton("Ok", new DialogInterface.OnClickListener() {
+					@Override
 					public void onClick(final DialogInterface dialog, final int id) {
 						dialog.cancel();
 					}
@@ -198,9 +241,11 @@ public class Menu {
 				builder.create().show();
 			}
 		});
+		*/
 
 		final Button btn_quit = (Button) activity.findViewById(R.id.btn_quit);
 		btn_quit.setOnClickListener(new ClickListener() {
+			@Override
 			public void onClick(final View v) {
 				super.onClick(v);
 				activity.onRequestQuit();
@@ -210,9 +255,13 @@ public class Menu {
 		updateButtons();
 	}
 
+	/**
+	 * Listener to handle menu button presses.
+	 */
 	private class ClickListener implements View.OnClickListener {
+		@Override
 		public void onClick(final View v) {
-			if (!ClientView.onTitleScreen()) {
+			if (!MainActivity.get().getActiveClientView().onTitleScreen()) {
 				nav.setVisibility(View.GONE);
 			}
 		}

app/android/client/src/main/java/org/stendhalgame/client/MusicPlayer.java

@@ -1,5 +1,5 @@
 /***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
  ***************************************************************************
  ***************************************************************************
  *                                                                         *
@@ -9,17 +9,14 @@
  *   (at your option) any later version.                                   *
  *                                                                         *
  ***************************************************************************/
-package org.arianne.stendhal.client.sound;
+package org.stendhalgame.client;
+
+import java.io.IOException;
 
 import android.content.Context;
 import android.media.MediaPlayer;
 import android.net.Uri;
 
-import java.io.IOException;
-
-import org.arianne.stendhal.client.DebugLog;
-import org.arianne.stendhal.client.MainActivity;
-
 
 public class MusicPlayer {
 
@@ -28,22 +25,24 @@ public class MusicPlayer {
 
 	public static void playMusic(final Context ctx, final int id, final boolean loop) {
 		if (isPlaying()) {
-			DebugLog.debug("freeing up MusicPlayer instance to play new song");
+			Logger.debug("freeing up MusicPlayer instance to play new song");
 			stopMusic();
 		}
 
-		DebugLog.debug("starting music (loop: " + loop + ")");
+		Logger.debug("starting music (loop: " + loop + ")");
 
 		mplayer = new MediaPlayer();
 		mplayer.setOnPreparedListener(new MediaPlayer.OnPreparedListener() {
+			@Override
 			public void onPrepared(final MediaPlayer mp) {
-				DebugLog.debug("starting music");
+				Logger.debug("starting music");
 				// FIXME: not working
 				//mplayer.setLooping(loop);
 				mplayer.start();
 			}
 		});
 		mplayer.setOnCompletionListener(new MediaPlayer.OnCompletionListener() {
+			@Override
 			public void onCompletion(final MediaPlayer mp) {
 				// free up resources & reset player to null
 				stopMusic();
@@ -59,7 +58,7 @@ public class MusicPlayer {
 			mplayer.setDataSource(ctx, parseResourceUri(id));
 			mplayer.prepareAsync();
 		} catch (final IOException e) {
-			DebugLog.error("failed to load resource " + id + ":\n" + e.getStackTrace());
+			Logger.error("failed to load resource " + id + ":\n" + e.getStackTrace());
 		}
 	}
 
@@ -67,10 +66,46 @@ public class MusicPlayer {
 		playMusic(MainActivity.get(), id, loop);
 	}
 
+	/**
+	 * Plays selected music.
+	 *
+	 * @param musicId
+	 *   String identifier of music to play or `null` to play music configured in preferences.
+	 */
+	public static void playTitleMusic(String musicId) {
+		if (musicId == null) {
+			musicId = PreferencesActivity.getString("song_list");
+		}
+		int id = R.raw.title_01;
+		switch (musicId) {
+			case "title_02":
+				id = R.raw.title_02;
+				break;
+			case "title_03":
+				id = R.raw.title_03;
+				break;
+			case "title_04":
+				id = R.raw.title_04;
+				break;
+			case "title_05":
+				id = R.raw.title_05;
+				break;
+		}
+		Logger.debug("playing music: " + musicId);
+		MusicPlayer.playMusic(id, true);
+	}
+
+	/**
+	 * Plays music configured in preferences.
+	 */
+	public static void playTitleMusic() {
+		playTitleMusic(null);
+	}
+
 	public static void stopMusic() {
 		if (mplayer != null) {
 			if (mplayer.isPlaying()) {
-				DebugLog.debug("stopping music");
+				Logger.debug("stopping music");
 				mplayer.stop();
 			}
 			mplayer.release();

app/android/client/src/main/java/org/stendhalgame/client/Notifier.java

@@ -1,5 +1,5 @@
 /***************************************************************************
- *                     Copyright © 2022-2023 - Arianne                     *
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
  ***************************************************************************
  ***************************************************************************
  *                                                                         *
@@ -9,7 +9,7 @@
  *   (at your option) any later version.                                   *
  *                                                                         *
  ***************************************************************************/
-package org.arianne.stendhal.client;
+package org.stendhalgame.client;
 
 import android.app.AlertDialog;
 import android.content.Context;
@@ -53,6 +53,7 @@ public class Notifier {
 			builder.setTitle(title);
 		}
 		builder.setPositiveButton("Ok", new DialogInterface.OnClickListener() {
+			@Override
 			public void onClick(final DialogInterface dialog, final int id) {
 				dialog.cancel();
 			}
@@ -92,6 +93,7 @@ public class Notifier {
 		}
 
 		builder.setPositiveButton(labelY, new DialogInterface.OnClickListener() {
+			@Override
 			public void onClick(final DialogInterface dialog, final int id) {
 				dialog.cancel();
 
@@ -111,6 +113,7 @@ public class Notifier {
 			}
 
 			builder.setNegativeButton(labelN, new DialogInterface.OnClickListener() {
+				@Override
 				public void onClick(final DialogInterface dialog, final int id) {
 					dialog.cancel();
 
@@ -131,6 +134,7 @@ public class Notifier {
 			}
 
 			builder.setNeutralButton(labelO, new DialogInterface.OnClickListener() {
+				@Override
 				public void onClick(final DialogInterface dialog, final int id) {
 					dialog.cancel();
 

app/android/client/src/main/java/org/stendhalgame/client/OpenAppByUrl.java

@@ -0,0 +1,32 @@
+/***************************************************************************
+ *                    Copyright © 2024 - Faiumoni e. V.                    *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+package org.stendhalgame.client;
+
+import android.app.Activity;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Bundle;
+
+public class OpenAppByUrl extends Activity {
+
+	@Override
+	public void onCreate(Bundle savedInstanceState) {
+		super.onCreate(savedInstanceState);
+		Intent intent = getIntent();
+		// String action = intent.getAction();
+		Uri data = intent.getData();
+		Logger.debug("URL: " + data);
+		MainActivity.get().getActiveClientView().checkLoginIntent(intent);
+		finish();
+	 }
+
+}

app/android/client/src/main/java/org/stendhalgame/client/PageId.java

@@ -1,5 +1,5 @@
 /***************************************************************************
- *                     Copyright © 2022 - Arianne                          *
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
  ***************************************************************************
  ***************************************************************************
  *                                                                         *
@@ -9,7 +9,7 @@
  *   (at your option) any later version.                                   *
  *                                                                         *
  ***************************************************************************/
-package org.arianne.stendhal.client;
+package org.stendhalgame.client;
 
 
 public enum PageId {

app/android/client/src/main/java/org/stendhalgame/client/PreferencesActivity.java

@@ -1,5 +1,5 @@
 /***************************************************************************
- *                     Copyright © 2022-2023 - Arianne                     *
+ *                 Copyright © 2022-2024 - Faiumoni e. V.                  *
  ***************************************************************************
  ***************************************************************************
  *                                                                         *
@@ -9,38 +9,47 @@
  *   (at your option) any later version.                                   *
  *                                                                         *
  ***************************************************************************/
-package org.arianne.stendhal.client;
+package org.stendhalgame.client;
 
 import android.content.SharedPreferences;
 import android.content.SharedPreferences.OnSharedPreferenceChangeListener;
 import android.os.Bundle;
-import android.preference.CheckBoxPreference;
-import android.preference.ListPreference;
-import android.preference.Preference;
-import android.preference.PreferenceFragment;
-import android.preference.PreferenceManager;
 import androidx.appcompat.app.AppCompatActivity;
-
-import org.arianne.stendhal.client.input.DPad;
-import org.arianne.stendhal.client.input.DPadArrows;
-import org.arianne.stendhal.client.input.DPadJoy;
-import org.arianne.stendhal.client.sound.MusicPlayer;
+import androidx.preference.CheckBoxPreference;
+import androidx.preference.ListPreference;
+import androidx.preference.Preference;
+import androidx.preference.PreferenceFragmentCompat;
+import androidx.preference.PreferenceManager;
 
 
+/**
+ * Interface for configuring app preferences.
+ */
 public class PreferencesActivity extends AppCompatActivity {
 
+	/** Preferences activity instance. */
 	private static PreferencesActivity instance;
 
 
+	/**
+	 * Retrieves preferences activity instance.
+	 */
 	public static PreferencesActivity get() {
 		return instance;
 	}
 
+	/**
+	 * Called when the activity is created.
+	 */
 	@Override
 	protected void onCreate(final Bundle savedInstanceState) {
 		super.onCreate(savedInstanceState);
+		// FIXME: may be considered unsafe as this is not technically a singleton
 		instance = this;
 
+		// use same orientation as main activity
+		setRequestedOrientation(MainActivity.get().getRequestedOrientation());
+
 		setContentView(R.layout.activity_preferences);
 
 		if (findViewById(R.id.preferencesFrame) != null) {
@@ -48,8 +57,8 @@ public class PreferencesActivity extends AppCompatActivity {
 				return;
 			}
 
-			getFragmentManager().beginTransaction().add(R.id.preferencesFrame,
-				new PFragment()).commit();
+			getSupportFragmentManager().beginTransaction().add(R.id.preferencesFrame,
+					new PFragment()).commit();
 		}
 	}
 
@@ -119,63 +128,62 @@ public class PreferencesActivity extends AppCompatActivity {
 			// SharedPreferences.getInt is returning string
 			final Object obj = getSharedPreferences().getString(key, String.valueOf(defVal));
 			if (obj instanceof String) {
-				DebugLog.debug("PreferencesActivity.getInt: casting string return value to integer");
+				Logger.debug("PreferencesActivity.getInt: casting string return value to integer");
 				return Integer.parseInt((String) obj);
 			} else {
-				DebugLog.debug("PreferencesActivity.getInt return value is integer");
+				Logger.debug("PreferencesActivity.getInt return value is integer");
 				return (Integer) obj;
 			}
 		} catch (final NumberFormatException e) {
 			final String errMsg = "An error occurred: " + e.getMessage();
-			DebugLog.error(errMsg + "\n" + e.getStackTrace());
-			Notifier.showError(errMsg + "\n\nSee " + DebugLog.getLogsDir()
+			Logger.error(errMsg + "\n" + e.getStackTrace());
+			Notifier.showError(errMsg + "\n\nSee " + Logger.getLogsDir()
 				+ " for more information.");
 		}
-
 		return null;
 	}
 
 	@Override
 	public void finish() {
-		DebugLog.debug(PreferencesActivity.class.getName() + ".finish() called");
-
+		Logger.debug(PreferencesActivity.class.getName() + ".finish() called");
 		super.finish();
 	}
 
 	@Override
 	protected void onDestroy() {
-		DebugLog.debug(PreferencesActivity.class.getName() + ".onDestroy() called");
-
+		Logger.debug(PreferencesActivity.class.getName() + ".onDestroy() called");
 		super.onDestroy();
 	}
 
 
-	public static class PFragment extends PreferenceFragment
+	public static class PFragment extends PreferenceFragmentCompat
 			implements OnSharedPreferenceChangeListener {
 
 		@Override
-		public void onCreate(final Bundle savedInstanceState) {
-			super.onCreate(savedInstanceState);
+		public void onCreatePreferences(final Bundle savedInstanceState, final String rootKey) {
 			addPreferencesFromResource(R.xml.preferences);
-
 			initListeners();
 		}
 
 		private void initListeners() {
 			final PreferenceManager pm = getPreferenceManager();
 
+			// FIXME: should update playing music
 			final Preference reset = pm.findPreference("reset");
 			if (reset != null) {
 				reset.setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
+					@Override
 					public boolean onPreferenceClick(final Preference pref) {
 						Notifier.showPrompt(getActivity(), "Restore prefrences defaults?",
 							new Notifier.Action() {
+								@Override
 								protected void onCall() {
-									DebugLog.debug("restoring preferences default values");
+									Logger.debug("restoring preferences default values");
 									restoreDefaults();
 								}
 							},
 							new Notifier.Action() {
+								@Override
 								protected void onCall() {
 									// do nothing
 								}
@@ -185,19 +193,20 @@ public class PreferencesActivity extends AppCompatActivity {
 					}
 				});
 			} else {
-				DebugLog.warn("preference \"reset\" not found");
+				Logger.warn("preference \"reset\" not found");
 			}
 
 			final CheckBoxPreference title_music = (CheckBoxPreference) pm.findPreference("title_music");
 			if (title_music != null) {
 				title_music.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {
+					@Override
 					public boolean onPreferenceChange(final Preference pref, final Object obj) {
 						// set music state as soon as preference is changed
-						if (ClientView.onTitleScreen()) {
+						if (MainActivity.get().getActiveClientView().onTitleScreen()) {
 							if (!((Boolean) obj)) {
 								MusicPlayer.stopMusic();
 							} else if (!MusicPlayer.isPlaying()) {
-								ClientView.playTitleMusic();
+								MusicPlayer.playTitleMusic();
 							}
 						}
 
@@ -217,13 +226,14 @@ public class PreferencesActivity extends AppCompatActivity {
 				}
 
 				song_list.setOnPreferenceChangeListener(new Preference.OnPreferenceChangeListener() {
+					@Override
 					public boolean onPreferenceChange(final Preference pref, final Object obj) {
 						// set music state as soon as preference is changed
-						if (ClientView.onTitleScreen()) {
-							DebugLog.debug("changing title music preference: " + (String) obj);
+						if (MainActivity.get().getActiveClientView().onTitleScreen()) {
+							Logger.debug("changing title music preference: " + (String) obj);
 
 							if (title_music.isChecked()) {
-								ClientView.playTitleMusic((String) obj);
+								MusicPlayer.playTitleMusic((String) obj);
 							}
 						}
 
@@ -231,6 +241,35 @@ public class PreferencesActivity extends AppCompatActivity {
 					}
 				});
 			}
+
+			final Preference clear_cache = pm.findPreference("clear_cache");
+			if (clear_cache != null) {
+				clear_cache.setOnPreferenceClickListener(new Preference.OnPreferenceClickListener() {
+					@Override
+					public boolean onPreferenceClick(final Preference pref) {
+						Notifier.showPrompt(getActivity(), "Delete cached data?",
+							new Notifier.Action() {
+								@Override
+								protected void onCall() {
+									Logger.debug("clearing cache");
+									for (final ClientView clientView: MainActivity.get().getClientViewList()) {
+										clientView.clearCache(true);
+									}
+								}
+							},
+							new Notifier.Action() {
+								@Override
+								protected void onCall() {
+									// do nothing
+								}
+							});
+
+						return true;
+					}
+				});
+			} else {
+				Logger.warn("preference \"clear_cache\" not found");
+			}
 		}
 
 		private void restoreDefaults() {
@@ -246,25 +285,9 @@ public class PreferencesActivity extends AppCompatActivity {
 
 		@Override
 		public void onSharedPreferenceChanged(final SharedPreferences sp, final String key) {
-			if (key.equals("show_dpad") || key.equals("dpad_joy")) {
-				// reset all d-pads states to hidden
-				DPadArrows.get().hide();
-				DPadJoy.get().hide();
-
-				if (getBoolean("dpad_joy", true)) {
-					DPad.setCurrentPad(DPadJoy.get());
-				} else {
-					DPad.setCurrentPad(DPadArrows.get());
-				}
-
-				// restore visible state
-				final DPad currentPad = DPad.getCurrentPad();
-				if (currentPad != null && ClientView.isGameActive() && getBoolean("show_dpad", false)) {
-					currentPad.show();
-					currentPad.onRefreshView();
-				}
-			} else if (key.equals("joypad_sensitivity")) {
-				DPadJoy.get().setSensitivity(getInt("joypad_sensitivity", 25));
+			if ("orientation".equals(key)) {
+				Logger.debug("orientation set to \"" + PreferencesActivity.getString(key) + "\"");
+				MainActivity.get().updateOrientation();
 			}
 		}
 

app/android/client/src/main/java/org/stendhalgame/client/SplashUtil.java

@@ -0,0 +1,90 @@
+/***************************************************************************
+ *                    Copyright © 2024 - Faiumoni e. V.                    *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+package org.stendhalgame.client;
+
+import android.content.res.Configuration;
+import android.widget.ImageView;
+
+
+public class SplashUtil {
+
+	/** Image used as title page background. */
+	private final ImageView splash;
+
+	/** Singleton instance. */
+	private static SplashUtil instance;
+
+
+	/**
+	 * Retrieves singleton instance.
+	 */
+	public static SplashUtil get() {
+		if (SplashUtil.instance == null) {
+			SplashUtil.instance = new SplashUtil();
+		}
+		return SplashUtil.instance;
+	}
+
+	/**
+	 * Hidden singleton constructor.
+	 */
+	private SplashUtil() {
+		splash = (ImageView) MainActivity.get().findViewById(R.id.splash);
+		setVisible(false);
+	}
+
+	/**
+	 * Sets the background splash image.
+	 *
+	 * @param resId
+	 *   Resource ID.
+	 * @param bgColor
+	 *   Coloring to fill behind splash image.
+	 */
+	private void setImage(final int resId, final int bgColor) {
+		splash.setBackgroundColor(bgColor);
+		splash.setImageResource(resId);
+	}
+
+	/**
+	 * Sets splash image dependent on device orientation.
+	 */
+	public void update() {
+		if (!isVisible()) {
+			return;
+		}
+		int resId = R.drawable.splash;
+		if (MainActivity.get().getOrientation() == Configuration.ORIENTATION_PORTRAIT) {
+			resId = R.drawable.splash_portrait;
+		}
+		// light blue background color
+		setImage(resId, 0xff6c9ed1);
+	}
+
+	/**
+	 * Shows or hides background splash image.
+	 *
+	 * @param visible
+	 *   `true` if image should visible, `false` if not.
+	 */
+	public void setVisible(final boolean visible) {
+		splash.setVisibility(visible ? ImageView.VISIBLE : ImageView.GONE);
+		update();
+	}
+
+	/**
+	 * Checks if splash is visible.
+	 */
+	public boolean isVisible() {
+		return ImageView.VISIBLE == splash.getVisibility();
+	}
+}

app/android/client/src/main/java/org/stendhalgame/client/UrlHelper.java

@@ -0,0 +1,280 @@
+/***************************************************************************
+ *                    Copyright © 2024 - Faiumoni e. V.                    *
+ ***************************************************************************
+ ***************************************************************************
+ *                                                                         *
+ *   This program is free software; you can redistribute it and/or modify  *
+ *   it under the terms of the GNU General Public License as published by  *
+ *   the Free Software Foundation; either version 2 of the License, or     *
+ *   (at your option) any later version.                                   *
+ *                                                                         *
+ ***************************************************************************/
+package org.stendhalgame.client;
+
+import android.net.Uri;
+
+
+class UrlHelper {
+
+	private static final String defaultServer = "https://stendhalgame.org/";
+
+
+	private UrlHelper() {
+		// static methods only
+	}
+
+	/**
+	 * Creates a URI from a string HTTP URL.
+	 *
+	 * @return
+	 *   `android.net.Uri`.
+	 */
+	public static Uri toUri(String url) {
+		if (!url.startsWith("https://") && !url.startsWith("http://") && !url.startsWith("about:")) {
+			// Uri.getHost returns `null` if localhost not prefixed with protocol
+			url = "http://" + url;
+		}
+		return Uri.parse(url);
+	}
+
+	/**
+	 * Retrieves the HTTP URL of the default server (stendhalgame.org).
+	 *
+	 * @return
+	 *   String URL.
+	 */
+	public static String getDefaultServer() {
+		return UrlHelper.defaultServer;
+	}
+
+	/**
+	 * Retrieves the URI of the default server (stendhalgame.org).
+	 *
+	 * @return
+	 *   `android.net.Uri` of default server.
+	 */
+	public static Uri getDefaultServerUri() {
+		return UrlHelper.toUri(UrlHelper.defaultServer);
+	}
+
+	/**
+	 * Retrieves the default host.
+	 *
+	 * @return
+	 *   Host portion of the default URI.
+	 */
+	public static String getDefaultHost() {
+		return UrlHelper.getDefaultServerUri().getHost();
+	}
+
+	/**
+	 * Removes protocol & "www" prefixes from a URL.
+	 *
+	 * FIXME: rename to "trimProtocol"
+	 *
+	 * @return
+	 *   Trimmed URL string.
+	 */
+	public static String stripHost(final String url) {
+		if (url == null) {
+			return "";
+		}
+		return url.replaceAll("^https://", "").replaceAll("^http://", "")
+			.replaceAll("^www\\.", "");
+	}
+
+	/**
+	 * Extracts character name from URL fragment identifier & converts to query string.
+	 *
+	 * Deprecated. Should use `UrlHelper.formatCharName(Uri, Uri.Builder).
+	 *
+	 * @param url
+	 *   HTTP string to be formatted.
+	 * @return
+	 *   Formatted URL.
+	 */
+	@Deprecated
+	public static String formatCharName(String url) {
+		final int idx = url.indexOf("#");
+		if (idx > -1) {
+			url = url.substring(0, idx) + "?char=" + url.substring(idx+1);
+		}
+		return url;
+	}
+
+	/**
+	 * Converts URL fragment identifier to character name query string parameter.
+	 *
+	 * @param uri
+	 *   URI being checked for fragment identifier.
+	 * @param builder
+	 *   URI builder to update.
+	 */
+	public static void formatCharName(final Uri uri, final Uri.Builder builder) {
+		final String name = uri.getFragment();
+		if (name != null) {
+			builder.appendQueryParameter("char", name);
+		}
+	}
+
+	/**
+	 * Formats client URL for currently selected server.
+	 *
+	 * @param url
+	 *   URL to be checked.
+	 * @return
+	 *   URL to be loaded.
+	 */
+	public static String checkClientUrl(String url) {
+		final Uri uri = UrlHelper.toUri(url);
+		final Uri.Builder builder = uri.buildUpon();
+		if (UrlHelper.isClientUrl(url)) {
+			final ClientView client = MainActivity.get().getActiveClientView();
+			final boolean testClient = client.isTestClient();
+			String replaceSuffix = "/testclient/";
+			if (testClient) {
+				replaceSuffix = "/client/";
+			}
+			// ensure website directs to configured client
+			builder.path(uri.getPath().replace(replaceSuffix, "/" + client.getClientUrlSuffix() + "/"));
+			UrlHelper.formatCharName(uri, builder);
+			if (testClient && !client.isTestServer() && uri.getQueryParameter("server") == null) {
+				// connect test client to main server
+				builder.appendQueryParameter("server", "main");
+			}
+		}
+		return builder.toString();
+	}
+
+	/**
+	 * Checks if a URL is a link to one of the web clients.
+	 *
+	 * @param url
+	 *   HTTP URL to be checked.
+	 * @return
+	 *   `true` if `url` links to "client" or "testclient".
+	 */
+	public static boolean isClientUrl(final String url) {
+		final String custom_client = PreferencesActivity.getString("client_url").trim();
+		if (!custom_client.equals("")) {
+			return url.contains(custom_client);
+		}
+		final String defaultHost = UrlHelper.stripHost(UrlHelper.getDefaultServerUri().getHost());
+		return url.contains(defaultHost + "/client/") || url.contains(defaultHost + "/testclient/");
+	}
+
+	/**
+	 * Retrieves client URL.
+	 *
+	 * @return
+	 *   Client URL string.
+	 */
+	public static String getClientUrl() {
+		final String custom_client = PreferencesActivity.getString("client_url").trim();
+		if (!custom_client.equals("")) {
+			return custom_client;
+		}
+		return UrlHelper.defaultServer + "client/stendhal.html";
+	}
+
+	/**
+	 * Retrieves URL string for initial page to be loaded from server.
+	 *
+	 * If custom client URL is used then client URL is returned.
+	 *
+	 * @return
+	 *   HTTP URL string.
+	 */
+	public static String getInitialPageUrl() {
+		final String custom_client = PreferencesActivity.getString("client_url").trim();
+		if (!custom_client.equals("")) {
+			return custom_client;
+		}
+		return UrlHelper.defaultServer + "account/mycharacters.html";
+	}
+
+	/**
+	 * Checks if requested URL is whitelisted to be opened within WebView client.
+	 *
+	 * @param uri
+	 *   `android.net.Uri` to be checked.
+	 * @return
+	 *   `true` if URI is under default domain (stendhalgame.org) or localhost.
+	 */
+	public static boolean isInternalUri(final Uri uri) {
+		if (UrlHelper.isLoginUri(uri)) {
+			// open login page in external browser
+			return false;
+		}
+		final String defaultHost = UrlHelper.stripHost(UrlHelper.getDefaultHost());
+		final String host = UrlHelper.stripHost(uri.getHost());
+		if (defaultHost.equals(host)) {
+			// allow pages from stendhalgame.org
+			return true;
+		}
+		final String cs = MainActivity.get().getActiveClientView().checkCustomServer();
+		if (cs != null) {
+			return UrlHelper.stripHost(cs).equals(host);
+		}
+		return "localhost".equals(host);
+	}
+
+	/**
+	 * Checks if requested URL is whitelisted to be opened within WebView client.
+	 *
+	 * @param url
+	 *   HTTP URL string to be checked.
+	 * @return
+	 *   `true` if URL is under default domain (stendhalgame.org) or localhost.
+	 */
+	public static boolean isInternal(final String url) {
+		return UrlHelper.isInternalUri(UrlHelper.toUri(url));
+	}
+
+	/**
+	 * Checks if a URI matches the intent URL scheme.
+	 *
+	 * @param uri
+	 *   URI to be check.
+	 * @return
+	 *   `true` if URI's host is the intent scheme.
+	 */
+	public static boolean isIntentUri(final Uri uri) {
+		return AppInfo.getIntentUrlScheme().equals(UrlHelper.stripHost(uri.getHost()));
+	}
+
+	/**
+	 * Checks if a URL matches the intent URL scheme.
+	 *
+	 * @param url
+	 *   HTTP URL string to be check.
+	 * @return
+	 *   `true` if URI's host is the intent scheme.
+	 */
+	public static boolean isIntentUrl(final String url) {
+		return UrlHelper.isIntentUri(UrlHelper.toUri(url));
+	}
+
+	/**
+	 * Checks if a URI represents a login page.
+	 *
+	 * @param uri
+	 *   Page URI to check.
+	 * @return
+	 *   `true` if URI path equals "/account/login.html" or `id` parameter of query string equals
+	 *   "content/account/login".
+	 */
+	public static boolean isLoginUri(final Uri uri) {
+		if ("/account/login.html".equals(uri.getPath())) {
+			return true;
+		}
+		if (!uri.isHierarchical()) {
+			return false;
+		}
+		final String id = uri.getQueryParameter("id");
+		if (id == null) {
+			return false;
+		}
+		return "content/account/login".equals(id);
+	}
+}

app/android/client/src/main/play/contact-email.txt

@@ -0,0 +1 @@
+https://sourceforge.net/projects/arianne/support

app/android/client/src/main/play/contact-website.txt

@@ -0,0 +1 @@
+https://stendhalgame.org/

app/android/client/src/main/play/default-language.txt

@@ -0,0 +1 @@
+en-US

app/android/client/src/main/play/listings/de/full-description.txt

@@ -0,0 +1,9 @@
+Stendhal has a huge and rich world. You can explore cities, forest, mountains, plains and dungeons.
+You can fight monsters and become a hero.
+
+You will meet a wide variety of characters. Many will give you tasks and quests for valuable
+experience. You may be asked to help protect land, feed the hungry, heal the sick, make someone
+happy, solve a puzzle or simply lend a hand.
+
+So what are you waiting for? A whole new world awaits... And if you like, get the source code, and
+add your own ideas!

app/android/client/src/main/play/listings/de/short-description.txt

@@ -0,0 +1 @@
+Ein Multiplayer-Adventure mit klassischer 2D-Grafik

app/android/client/src/main/play/listings/en-US/full-description.txt

@@ -0,0 +1,9 @@
+Stendhal has a huge and rich world. You can explore cities, forest, mountains, plains and dungeons.
+You can fight monsters and become a hero.
+
+You will meet a wide variety of characters. Many will give you tasks and quests for valuable
+experience. You may be asked to help protect land, feed the hungry, heal the sick, make someone
+happy, solve a puzzle or simply lend a hand.
+
+So what are you waiting for? A whole new world awaits... And if you like, get the source code, and
+add your own ideas!

app/android/client/src/main/play/listings/en-US/short-description.txt

@@ -0,0 +1 @@
+A multiplayer adventure with classic 2D graphics

app/android/client/src/main/play/listings/en-US/title.txt

@@ -0,0 +1 @@
+Stendhal Game

app/android/client/src/main/play/listings/es/full-description.txt

@@ -0,0 +1,9 @@
+Stendhal tiene un mundo enorme y rico. Puedes explorar ciudades, bosques, montañas, llanos y
+mazmorras. Puedes combatir monstruos y llegar a ser un héroe.
+
+Te encontrarás con una amplia variedad de personajes. Muchos te darán tareas y misiones para obtener
+experiencia valiosa. Es posible que se te pida proteger terrenos, alimentar a los hambrientos, curar
+a los enfermos, hacer feliz a alguien, resolver un rompecabezas, o simplemente echar una mano.
+
+Entonces, ¿a qué estás esperando? Un mundo completamente nuevo te espera... ¡Y si deseas, consigue
+el código fuente y añade tus propias ideas!

app/android/client/src/main/play/listings/es/short-description.txt

@@ -0,0 +1 @@
+Una aventura multijugador con gráficos 2D clásicos

app/android/client/src/main/play/listings/fr/full-description.temp.txt

@@ -0,0 +1,10 @@
+Stendhal a un monde immense et riche. Vous pouvez explorer des villes, des forêts, des montagnes,
+des plaines et des donjons. Vous pouvez combattre des monstres et devenir un héros.
+
+Vous rencontrerez une grande variété de personnages. Beaucoup vous donneront des tâches et des
+quêtes pour l'expérience précieuse. On vous demandera peut-être d'aider à protéger des terres,
+nourrir les affamés, soigner les malades, rendre quelqu'un heureux, résoudre une énigme ou
+simplement donner un coup de main.
+
+Alors, qu'attendez-tu? Un tout nouveau monde vous attend... Et si vous le souhaitez, récupérez le
+code source et ajoutez vos propres idées!

app/android/client/src/main/play/listings/fr/short-description.txt

@@ -0,0 +1 @@
+Une aventure multijoueur avec des graphismes 2D classiques

app/android/client/src/main/play/listings/it/full-description.temp.txt

@@ -0,0 +1,9 @@
+Stendhal ha un mondo enorme e ricco. Puoi esplorare città, foreste, montagne, pianure e dungeon.
+Puoi combattere mostri e diventare un eroe.
+
+Incontrerai una vasta varietà di personaggi. Molti ti daranno compiti e missioni per preziosa
+esperienza. Potresti essere chiesto di aiutare a proteggere terra, nutrire gli affamati, curare i
+malati, rendere felice qualcuno, risolvere un puzzle o semplicemente dare una mano.
+
+Allora, cosa stai aspettando? Un mondo completamente nuovo aspetta... E se vuoi, ottieni il codice
+sorgente e aggiungi le tue idee!

app/android/client/src/main/play/listings/it/short-description.txt

@@ -0,0 +1 @@
+Un'avventura multiplayer con la classica grafica 2D

app/android/client/src/main/play/listings/pl/full-description.txt

@@ -0,0 +1,9 @@
+Stendhal to niezwykły, pełen możliwości świat. Odkryjesz w nim miasta, lasy, góry, równiny i lochy.
+Stawić możesz czoło potworom oraz stać się bohaterem.
+
+W drodze napotkasz rozmaite postacie. Wielu z nich zleci ci misje, które zapewnią cenne
+doświadczenie. Zdarzy się, że będziesz musiał ochraniać ziemie, nakarmić głodnych, pomóc wyleczyć chorych,
+uprzyjemnić czyjeś życie, rozwiązać zagadki lub po prostu wesprzeć pomocną dłonią.
+
+A więc na co jeszcze czekasz? Cały nowy świat wyczekuje ciebie... Jeśli chcesz, pobierz kod
+źródłowy oraz dodaj własne pomysły!

app/android/client/src/main/play/listings/pl/short-description.txt

@@ -0,0 +1 @@
+Wieloosobowa gra przygodowa z klasyczną grafiką 2D

app/android/client/src/main/play/listings/pt/full-description.temp.txt

@@ -0,0 +1,9 @@
+Stendhal tem um mundo enorme e rico. Podes explorar cidades, florestas, montanhas, planícies e
+masmorras. Podes lutar contra monstros e tornar-te um herói.
+
+Vais encontrar uma grande variedade de personagens. Muitos vão dar-te tarefas e missões para
+experiência valiosa. Podes ser solicitado(a) a proteger a terra, alimentar os famintos, curar os
+doentes, fazer alguém feliz, resolver um quebra-cabeça, ou simplesmente dar uma mão.
+
+Então, do que estás à espera? Um mundo completamente novo aguarda... E se quiseres, obtém o
+código-fonte e adiciona as tuas próprias ideias!

app/android/client/src/main/play/listings/pt/short-description.txt

@@ -0,0 +1 @@
+Uma aventura multijogador com gráficos 2D clássicos

app/android/client/src/main/play/listings/ro/full-description.txt

@@ -0,0 +1,9 @@
+Stendhal are o lume imensă și bogată. Poți explora orașe, păduri, munți, câmpii și temnițe. Poți să
+lupți cu monștri și să devii erou.
+
+Vei întâlni o gamă largă de personaje. Multe îți vor da sarcini și misiuni în schimbul valoroasei
+experiențe. Ți s-ar putea cere să protejezi pământuri, să-i hrănești pe cei flămânzi, să-i vindeci
+pe cei bolnavi, să faci pe cineva fericit, să dezlegi un puzzle sau doar să dai o mână de ajutor.
+
+Ce mai aștepți? O întreagă nouă lume te așteaptă... Și dacă vrei, ia codul sursă și adaugă-ți
+propriile idei!

app/android/client/src/main/play/listings/ro/short-description.txt

@@ -0,0 +1 @@
+O aventură multijucător cu grafică 2D clasică

app/android/client/src/main/play/release-notes/en-US/default.txt

@@ -0,0 +1,3 @@
+PUT RELEASE ANNOUNCEMENT LINES HERE
+
+Please see the complete change log for further details: https://arianne-project.org/game/stendhal.html#changes

app/android/client/src/main/res/layout/activity_main.xml

@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<androidx.constraintlayout.widget.ConstraintLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	xmlns:tools="http://schemas.android.com/tools"
+	android:id="@+id/content"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	tools:context="org.stendhalgame.client.MainActivity">
+
+	<ImageView
+		android:id="@+id/splash"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		android:scaleType="fitCenter"
+		app:layout_constraintTop_toTopOf="parent"
+		app:layout_constraintStart_toStartOf="parent"
+	/>
+
+	<androidx.constraintlayout.widget.ConstraintLayout
+		android:id="@+id/clientList"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+		app:layout_constraintBottom_toBottomOf="parent"
+		app:layout_constraintLeft_toLeftOf="parent"
+		app:layout_constraintRight_toRightOf="parent"
+		app:layout_constraintTop_toTopOf="parent">
+	</androidx.constraintlayout.widget.ConstraintLayout>
+
+	<Toolbar
+		android:id="@+id/menu_main"
+		android:layout_width="match_parent"
+		android:layout_height="wrap_content"
+		android:background="#80ffffff"
+		android:logo="@mipmap/ic_launcher_round"
+		android:title="Menu"
+		app:layout_constraintLeft_toLeftOf="parent"
+		app:layout_constraintBottom_toBottomOf="parent">
+
+		<LinearLayout
+			android:layout_width="match_parent"
+			android:layout_height="wrap_content"
+			android:gravity="right">
+
+			<Button
+				android:id="@+id/btn_connect"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Connect"
+				android:background="#00000000"
+			/>
+
+			<Button
+				android:id="@+id/btn_title"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Title"
+				android:background="#00000000"
+			/>
+
+			<Button
+				android:id="@+id/btn_reload"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Reload"
+				android:background="#00000000"
+			/>
+
+			<Button
+				android:id="@+id/btn_settings"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Settings"
+				android:background="#00000000"
+			/>
+
+			<!--
+			<Button
+				android:id="@+id/btn_about"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="About"
+				android:background="#00000000"
+			/>
+			-->
+
+			<Button
+				android:id="@+id/btn_quit"
+				android:layout_width="wrap_content"
+				android:layout_height="wrap_content"
+				android:text="Quit"
+				android:background="#00000000"
+			/>
+
+		</LinearLayout>
+
+	</Toolbar>
+
+</androidx.constraintlayout.widget.ConstraintLayout>

app/android/client/src/main/res/layout/activity_preferences.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<androidx.constraintlayout.widget.ConstraintLayout
+	xmlns:android="http://schemas.android.com/apk/res/android"
+	xmlns:app="http://schemas.android.com/apk/res-auto"
+	xmlns:tools="http://schemas.android.com/tools"
+	android:id="@+id/preferences"
+	android:layout_width="match_parent"
+	android:layout_height="match_parent"
+	tools:context="org.stendhalgame.client.PreferencesActivity">
+
+	<FrameLayout
+		android:id="@+id/preferencesFrame"
+		android:layout_width="match_parent"
+		android:layout_height="match_parent"
+	/>
+
+</androidx.constraintlayout.widget.ConstraintLayout>