Skip to content

Commit

Permalink
Initial commit
Browse files Browse the repository at this point in the history
  • Loading branch information
BullyWiiPlaza committed Dec 22, 2022
0 parents commit 2ea196c
Show file tree
Hide file tree
Showing 3 changed files with 90 additions and 0 deletions.
Binary file added JGecko U.jar
Binary file not shown.
27 changes: 27 additions & 0 deletions LICENSE
@@ -0,0 +1,27 @@
# License/Terms of use

#### Copyright (C) BullyWiiPlaza - All Rights Reserved

By downloading and/or using **JGecko U** (in the following referred to as "the software") you agree to **fully** abide to all of the terms outlined in this document.

The downloader is granted a private and unlimited usage right of the software free of charge by **BullyWiiPlaza** (in the following referred to as "the author").

### Only respectful usage
* Stealing or supporting the theft of other people's creations in the community (mods/codes/etc.) is not permitted (supporting theft would be running stolen cheats/mods/etc. using the software)
* Abusing cheats/mods/etc. in online enabled titles/games is generally not permitted (acceptable uses have to be decided on a case basis)
* Using the software for piracy (e.g. enabling `DLC` or `DLC` content without having purchased the content legally) is not permitted

### No copyright infringements
Do not modify, re-upload, or reverse engineer (e.g. decompile, disassemble, sniff, ...) the software or change its intended/default behavior in any way.

Violations in this regard are considered copyright infringements and are e.g. subject to [`DMCA` takedowns](https://www.dmca.com/faq/What-is-a-DMCA-Takedown).

### Mandatory updates
When using this software, the user may only run the latest officially released version of the software and is responsible for regularly checking for a new version of the software.

### TOS updates
By continuing to possess or use the software you automatically agree to any updates towards these TOS.

### Violations
If you violate any part of the TOS or stop agreeing with anything listed in the TOS, at the sole discretion of the author, you will lose all rights granted to you by the license permanently
and have to destroy all copies of the software.
63 changes: 63 additions & 0 deletions README.md
@@ -0,0 +1,63 @@
## Overview
`JGecko U` is a replacement for [`TCP Gecko.NET`](https://github.com/Chadderz121/tcp-gecko-dotnet) as a platform independent Wii U RAM debugger and cheat code manager for Wii U titles.

It is the most advanced Wii U game hack/cheat development tool which is used by almost all mod developers and end users across all Wii U titles.

## Setup
**PC side:**
* Install [`Java 8+`](https://www.java.com/en/download)
* Download `JGecko U.jar` from [here](https://github.com/BullyWiiPlaza/JGeckoU/releases)*
* Double-click `JGecko U.jar` **OR** type `java -jar "JGecko U.jar"` on the command line/Terminal to launch `JGecko U`

**Wii U side:**
* Download the [`TCP Gecko Installer`](https://github.com/BullyWiiPlaza/tcpgecko/blob/master/tcpgecko.elf?raw=true). Extract it to your SD Card into the folder `E:\wiiu\apps\TCPGecko`*
* Proceed to run the [`Homebrew Launcher`](https://github.com/dimok789/homebrew_launcher) by visiting `http://u.wiidb.de` with your Wii U. Finally, load the `TCP Gecko Installer` app and confirm the desired `TCP Gecko Installer` installation mode.

*Alternatively: Use the [`Gecko U Updater`](https://github.com/BullyWiiPlaza/Gecko-U-Updater) application.

A YouTube video visually showing the full setup guide can be found [here](https://www.youtube.com/watch?v=Uk7DhEdSfxA).

## Troubleshooting

* **JGecko U does not connect successfully despite following all steps correctly:**
Usually, your [(Windows) Firewall](https://en.wikipedia.org/wiki/Windows_Firewall) will ask you for permission to allow java.exe to access the network the first time you're trying to use the network with a Java application like JGecko U. Obviously, you need to give this permission (and specify you're inside a private network). Note: [If no such pop-up comes up](https://www.windowsdispatch.com/turn-on-off-windows-defender-firewall-notifications), you may need to manually [add a firewall rule to allow java.exe to access the network](https://pureinfotech.com/allow-apps-firewall-windows-10). This is something that prevented some users from connecting JGecko U successfully. After adding the firewall rule, the connection should work fine.

## Donator features
Since the application took months or even years to develop and I worked on it alone, I made some features of JGecko U donator only. If you appreciate this application and want to unlock extra features (mainly useful for code creation and development), feel free to become a donator on the Donator tab in JGecko U. The following features will become available after donator license activation:

**Disassembler**
* Add Dump Registers Hook: Adds an assembly hook to dump values of registers of interest
* Add Dump Structures Hook: Adds an assembly hook dump structures of interest
* Insert Hook: Allows inserting assembly instructions at the current address in the disassembler (performs a jump to the injected assembly and a jump to safely return after execution)
* Delete Hook: Removes an inserted hook again
* Parse Immediate: Finds corresponding lis/ori or lis/addi etc. pairs (which setup the same register) and gets the address referenced by both of them

**Cafe Code Creation**
* Code Wizard: Supports creating all codetypes via easy to use dialogs and input components

**General**
* Watchlist: Allows watching the current values of multiple addresses (including pointer support and view modes)

**Assembly**
* Obfuscate Assembly: Allows obfuscating assembly sources with mathematical tricks to make reverse engineering hard (note: this feature is experimental and may not be completely stable. Intended to be used on simple and short assembly RAM writes)
* Parse IDA Pro ASM File: Allows loading assembly instructions from an IDA Pro .asm file

**View Modes**
* Memory Viewer View Mode: Allows switching the view mode of all data in the memory viewer
* Search Tab View Mode: Allows switching the view mode of all results in the search tab

## Feature Requests/Problems
You can post them in one of the following places:
* [GitHub issues](https://github.com/BullyWiiPlaza/JGeckoU/issues)
* [`Discord`](https://discord.gg/XVA6SjJyC8)

**Note:**

The following types of requests will **NOT** be answered:
* Requests for code creation or sharing codes (-> this is not related to bugs or features of `JGecko U`)
* Reports regarding codes not working correctly (-> unless you can prove that there is a code handler bug)
* Requests regarding connection problems (-> follow the setup guide and verify your network/IP address(es))
* Requests regarding learning how to get started with making codes (-> watch/read tutorials like [`the ones on my YouTube channel`](https://www.youtube.com/playlist?list=PLKHNWhJawkhgisx0p0Fmv0E3UvwFWTADN) first)

## Credits
Check the `About` tab in `JGecko U`.

0 comments on commit 2ea196c

Please sign in to comment.