*****************************************************************

* PSN LIBERATOR V0.96B *

* by Rudi Rastelli *
*****************************************************************
* Credits: *
* @ifcaro, @Brunestud, @RipCord, *
* @DeLiGht, @Hykem, @aldostools, @eslab *
*****************************************************************

Beschreibung:
*************
- Wandelt PSN-Inhalte, wie Games, PS1- PS2-Classics, DLCs, Minis, Designs und
Avatare, in aktivierungsfreien Inhalt um.
- Als Eingangsdaten werden PKG-Files oder von der PS3 kopierte
"/dev_hdd0/games/[GameID]"-Ordner unterst�tzt
- Optionale Integration von Updates, Unlock-PKGs/EDATs und DLCs
- Wandelt PSN-Games in Disk-Games (Ordner- und ISO-Format)
- Patcht alle PSN-Inhalte wahlweise auf 3.55 oder 4.21
- Automatische und manuelle Umwandlung von "*.rif"-Datein in "*.rap"-Dateien
- Erzeugung einer "Bubble"-PKG-Installations-Disk f�r die befreiten Inhalte
- Erzeugung einer "PS2-Classics-Placeholder" rap-Datei

Vorbereitende erste Schritte:

*****************************
1. Startet den LIBERATOR und folgt dem Assistenten zum Einrichten des Programms
gewissenhaft.

Anmerkung: Ihr k�nnt f�r's erste den "PSN CONTENT"-Ordner aus dem LIBERATOR
Programmverzeichnis irgendwohin kopieren
und als Vorlage f�r eine m�gliche Ordnerstruktur nehmen, damit Ihr
untenstehendem Beispiel folgen k�nnt.

Eine Vorgehensweise(als Beispiel):

**********************************
1. Ihr ben�tigt ein installiertes, freigeschaltetes und geupdatetes(optional) PSN-
Game auf eurer PS3.
DLCs k�nnen, sofern freigeschaltet, auch enthalten sein.
(Vielleicht habt Ihr schon ein Game drauf, oder aber Ihr geht in den PSN-Store
und kauft Euch eins.)

2. Bringt die "GameID" des Games in Erfahrung und sucht in "/dev_hdd0/games/" nach
einem Ordner dessen Namen genau diese "GameID" ist
Kopiert diesen "GameID"-Ordner nach "PSN CONTENT\LOCKED\PSN GAMES\"

3. Geht nun auf der PS3 ins Verzeichnis "/dev_hdd0/home/0000000x/exdata/" und sucht
nach
a) allen "*.rif"-Dateien, in deren Namen ebenfalls die "GameID" vorkommt, und
kopiert sie in den "PSN CONTENT\RIFsRAPs"-Ordner
b) einer "*.edat"-Datei, in deren Namen ebenfalls die "GameID" vorkommt, und
kopiert sie in den "PSN CONTENT\UNLOCKS"-Ordner
(Nicht jedes Game hat "*.rif"- UND "*.edat"-Dateien... manchmal gibt's nur eine
Sorte)
TIPP: Kopiert beim erten Mal gleiche alle RIFs und EDATs, die ihr findet.

4. Im LIBERATOR einstellen:
a) "PSN Game Folder" = "PSN CONTENT\LOCKED\PSN GAMES\[GameID]\"
b) "PSN Game Unlock File" = "PSN CONTENT\UNLOCKS\****[GameID]****.edat" (nur,
wenn man auch ne "*.edat"-Datei bei 3b gefunden hat)

5. Dr�ck den Knopf

a) "PKG" -> Erzeugt eine freigeschaltete PKG-Datei im "OUTPUT
DIRECTORY"
b) "DISC GAME FOLDER" -> Erzeugt einen freigeschalteten Disc-Game-Ordner
c) "ISO" -> Erzeugt eine freigeschaltete ISO-Datei

Anmerkungen:
************
- Um Update-PKGs f�r Eure Games zu bekommen kann man zB den PS3 GAME UPDATER
benutzen

- Manchmal wird zus�tzlich eine Unlock-PKG-Datei erzeugt, die man installieren

muss, um das Spiel vollends freizuschalten.
Es kommt aber auf den Versuch an, dass freigeschaltete Game erstmal ohne die
Unlock-PKG-Datei zu testen.

- In der Datei "my_klics.txt"(im "Tools"-Unterverzeichnis) kann man bei Bedarf

seine selbst gefundenen (dev_)klicensee-Schl�ssel eintragen.

- L�ngst nicht jedes PSN-Game l�sst sich in eine Disk-Version umwandeln. Auch hier
gilt : Versuch macht kluch !
(Manchmal l�uft es tadellos, manchmal gar nicht, manchmal mit Frezzern und
machmal mit Fehlern)

- Das Icon("ICON0.PNG") eines jeden umgewandelten Inhalts wird im "[LIBERATOR

Programmverzeichnis]\GameIconCache\"-Ordner als
"[GameID].PNG" abgelegt. Das k�rzt die Erstellung einer "Bubble"-PKG-
Installations-Disk, die Game-Icons anzeigen soll, meist erheblich ab.

- Bei der Erstellung der "Bubble"-PKG-Installations-Disk einfach die PKG-Dateien,

die auf der Disk enthalten sein sollen,
per Drag&Drop ins Fenster ziehn, nach eigenem Gusto sortieren und anschliessen
die Disk als Ordner oder ISO erzeugen.

- Sollen in den "Bubbles" Game-Icons angezeigt werden, sucht der LIBERATOR zuerst
in "[LIBERATOR Programmverzeichnis]\GameIconCache\"
nach einer "[GameID].PNG"-Datei. Falls nicht vorhanden, extrahiert er die PKG-
Datei, um die "ICON0.PNG" zu bekommen, was u.U. lange
dauern kann. Deshalb kann man die "ICON0.PNG"-Datei auch manuell im
"GameIconCache" mit dem Namen "[GameID].PNG" ablegen.

- Bedenkt, dass die "Bubble"-PKG-Installations-Disk, abh�ngig von Anzahl und Gr�sse

der gew�hlten PKG-Dateien, sehr gro� werden kann.

- Macht keine Online/Offline-Updates der befreiten Games ! ... danach w�ren sie
n�hmlich wieder gelockt !

- Ich empfehle insbesondere das "PSN CONTENT"-Verzeichnis nicht zu tief in anderen

Unterverzeichnissen zu vergraben, da 'PKGView' mit
sehr langen Pfaden nicht klar kommt und eine Exception erzeugt

Gru�
Rudi