Skip to content
/ aRAMa Public
forked from c08oprkiua/aRAMa

Aroma WUPS plugin for game modding and research

License

Notifications You must be signed in to change notification settings

29th-Day/aRAMa

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

91 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

What is this?

This is an unofficial TCPGecko rewrite and port for Aroma. It contains several improvements, including notifications, enabling and disabling specific features via the plugin config menu, and more.

At the time of writing this, this is a work in progress and is not usable yet.

How do I use this?

In the config menu, there will be several options:

  • aRAMa active: Activates/deactivates the entire plugin.

  • Notifications: When enabled, you will get Aroma notifications when the plugin does various things, such as load an assembly code or encounter an error.

  • Save sent codes: When a code is set from a client, such as JGeckoU, automatically save it to the SD card for offline use.

  • TCP Gecko: Enable TCPGecko.

  • Code handler: Enable the environment used for running assembly code.

  • Caffiine: Enable Caffiine.

  • Saviine: Enable Saviine.

Compiling

To compile this, you will need:

  • wut

  • WiiUPluginSystem

  • libkernel

And then simply run make in the root directory of this repo after cloning locally.

Feature re-implementation checklist:

Though I tried, I cannot guarantee that everything works, because of what was necessarily changed in porting TCPGecko from the old libraries to the new equivalents.

  • Things related to kernel access may be depreciated and/or redundant to their non-kernel counterparts in the future.
  • Old codes are anticipated to not work due to RAM offsets, so please do not report unmodified old codes not working as an issue.
  • Assembly related commands will not do anything if the Code handler is disabled.

I am reliant on people testing it and getting back to me on the status of various features. A checklist of what has been reported to work is below.

Commands:

  • Write 8 bit value
  • Write 16 bit value
  • Write 32 bit value
  • Read memory
  • Read memory with kernel access
  • Validate address range
  • Disassemble range (currently disabled)
  • Disassemble memory
  • Read compressed memory
  • Write with kernel access
  • Read with kernel access
  • Take a screenshot
  • Upload memory
  • Get the size of data buffer
  • Read a file
  • Read a directory
  • Replace a file
  • "IOSU read file" (currently disabled)
  • Get version hash
  • Get code handler address
  • Read threads
  • Get account identifier
  • Write screen (currently disabled)
  • Follow pointer
  • Get server status
  • Remote procedure call
  • Get symbol
  • Search memory 32
  • Advanced memory search
  • Execute assembly
  • Pause the console
  • Unpause the console
  • See whether the console is paused or not
  • Get server version
  • Get OS version
  • Set data breakpoint
  • Set instruction breakpoint
  • Toggle breakpoint
  • Remove all breakpoints
  • Get stack trace
  • Poke registers
  • Get entry point address
  • Run kernel copy service
  • Persist assembly
  • Clear assembly

Credits

Original TCPGecko credits:

  • dimok for Homebrew Launcher project engine/base
  • BullyWiiPlaza for further development of advanced/efficient features of TCPGecko
  • wj44 for porting pyGecko to the Homebrew Launcher and some development
  • Marionumber1 for exploit development and TCP Gecko Installer contributions
  • NWPlayer123 for the pyGecko client library
  • Chadderz for the original TCP Gecko Installer
  • Kinnay for some DiiBugger code this project made use of
  • CosmoCortney for the original café code handler
  • Mewtality for various code handler improvements

aRAMa credits:

  • Maschell for help on Discord
  • Lulsec2#0064 on Discord, for coming up with the name "aRAMa"
  • (The devs of) FTPiiU, for implementation referencing
  • Quarky, for arGecko

Help, inquiries, etc.

For help with or questions about JGecko U or the original TCPGecko, join the JGecko U Discord

For help with or questions about aRAMa, join my Discord

About

Aroma WUPS plugin for game modding and research

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Languages

  • C++ 75.4%
  • C 16.8%
  • Makefile 3.6%
  • Assembly 2.7%
  • CMake 1.5%