Diablo 2 Access 1.6 beta

Co nowego

• Mowa idzie teraz przez Prism. Wcześniej mod rozmawiał wprost z NVDA, a gdy NVDA nie działało, mówił syntezatorem Windows. Inne czytniki ekranu były poza zasięgiem. Prism stawia jeden interfejs przed NVDA, JAWS, ZoomText, SenseReader, PC-Talker, ZDSR, BoyPC Reader, SAPI i OneCore, i sam wybiera ten o najwyższym priorytecie, który naprawdę działa. Jeśli masz uruchomiony czytnik ekranu, mowa idzie przez niego; jeśli nie, przez syntezator Windows.
• Nic nie trzeba ustawiać. Po rozpakowaniu paczki obok D2AccessHook.dll leży prism32.dll i to wystarczy. Gdyby tego pliku zabrakło, mod nadal mówi syntezatorem Windows.
• Instalator D2AccessSetup.exe nosi Prism w sobie, więc dalej jest jednym plikiem do pobrania i też rozmawia z Twoim czytnikiem.

Prism udostępnia gotowe biblioteki tylko dla 64 bitów i ARM64, a mod działa wewnątrz 32-bitowego Game.exe, więc prism32.dll w tej paczce jest zbudowany ze źródeł. Dokładny przepis — wersja, commit i ustawienia budowania — jest w repozytorium w third_party/prism/README.md. Prism jest na licencji MPL 2.0; jej treść i lista kodu trzecich stron leżą w paczce jako PRISM-LICENSE.txt i PRISM-NOTICE.txt.

Znany drobiazg: ZDSR zgłasza błąd przy wyjściu łączącym mowę z brajlem, choć mówi poprawnie. Mod po pierwszym takim błędzie przechodzi na samą mowę i dalej działa normalnie.

Reszta funkcji bez zmian względem 1.5 beta.

---

What is new

• Speech now goes through Prism. The mod used to talk to NVDA directly and fall back to the Windows synthesizer, which left every other screen reader out of reach. Prism puts one interface in front of NVDA, JAWS, ZoomText, SenseReader, PC-Talker, ZDSR, BoyPC Reader, SAPI and OneCore, and picks the highest priority one that actually works. If you have a screen reader running, speech goes through it; if not, through the Windows synthesizer.
• Nothing to configure. After extracting the archive, prism32.dll sits next to D2AccessHook.dll and that is all it takes. If the file is missing, the mod still speaks with the Windows synthesizer.
• D2AccessSetup.exe carries Prism inside it, so it remains a single download and talks to your screen reader as well.

Prism publishes binaries for x64 and ARM64 only, and the mod runs inside a 32-bit Game.exe, so the prism32.dll in this archive is built from source. The exact recipe - version, commit and build settings - is in the repository under third_party/prism/README.md. Prism is licensed under MPL 2.0; the licence text and the list of third-party code ship here as PRISM-LICENSE.txt and PRISM-NOTICE.txt.

Known detail: ZDSR reports an error on the combined speech-and-braille output even though it speaks correctly. After the first such error the mod switches to plain speech and carries on.

Everything else is unchanged from 1.5 beta.

Diablo 2 Access 1.5 beta

Co nowego

• Strzałki w menu nie ruszają już postacią. W rozmowie z postacią niezależną, w dzienniku zadań, w drzewku umiejętności, na ekranie sterowania i w ekwipunku strzałki należą wyłącznie do menu. Wcześniej strzałka, której dane menu nie używało — na przykład w lewo i w prawo w rozmowie z NPC — albo strzałka na krańcu listy przechodziła do obsługi ruchu i postać robiła krok. To samo dotyczy przytrzymanej strzałki: teraz zatrzymuje się w chwili otwarcia menu.

• Enter nie otwiera już czatu. W Diablo II Enter jest przypisany do akcji „Rozmowa", a otwartej linijki czatu mod nie widzi: zjadała pierwsze Escape, więc z każdego menu trzeba było wychodzić dwa razy, a spacja („Wyczyść ekran") to naprawiała. Mod przy wejściu do gry usuwa to przypisanie w pamięci. Plik default.key zostaje nietknięty, więc bez moda czat wraca sam, a na czas ekranu „Konfiguracja sterowania" przypisanie wraca, bo gra zapisuje ten plik właśnie stamtąd.

