Dokumentacja systemu

Dział 02 · Karta live

Karta postaci v10

Jedno miejsce, w którym spotykają się mechanika bohatera, wyposażenie, magia, stan podczas gry i informacje zebrane w świecie. Karta pokazuje dane przypisane do konkretnej postaci i pozwala bezpiecznie przekazywać do MG dozwolone zmiany.

kanoniczny stan JSONrole gracz / MGwersjonowany zapis
1

Czym jest karta v10

Karta v10 nie jest tylko obrazkiem ani formularzem HTML. Widoczna strona jest interfejsem do uporządkowanego rekordu postaci. Źródłem stanu jest karta zapisana jako dane, a interfejs układa je w czytelne moduły, wykonuje dozwolone obliczenia i wysyła zatwierdzone zmiany do serwera kart.

Po chargenie

Zamrożony punkt odniesienia

Po finalizacji pozostaje zaakceptowany snapshot postaci. Jest dowodem tego, z czym bohater zakończył tworzenie i rozpoczął grę.

Podczas gry

Zmienny stan live

Żywotność, rany, zapasy, monety, notatki i inne elementy mogą zmieniać się w trakcie kampanii. Stan live rozwija się oddzielnie, bez nadpisywania dowodu finalizacji chargenu.

2

Droga danych

1Chargenzaakceptowany bohater
2Karta v10struktura i moduły
3Walidacjakontrola pakietu
4Import do MGprzejęcie postaci
5Stan livezmiany w kampanii

Sama zgodność struktury v10 nie rozstrzyga całego balansu mechanicznego. Legalność wyborów sprawdzają wcześniej zasady chargenu i walidatory, a w trakcie gry — właściwy profil MG oraz źródła prawdy kampanii.

3

Jak otworzyć kartę

Wejdź na stronę kart live

Otwórz rpgcards.uk. Każdy użytkownik korzysta z własnego tokenu dostępu.

Wklej token i połącz się

Serwer rozpoznaje rolę oraz pokazuje wyłącznie karty przypisane do tego dostępu. Token gracza nie daje dostępu do cudzych postaci.

Token jest kluczem do karty — nie należy go udostępniać innym osobom.

Otwórz właściwą postać

Loader pobiera aktualną wersję karty z serwera i zapisuje jej kopię roboczą w tej przeglądarce. Następnie otwiera właściwy interfejs v10.

Zakończ pracę przez wylogowanie

Opcja „Wyloguj / zmień kartę” usuwa z przeglądarki zapamiętany token i lokalne dane kart. Niezapisane lokalne zmiany zostaną utracone.

4

Co zawiera karta

Zakres modułów zależy od postaci i użytego wariantu interfejsu. Karta pokazuje tylko elementy, które mają zastosowanie do danego bohatera.

Tożsamość i charakterImię, pochodzenie, wygląd, opis, cele, tło i informacje fabularne.
Statystyki i wartości pochodneGłówne cechy, modyfikatory oraz wartości używane w testach i walce.
Żywotność, EZ i ranyAktualne oraz maksymalne pule, stany, kondycja i zapis obrażeń.
Umiejętności i biegłościPoziomy, podstawy testów, specjalizacje i kompetencje postaci.
Broń, pancerz i tarczeParametry, materiały, obrażenia, ochrona, opisy i przypisane modyfikatory.
Ekwipunek i obciążeniePrzedmioty noszone, torby, sakwy, zapasy, woda, żywność oraz rozłożenie ciężaru.
Monety i zasobyStan walut, wpisy monet i wynikająca z nich waga.
Zwierzęta i transportWierzchowce, juki, pojemniki i przedmioty przewożone poza ekwipunkiem osobistym.
Magia v10PM, dziedziny, umiejętności magiczne, składniki i spellbook — jeśli postać używa magii.
Notatki, tropy i NPCNotatki z wyprawy, poznane informacje oraz istotne postacie spotkane podczas gry.

Zobacz kartę ekran po ekranie

Przygotowaliśmy statyczny wzorzec z adnotacjami oraz pełną lokalną kartę demonstracyjną Sairana. Pierwszy widok wyjaśnia każdy moduł, a drugi odtwarza interfejs widoczny po logowaniu i zapisuje zmiany wyłącznie w przeglądarce. Wzorzec z adnotacjami → · Pełna karta demo →

5

Obliczenia i zależności

Automatyka

Karta pomaga liczyć

Interfejs może przeliczać między innymi wartości pochodne, modyfikatory pancerza i broni, sumy monet, wagę zapasów oraz obciążenie. Zmiana jednego elementu może wpłynąć na kilka widoków.

Źródło prawdy

Automatyka nie zmienia zasad

Wyliczenia prezentują aktywne reguły karty, lecz nie tworzą nowych zdolności ani wyjątków. Gdy wynik wymaga decyzji mechanicznej, rozstrzyga ją MG zgodnie z zasadami kampanii.

6

Gracz, MG i uprawnienia

Gracz

  • widzi wyłącznie przypisane mu karty;
  • otrzymuje widok oczyszczony z pól prywatnych;
  • może zapisywać notatki gracza i dozwolone pola opisowe;
  • może edytować dodatkowe moduły tylko wtedy, gdy pozwala na to karta lub MG;
  • nie może zmieniać statystyk ani pól zastrzeżonych.

