Skip to content

Add Vietnam TFT package support - #4

Closed
chauvansang1997 wants to merge 3 commits into
tweet9ra:masterfrom
chauvansang1997:feature/vietnam-tft-support
Closed

chauvansang1997 wants to merge 3 commits into
tweet9ra:masterfrom
chauvansang1997:feature/vietnam-tft-support

Conversation

@chauvansang1997

@chauvansang1997 chauvansang1997 commented Sep 2, 2026 •

Copy link
Copy Markdown

Summary

The launcher previously assumed the global TFT Android package,
com.riotgames.league.teamfighttactics, throughout installation, launching,
process monitoring, FPS collection, login repair, and diagnostic scripts.

This change adds support for the Vietnam client package,
com.riotgames.league.teamfighttacticsvn, while preserving support for the
global client.

The selected package is now taken from the validated game release, persisted in
installation state, and propagated through the runtime. Package changes are
also recognized as game updates, even when version numbers match.

This change does not modify bundled APKs, APK hashes, the bundled global release
manifest, or the launcher UI.

Motivation

The Vietnam TFT client is distributed under a separate Android package and
could not be launched or monitored correctly while the global package name was
hard-coded.

Supporting both known package identifiers is preferable to replacing the
global identifier because it preserves existing installations and keeps the
runtime compatible with both official distributions. Manifest validation and
the runtime helper continue to fail closed for unknown package identifiers.

Validation

  • ./scripts/verify-repository.command
  • ./scripts/test-mactician.command
  • Relevant manual or integration checks are described below, or are not applicable.

Completed checks:

  • Swift unit-test binary passed: Mactician tests: OK.
  • All launcher Swift sources passed type-checking.
  • Modified shell scripts passed zsh -n.
  • git diff --check passed.
  • Vietnam runtime helper smoke test passed with:
    • TFT_PACKAGE=com.riotgames.league.teamfighttacticsvn
    • TFT_GAME_LANGUAGE=vi-VN
  • A complete ad-hoc application build succeeded using the verified pinned APK set.
  • The installed application passed deep code-signature verification.

Known local validation blockers:

  • verify-repository.command scans the unrelated untracked
    android-play-runtime/ directory and reports a non-executable third-party
    shell script. That directory is not part of this commit.
  • test-mactician.command stops because the local ignored fixture
    scripts/test-fixtures/unreal-startup/TFT.log is missing.

Screenshots

Not applicable. This change does not modify the UI.

Contributor checklist

  • I did not add game APKs, Android images, private runtime state, credentials, logs, or generated build products.
  • Developer-facing output and documentation are in English.
  • New machine paths are resolved from environment variables, standard locations, or PATH.
  • Behavior changes include tests or a concrete reason why a test is impractical.
  • Performance claims include reproducible evidence and avoid overstating noisy results.
  • Documentation, changelog, and release notes are updated when applicable.
  • Existing rollback, Repair, Reset, and fail-closed behavior is preserved or the deliberate change is explained.

LamPPKK pushed a commit to LamPPKK/Macrodroid that referenced this pull request Sep 4, 2026
…-ownership-and-storag-20d888cb

docs: define TFTMAC clean ownership and storage reclamation
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant