mobile-textdb 0.4.0

Read/write GTA San Andreas & Vice City mobile texture databases (textdb)

mobile-textdb

Python-библиотека для GTA San Andreas / Vice City Mobile — чтение и запись textdb (.txt, .dat, .toc).

Режимы импорта (TXD Tool) + prompt для AI: docs/AI_TEXTURE_IMPORT_GUIDE.md

Установка

pip install -e .

Минимальный пример

from pathlib import Path
from PIL import Image
from mobile_textdb import TextureDatabase

db = TextureDatabase.open(Path("texdb/gta3"))
db.replace("radar00", Image.open("radar00.png").convert("RGBA"))
db.save()

TXD (через rwfury)

from mobile_textdb import TextureDatabase, load_txd

db = TextureDatabase.open("texdb/gta3")
for tex in load_txd("grenade.txd", max_size=512):
    (db.replace if db.get(tex.name) else db.add)(tex.name, tex.image)
db.save()

CLI

python example_import_examples.py
mobile-textdb --folder texdb/gta3 --png-dir examples/ --replace

Файлы

Пишем	Не трогаем
.txt, .dat, .toc	.tmb (не нужен игре)

Платформы

Windows, Linux (Ubuntu), macOS — только Python 3.10+ и pip.

Зависимости

Pillow (≥ 11.2.1), texfury (только Windows), texture2ddecoder, rwfury (импорт TXD)