Pubblicare sullo Steam Workshop | Wiki di The Undercut

Tutto ciò che puoi mettere in mods/ può essere pubblicato sullo Steam Workshop, e chi si iscrive non deve copiare nulla: Steam scarica l’oggetto e il gioco lo legge direttamente dalla cartella di download di Steam.

Dieci minuti la prima volta, due minuti dopo. L’unica cosa da mettere in conto subito: Steam non ha un pulsante per caricare oggetti del Workshop. L’unico canale è SteamCMD, il piccolo strumento a riga di comando di Valve. Vale per ogni gioco su Steam.

Come un oggetto arriva a un giocatore

Chi si iscrive non copia nulla. La sua cartella mods/ vince comunque sui nomi uguali.

1. Metti i tuoi contenuti in una cartella

Un oggetto del Workshop è una cartella, non un file — anche quando contiene un solo circuito. Creala dove vuoi sul disco. La sua struttura rispecchia mods/, quindi un unico formato di creazione serve entrambi i canali:

MyItem/
  my_pack.db               ← un pacchetto mod
  circuits/monaco.circuit  ← un circuito (o nella radice dell'oggetto)
  lang/pl.txt              ← un pacchetto lingua (o pl.txt nella radice)

Tutto è facoltativo e un oggetto può portare tutti e tre. Un file nella radice dell’oggetto viene letto come lingua solo se il suo nome ha la forma di un codice lingua, quindi un readme.txt lì accanto resta intoccato.

Poi aggiungi un’immagine di anteprima accanto alla cartella, non dentro: un PNG o JPG, sotto 1 MB. Uno screenshot dell’editor, o del tracciato, va benissimo.

2. Installa SteamCMD

Da Valve: developer.valvesoftware.com/wiki/SteamCMD.

Windows — estrai steamcmd.exe in una cartella dedicata ed eseguilo una volta perché si aggiorni.
Linux — installa il pacchetto steamcmd, oppure scompatta il tarball.

3. Scrivi `item.vdf`

Un piccolo file di testo, accanto alla tua cartella. Cambia i percorsi e il titolo:

"workshopitem"
{
    "appid"           "4514930"
    "publishedfileid" "0"
    "contentfolder"   "C:\\Users\\me\\Workshop\\MyItem"
    "previewfile"     "C:\\Users\\me\\Workshop\\preview.png"
    "title"           "Monaco 1994"
    "description"     "Un cittadino stretto, 3,3 km, 19 curve."
    "changenote"      "Prima versione."
    "visibility"      "0"
}

Campo	Note
`appid`	`4514930` — The Undercut. Non cambiarlo mai
`publishedfileid`	`0` crea un nuovo oggetto. Dopo il primo caricamento, SteamCMD ci scrive l’id reale al posto tuo
`contentfolder`	Percorso assoluto della cartella dell’oggetto. Su Windows, raddoppia ogni backslash
`previewfile`	Percorso assoluto dell’immagine, sotto 1 MB. Facoltativo — puoi aggiungerla dopo sulla pagina dell’oggetto
`visibility`	`0` pubblico · `1` solo amici · `2` nascosto. Parti da nascosto se vuoi prima controllare la pagina

4. Carica

In un terminale o prompt dei comandi, con l’account Steam che possiede il gioco:

steamcmd +login IL_TUO_NOME_STEAM +workshop_build_item "C:\Users\me\Workshop\item.vdf" +quit

Chiede la password e il codice Steam Guard — è interattivo, quindi eseguilo di persona e non da uno script. Al termine stampa l’id dell’oggetto e lo scrive in item.vdf.

Conserva item.vdf. È la tua chiave sull’oggetto: è ciò che rende il caricamento successivo un aggiornamento invece di un doppione. (SteamCMD riscrive il file ed elimina qualsiasi commento tu ci metta, quindi tieni gli appunti altrove.)

5. Accetta l’accordo, completa la pagina

Apri la pagina Workshop dell’oggetto — Steam → Comunità → Workshop → The Undercut → I tuoi file. Al primo caricamento Steam chiede di accettare l’accordo legale del Workshop, e l’oggetto resta invisibile finché non lo fai. Titolo, descrizione, immagini e tag da lì in poi si modificano lì.

6. Verifica che funzioni

Iscriviti al tuo stesso oggetto. Steam lo scarica da solo; non c’è nulla da copiare. Avvia il gioco:

un pacchetto compare in Nuova carriera → Mod personalizzate
un circuito compare negli elenchi dei circuiti della configurazione carriera
una lingua compare in Impostazioni → Lingua

Se non succede, esegui il gioco con --list-mods dalla sua cartella: stampa la cartella Workshop risolta, ogni oggetto a cui sei iscritto che ha trovato e tutto ciò che ogni scansione ha raccolto.

Aggiornare un oggetto pubblicato

Sostituisci i file nella stessa cartella, imposta una nuova changenote in item.vdf ed esegui lo stesso comando. Poiché publishedfileid contiene ora l’id del tuo oggetto, questo viene aggiornato sul posto — nessun doppione, e chi è iscritto riceve la nuova versione automaticamente.

Mentre iteri, ricorda che un file nella tua cartella mods/ batte la copia a cui sei iscritto con lo stesso nome. È così che provi una modifica a qualcosa che hai già pubblicato, senza disiscriverti.

Se qualcosa va storto

Sintomo	Cosa controllare
«Failed to update workshop item»	Ogni percorso in `item.vdf` deve essere assoluto ed esistere; l’immagine di anteprima deve stare sotto 1 MB
Accesso rifiutato	SteamCMD è interattivo — digita il codice Steam Guard quando te lo chiede. L’account deve possedere il gioco
La pagina dell’oggetto è vuota dopo un caricamento andato in errore	Un id assegnato da una creazione poi fallita è un fantasma: non è stato salvato nulla. È reale solo un id che puoi aprire sul Workshop
Il contenuto non compare nel gioco	Controlla l’estensione (`.db`, `.circuit`, `.txt`) e la sua posizione nella cartella dell’oggetto, poi esegui `--list-mods`
Nella demo non funziona nulla	La demo e le build del Next Fest escono del tutto senza supporto alle mod