Attempt to recreate code of Fishlabs games and their common core Abyss Engine for education and entertainment purposes, by revese engineering.

Currently the essence of this repo is the symbol mapping for GoF2 version 1.0.4 (the last update for J2ME published for free by the fishes)

---

---

Goals

1. Getting fully readable java code
   • deobfuscating GoF2 classes, fields and methods names using Recaf - now
   • deobfuscating insides of methods - touched (.aem loading class implemented in GoF2:Reforged¹)
   • Making documentation for the code.
2. Porting to other platforms, modding java...

---

Want to contribute?

Software requirements:
Operating system:

• Windows or Linux or MacOS may work too.

Decompilation, static analysis, deobfuscation:

• Recaf 4: (manual) Java 22+ 64-bit

Testing and dynamic analysis:

• KEmulator (nnmod) - standalone emulator with many options
• EclpiseME (video guide, debuging fix) - J2ME development extension for Eclipse IDE, allows breakpoint, step debuging

Deobfuscation procedure (what I do):

1. In Recaf:
   • File -> Open workspace -> load /Recaf/GoF2/GoF2_JSR_1.0.4.jar
   • Mapping -> Apply -> Simple -> load /Recaf/GoF2/GoF2_JSR_1.0.4.mapping
   • Alternatively to the above if you don't have Github account skip above³:
   • (optional) do the *renaming: context menu or Alt+R
   • File -> Export application -> save as a .jar file
2. In KEmulator:
   • Test² by running the .jar
   • Dynamic analysis: tab View-> Watches/Methods/Memory View/Log/Options...*
3. In Recaf:
   • If testing went well: Mapping -> Export -> Simple -> save /Recaf/GoF2/GoF2_JSR_1.0.4_unordered.jar⁰

³ Just load the GoF2_deobfuscation.jar deobfuscate, save the mapping, send it to me and I will be able to apply it on top of main mapping.
² If you screwed up or Recaf breaks (happens), but have unsaved renaming, go to step 3. and Save the mapping as without overwritting the old one. Try step 1. it or try fixing the new mapping in text editor.
¹ Biggest GoF2 Mod as of now (2024-10-20). Source code I haven't seen, haven't accessed and will not be published.
⁰ 'unordered' becouse Recaf shuffles lines in mapping file on export so they should be sorted before commiting using sorter.py. Better use my pre-commit hook.

More:
Pre Recaf attempts
Renaming inspiration
Lookup tables for GoF2 (work in progress)