Przejdź do treści
Biblioteka skilli
Programowanie · Analiza

d2r-debug

/d2r-debug

Diagnozuje błędy modyfikacji Diablo II Resurrected na podstawie logów i zrzutów pamięci, od objawów do przyczyn.

Repozytorium
d2rAI-toolkit ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Diagnozuje błędy modyfikacji Diablo II Resurrected na podstawie logów i zrzutów pamięci, od objawów do przyczyn.

Wyzwalacze z opisu

crasheddoesncharacter disappearedlooks wrong
Oryginalny opis (EN)

Diagnose a Diablo II Resurrected mod that crashes, asserts, hangs, shows the wrong thing, or loses characters - read D2RLoader/D2R logs and crash dumps, map symptoms to causes, and bisect. Use whenever the user reports the mod "crashed", "doesn't load", "character disappeared", "looks wrong" or a skill/item/UI misbehaves in game.

Jak działa

  1. Where to look (newest first)
  2. Symptom -> usual cause
  3. Bisect
Sekcje z nagłówków SKILL.md, w oryginale · 49 linii, 534 słów
Podgląd SKILL.md
---
name: d2r-debug
description: Diagnose a Diablo II Resurrected mod that crashes, asserts, hangs, shows the wrong thing, or loses characters - read D2RLoader/D2R logs and crash dumps, map symptoms to causes, and bisect. Use whenever the user reports the mod "crashed", "doesn't load", "character disappeared", "looks wrong" or a skill/item/UI misbehaves in game.
---

# Debug a D2R mod

The user tests; you diagnose from files. Don't ask them to describe a crash: read the logs.

A crash report with an address (`D2R.exe+0x...`, a last-resort report): use the `d2r-crash` skill and
knowledge/crash-triage.md. Loader-side surprises (another `default_mod`, the cache-building first start, other
plugins, stored key bindings): knowledge/d2rloader.md. A plugin change that breaks multiplayer, item moves or the
weapon swap: knowledge/network-messages.md (refused requests get no reply; an oversized item record is sent empty).

## Where to look (newest first)
- `<game>/d2rloader/logs/d2rloader.log`: load steps and **asserts after "startup complete"** (data errors name
  the table and row).
- `<game>/d2rloader/crashes/*.log`: crash reports with the faulting RVA. Map the RVA to a function in Ghidra
  (`Decompile.java <rva>`), then to a table column it reads.
- `%LOCALAPPDATA%\CrashDumps\D2RLoader.exe.<pid>.dmp` (or D2R.exe): crashes without a report.
- `<game>/blz-log.txt`: D2R's own session log (missing files like `[default_unit]`, string and asset warnings).
- `<game>/mods/<Mod>/d2rloader/logs/<plugin>.log`: your plugin's lines.
- Hangs: dump the busy thread (MiniDumpWriteDump) a few times; repeated instruction pointers mark the loop.

## Symptom -> usual cause
See knowledge/debugging.md for the full table. Most common:
- **Skill plays the knockback/get-hit animation**: `anim` = `GH` (get hit) instead of `SQ`; or plrmode Code changed.
- **Crash the moment a sequence skill is used**: anim `SQ` but the mode lookup failed (plrmode/monmode codes must
  stay D2R's: SQ, KB).
- **Skill animates in classic but not HD**: no HD state for its skill ID (anim SQ) - `hd_sequence` op.
- **Missile invisible in HD**: no missiles.json entry - `missile_hd` op.
- **No HD aura/overlay effect**: overlay.txt `Character` empty (it names the HD overlay folder).
- **Item picture missing / vendor crash**: base item code missing from data/hd/items/items.json - `item_hd` op.
- **Character missing from character select**: the save no longer matches (checksum, .d2rl hashes, or more class
  skills than the save format holds). Restore the backup; edit saves only with `modkit save-set`.
- **Load assert about states or level types**: engine limits (knowledge/engine-limits.md); needs a plugin or fewer rows.
- **Strings crash on a message**: a key D2R formats itself got different `%s/%d` placeholders.
- **Crash or hang on picking up / wearing one item type** (assert ItemMode.cpp:676): itemtypes ids shifted; D2R's
  rows must keep D2R's numbers (`warl` 67).
- **Crash when a monster comes into view / all new sounds silent**: sound id -1, or the first start after a
  D2RLoader/D2R update loaded D2R's sounds table. Restart; plugin sound guard.
- **Write to address 0 at D2R.exe+0xF3D028 in a busy fight**: the Renderer Pool is full (heap fallback plugin).
- **Fix works on one PC, not another**: `default_mod`, a stray plugin copy, or other plugins. Read the plugin log's
  first lines.
- **Monsters can't be hovered / overlays gone after a plugin change**: the plugin patched something D2RLoader
  already handles (state sync). Turn plugin features off one by one with the off-switch file.

## Bisect
1. Plugin: list feature words in `<plugin>-off.txt` (half at a time) until the problem goes.
2. Data: move patches out of `patches/` (or comment ops out by splitting files), rebuild, reinstall; halve until
   one op remains. Then compare that row with the vanilla row (`modkit show`).
3. Fix, rebuild, add a TESTING.md row for the regression.

Wersje

W bazie nie ma innych skilli o nazwie d2r-debug.

Migawka bazy z 13.11.2026 · wersja paczki c68b59677ad2 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 88d2r-mod-setup
    Przygotowuje narzędzie d2r-modkit do modów Diablo II Resurrected: instaluje, buduje, uruchamia i wyjaśnia błędy brakujących plików gry.
  • 100d2r-port
    Przenosi klasyczny mod Diablo II na Diablo II Resurrected 3.x za zgodą twórców, zamieniając tabele wiersz po wierszu z D2RLoader.
  • 98ci-crash-dump
    Pobiera i analizuje zrzuty awarii z testów CI w repozytoriach dotnet, gdy test się wywrócił, a nie tylko nie przeszedł, na przykład w pull requeście.
  • 100native-runtime-debug
    Diagnozuje awarie, zawieszenia i błędny stan działającego programu w C i C++, przez DAP i zrzuty pamięci, i weryfikuje poprawki.
  • 98cyberwise-crashes
    Diagnozuje awarie, zawieszenia i brak uruchamiania Cyberpunk 2077 na zmodowanej instalacji: wskazuje właściwe logi i pokazuje, jak bisekcją znaleźć winny mod.
  • 90estack-debug
    Diagnozuje i naprawia błędy Elixir i Phoenix na podstawie objawów i dowodów w kodzie: awarie, testy, zapytania, LiveView i Oban.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.