Wtyczki i motywy do Obsidiana

Game Sync: dokumentacja

Ta sama gra na Steamie, na PlayStation i w GameTrack to trzy listy, trzy liczniki godzin i żadnego miejsca na notatkę „utknąłem w trzecim rozdziale, spróbować inną postacią”. Game Sync robi z tego jedną notatkę na grę.

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.

Wtyczka działa tylko na komputerze. Wybór pliku z GameTrack i odczyt eksportu korzystają z Electrona, więc na telefonie i tablecie się nie instaluje.

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

Wybierz Sign in to PlayStation i zaloguj się na stronie Sony w osobnym oknie, a potem wybierz Finish connecting. Nie trzeba kopiować żadnego kodu. Wtyczka zapisuje sesję w SecretStorage i sama odświeża tokeny dostępu. Okno logowania zamyka się, gdy nawigacja wyjdzie poza domeny Sony i PlayStation.

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:

...

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