ToolBoxV2 Registry - Dokumentation¶

Willkommen zur offiziellen Dokumentation der ToolBoxV2 Registry.

Schnellnavigation¶

Für Nutzer¶

User Guide - Mods finden, installieren und verwenden

Für Contributors (Mod-Entwickler)¶

Contributors Guide - Mods veröffentlichen und verwalten

Für Entwickler (Registry-Entwicklung)¶

Developers Guide - Registry setup, Architektur, Contributing

API-Referenz¶

API Reference - HTTP-API Endpunkte und Beispiele

Kurzeinführung¶

Die ToolBoxV2 Registry ist die zentrale Plattform für: - Mods: Erweiterungen für ToolBoxV2 - Libraries: Nützliche Python-Bibliotheken - Artifacts: Kompilierte Binaries und Tools (SimpleCore Desktop, TB CLI)

Was kann ich hier?¶

Rolle	Kann...	Siehe...
Nutzer	Mods downloaden, installieren, updaten	User Guide
Contributor	Mods veröffentlichen, verwalten	Contributors Guide
Entwickler	Registry mitentwickeln, API nutzen	Developers Guide

Erste Schritte¶

1. ToolBoxV2 installieren¶

# Mit pip
pip install toolboxv2

# Version prüfen
tb --version

2. Mods installieren (über CloudM)¶

# Interaktiver Manager (empfohlen)
tb -c CloudM mods manager

# Direkt installieren
tb -c CloudM mods install CloudM

# Oder Shortcut
tb --install CloudM

3. Registry CLI verwenden¶

# Mods suchen
tb registry search discord

# Mods auflisten
tb registry list

# Mod-Details anzeigen
tb registry info CloudM

# Mod herunterladen
tb registry download CloudM

Mod-Sichtbarkeit verstehen¶

Public¶

In der Suche sichtbar
Jeder kann downloaden
Erfordert verifizierten Publisher

Unlisted¶

Nicht in der Suche
Aber mit Link/Namen downloadbar
Keine Verifizierung nötig

Private¶

Nur für den Owner
Nicht in der Suche
Nicht downloadbar (außer Owner)

Admin-Zugang¶

Der erste Admin wird direkt auf dem Registry-Server mit dem Admin-CLI erstellt:

# Auf dem RYZEN-Server ausführen
python admin_cli.py --db ./data/registry.db
# → Option 7: "Toggle admin"

Danach kann der Admin über die API Publisher verifizieren:

tb registry admin publisher verify --target <publisher-id>

Siehe Developers Guide für Details.

Häufige Fragen¶

Wie veröffentliche ich einen Mod?¶

Siehe Contributors Guide:

Einloggen: tb registry login
Publisher registrieren (über API oder CloudM)
Package erstellen: tb registry publish ./my-mod --create --metadata metadata.json
Version hochladen: tb registry publish ./my-mod --upload --metadata metadata.json

Wie werde ich verifizierter Publisher?¶

Publisher registrieren (via POST /api/v1/auth/register-publisher)
Verification beantragen (via POST /api/v1/publishers/verify)
Admin verifiziert den Publisher

Wie ändere ich die Sichtbarkeit?¶

tb registry publish my-mod --visibility public
tb registry publish my-mod --visibility unlisted
tb registry publish my-mod --visibility private

Support¶

Issues: GitHub Issues
Discord: ToolBoxV2 Discord
Email: support@toolboxv2.app

Dokumentations-Status¶

Dokument	Status	Letztes Update
User Guide	✅ Aktuell	2026-04-28
Contributors Guide	✅ Aktuell	2026-04-28
Developers Guide	✅ Aktuell	2026-04-28
API Reference	✅ Aktuell	2026-04-28

Versions-Historie¶

v1.1.0 (2026-04-28)¶

Dokumentation mit Code synchronisiert
Admin-CLI und Bootstrapping dokumentiert
Artifact Upload/Download Endpoints hinzugefügt
Diff-System dokumentiert
Versions-Endpoint dokumentiert
CLI-Commands an tatsächlichen Code angepasst

v1.0.0 (2025-02-25)¶

Initiale Veröffentlichung
CloudM.Auth Integration
Public/Unlisted/Private Mods
CLI und HTTP API

Letzte Aktualisierung: 2026-04-28 Registry Version: 1.1.0