The tmc CLI - The Modding Community
L'API, Depuis Votre Terminal
tmc est un client en ligne de commande pour notre API de contenu publique. Il crée, modifie et supprime vos ressources, mods, serveurs, articles, communautés, collections et groupes — et, parce que c'est à cela que l'API sert vraiment, il téléverse des fichiers et publie des versions en une seule commande.
tmc n'est pas encore publié. Il n'est pas sur PyPI et n'a pas de dépôt public — aujourd'hui il s'installe depuis une copie des sources, et cette page décrit ce que l'outil fait déjà plutôt que d'annoncer une sortie.
# 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 seul paquet en bibliothèque standard : rien à compiler et rien à résoudre — et chaque commande, option et code de sortie est documenté.
La Raison D'Avoir Un Outil
Publier une version via l'API brute, c'est quatre requêtes dans un ordre précis : téléverser les fichiers, récupérer leurs ids, lire l'ensemble des versions existantes, puis réécrire la nouvelle sans toucher aux autres. release publish, c'est cette séquence.
Tout Ce Que Fait L'API, Détaillé
Une commande par chose que vous feriez dans le navigateur, et quelques-unes que vous n'y feriez pas : modifications en masse, pipelines et publications scriptées.
Clés, Profils Et La Moitié Publique
Connectez-vous une fois et l'identifiant est stocké dans ~/.config/tmc/config.json en mode 0600 — ou passez-le par l'environnement et rien ne touche le disque. Un profil par site ou par clé, et --anon pour la moitié de l'API qui ne demande aucune clé.
Quatre Verbes Qui Disent Ce Qu'Ils Font
Le dangereux, c'est set : sur cette API, un PUT sur une relation signifie « voici désormais l'ensemble complet », donc un PUT à un seul membre supprime tout le reste sur l'élément. La CLI garde les quatre distincts et prévient avant d'envoyer le destructeur.
Fait Pour Vivre En CI
Compilez votre projet, publiez une version et téléversez ses fichiers à chaque tag. Les identifiants viennent de l'environnement, donc rien n'est écrit sur le disque d'un runner.
