diff --git a/docs/guide/installation.md b/docs/guide/installation.md index ae3ff235..47218f83 100644 --- a/docs/guide/installation.md +++ b/docs/guide/installation.md @@ -312,7 +312,7 @@ docker-compose down ## Run on Android -It is possible to run Minecraft Console Client on Android through Termux and Ubuntu 24.04, but it requires a manual setup with a lot of commands, so be careful not to skip any steps. Depending on your technical background, internet speed, and device speed, this can take anywhere from 10 to 20 minutes or more. +It is possible to run Minecraft Console Client on Android through Termux and Ubuntu, but it requires a manual setup with a lot of commands, so be careful not to skip any steps. Depending on your technical background, internet speed, and device speed, this can take anywhere from 10 to 20 minutes or more.

Tip

@@ -341,195 +341,113 @@ It is possible to run Minecraft Console Client on Android through Termux and Ubu

Warning

-**The Play Store version of Termux is outdated and not supported. Use the [GitHub release](https://github.com/termux/termux-app/releases/latest/) instead.** +**The Play Store version of Termux is outdated and not supported. Install Termux from [F-Droid](https://f-droid.org/packages/com.termux/) (recommended) or from the [GitHub releases page](https://github.com/termux/termux-app/releases/latest/).**
-Go to [the latest Termux GitHub release](https://github.com/termux/termux-app/releases/latest/), download the `debug_universal.apk`, unzip it, and run it. +**F-Droid (recommended):** Install the [F-Droid](https://f-droid.org/) app store, search for "Termux", and install it. + +**GitHub releases:** Go to [the latest Termux GitHub release](https://github.com/termux/termux-app/releases/latest/), download the APK file whose name contains `universal` (e.g. `termux-app_v...-debug_universal.apk`), and install it.

Tip

-**If your file manager does not let you run APK files, install and use `File Manager +` and give it a permission to install 3rd party applications when asked.** +**If your file manager does not let you install APK files, install and use `File Manager +` and grant it permission to install third-party applications when asked.**

Danger

-**Once you have installed Termux, open it, bring down the Android menu for notifications, on Termux notification, drag down until you see the following options: `Exit | Acquire wakelock`, press on the `Acquire wakelock` and allow Termux to have a battery optimization exclusion permission when asked. If you do not do this, your performance will be poorer and the Termux might get killed by Android while running in the background!** +**Once you have installed Termux, open it, pull down the Android notification drawer, find the Termux notification, and expand it (swipe down on the notification) until you see `Exit | Acquire wakelock`. Tap `Acquire wakelock` and allow Termux to bypass battery optimization when prompted. Skipping this step may cause Termux to be killed by Android when running in the background.**
-#### Installing Ubuntu 24.04 +#### Installing Ubuntu -At this stage, you have 2 options: +We use `proot-distro`, an official Termux utility, to install Ubuntu. It will install the latest Ubuntu LTS release available for your device architecture. -1. Following this textual tutorial -2. Watching a [YouTube tutorial for installing Ubuntu](https://www.youtube.com/watch?v=5yit2t7smpM) - -

Tip

- -**If you decide to watch the YouTube tutorial, watch only up to `1:58`. The steps after that are not needed here and might just confuse you.** - -
- -In order to install Ubuntu 24.04 in Termux you require `wget` and `proot`, and we are going to install them in the next step. - -Once you have Termux installed open it up and run the following command one after other (in order): +Open Termux and run the following commands one at a time, in order: 1. `pkg update` 2. `pkg upgrade` -3. `pkg install proot wget` +3. `pkg install proot-distro`

Tip

-**If you're asked to press Y/N during the update/upgrade command process, just enter Y and press Enter** +**If you are asked to press Y/N during the update or upgrade step, enter Y and press Enter.**
-Then you need to download an installation script using the following command: +Now install Ubuntu: ```bash -wget https://raw.githubusercontent.com/MFDGaming/ubuntu-in-termux/master/ubuntu.sh +proot-distro install ubuntu ``` -Once the script has downloaded, run it with: +Once the installation finishes, start Ubuntu with: ```bash -bash ubuntu.sh -``` - -Then you will be asked a question, enter `Y` and press `Enter`. - -Once the installation is complete, you can start Ubuntu with: - -```bash -./startubuntu.sh +proot-distro login ubuntu ```

Tip

-**Now every time you open Termux after it has been closed, in order to access Ubuntu you have to use this command** +**Every time you open Termux after it has been closed, run this command to get back into Ubuntu.**
-#### Installing .NET on ARM +#### Installing .NET -If the package-manager route does not provide a current enough SDK for your setup, install .NET manually instead. - -First we need to update the APT package manager repositories and install dependencies. - -To update the APT repositories, run the following command: +First, update the Ubuntu package lists and install a few tools: ```bash apt update -y && apt upgrade -y ``` -After you did it, we need to install dependencies for .NET, with the following command: - ```bash -apt install wget nano unzip libc6 libgcc1 libgssapi-krb5-2 libstdc++6 zlib1g libicu70 libssl3 -y +apt install wget curl nano unzip -y ``` -After you have installed the dependencies, install .NET either by following this guide or by using Microsoft's [manual install instructions](https://learn.microsoft.com/en-us/dotnet/core/install/linux-scripted-manual#manual-install). - -Navigate to your `/root` home directory with the following command: +Then install .NET 8.0 using Microsoft's official install script: ```bash -cd /root +wget https://dot.net/v1/dotnet-install.sh -O dotnet-install.sh +chmod +x dotnet-install.sh +./dotnet-install.sh --channel 8.0 ``` -Download a current .NET SDK tarball for your platform from Microsoft. Replace the placeholder below with the actual current download URL from the [.NET download page](https://dotnet.microsoft.com/en-us/download): +Now add .NET to your PATH so it works in future sessions. Open `.bashrc`: ```bash -wget +nano ~/.bashrc ``` -

Tip

- -**This example assumes a 64-bit ARM processor. If you are using a different architecture, download the matching SDK archive for that platform instead.** - -
- -

Tip

- -**This tutorial assumes Ubuntu 24.04. If you are using a different distro, get the current SDK archive for your platform from the [.NET download page](https://dotnet.microsoft.com/en-us/download).** - -
- -Once the file has been downloaded, you need to run the following commands in order: - -1. `DOTNET_FILE=` - -

Warning

- - **Replace the placeholder with the exact filename you downloaded. If you are using a different archive, update this value to match it exactly.** - -
- -2. `export DOTNET_ROOT=/root/.dotnet` - -

Warning

- - **Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!** - -
- -3. `mkdir -p "$DOTNET_ROOT" && tar zxf "$DOTNET_FILE" -C "$DOTNET_ROOT"` -4. `export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools` - -Now we need to tell our shell to know where the `dotnet` command is, for future sessions, since the commands above just tell this current session where the `dotnet` is located. - -

Warning

- -**You will need a basic knowledge of the Nano text editor. If you do not know how to use it, watch this [YouTube tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).** - -
- -To enable this, we need to edit our `/root/.bashrc` file with the following command: +Scroll to the bottom of the file using the `Page Down` key, add a blank line, and paste the following: ```bash -nano /root/.bashrc -``` - -Scroll down to the bottom of the file using `Page Down` (`PGDN`) button, make a new line and paste the following text: - -```bash -export DOTNET_ROOT=/root/.dotnet/ -export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools +export DOTNET_ROOT=$HOME/.dotnet +export PATH=$PATH:$HOME/.dotnet:$HOME/.dotnet/tools ```

Warning

-**Here we're installing .NET in `/root`, if you're installing it somewhere else, make sure to set your own path!** +**If you do not know how to use Nano, watch this [YouTube tutorial](https://www.youtube.com/watch?v=DLeATFgGM-A).**
-Save the file usign the following combination of keys: `CTRL + X`, type `Y` and press Enter. - -Veryfy that .NET was installed correctly by running: +Save the file with `CTRL + X`, type `Y`, and press Enter. Then apply the changes: ```bash -dotnet +source ~/.bashrc ``` -You should get a help page: +Verify the installation by running: ```bash -root@localhost:~# dotnet - -Usage: dotnet [options] -Usage: dotnet [path-to-application] - -Options: - -h|--help Display help. - --info Display .NET information. - --list-sdks Display the installed SDKs. - --list-runtimes Display the installed runtimes. - -path-to-application: - The path to an application .dll file to execute. +dotnet --version ``` +You should see a version number like `8.0.xxx`. + #### Installing MCC Finally, we can install MCC. @@ -578,9 +496,13 @@ And finally run it with: #### After installation -When you run Termux next time, you need to start Ubuntu with: `./startubuntu.sh` +When you open Termux next time, start Ubuntu with: -Then you can start the MCC again with `./MinecraftClient` +```bash +proot-distro login ubuntu +``` + +Then run MCC with `./MinecraftClient` To stop MCC from running you can press `CTRL + C`