Game Sync: dokumentacja

Game Sync synchronizuje bibliotekę gier, czas gry oraz osiągnięcia i trofea z GameTrack, Steam i PlayStation do zwykłych notatek Markdown w Obsidianie. Jedna gra to jedna notatka, także wtedy, gdy masz ją na kilku platformach.

Co robi

• importuje bibliotekę Steam z czasem gry, osiągnięciami i metadanymi;
• importuje bibliotekę PlayStation z czasem gry i trofeami;
• importuje wieloplatformową bibliotekę GameTrack z oficjalnego eksportu ZIP;
• pokazuje podgląd przed pierwszym zapisem i przy każdym niepewnym dopasowaniu;
• adoptuje istniejące notatki bez przepisywania ręcznej treści;
• opcjonalnie tworzy jeden raz plik Games.base z gotowymi widokami;
• ma interfejs po polsku i angielsku.

Czego nie robi: nie zapisuje niczego z powrotem u dostawców, nie usuwa, nie przenosi, nie zmienia nazw i nie scala notatek automatycznie. Nie ma też telemetrii, konta Game Sync ani własnego backendu.

Instalacja

BRAT (zalecane w fazie testowej): dodaj repozytorium https://github.com/voi-tech/obsidian-game-sync, a po instalacji włącz wtyczkę.

Ręcznie: pobierz main.js, manifest.json i styles.css z wydań na GitHubie, umieść je w .obsidian/plugins/game-sync/, przeładuj Obsidiana i włącz Game Sync.

Pełna obsługa połączeń, synchronizacji i pracy w tle jest sprawdzana na komputerze. Na telefonie synchronizacja w tle jest wyłączona.

Pierwsza konfiguracja

1. Uruchom Game Sync: Open Quick Setup z palety poleceń.
2. Wybierz źródło biblioteki.
3. Obejrzyj podgląd pierwszej synchronizacji.
4. Zastosuj zaakceptowane zmiany.

Domyślnym folderem jest Games/. Pierwsza synchronizacja nigdy nie zapisuje niczego po cichu.

Źródła danych

GameTrack

Wyeksportuj bibliotekę oficjalną funkcją eksportu w GameTrack, wybierz GameTrack jako źródło i wskaż plik ZIP. Import jest ręczny i tylko do odczytu: wtyczka nie sięga do prywatnej bazy aplikacji, nie wymaga Full Disk Access i nie zmienia eksportu.

Dla biblioteki z GameTrack możesz w ustawieniach dodatkowych włączyć odświeżanie aktywności i osiągnięć ze Steam oraz trofeów z PlayStation. Takie wzbogacanie aktualizuje tylko dopasowane gry i nie dodaje nowych.

Steam

Potrzebujesz oficjalnego klucza Steam Web API i profilu, którego biblioteka oraz Game Details są widoczne. W oknie połączenia podaj klucz oraz adres profilu, nazwę albo SteamID64. Klucz trafia do SecretStorage Obsidiana, nie do sejfu.

PlayStation

Okno połączenia otwiera oficjalną stronę logowania Sony i stronę z kodem. Po wklejeniu kodu wtyczka zapisuje sesję w SecretStorage. Jednorazowy kod nie jest przechowywany.

Notatki i properties

Game Sync zapisuje zwykłe notatki. Zarządza między innymi properties game-sync-id, steam-id, playstation-id i playtime. Nazwy properties można zmienić albo wyłączyć w ustawieniach.

• Czas gry jest zapisywany w minutach, postęp jako liczba 0-100, daty w formacie YYYY-MM-DD.
• Szablon działa tylko przy tworzeniu notatki. Dostępne klucze to między innymi title, released, description, cover, providers, playtime, lastPlayed, a helpery to join, hours, percent i date.
• Osiągnięcia trafiają do zarządzanego bloku. Reszta notatki należy do Ciebie:

%% game-sync:achievements %%
...
%% /game-sync:achievements %%

Osiągnięcia Steam i trofea PlayStation pozostają osobnymi danymi. Wtyczka nie wylicza wspólnego procentu, a ukryte osiągnięcia domyślnie nie zdradzają spoilerów.

Synchronizacja w tle

Domyślnie wyłączona. Interwały: 30 minut, 1, 6, 12 albo 24 godziny. W tle wykonywane są wyłącznie bezpieczne operacje. Konflikty, niepewne dopasowania i pierwsza synchronizacja zawsze czekają na Twoją decyzję w podglądzie.

Prywatność

Żądania idą bezpośrednio z Obsidiana do usług dostawców (api.steampowered.com, store.steampowered.com, ca.account.sony.com, web.np.playstation.com, m.np.playstation.com). Treść sejfu nie jest wysyłana. Raport diagnostyczny korzysta z listy dozwolonych pól i nie zawiera danych logowania, tokenów, odpowiedzi API ani treści notatek.

Ograniczenia

• jedno konto Steam i jedno konto PlayStation na sejf;
• brak bezpośredniej integracji z Xbox i historii zakupów;
• import GameTrack wymaga ręcznego wskazania eksportu;
• niepewne dopasowania pozostają do ręcznego przeglądu.

Najczęstsze problemy

• Steam nie zwraca gier. Sprawdź SteamID64, klucz API i widoczność profilu oraz Game Details, a potem uruchom Force refresh all data.
• PlayStation ponownie prosi o połączenie. Sesja wygasła albo została unieważniona. Połącz konto ponownie, notatki nie zostaną usunięte.
• Notatka nie zmieniła się. Sprawdź podgląd. Gra może być ignorowana albo czekać na decyzję o dopasowaniu. Nie wymuszaj scalenia, jeżeli nie masz pewności, że to ta sama gra.
• Zgłoszenie błędu. Użyj Copy diagnostic information, przejrzyj raport i zgłoś problem w GitHub Issues. Nie wklejaj danych logowania.

Wszystkie wtyczki i motywy · Strona główna