kalli/FSHook
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
No description
3 commits 1 branch 0 tags 15 MiB
AspectJ 69.3%
Java 30.7%
Find a file
Daniel Kallendorf ae005c3005 Added Hint
2022-11-10 00:14:53 +01:00
.vscode Initial 2022-11-10 00:06:01 +01:00
lib Initial 2022-11-10 00:06:01 +01:00
src/com/kallendorf/fshook Initial 2022-11-10 00:06:01 +01:00
tool Initial 2022-11-10 00:06:01 +01:00
.gitignore FixFSCrap 2022-11-10 00:11:37 +01:00
README.md Added Hint 2022-11-10 00:14:53 +01:00

README.md

Getting Started

Dependencies

  • FirstSpirit installation
  • OpenJDK11 (On Windows this gets installed together with FS C:/Users/<User>/.firstspirit/FSLauncher/jre/11.0.11/jre-win/jdk-11.0.11+9-jre/bin/java.exe)
  • AspectJ https://www.eclipse.org/aspectj/ (already included)
  • copy .firstspirit/FSLauncher/jar/*, .firstspirit_<version>/jars/* (usually located in $HOME) of the FS installation into lib/
  • Fix some FirstSpirit crap: open .firstspirit/FSLauncher/jar/fs-isolated-client-<version>.jar and replace de/javasoft\plaf\synthetica\SyntheticaIcon.class with META-INF\versions\9\de\javasoft\plaf\synthetica\SyntheticaIcon.class

Paths

  • <java> point to your (or FSs) OpenJDK11 installation
  • <aspectjweaver.jar> can be found in FSHook/tool
  • <classpath> points to lib/* and tool/*
  • The seperator is : on Linux and ; on Windows.

Building

java -cp <classpath> org.aspectj.tools.ajc.Main -sourceroots 'src/' -injars lib/fs-isolated-client-*.jar -outjar bin/uploadPlugin.jar -outxml -9 -Xlintfile .vscode/ajc.properties", (Should give a few warnings but no errors)

What the hell?

AspectJ is a bytecode manipulation framework. In our case the method Plugins.getPlugins(ServerConnection, Class, BaseContext) from de.espirit.firstspirit.client.plugin.Plugins gets overriden to load the plugins registered in com.kallendorf.fshook.CustomLoader.pluginsToLoad in addition to the default ones. This allows th execution of arbitrary code within the FirstSprit client.