The tmc CLI - The Modding Community
La API, Desde Tu Terminal
tmc es un cliente de línea de comandos para nuestra API pública de contenido. Crea, edita y elimina tus recursos, mods, servidores, artículos, comunidades, colecciones y grupos — y, porque es para lo que realmente se usa la API, sube archivos y publica versiones en un solo comando.
tmc todavía no está publicado. No está en PyPI y no tiene repositorio público — hoy se instala desde una copia del código fuente, y esta página describe lo que la herramienta ya hace en lugar de anunciar un lanzamiento.
# From the source checkout — there is nothing to build
pip install .
pip install '.[fast]' # optional: cryptography, for faster signing
tmc --version # tmc 1.1.0
# Keys are made under Account → API Keys
tmc auth login --token tmc_xxxxxxxxxxxx
tmc auth whoami
# …or read public items with no key at all
tmc mod list --anon --app 4 -o json
Un único paquete de biblioteca estándar, así que no hay nada que compilar ni nada que resolver — y cada comando, opción y código de salida está documentado.
La Razón De Tener Una Herramienta
Publicar una versión a través de la API en crudo son cuatro peticiones en un orden concreto: subir los archivos, recoger sus ids, leer el conjunto de versiones que ya existe y luego escribir la nueva sin tocar las demás. release publish es esa secuencia.
Todo Lo Que Hace La API, Bien Explicado
Un comando por cada cosa que harías en el navegador, y unas cuantas que no querrías hacer allí: ediciones masivas, pipelines y publicaciones automatizadas.
Claves, Perfiles Y La Mitad Pública
Inicia sesión una vez y la credencial se guarda en ~/.config/tmc/config.json con permisos 0600 — o pásala por el entorno y no se toca el disco en absoluto. Un perfil por sitio o por clave, y --anon para la mitad de la API que no necesita ninguna clave.
Cuatro Verbos Que Dicen Lo Que Hacen
El peligroso es set: en esta API un PUT a una relación significa «este es ahora el conjunto completo», así que un PUT con un solo miembro borra todo lo demás del elemento. La CLI mantiene los cuatro separados y avisa antes de enviar el destructivo.
Hecho Para Vivir En CI
Compila tu proyecto, publica una versión y sube sus archivos en cada etiqueta. Las credenciales vienen del entorno, así que no se escribe nada en el disco de un runner.
