https://github.com/szapp/hrav
Human Readable Access Violations: Extend the stack trace of access violations to include Daedalus symbols for Gothic 2 NotR (with partial support for Gothic 1)
https://github.com/szapp/hrav
access-violation daedalus gothic gothic1 gothic2 modding-gothic ninja
Last synced: 2 months ago
JSON representation
Human Readable Access Violations: Extend the stack trace of access violations to include Daedalus symbols for Gothic 2 NotR (with partial support for Gothic 1)
- Host: GitHub
- URL: https://github.com/szapp/hrav
- Owner: szapp
- License: other
- Created: 2024-05-05T12:02:53.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-01-19T08:30:18.000Z (4 months ago)
- Last Synced: 2025-01-19T09:27:59.660Z (4 months ago)
- Topics: access-violation, daedalus, gothic, gothic1, gothic2, modding-gothic, ninja
- Language: D
- Homepage:
- Size: 328 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Human Readable Access Violations
[](https://github.com/szapp/HRAV/actions/workflows/scripts.yml)
[](https://github.com/szapp/HRAV/actions/workflows/validation.yml)
[](https://github.com/szapp/HRAV/actions/workflows/build.yml)
[](https://github.com/szapp/HRAV/releases/latest)
[](https://forum.worldofplayers.de/forum/threads/?p=26774926)
[](https://clockwork-origins.com/spine)
[](https://steamcommunity.com/sharedfiles/filedetails/?id=2787341517)
Human Readable Access Violations: Extend the stack trace of access violations to include Daedalus symbols for Gothic 2 NotR (with partial support for Gothic 1).
This is a modular modification (a.k.a. patch or add-on) that can be installed and uninstalled at any time and is virtually compatible with any modification.
It supports Gothic 1 (partially) and Gothic II: NotR.
Generated from [szapp/patch-template](https://github.com/szapp/patch-template).
## About
This patch offers more insight into crashes by showing symbol names and byte offsets for script induced access violation errors.
Access violations may differ in their stack traces and register information.
The information within can be valuable to developers to fix bugs.
However, this information is not very accessible and depending on the circumstance not easy to decode.
This patch makes this valuable information available.
Users of this patch may contribute by sending access violation screenshots to mod-developers.
This helps them to get to the bottom of game crashes more easily and, in turn, provide faster support.
## Disclaimer
I had written this patch quite a while ago and never finalized it.
Some byte-offset may be slightly off.
It clarifies the stack trace for script functions only.
The patch follows a manual procedure described here [2].
The uncovered Daedalus stack trace is inferior (incomplete and less accurate) to Ikarus's stack trace printed to the zSpy.
If access to the zSpy is possible, it should be preferred. The "Human Readable Access Violations" is therefore merely a small aid.
## Links
[1] https://forum.worldofplayers.de/forum/threads/?p=26774926
[2] https://forum.worldofplayers.de/forum/threads/?p=25925207
## Installation
1. Download the latest release of `HRAV.vdf` from the [releases page](https://github.com/szapp/HRAV/releases/latest).
2. Copy the file `HRAV.vdf` to `[Gothic]\Data\`. To uninstall, remove the file again.
The patch is also available on
- [World of Gothic forum post](https://forum.worldofplayers.de/forum/threads/?p=26774926)
- [Spine Mod-Manager](https://clockwork-origins.com/spine/)
- [Steam Workshop Gothic 2](https://steamcommunity.com/sharedfiles/filedetails/?id=2787341517)
### Requirements
GothicGothic II: NotR
Version 1.08k_modReport version 2.6.0.0
Ninja 2.1.02 or higher