• Identyfikowanie przedmiotów zwojem. Wybierz w plecaku zwój identyfikacji i naciśnij Shift + Enter. Mod powie „Wybierz przedmiot. Strzałki zmieniają pole, Enter zatwierdza, Escape anuluje.", a gra czeka wtedy na wskazanie przedmiotu. Strzałkami wybierz nierozpoznany przedmiot i naciśnij Enter — mod przeczyta jego nazwę już po identyfikacji, a spacja poda pełny opis z właściwościami magicznymi. Wcześniej Enter podnosił przedmiot na kursor zamiast go identyfikować.

• Control + Enter: kliknięcie w wybrane pole. Działa zawsze, dokładnie tak jak kliknięcie myszą, niezależnie od tego, co mod rozpoznaje. Przydaje się przy naprawie u kowala, wstawianiu klejnotów i personalizacji.

Znany błąd: zakładanie broni i zbroi przez Shift + Enter prosto z plecaka kończy się komunikatem „Nie można tego zrobić". Błąd jest starszy od tego wydania. Dłuższa droga działa: podnieś przedmiot Enterem, strzałką w górę przejdź do założonych przedmiotów, wybierz miejsce i naciśnij Enter.

---

What is new

• Arrows in a menu no longer walk the character. In an NPC conversation, the quest log, the skill tree, the controls screen and the inventory the arrows belong to the menu alone. Before, an arrow the menu had no use for — left and right in an NPC conversation, for instance — or an arrow at the end of a list fell through to the movement code and the character took a step. A held arrow now stops the moment a menu opens.

• Enter no longer opens the chat line. Diablo II binds Enter to its Chat action, and the mod cannot see the chat line that opens: it swallowed the first Escape, so leaving any menu took two presses and Space ("Clear screen") was the cure. The mod now clears that binding in memory when a game starts. The default.key file on disk is left alone, so the binding is back whenever you play without the mod, and it is restored while the controls screen is open, because the game saves that file from there.

• Identifying items with a scroll. Select a scroll of identify in the backpack and press Shift + Enter. The mod says "Choose an item. The arrows move, Enter confirms, Escape cancels." and the game waits for a target. Choose the unidentified item with the arrows and press Enter: the mod reads its name once it is identified, and Space gives the full description with its magic properties. Before, Enter picked the item up onto the cursor instead of identifying it.

• Control + Enter clicks the chosen slot. It always works, exactly like a mouse click, whatever the mod recognises — useful for repairing at the blacksmith, socketing gems and personalizing.

Known issue: equipping weapons and armor with Shift + Enter straight from the backpack ends with "Cannot do that.". The bug is older than this release. The long way works: pick the item up with Enter, go up to the equipped items, choose the slot and press Enter.

Diablo 2 Access 1.4 beta

Co nowego

• Zwiedzanie lokacji pod ukośnikiem. Mod zapamiętuje, gdzie postać już była, a klawisz / podaje drogę do najbliższego miejsca, którego jeszcze nie zwiedziłeś — w krokach, dokładnie tak samo jak Home podaje drogę do celu. Na otwartym terenie brzmi to na przykład „Najbliższe nieodkryte miejsce: wschód 7", a w lochu mod poprowadzi wokół ścian: „Najbliższe nieodkryte miejsce: południe 2, zachód 1, południe 1, zachód 1, południe 3".
  • Szukanie idzie po polach, po których da się przejść, więc wskazane miejsce zawsze jest osiągalne, a nie odcięte ścianą.
  • Działa tak samo w lochach i na otwartych terenach, jak Krwawe Wrzosowisko.
  • Gdy drogi nie da się wyznaczyć, mod poda sam kierunek i odległość w krokach.
  • Gdy cała okolica jest już zwiedzona, usłyszysz „Nie znaleziono nieodkrytych obszarów" — wtedy przejdź kawałek dalej i naciśnij ukośnik ponownie.
  • Pamięć zwiedzonych miejsc czyści się przy każdej zmianie lokacji.

W modzie Diablo Access podobna funkcja działa wyłącznie w lochach, bo korzysta z gotowej flagi silnika. Diablo II takiej flagi nie ma, więc mod prowadzi własną mapę zwiedzonych pól — dzięki temu działa również na otwartych obszarach z przejściami.

---

What is new

