FVTT-NOE

*Nieoficjalna konwersja Neuroshima Ostatnia Era (świat Za Garść Gambli) na silnik dnd5e we FoundryVTT.*

English speakers: this is a Polish-language fan module for a Polish-language RPG line, so player-facing docs here are Polish by design. If you're here to work on the code, start with DEVGUIDE.md, ARCHITECTURE.md, TESTING.md, RELEASING.md, and CONTRIBUTING.md — all in English.

---

O projekcie

FVTT-NOE to zestaw nakładek na system dnd5e, które zamieniają go w silnik zasad Neuroshima Ostatnia Era — polskości, terminologii, cech, umiejętności, obrażeń, ekwipunku, klas, stanów i mechanik przetrwania włącznie. Nie jest to osobny system FoundryVTT — to moduł, który modyfikuje dnd5e „w locie".

To projekt fanowski i niekomercyjny, niezwiązany z Portal Games i nieoficjalny. Nie dystrybuuje treści książki poza tym, co niezbędne do rozgrywki (statystyki, zasady, terminologia) — zobacz CREDITS.md.

Podziękowania

Marcin „Nicram” Kubiesa — autor mechaniki Neuroshima Ostatnia Era. Ten moduł stoi na jego zasadach, a tam, gdzie podręcznik milczy albo jest jeszcze w alfie, także na jego wyjaśnieniach, rozstrzygnięciach i pomysłach z rozmów — od podziału magazynków po zasady, które dopiero powstaną. Dziękujemy raz, tutaj, za wszystkie: w kodzie takie fragmenty są oznaczone jako intencja autora (RAI), bez powtarzania nazwiska przy każdym z osobna. Lista tych rozstrzygnięć: scripts/wkk/README.md.

Status projektu

Alfa. Walka, broń i amunicja, stany, choroby, odpoczynki, podróż i przetrwanie działają i są używane przy żywym stole. Produkcja przedmiotów i naprawa są świeże — jeszcze nie ograne przy stole. Nie ma jeszcze towarzyszy i dronów, szabrowania, handlu ani większości zasad pojazdów; większość zdolności klas to na razie sam tekst. Można się spodziewać zmian w danych między wersjami. Co jest zrobione — macierz w IMPLEMENTATION.md; co trzeba zrobić, żeby wydać betę — PLANbeta.md.

Wymagania

| Komponent | Wersja | |---|---| | FoundryVTT | v14+ | | System dnd5e | 5.3.x |

Instalacja w jednym kroku

1. W FoundryVTT: Add-on Modules → Install Module.
2. Wklej w pole „Manifest URL":

`` https://github.com/jjanisze/FVTT-NOE/releases/latest/download/module.json ``

1. Install, potem włącz moduł w świecie opartym o system dnd5e.

Pełna instrukcja (metoda ręczna, aktualizacje, deinstalacja, typowe błędy) — docs/Instalacja.md.

Modpack — jak grać w to samo, co autor

FVTT-NOE zakłada konkretny zestaw modułów i konfigurację, a nie tylko sam override. Do pełnego doświadczenia (dźwięk pozycyjny, VFX strzałów, krew na scenach) dodaj te dwa:

| Moduł | Rola | Status | |---|---|---| | Sequencer | Silnik VFX/SFX (muzzle flash, tracery, dźwięk pozycyjny) — moduł go wykorzystuje, jeśli jest obecny | Zalecany (opcjonalna zależność w module.json) | | Splatter (theripper93) | Ambientowe plamy krwi napędzane obrażeniami aktorów, dobiera kolory wg typu istoty | Zalecany |

Zainstaluj je tak samo jak każdy inny moduł FoundryVTT (manifest URL / sklep modułów), włącz razem z tym modułem w tym samym świecie. Bez nich moduł nadal działa — po prostu bez efektów, które od nich zależą.

Dokumentacja / podręcznik

Początek podręcznika użytkownika (po polsku) — docs/:

• Instalacja
• Pierwsze kroki
• Czym różni się od dnd5e
• Kolor Kobaltu
• FAQ

To dopiero początek — pełny, gęsty opis każdej mechaniki na razie mieszka w IMPLEMENTATION.md (dziennik zmian dewelopera, gęściejszy i mniej uporządkowany, ale kompletny).

Zgłaszanie błędów

Coś nie działa, tłumaczenie jest błędne, zasada nie zgadza się z podręcznikiem? Zgłoś przez GitHub Issues. W zgłoszeniu podaj:

• wersję FoundryVTT, wersję systemu dnd5e i wersję tego modułu (Add-on Modules),
• kroki, które prowadzą do problemu,
• jeśli to błąd wyświetlany w konsoli — treść błędu (F12 → Console),
• co się miało stać, a co się stało.

Szczegóły procesu (dla osób chcących też zaproponować poprawkę w kodzie) — CONTRIBUTING.md.

Licencja i źródła zasobów

Kod i dokumentacja modułu — licencja MIT, patrz LICENSE. Dźwięki, ikony, grafika żetonów i treść wywiedziona z Neuroshima Ostatnia Era mają odrębne źródła i warunki — pełna lista w CREDITS.md.

Ten projekt powstaje w dużej mierze przy pomocy AI — kod i dokumentacja przy udziale Claude Code, część ikon wygenerowana przez Gemini/ChatGPT (szczegóły w CREDITS.md). Właśnie dlatego moduł nie trafia do oficjalnego sklepu modułów FoundryVTT — jest dostępny wyłącznie tutaj, na GitHubie, jawnie opisany, żeby każdy mógł ocenić, co dostaje. Zgłoszenia i uwagi są jak najbardziej mile widziane.

Dla deweloperów

• DEV_GUIDE.md — środowisko, ścieżki, konwencje pracy nad modułem.
• ARCHITECTURE.md — inwarianty i decyzje architektoniczne (dlaczego coś jest

zrobione tak, a nie inaczej).

• TESTING.md — testy w Foundry przez Quench, npm run validate:tests.
• RELEASING.md — jak wychodzi nowa wersja (tag → GitHub Release → manifest URL).
• CONTRIBUTING.md — jak zgłosić błąd / zaproponować zmianę w kodzie.