Skip to content

Commit

Permalink
Add a ReadMe
Browse files Browse the repository at this point in the history
  • Loading branch information
RA-Kooi committed Dec 21, 2021
1 parent 8609a9c commit 5096d8c
Showing 1 changed file with 33 additions and 0 deletions.
33 changes: 33 additions & 0 deletions ReadMe.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# DwarfOne2C

Parses output from DWARFOne by LuigiBlood (https://github.com/LuigiBlood/dwarfone) and turns it into C(++) code.

Heavily tailored towards MetroWerks compiled GameCube games.
May or may not work with all MetroWerks compiled GC games, probably crashes and burns on Wii games.

# How to build

Install dotnet SDK and runtimes (included with Visual Studio).

```sh
dotnet publish -c Release
```

The compiled project will be in `.\DwarfOne2C\bin\Release\net5.0\publish`.
Optionally copy all files in the publish folder to somewhere in your `$PATH` for easy access.

# How to use

As an example we will take a fictional game called YourGame which has an elf with debug info included.

```sh
dwarfone YourGame.elf > YourGame-dwarf.txt
dotnet DwarfOne2C.dll --list-files YourGame-dwarf.txt

# Pick a file from the output

# Output in current folder, add path to output folder at the end if you want it to output somewhere else
dotnet DwarfOne2C.dll YourGame-dwarf.txt C:\YourGame\ C:\YourGame\src\main.cpp
```

If you're lucky and it didn't crash, you should now have a file called `main.cpp` in `.\src\`

0 comments on commit 5096d8c

Please sign in to comment.