Verity Mod Android Setup: Termux and Bedrock Guide

Which Verity download is this Android guide for?

Use this Verity Mod Android setup for Verity - Bedrock Edition by PnTMC, Project ID 1575941. The box above shows its current file. Start at PnTMC’s project page and match the file’s game version to the Minecraft version installed on your phone.

The same name appears on other projects. Utlover65’s Verity BE is Project ID 1574632; its connection tutorial is not interchangeable with this one. Verity JE is a Java mod. Running Java through Mojo, Zalith, or another Android launcher is a different installation, not a reason to put Java files inside this Bedrock setup. Use the edition comparison if you are unsure which game you have.

There are two things to install: the add-on that Minecraft imports and the Android helper that Termux runs. The helper handles the connection to external AI and voice services. Seeing Verity in a world only confirms part of the setup. It does not show that the helper is running, that a provider accepted your credentials, or that Android permitted microphone access.

Before installing: keep a recovery path

Create a disposable world for the first connection. Keep a backup of any existing world you plan to use later. Do not change an important world’s experiments just to discover whether the new files work on your phone.

Have Minecraft, a file manager capable of showing hidden files, and access to your own provider accounts ready. A file called .env begins with a dot, so some file managers hide it. Enable their hidden-file option before concluding that the download is incomplete. Choose a text editor that preserves the filename and plain-text content; a note saved as .env.txt is a different file.

Open PnTMC’s platform setup instructions beside this page. Use the Android section and the maintainer’s setup releases for the helper. Windows batch files and the iOS a-Shell instructions do not belong in Termux. If a later release changes the dependency command or filenames, follow the matching release instead of combining two tutorials.

1. Install both Termux apps from F-Droid

Install Termux and Termux:API through F-Droid, as PnTMC instructs. They are separate Android apps. The termux-api terminal package used later is not a replacement for the Termux:API Android app.

Keep their installation source consistent. Termux’s installation documentation explains that its app and plugins must have compatible signatures. Mixing F-Droid and GitHub builds can produce installation or compatibility errors. If you already use Termux for other work, back up that environment before changing its installation source; uninstalling the app can remove its local files.

Open Termux once and let its initial environment finish loading. You should reach a terminal prompt. An Android app-installation failure happens before Verity runs, so changing your Groq key or Minecraft packs cannot fix it.

2. Allow the helper to stay available

In Android, press and hold Termux:API, open App info, and find its battery setting. PnTMC instructs you to select Unrestricted or No restrictions and allow its microphone permission. Manufacturers use different labels, so look under the app’s permissions and battery sections rather than searching Minecraft’s settings for these controls.

Permission to capture audio and permission to keep running are different. A denied microphone can explain silent voice input, while a stopped helper can break the entire connection. Test typed chat first so that a microphone problem does not obscure a working text conversation.

Do not disable security protections across the phone or install an unrelated “performance fix.” If the terminal closes as soon as you switch to Minecraft, check which app Android actually stopped and whether its battery policy changed. Termux also documents process termination on Android 12 and newer; an unrestricted setting is useful but not a guarantee that a memory-constrained phone will keep every process alive.

3. Extract the helper and configure its local .env

Extract the Android setup archive directly into the phone’s Download folder. The folder you need is named verity-android-setup. Open it and check that start_android.sh and .env are inside that folder, not one additional nested folder with the same name.

Use the field names already supplied in .env. PnTMC’s instructions link to your Groq key, FishAudio key, and selected FishAudio voice model ID. Those are different values: a voice model ID identifies a voice, while a key authorizes requests. Do not substitute the full voice-page address for an ID unless the helper’s current instructions explicitly require it.

Keep this file local. Do not paste its contents into a comment, chat, screenshot, issue, or this website. When asking for help, describe which field you configured without revealing its value. If you accidentally publish a credential, revoke it through the provider and replace the local value; deleting the public message alone does not invalidate the exposed credential.

In PnTMC’s v4.0.3 Android release, only three lines need your values: GROQ_API_KEY, FISH_API_KEY, and FISH_REFERENCE_ID (the voice model ID). The rest are working defaults: VERITY_MIC_BACKEND=termux uses Termux:API for the microphone, and VERITY_MIC_FOREGROUND=0 keeps you in Minecraft while recording instead of switching apps. Leave them unless the helper reports a problem.

Before saving, check for accidental spaces, smart quotes, or an extra filename extension introduced by the editor. Do not invent new environment-variable names from a Java tutorial. The helper can only use the settings its own version recognizes.

4. Run the Android installation in Termux

First grant Termux access to shared storage:

termux-setup-storage

Respond to Android’s storage-permission prompt. Then use the installation command in the Android section of PnTMC’s setup guide. Its documented sequence installs the terminal packages, copies the extracted helper into Termux’s home directory, prepares the shell script, installs Python dependencies, and starts the helper. The checked instruction pins websockets to 10.4; do not replace it with an arbitrary newer release while troubleshooting.

Read the command before running it and watch for the first failure. A download interrupted during package installation is not a Minecraft connection error. Likewise, a failed folder copy means the startup script might not exist where the next command expects it. Preserve the error message rather than repeatedly pasting the entire installer.

The two folder locations matter:

