Projektuj niestandardowe słoiki i bramki na końcówki

Nadaj celom darowizn, liczników i szumu swój własny styl wizualny, bez zmiany ich kwot i zasad realizacji.

Pokazuj inny GIF wraz z postępem zbiórki

Użyj jednej własnej nakładki z paskiem celu i grafiką. Pasek już oblicza postęp; grafika powinna korzystać z tego samego postępu zamiast osobno liczyć darowizny. Ten przepis wymaga zmodyfikowanej kopii nakładki, a nie dodatkowej wbudowanej opcji.

  1. W SSN skonfiguruj Słoik na napiwki i miernik celu z Płynny pasek celu (Fluid Goal Bar), swoim tytułem, celem i filtrami darowizn. Dla tego stałego celu pieniężnego 500 USD pozostaw Punktacja Hype Cup (Hype Cup Scoring) wyłączone i wyłącz cele powtarzalne lub rosnące. Zanim dostosujesz nakładkę, upewnij się, że oryginalny link działa.
  2. Obserwacja Pobierz i zachowaj strukturę plików poniżej, aby utworzyć my-goal.html. Zapisz pięć GIF-ów obok tego pliku, używając nazw z tabeli. Użyj takich samych wymiarów płótna, aby grafika nie przeskakiwała ani nie rozciągała się przy zmianie.
  3. Przekaż edytorowi lub narzędziu AI skopiowany kod i GIF-y. Użyj poniższych instrukcji progów wraz z pełnego promptu dostosowania. Poproś o jeden obraz obok istniejącego paska.
  4. Obejrzyj podgląd zmodyfikowanej kopii przy każdym progu, a następnie przejdź do Sesja i OBS aby połączyć kopię z oryginalnymi ustawieniami linku. Dodaj połączoną nakładkę jako jedno źródło przeglądarkowe OBS.
Postęp celuDla celu 500 USDTwój plik GIF
Od 0% do poniżej 25%Od 0 USD do poniżej 125 USDgoal-0.gif
Od 25% do poniżej 50%Od 125 USD do poniżej 250 USDgoal-25.gif
Od 50% do poniżej 75%Od 250 USD do poniżej 375 USDgoal-50.gif
Od 75% do poniżej 100%Od 375 USD do poniżej 500 USDgoal-75.gif
100% i więcej500 USD i więcejgoal-100.gif

Nazwy plików są przykładami; dostarcz własną grafikę. Kwoty w dolarach dotyczą tego stałego celu pieniężnego. Dla celów licznikowych, Hype, powtarzalnych lub rosnących wybieraj obraz na podstawie procentu wyświetlanego na pasku.

Skopiuj instrukcje progów GIF
Add milestone artwork beside the existing Fluid Goal Bar in my-goal.html.
Use these relative GIF files:
0%: goal-0.gif; 25%: goal-25.gif; 50%: goal-50.gif;
75%: goal-75.gif; 100%: goal-100.gif.

Read the existing getProgressState().percentage from the renderAmount()
update path. Do not add a second donation counter or change goal math.
Select the highest reached threshold. If progress jumps from 20% to 80%,
show goal-75.gif directly. Clamp the artwork selection to 0–100%.
Change img.src only when its selected file changes so ordinary updates
do not restart the GIF. Keep one fixed-size image box with object-fit: contain.
Provide meaningful alternative text and handle a missing image without
hiding or breaking the goal bar.

Update the artwork on first render, donations, manual total changes,
reset, restored totals, and recurring/advancing-goal transitions.
Keep the completion image while a fixed goal remains at or above 100%.
If the configured goal resets or advances, follow its displayed percentage.
Preserve the existing filters, session, password, currency/count/Hype
semantics, persistence, completion rules, and local dependencies.

Use the existing preview mode to test 0, 124, 125, 249, 250, 374,
375, 499, 500, and 600 against a fixed goal of 500. Also test a large
jump, a manual decrease, reset, refresh, and any enabled recurring rules.

Ćwicz bez zmieniania rzeczywistych sum

Otwórz zmodyfikowaną kopię z poniższymi ustawieniami podglądu. Zmień startamount na wartości z promptu i odświeżaj między sprawdzeniami. Podgląd używa przykładowych danych oraz wyłącza połączenia na żywo, zapisane sumy i dźwięk.

file:///C:/SSN/social_stream-beta/my-goal.html?preview&style=bar&goal=500&startamount=125

Przy 125 USD pierwszy GIF progowy powinien pojawić się obok paska pełnego w 25%. Usuń preview oraz próbne startamount zanim użyjesz prawdziwej sesji z jej oryginalnymi ustawieniami. Przywracanie sum i resetowanie sprawdź osobno w sesji testowej, ponieważ podgląd nie zapisuje sum.

GIF jest już osobnym źródłem OBS? Może odtwarzać się obok celu, ale nie zna automatycznie jego postępu. Do automatycznych zmian przy progach użyj połączonej własnej nakładki.

Wybierz właściwą stronę startową

Słoik napiwków/miernik celów może prezentować różne wskaźniki i style tipjar.html. Najpierw skonfiguruj zamierzoną metrykę w SSN, a następnie zachowaj wygenerowany adres URL podczas zmiany projektu. Punktacja szumu w tym celu różni się od licznika widzów/gadających hype.html.

Wskaźnik celu Jar Tip renderowany lokalnie w trybie podglądu
Aktualny podgląd tipjar.html; wyświetlana kwota to przykładowe dane.