• Exploring an area with the slash key. The mod remembers where the character has already been, and / reads the way to the nearest place you have not explored yet, counted in steps exactly as Home counts the way to a target. Outdoors it sounds like "Nearest unexplored space: east 7", and in a dungeon it leads around the walls: "Nearest unexplored space: south 2, west 1, south 1, west 1, south 3".
  • The search walks over cells the character can actually cross, so the place it names is always reachable rather than cut off by a wall.
  • It works the same in dungeons and in open areas such as the Blood Moor.
  • When no path can be worked out, the mod gives the plain direction and the distance in steps.
  • When everything around is explored you hear "No unexplored areas found" — walk on a little and press slash again.
  • The record of explored places is cleared whenever you change area.

Diablo Access has a similar key for dungeons only, because it uses the engine's own Explored flag. Diablo II has no such flag, so the mod keeps its own map of visited tiles, which is why this also works in open areas.

Diablo 2 Access 1.3 beta

Co nowego

• Mod sam zapowiada potwory. Gdy potwór pojawi się w pobliżu, mod od razu poda jego nazwę, na przykład „Potwory: Upadły, Zombie". Przy większej grupie wymienia trzy pierwsze i dodaje, ile jest pozostałych. Nie trzeba już naciskać Page Down, żeby się dowiedzieć, że coś nadchodzi, a zapowiedź obejmuje cały zasięg, w jakim gra trzyma potwory — czyli dalej, niż słychać dźwięki otoczenia.

Dlaczego nie „dalszy radar"

Sprawdziłem to pomiarem w grze: lista celów nie ma żadnego ograniczenia odległości i pokazuje dokładnie tyle, ile gra ma wczytane. Potwory powstają dopiero wtedy, gdy wczyta się fragment poziomu, w którym stoją — na Krwawym Wrzosowisku sięgało to około dwudziestu dwóch kroków, podczas gdy dźwięki otoczenia mają promień dwunastu. Rozmieszczenie zapisane na mapie też nie pomoże: na tym samym poziomie mapa zna 502 obiekty, ale tylko 2 potwory, bo zwykłe potwory są losowane przy wczytywaniu. Dlatego zamiast podnosić limit, którego nie ma, mod zgłasza potwory, gdy tylko gra je utworzy.

---

What is new

• The mod announces monsters by itself. When a monster shows up nearby, the mod names it at once, for example "Monsters: Fallen, Zombie". For a larger group it names the first three and adds how many others there are. There is no need to press Page Down to learn that something is coming, and the announcement covers the whole range in which the game keeps monsters — further than the surrounding sounds carry.

Why not "a longer radar"

Measured in the game: the target list has no distance limit at all and shows exactly what the game has loaded. Monsters only come into being once the part of the level they stand in is loaded, which in the Blood Moor reached about twenty-two steps, while the sound cues carry twelve. The layout stored in the map does not help either: on that level the map knows 502 objects but only 2 monsters, because ordinary monsters are rolled when a room loads. So instead of raising a limit that does not exist, the mod reports monsters as soon as the game creates them.

Diablo 2 Access 1.2 beta

Co nowego

• Umiejętności bojowe pod klawiszem S. Do tej pory klawisz F zawsze uderzał bronią, bo moda nie dało się przełączyć na umiejętność. Teraz S przechodzi po umiejętnościach, które postać już zna, i ustawia wybraną do ataku. Mod czyta nazwę, poziom i pozycję na liście, na przykład „Zamach, poziom 1. 1 z 2. F używa tej umiejętności". Każde naciśnięcie F atakuje wskazanego potwora tą umiejętnością.
  • S: następna umiejętność,
  • Shift + S: poprzednia,
  • Control + S: powrót do zwykłego ataku bronią.
  • Na liście są tylko umiejętności z wydanym punktem (albo dodane przez przedmioty), które da się trzymać w ręce. Umiejętności bierne i aury działają same z siebie i gra nie pozwala ich wybrać, więc mod ich nie proponuje.

Poprawki

• Dziennik zadań zabierał strzałki innym panelom. Przy pewnym stanie gry mod uznawał dziennik za otwarty, choć był zamknięty. Skutek: w drzewku umiejętności strzałki mówiły „To jedyny dostępny akt" zamiast przechodzić po umiejętnościach. Naprawione.
• Opis śmierci w instrukcji był mylący. Zwłoki zostają tam, gdzie postać zginęła, a nie zawsze w mieście. Jeśli zginęła w lochu, po ekwipunek trzeba tam wrócić, bo mod pokazuje cele tylko z lokacji, w której właśnie jesteś.

Przypomnienie

Nie wybieraj w menu głównym opcji BATTLE.NET. Uruchamia ona aktualizator Blizzarda, który psuje pliki gry, a nowsza wersja gry nie działa z modem. Asystent instalacji sam wyłącza ten aktualizator.