Location	What it contains	When to check it
Download/verity-android-setup	Your extracted download and initial .env	Before the first installation or copying edited settings
~/verity-android-setup inside Termux	The copy used to run the helper	When restarting or checking whether new settings took effect

The maintainer’s copy command checks the shared-storage paths /storage/emulated/0/Download and /sdcard/Download. These are not Windows paths. If neither resolves on your device, verify storage permission and the extracted folder location before changing anything in Minecraft.

Keep the helper session open when installation finishes. A terminal that immediately returns with an error is not ready for the game’s connection command. Resolve the startup error first; the game cannot connect to a program that has already exited.

5. Configure Minecraft and connect locally

Import the add-on through Minecraft and activate its behavior and resource packs in your test world. Confirm that they appear under Active, not only in the available pack list. Enable Beta APIs and Cheats as required by the setup guide. Cheats can affect achievements, which is another reason to start in a separate world.

In Minecraft, open Settings > General > Configure WebSockets. PnTMC instructs players to enable WebSockets and disable Require Encrypted Websockets. Its example screenshot was taken in version 26.44, so the control’s position may differ on your build. Apply this instruction only for the documented same-device connection; do not use it as permission to connect to an unknown unencrypted remote endpoint.

With the helper still running in Termux, enter the test world and send this in Minecraft chat:

/connect 127.0.0.1:3000

127.0.0.1 means this Android device. It does not refer to a friend’s phone, your laptop, or a public server. A helper running on another device will not be reached by this command. Do not open a router port or publish a server address to make this local setup work.

The local address also does not mean the whole conversation works offline. Minecraft talks to the helper locally, but the documented provider setup still uses online AI and speech services. A successful local connection and a successful provider request are separate checks.

6. Test text before the microphone and spoken replies

Once connected, try one short typed message. PnTMC describes talking near Verity when it is on the ground and using Hey Verity when it is in your inventory. Keep close during the first test. If nothing happens, confirm that you are using PnTMC’s packs before copying Utlover65’s interaction rules.

A text answer gives you a useful starting point: the world, local connection, and at least the text-response request have worked together. Leave those settings alone while checking voice. Microphone input turns your speech into text; spoken output turns Verity’s answer into audio. Either can fail while the other still works.

For missing input, check Termux:API’s microphone permission and whether Android’s microphone control is disabled. For missing output, check media volume and audio routing before replacing credentials. A Bluetooth headset can send playback somewhere other than the phone speaker. If the helper reports a FishAudio error, inspect that provider’s key, voice selection, and account status rather than changing the Minecraft packs.

Use the chat and voice guide to compare symptoms. Do not run repeated voice requests while a provider is rejecting them; record the error once and address that specific failure.

Stop and restart without reinstalling

To stop, return to Termux and press Ctrl+C, then use Exit in the Termux session notification as described by the maintainer. Save and leave your world normally. Closing the helper ends the service that Minecraft was using, so a later world session needs a fresh connection.

For the next play session, open Termux and run:

cd ~/verity-android-setup && bash start_android.sh

Keep it running, open Minecraft, enter the world, and repeat /connect 127.0.0.1:3000. PnTMC explicitly requires reconnecting when you re-enter the world. You do not need to download the archive and reinstall every dependency for each session.

If you see an address-already-in-use error after starting again, check for an older helper session before opening another. Stop the duplicate session and retry once. Changing the port without changing the matching game connection would create a second problem.

Update settings without leaving the old copy running

Editing .env in Download does not automatically replace the copy inside Termux. Stop the helper first, save your changes, and use the maintainer’s .env update/copy instruction. Then start the helper again and reconnect Minecraft. Keep track of which copy you edited so that a later copy operation does not overwrite newer values with an old download.

Before updating the helper itself, keep a private backup of your working settings and note the add-on and Minecraft versions. Read the new release instructions before copying old configuration into it. A newer helper may introduce fields that an older .env does not contain; transfer the required values into the new template instead of assuming every old file should replace the new one.

Change one component at a time when possible. Updating Minecraft, the add-on, the helper, and all providers at once makes a failure harder to isolate. After an update, repeat the same short test: helper starts, local connection succeeds, one typed answer arrives, then voice works.

Fix the failure you actually see

Folder or startup script not found: check extraction depth and spelling. Download/verity-android-setup/verity-android-setup is not the same layout as a script directly inside the first folder. Confirm the runtime copy exists before using the restart command.

Storage permission denied: return to Android’s Termux permissions and repeat the storage-setup step. Do not treat a phone-wide file-access problem as an invalid AI credential. Never solve it by moving secrets into a publicly shared folder.

Connection fails after switching apps: inspect Termux immediately. If Android stopped the process, restarting the helper and reviewing its background restrictions is more relevant than reinstalling the packs. If it is still running, check the WebSockets settings and exact connection address.

Connected, but a provider rejects requests: keep the working local connection. Read whether the error concerns authentication, a model, a quota, or a temporary service failure. The API error guide explains those distinctions, but its Java configuration-menu paths do not apply to this Android helper.

Support needs more information: provide the project ID, add-on version, Minecraft build, Android version, and the first failing step. Include a sanitized error message and whether typed chat ever worked. Exclude .env, authorization headers, account details, and complete unreviewed logs. That lets the maintainer distinguish an import failure from a stopped helper without asking you to expose credentials.