CustomRPXLoader/README.md

36 lines
1.7 KiB
Markdown
Raw Permalink Normal View History

2022-02-02 19:42:35 +01:00
[![CI-Release](https://github.com/wiiu-env/CustomRPXLoader/actions/workflows/ci.yml/badge.svg)](https://github.com/wiiu-env/CustomRPXLoader/actions/workflows/ci.yml)
2020-04-27 13:32:37 +02:00
# CustomRPXLoader
2020-04-27 13:34:00 +02:00
This custom loader for `.rpx` files which can be used with any `payload.elf` loader. (For example [PayloadFromRPX](https://github.com/wiiu-env/PayloadFromRPX) or [JsTypeHax](https://github.com/wiiu-env/JsTypeHax))
2020-04-27 13:32:37 +02:00
## Usage
2021-12-31 15:16:20 +01:00
Place the `payload.elf` in the `sd:/wiiu` folder of your sd card and run a exploit which loads `payload.elf`, this will load the `sd:/wiiu/payload.rpx` into memory and execute it. The maximum size of the `payload.rpx` depends on the size of this loader, but should > 7Mib.
2020-04-27 13:32:37 +02:00
## Building
2021-09-01 12:18:33 +02:00
For building you just need [wut](https://github.com/devkitPro/wut/) and the ppc-portlibs (`(dkp-)pacman -Syu ppc-portlibs`) installed, then use the `make` command.
2020-04-27 13:32:37 +02:00
2020-06-25 18:48:21 +02:00
## Building using the Dockerfile
It's possible to use a docker image for building. This way you don't need anything installed on your host system.
```
# Build docker image (only needed once)
docker build . -t customrpxloader-builder
# make
docker run -it --rm -v ${PWD}:/project customrpxloader-builder make
# make clean
docker run -it --rm -v ${PWD}:/project customrpxloader-builder make clean
```
2022-02-02 19:42:35 +01:00
## Format the code via docker
2023-03-17 18:54:39 +01:00
`docker run --rm -v ${PWD}:/src ghcr.io/wiiu-env/clang-format:13.0.0-2 -r ./src --exclude ./src/elfio -i`
2022-02-02 19:42:35 +01:00
2020-04-27 13:32:37 +02:00
## Credits
- Maschell
- orboditilt
- Copy pasted the solution for using wut header in .elf files from [RetroArch](https://github.com/libretro/RetroArch)
- Copy pasted resolving the ElfRelocations from [decaf](https://github.com/decaf-emu/decaf-emu)
- Copy pasted SD mounting code + devoptabs from [libutils](https://github.com/Maschell/libutils)