---

What is new

• Combat skills under S. Until now F always swung the weapon, because there was no way to switch to a skill. S now walks through the skills the character knows and puts the chosen one into the attack. The mod reads its name, level and place in the list, for example "Bash, level 1. 1 of 2. F uses this skill." Every press of F then attacks the selected monster with it.
  • S: next skill,
  • Shift + S: previous one,
  • Control + S: back to the normal weapon attack.
  • The list holds only skills with a point in them (or granted by items) that the game lets you hold in a hand. Passive skills and auras work on their own and cannot be chosen, so the mod leaves them out.

Fixes

• The quest log stole the arrow keys. In one game state the mod treated the closed quest log as open, so in the skill tree the arrows said "This is the only act you can open" instead of moving through the skills. Fixed.
• The death section of the guides was misleading. The corpse waits where the character died, not always in town. If that was a dungeon, you have to go back there for the equipment, because the mod only lists targets from the area you are in.

Reminder

Do not choose BATTLE.NET in the main menu. It starts Blizzard's updater, which breaks the game files, and the newer game version does not work with the mod. The setup assistant disables that updater for you.

Diablo 2 Access 1.1 beta

Co nowego

• Rozmowy z postaciami niezależnymi. Menu rozmowy reaguje teraz na klawiaturę: strzałki w górę i w dół wybierają odpowiedź, Enter ją zatwierdza, Escape zamyka. Wcześniej strzałki przesuwały postać i nie dało się nic wybrać.
• Zakładanie przedmiotów jednym klawiszem. Shift + Enter na broni albo zbroi w plecaku zakłada ją od razu w odpowiednim miejscu. Mod potwierdza: „Założono:" i nazwę. Dotychczasowy sposób z podniesieniem przedmiotu i wyborem miejsca działa jak dawniej.
• Dziennik zadań pod klawiszem Q. Mod czyta akt i wybrane zadanie razem z opisem, na przykład „Siedlisko Zła. Szukaj Siedliska Zła w dziczy poza Obozowiskiem Łotrzyc". Strzałki w górę i w dół wybierają zadanie, w lewo i w prawo zmieniają akt, Spacja powtarza, Q zamyka.
• Konfiguracja sterowania jest wreszcie dostępna. Ekran z listą akcji czyta nazwę akcji oraz klawisz główny i zapasowy. Strzałki wybierają akcję, w lewo i w prawo przełączają klawisz główny i zapasowy, Enter przypisuje nowy klawisz, Tab przechodzi do przycisków na dole.
• Ochrona przed zepsuciem gry. Launcher sprawdza wersję gry i nie uruchomi moda z inną niż 1.14b, a asystent instalacji wyłącza aktualizator Blizzarda.

Ważne: nie wybieraj opcji BATTLE.NET

Ta opcja uruchamia aktualizator Blizzarda, który kasuje plik patch_d2.mpq, po czym przerywa pracę i zostawia grę, która wysypuje się przy starcie komunikatem „Diablo II Exception: ACCESS_VIOLATION". Gra przez Battle.net wymaga wersji 1.14d, której mod nie obsługuje.

Jeśli to już się stało, skopiuj patch_d2.mpq (około 8 MB) z powrotem do folderu gry z nośnika instalacyjnego albo z innej kopii gry.

Instalacja

Pobierz D2AccessSetup.exe i uruchom go. Asystent przeprowadzi przez instalację gry, a potem pobierze i zainstaluje moda. Gdy gra jest już zainstalowana, od razu instaluje albo aktualizuje sam mod. Paczka diablo-2-access-1.1-beta-windows.zip zawiera te same pliki do ręcznego rozpakowania do folderu gry.

---

What is new

• Talking to NPCs. The conversation menu answers to the keyboard now: up and down arrows choose the option, Enter selects it, Escape closes it. Until now the arrows walked the character and no choice could be made.
• Equipping with one shortcut. Shift + Enter on a weapon or a piece of armor in the backpack puts it straight into the slot it belongs to, and the mod says "Equipped:" and its name. The old way, picking the item up and choosing the slot, still works.
• Quest log on Q. The mod reads the act and the selected quest together with its text. Up and down arrows choose a quest, left and right change the act, Space repeats it, Q closes the log.
• Configure controls is accessible. The screen reads every action with its primary and secondary key. Arrows choose the action, left and right switch between the two keys, Enter assigns a new key and Tab moves to the buttons at the bottom.
• Protection against breaking the game. The launcher checks the game version and refuses anything but 1.14b, and the setup assistant disables Blizzard's updater.

