Scegli la pagina iniziale giusta
Il Tip Jar/Goal Meter può presentare metriche e stili diversi dallo stesso tipjar.html. Configura innanzitutto la metrica desiderata in SSN, quindi mantieni l'URL generato quando modifichi il design. Il punteggio pubblicitario in questo goal è diverso dal contatore dello spettatore/chat hype.html.

Scaricare e conservare la struttura del file
- Scarica lo ZIP sorgente ed estrarlo. Queste guide utilizzano l'origine beta; mantenere insieme i file di un download.
- Copia
tipjar.htmlamy-goal.htmlaccanto all'originale. Se scegli una pagina o un tema diverso, conserva la copia nella cartella originale del file. - Apri l'HTML copiato e il relativo CSS/JS di riferimento nel tuo editor o strumento AI. Aggiungi grafica/caratteri forniti allo stesso progetto e utilizza i percorsi relativi. Inizia con le sostituzioni CSS; includere il renderer quando si modifica il markup generato.
I file seguenti aiutano a trovare la progettazione e il comportamento. Questo è un elenco di lettura, non un pacchetto di dipendenze completo: mantieni intatta la cartella estratta, incluse immagini, caratteri, script ed eventuali file di dati.
| Fascicolo | Perché è importante |
|---|---|
tipjar.html | Presentazione obiettivo/barattolo, impostazioni e gestione degli importi. |
currency.js | Stime in USD e sostituzione della fonte. |
thirdparty/matter.min.js | Fisica utilizzata dalle presentazioni dei vasi. |
shared/overlay-control-transport.js | Impostazioni dell'host e aggiornamenti del controllo. |
shared/utils/chatHtml.js | Sanificazione display; richiede libs/objects.js. |
Collega la tua copia e aprila in OBS
Avvia SSN e fai funzionare prima l'URL di sovrapposizione generato originale. Il session= si connette a quella sessione SSN; non è il nome del tuo canale o il nome di questo file. Mantieni SSN, la funzionalità pertinente e le relative origini dati in esecuzione.

- Trascina il file HTML modificato in Chrome o Edge. Copia il suo indirizzo dalla barra degli indirizzi; inizia con
file:///. - Copia tutto da
?in poi nel collegamento in sovrapposizione SSN funzionante e aggiungilo alla fine dell'indirizzo del file. Conserva tutte le impostazioni, inclusa la sessione, la password e altro#fine. - Aprire il risultato in un browser, quindi impostare una sorgente browser OBS URL allo stesso indirizzo con File locale deselezionato. Abbina le dimensioni di origine al progetto previsto.
Per il file iniziale sopra, l'indirizzo locale è simile a questo; il tuo collegamento effettivo potrebbe contenere ulteriori opzioni richieste:
file:///C:/SSN/social_stream-beta/my-goal.html?session=YOUR_SESSION
Utilizza l'indirizzo file effettivo sul tuo computer. OBS lo salva con il sorgente; mantieni la cartella scaricata nello stesso posto. Dopo aver salvato le modifiche al design, aggiorna la sorgente del browser. Il guida di configurazione condivisa include esempi Mac e un launcher opzionale per la casella di controllo File locale.
Dove modificare il design
Modifica la grafica del barattolo, i colori di riempimento, il tracciato della barra, l'etichetta dell'obiettivo, la tipografia dell'importo e l'animazione di completamento. Inizia con i controlli di stile e colore esistenti descritti nel file guida agli obiettivi. Per la grafica personalizzata, mantieni le risorse accanto alla tua copia e aggiorna solo il percorso di riferimento.
La metrica dell'obiettivo, le regole di completamento/reimpostazione, la persistenza e il conteggio dei donatori appartengono al suo comportamento. Conservali mentre cambi la presentazione. Non convertire monete grezze, abbonamenti regalo e USD in un unico numero senza etichetta. Conserva un numero donoValue di zero quando la fonte lo fornisce.
Copia questo prompt AI
Fornisci all'intelligenza artificiale i file sorgente copiati e la grafica di riferimento. Sostituisci i dettagli tra parentesi. Conservare le istruzioni di sicurezza dell'input nel prompt.
Mostra il prompt completo
Customize my-goal.html, copied from tipjar.html.
Design: [describe the look or attach a reference].
Colors/fonts/assets: [supply hex colors and local filenames].
OBS canvas and placement: [size and position].
Style this tip jar/goal as [design] for [canvas]. Change artwork, colors, layout, labels, and motion while preserving the chosen metric, amount calculation, source filters, streak handling, persistence, and completion/reset rules. Keep hasDonation display units and donoValue USD semantics. Do not fabricate progress when the feed is empty.
Read docs/event-reference.html for incoming fields and
docs/overlay-customization-guide.html for local setup and safe rendering.
Keep the existing session/password handling, labels, server routes, query
parameters, URL fragments, and relative asset paths. Use classic scripts
compatible with Chrome 80. Keep executable dependencies packaged locally.
Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.
Make the edited overlay work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files, any additional assets, exact local browser/OBS
setup instructions using placeholders, and the specific tests performed.
Do not put my private session link or credentials into a public example.Testare questo tipo di overlay
Utilizzare prima un'anteprima o una configurazione di prova. Il guida al messaggio di prova spiega come inviare payload fittizi tramite SSN; un test inviato alla sessione di produzione può attivare le sue automazioni esistenti.
- Prova prima la modalità di anteprima della pagina (?anteprima con le tue opzioni di stile); rimuovi l'anteprima quando ti connetti alla sessione reale.
- Utilizza eventi di supporto di esempio corrispondenti alla metrica scelta. Controlla zero, progresso parziale, obiettivo raggiunto e progresso oltre l'obiettivo.
- Controllare le impostazioni di ripristino/riportamento e un aggiornamento della sorgente tra le prove. Esamina le etichette delle valute, i titoli lunghi e qualsiasi effetto sonoro o di completamento in OBS.
Eseguire anche il file controlli di rendering dell'input rispetto ai percorsi di rendering modificati. Dopo aver salvato le modifiche, aggiorna la sorgente del browser OBS tra le prove e ripeti l'interazione visibile. Le anteprime del browser non stabiliscono l'acquisizione dal vivo o il comportamento di OBS.
Altri riferimenti: Metriche e controlli degli obiettivi · Campi per le donazioni · Riferimento degli eventi · Risoluzione dei problemi di configurazione locale.