Mistrz Gry

  • zarządza kanonicznym stanem postaci;
  • może zmieniać mechanikę i stan wymagany przez przebieg gry;
  • kontroluje zakres edycji dostępny graczowi;
  • otrzymuje pełny autoryzowany widok karty;
  • przejmuje odpowiedzialność za postać po handoffie.

Ochrona działa po stronie serwera. Nawet jeśli ktoś zmodyfikuje stronę w narzędziach przeglądarki, niedozwolone pola nie powinny zostać przyjęte do kanonicznego stanu.

7

Jak działa zapis

1KOPIA LOKALNAinterfejs aktualizuje roboczy stan w przeglądarceROBOCZE
2ZAPISZ DO MGkarta wysyła dane wraz z numerem aktualnej wersjiJAWNE
3FILTR UPRAWNIEŃbackend przyjmuje dozwolone pola i blokuje pozostałeWYMAGANE
4KONTROLA WERSJIstarsza kopia nie może nadpisać nowszego stanuWYMAGANE
5SNAPSHOT + AUDYTprzed zmianą powstaje kopia, a zapis trafia do historii operacjiAUTOMATYCZNE
Co oznacza komunikat o konflikcie wersji?

Od otwarcia karty stan na serwerze został zmieniony przez MG albo inny autoryzowany proces. System odrzuca zapis, aby nie utracić nowszych danych. Należy ponownie otworzyć kartę, sprawdzić aktualny stan i dopiero wtedy powtórzyć własną zmianę.

Co oznacza liczba zablokowanych pól?

Przeglądarka wysłała różnice, których dana rola nie może zapisać. Backend pozostawił te pola bez zmian i raportuje, ile prób zostało odrzuconych.

8

Narzędzia lokalne a zapis online

Niektóre warianty karty pokazują przyciski Eksport, Import lub Reset. Operują one przede wszystkim na kopii w przeglądarce. Nie omijają uprawnień serwera i nie zastępują przycisku „Zapisz do MG”. Przed resetem lub wylogowaniem trzeba upewnić się, że ważne zmiany zostały zapisane.

9

Magia na karcie v10

Dla postaci magicznych karta przechowuje zaakceptowany model startowy, PM, dziedziny lub segmenty, umiejętności rzucania, składniki oraz uporządkowany spellbook.

Kanoniczność

Czary z katalogu

Każdy czar pochodzi z aktywnego katalogu i ma jednoznaczne ID. Karta nie jest miejscem do dopisywania własnych czarów ani omijania walidacji chargenu.

Dokładność

PM i składniki

Końcowa karta zachowuje wynik PM wraz z wymaganym pochodzeniem obliczeń oraz dane składników potrzebne do działania interfejsu i mechaniki.

10

Dobra praktyka gracza

Otwieraj kartę przez stronę logowania

Dzięki temu loader pobierze aktualną wersję przypisaną do Twojego tokenu.

Sprawdź komunikat zapisu

Po kliknięciu „Zapisz do MG” upewnij się, że operacja zakończyła się powodzeniem i czy jakieś pola zostały zablokowane.

Nie nadpisuj konfliktu na siłę

Gdy serwer zgłasza nowszą wersję, odśwież kartę. Konflikt chroni zmiany wprowadzone wcześniej przez MG.

Wyloguj się na obcym urządzeniu

Wylogowanie usuwa lokalny token i kopie kart z tej przeglądarki.

11

Najczęstsze pytania

Czy karta v10 aktualizuje się jak wspólny dokument w czasie rzeczywistym?

Nie jest edytorem współdzielonym przez WebSocket. Pobiera aktualny stan przy otwarciu, a zapis przechodzi jawnie przez serwer i kontrolę wersji. Gdy stan zmieni się równolegle, ochrona konfliktu wymaga ponownego wczytania.

Czy gracz może zmienić statystyki przez edycję HTML?

Nie. Serwer traktuje statystyki jako pola zastrzeżone. Zmiana wyglądu strony lub lokalnej kopii nie daje uprawnienia do zapisu tych danych.

Czy MG widzi to samo co gracz?

MG ma szerszy autoryzowany widok i uprawnienia. Odpowiedź dla gracza jest oczyszczana z pól prywatnych oraz technicznych.

Czy karta zastępuje zasady i decyzje MG?

Nie. Karta porządkuje stan i wykonuje wdrożone obliczenia. Interpretacja zasad, konsekwencje scen oraz legalne zmiany mechaniczne należą do właściwego MG.

Czy można odzyskać stan sprzed błędnego zapisu?

Każda rzeczywista zmiana serwerowa tworzy snapshot poprzedniego stanu i wpis audytowy. Odzyskanie wykonuje operator lub MG po sprawdzeniu historii.

+

Następny dział

Przekazanie do MGJak zwalidowany pakiet postaci trafia do właściwego profilu MG i kiedy rozpoczyna się gra.
RozgrywkaDeklaracje, testy, konsekwencje i aktualizacja stanu live.
WalkaInicjatywa, tury, obrażenia, obrona, rany i śmierć postaci.