Important: do not choose BATTLE.NET

It starts Blizzard's updater, which deletes patch_d2.mpq and then fails, leaving a game that dies at start-up with "Diablo II Exception: ACCESS_VIOLATION". Playing on Battle.net needs version 1.14d, which the mod does not support.

If it already happened, copy patch_d2.mpq (about 8 MB) back into the game folder from your installation media or another copy of the game.

Installing

Download D2AccessSetup.exe and run it. The assistant guides you through installing the game and then downloads and installs the mod. When the game is already installed, it installs or updates just the mod. The diablo-2-access-1.1-beta-windows.zip package holds the same files for extracting into the game folder by hand.

Diablo 2 Access 1.0 beta

Pierwsze wydanie beta moda dostępności do klasycznego Diablo II 1.14b dla osób niewidomych. / First beta of the accessibility mod for blind players of classic Diablo II 1.14b.

Instalacja z asystentem (zalecana)

1. Pobierz D2AccessSetup.exe z tego wydania i uruchom go.
2. Asystent przeprowadzi Cię przez oryginalny instalator Diablo II, czytając jego okna. Sam wybiera instalację w graficznym menu i akceptuje umowę licencyjną po Twojej zgodzie. Klucz CD wpisujesz sam; grę kupisz w Battle.net.
3. Po instalacji gry asystent pobiera z GitHuba najnowsze wydanie moda i instaluje je w folderze gry. Gdy gra jest już zainstalowana, asystent od razu instaluje albo aktualizuje moda.
4. Grę z modem uruchamiasz plikiem D2AccessLauncher.exe z folderu gry.

Do instalacji ręcznej służy paczka diablo-2-access-1.0-beta-windows.zip: rozpakuj ją do folderu gry. Pełna instrukcja jest w folderze docs.

Installation with the assistant (recommended)

1. Download D2AccessSetup.exe from this release and run it.
2. The assistant guides you through the original Diablo II installer, reading its windows aloud. It chooses Install in the graphical menu and accepts the licence agreement after you agree. You type the CD-key yourself; the game is sold on Battle.net.
3. After the game is installed, the assistant downloads the newest mod release from GitHub and installs it into the game folder. When the game is already installed, it installs or updates the mod right away.
4. Start the game with the mod using D2AccessLauncher.exe in the game folder.

For a manual installation, extract diablo-2-access-1.0-beta-windows.zip into the game folder. The full user guide is in the docs folder.

Co zawiera / What is included

• Mowa przez NVDA albo syntezator Windows, po polsku lub angielsku według języka gry. / Speech through NVDA or the Windows synthesizer, in Polish or English following the game language.
• Menu główne, wybór postaci (także usuwanie klawiszem Delete), tworzenie postaci. / Main menu, character selection (including Delete), character creation.
• Tracker celów w kategoriach, opis drogi w krokach, automatyczny marsz i interakcja jak w Diablo Access. / Target tracker by category, step-based path description, auto-walk and interaction as in Diablo Access.
• Dźwięki zbliżeniowe identyczne jak w Diablo Access. / Proximity sound cues identical to Diablo Access.
• Karta postaci, ekwipunek z opisami przedmiotów, drzewko umiejętności jako drzewo, menu gry i opcje. / Character sheet, inventory with item descriptions, skill tree as a tree view, game menu and options.
• Rozmowy z NPC, komunikaty o śmierci i odzyskiwanie zwłok. / NPC dialogs, death announcements and corpse recovery.

Znane ograniczenia / Known limitations

• Tylko Game.exe w wersji 1.14b. / Game.exe 1.14b only.
• Asystent instalacji był sprawdzany do okna klucza CD, a instalacja moda do folderu gry w całości; wybór folderu, postęp instalacji gry i instalator Lord of Destruction nie były jeszcze sprawdzone. / The installation assistant was tested up to the CD-key window and the mod installation fully; the folder choice, game installation progress and the Lord of Destruction installer are not tested yet.
• Ekran konfiguracji klawiszy w opcjach nie jest jeszcze udostępniony. / The key configuration screen is not accessible yet.
• To wersja beta: zgłaszaj błędy razem z plikami D2AccessSetup.log lub D2AccessHook.log. / This is a beta: please report problems together with D2AccessSetup.log or D2AccessHook.log.