Pobierz i zachowaj strukturę plików

  1. Pobierz źródłowy plik ZIP i wyodrębnij go. Te przewodniki korzystają ze źródła beta; przechowuj pliki z jednego pobrania razem.
  2. Kopiuj tipjar.html na my-goal.html obok oryginału. Jeśli wybierzesz inną stronę lub motyw, zachowaj jej kopię w oryginalnym folderze tego pliku.
  3. Otwórz skopiowany kod HTML i przywoływany do niego CSS/JS w swoim edytorze lub narzędziu AI. Dodaj dostarczoną grafikę/czcionki do tego samego projektu i użyj ścieżek względnych. Zacznij od zastąpień CSS; dołącz moduł renderujący podczas zmiany wygenerowanych znaczników.

Poniższe pliki pomogą Ci znaleźć projekt i zachowanie. To jest lista do przeczytania, a nie kompletny pakiet zależności: zachowaj wyodrębniony folder w stanie nienaruszonym, łącznie z obrazami, czcionkami, skryptami i wszelkimi plikami danych.

PlikDlaczego to ma znaczenie
tipjar.htmlPrezentacja celu/słoika, ustawienia i obsługa ilości.
currency.jsSzacunki w USD i zmiany w źródłach.
thirdparty/matter.min.jsFizyka wykorzystywana w prezentacjach słoików.
shared/overlay-control-transport.jsUstawienia hosta i aktualizacje kontroli.
shared/utils/chatHtml.jsOdkażanie wyświetlaczy; wymaga bibliotek/objects.js.

Podłącz swoją kopię i otwórz ją w OBS

Uruchom SSN i najpierw spraw, aby oryginalnie wygenerowany adres URL nakładki zaczął działać. The session= łączy się z tą sesją SSN; to nie jest nazwa Twojego kanału ani nazwa tego pliku. Utrzymuj działanie SSN, odpowiedniej funkcji i jej źródeł danych.

Wklej pełny lokalny adres nakładki w polu URL OBS.
Wklej pełny lokalny adres nakładki w polu URL OBS.
  1. Przeciągnij edytowany plik HTML do przeglądarki Chrome lub Edge. Skopiuj jego adres z paska adresu; zaczyna się od file:///.
  2. Skopiuj wszystko z ? dalej w działającym łączu nakładki SSN i dodaj go na końcu adresu tego pliku. Zachowaj wszystkie ustawienia, w tym sesję, hasło i inne # zakończenie.
  3. Otwórz wynik w przeglądarce, a następnie ustaw źródło przeglądarki OBS URL na ten sam adres z Plik lokalny niezaznaczone. Dopasuj wymiary źródłowe do zamierzonego projektu.

Dla powyższego pliku startowego adres lokalny wygląda następująco; Twój rzeczywisty link może zawierać dodatkowe wymagane opcje:

file:///C:/SSN/social_stream-beta/my-goal.html?session=YOUR_SESSION

Użyj rzeczywistego adresu pliku na swoim komputerze. OBS zapisuje go ze źródłem; przechowuj pobrany folder w tym samym miejscu. Po zapisaniu zmian w projekcie odśwież źródło przeglądarki. The udostępniony przewodnik konfiguracji zawiera przykłady dla komputerów Mac i opcjonalny program uruchamiający dla pola wyboru Plik lokalny.

Gdzie zmienić projekt

Zmień grafikę słoika, kolory wypełnienia, ścieżkę paska, etykietę celu, typografię kwoty i animację ukończenia. Zacznij od istniejących elementów sterujących stylem i kolorem opisanych w sekcji przewodnik po celach. W przypadku niestandardowych kompozycji zachowaj zasoby obok kopii i zaktualizuj tylko ścieżkę, do której się odwołuje.

Metryka celu, zasady ukończenia/resetowania, trwałość i liczenie dawców zależą od jego zachowania. Zachowaj je podczas zmiany prezentacji. Nie zamieniaj surowych monet, subskrypcji podarowanych i USD na jedną nieoznaczoną liczbę. Zachowaj liczbę donoValue zero, jeśli źródło to dostarcza.

Skopiuj ten monit AI

Przekaż AI skopiowane pliki źródłowe i grafikę referencyjną. Wymień szczegóły w nawiasach. Zachowaj instrukcje dotyczące bezpieczeństwa wprowadzania w wierszu poleceń.

Pokaż pełny monit
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.

Przetestuj ten typ nakładki

Najpierw skorzystaj z podglądu lub konfiguracji testowej. The przewodnik po wiadomościach testowych wyjaśnia, jak wysyłać fikcyjne ładunki poprzez SSN; test przesłany do Twojej sesji produkcyjnej może uruchomić istniejące automatyzacje.

  1. Najpierw wypróbuj tryb podglądu strony (?podgląd z opcjami stylu); usuń podgląd podczas łączenia prawdziwej sesji.
  2. Skorzystaj z przykładowych zdarzeń wsparcia pasujących do wybranej metryki. Sprawdź zero, częściowy postęp, cel osiągnięty i postęp poza celem.
  3. Sprawdź ustawienia resetowania/przeniesienia i odświeżanie źródła pomiędzy próbami. Sprawdź etykiety walut, długie tytuły i wszelkie efekty dźwiękowe lub zakończenia w OBS.

Uruchom także plik Kontrola renderowania danych wejściowych względem zmienionych ścieżek renderowania. Po zapisaniu zmian odśwież źródło przeglądarki OBS pomiędzy próbami i powtórz widoczną interakcję. Podgląd przeglądarki nie określa przechwytywania na żywo ani zachowania OBS.

Więcej materiałów: Metryki i kontrola celów · Pola darowizn · Dokumentacja zdarzeń · Rozwiązywanie problemów z konfiguracją lokalną.