From c5d76bfa06f8a4e898afd232a306269294457991 Mon Sep 17 00:00:00 2001 From: AKuHAK <621640+AKuHAK@users.noreply.github.com> Date: Thu, 22 Jul 2021 12:55:01 +0300 Subject: [PATCH 1/3] Added MEGA badge into readme --- README.md | 76 +++++++++++++++++++++++++++---------------------------- 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/README.md b/README.md index 91c5bdab5..adfe976d0 100644 --- a/README.md +++ b/README.md @@ -1,87 +1,87 @@ # Open PS2 Loader Copyright 2013, Ifcaro & jimmikaelkael -Licenced under Academic Free License version 3.0 -Review LICENSE file for further details. +Licensed under Academic Free License version 3.0 +Review the LICENSE file for further details. [![CI](https://github.com/ifcaro/Open-PS2-Loader/workflows/CI/badge.svg)](https://github.com/ifcaro/Open-PS2-Loader/actions?query=workflow%3ACI) +[![CI](https://img.shields.io/badge/Mega-%23D90007.svg?style=flat&logo=Mega&logoColor=white)](https://mega.nz/folder/Ndwi1bAK#oLWNhH_g-h0p4BoT4c556A) ## Introduction Open PS2 Loader (OPL) is a 100% Open source game and application loader for -the PS2 and PS3 units. It supports three categories of devices : USB mass +the PS2 and PS3 units. It supports three categories of devices: USB mass storage devices, SMB shares and the PlayStation 2 HDD unit. USB devices and SMB shares support USBExtreme and \*.ISO formats while PS2 HDD supports HDLoader format. It's now the most compatible homebrew loader. OPL is also developed continuously - anyone can contribute improvements to -the project due to its open source nature. +the project due to its open-source nature. You can visit the Open PS2 Loader forum at: -https://www.psx-place.com/forums/open-ps2-loader-opl.77/ + You can report compatibility game problems at: -https://www.psx-place.com/threads/open-ps2-loader-game-bug-reports.19401/ + -For updated compatibility list, you can visit OPL-CL site at: +For an updated compatibility list, you can visit the OPL-CL site at: -http://sx.sytes.net/oplcl/games.aspx + ## Release types Open PS2 Loader bundle included several types of the same OPL version. These -types come with more or less features included. +types come with more or fewer features included. -| Type (can be a combination) | Description | -| --------------------------- | ---------------------------------------------------------------------------------------------- | -| "Release" | Regular OPL release with GSM, IGS, PADEMU, VMC, PS2RD Cheat Engine & Parental Controls. | -| "DTL_T10000" | OPL for TOOLs (DevKit PS2) | -| "IGS" | OPL with InGame Screenshot feature. | -| "PADEMU" | OPL with Pad Emulation for DS3 & DS4. | -| "RTL" | OPL with right to left language suppport. | +| Type (can be a combination) | Description | +| --------------------------- | --------------------------------------------------------------------------------------- | +| "Release" | Regular OPL release with GSM, IGS, PADEMU, VMC, PS2RD Cheat Engine & Parental Controls. | +| "DTL_T10000" | OPL for TOOLs (DevKit PS2) | +| "IGS" | OPL with InGame Screenshot feature. | +| "PADEMU" | OPL with Pad Emulation for DS3 & DS4. | +| "RTL" | OPL with the right to left language support. | ## How to use OPL uses the following directory tree structure across HDD, SMB, and USB modes: -| Folder | Description | Modes | -| ------ | ----------- | ----- | -| "CD" | for games on CD media - i.e. blue-bottom discs | USB and SMB | -| "DVD" | for DVD5 and DVD9 images if using the NTFS file system on USB or SMB ; DVD9 images must be split and placed into the device root if using the FAT32 file system on USB or SMB | USB and SMB | -| "VMC" | for Virtual Memory Card images - from 8MB up to 64MB | all | -| "CFG" | for saving per-game configuration files | all | -| "ART" | for game art images | all | -| "THM" | for themes support | all | -| "LNG" | for translation support | all | -| "CHT" | for cheats files | all | +| Folder | Description | Modes | +| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | +| "CD" | for games on CD media - i.e. blue-bottom discs | USB and SMB | +| "DVD" | for DVD5 and DVD9 images if using the NTFS file system on USB or SMB; DVD9 images must be split and placed into the device root if using the FAT32 file system on USB or SMB | USB and SMB | +| "VMC" | for Virtual Memory Card images - from 8MB up to 64MB | all | +| "CFG" | for saving per-game configuration files | all | +| "ART" | for game art images | all | +| "THM" | for themes support | all | +| "LNG" | for translation support | all | +| "CHT" | for cheats files | all | OPL will automatically create the above directory structure the first time you launch it and enable your favourite device. -For HDD users, OPL will read hdd0:__common/OPL/conf_hdd.cfg for the config entry "hdd_partition" to use as your OPL partition. -If not found a config file and a 128Mb +OPL partition will be created, you can edit the config if you wish to use/create a different partition. +For HDD users, OPL will read hdd0:\_\_common/OPL/conf_hdd.cfg for the config entry "hdd_partition" to use as your OPL partition. +If not found a config file and a 128Mb +OPL partition will be created. You can edit the config if you wish to use/create a different partition. All partitions created by OPL will be 128Mb (it is not recommended to enlarge partitions as it will break LBAs, instead remove and recreate manually with uLaunchELF at a larger size if needed). ## USB Game files on USB must be perfectly defragmented either file by file or by whole drive, and Dual Layer DVD9 images must be split to avoid the 4GB -limitations of the FAT32 file system. We recommend Auslogics Disk Defrag -for best defragging results. - -http://www.auslogics.com/en/software/disk-defrag/ +limitations of the FAT32 file system. We do not recommend using any programs. +The best way for defragmenting - copy all files to pc, format USB, copy all files back. +Repeat it once you faced defragmenting problem again. You also need a PC program to convert or split games into USB Advance/Extreme format, such as USBUtil 2.0. ## SMB -For loading games by SMB protocol you need to share a folder (ex: PS2SMB) +For loading games by SMB protocol, you need to share a folder (ex: PS2SMB) on the host machine or NAS device and make sure that it has full read and write permissions. USB Advance/Extreme format is optional - \*.ISO images -are supported using the folder structure above with the added bonus that +are supported using the folder structure above with the bonus that DVD9 images don't have to be split if your SMB device uses the NTFS or EXT3/4 file system. @@ -98,9 +98,9 @@ executable elf. On PS3, you need an original SwapMagic 3.6+ or 3.8 disc (at the moment there aren't any other options). The steps for loading OPL on a PS3 are: -1. Rename OPNPS2LD.ELF to SMBOOT0.ELF -2. Make a folder in root of USB device called SWAPMAGIC and copy SMBOOT0.ELF to it. -3. Launch SwapMagic in PS3 and press UP+L1 then Open PS2 Loader should start. +1. Rename OPNPS2LD.ELF to SMBOOT0.ELF +2. Make a folder in the root of a USB device called SWAPMAGIC and copy SMBOOT0.ELF to it. +3. Launch SwapMagic in PS3 and press UP+L1 then Open PS2 Loader should start. There are 4 forms for launching elfs in SwapMagic. @@ -115,4 +115,4 @@ Note: on PS3, only USB and SMB modes are supported. Open PS2 Loader needs the latest PS2SDK: -https://github.com/ps2dev/ps2sdk + From bc87a2c65291dec70857e487b33841e855252360 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mat=C3=ADas=20Israelson?= <57065102+israpps@users.noreply.github.com> Date: Thu, 22 Jul 2021 12:55:23 -0300 Subject: [PATCH 2/3] Collapsible sections and minor changes --- README.md | 92 ++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 70 insertions(+), 22 deletions(-) diff --git a/README.md b/README.md index adfe976d0..f05ea5c20 100644 --- a/README.md +++ b/README.md @@ -30,34 +30,42 @@ For an updated compatibility list, you can visit the OPL-CL site at: -## Release types + +
+ Release types +

Open PS2 Loader bundle included several types of the same OPL version. These types come with more or fewer features included. | Type (can be a combination) | Description | | --------------------------- | --------------------------------------------------------------------------------------- | -| "Release" | Regular OPL release with GSM, IGS, PADEMU, VMC, PS2RD Cheat Engine & Parental Controls. | -| "DTL_T10000" | OPL for TOOLs (DevKit PS2) | -| "IGS" | OPL with InGame Screenshot feature. | -| "PADEMU" | OPL with Pad Emulation for DS3 & DS4. | -| "RTL" | OPL with the right to left language support. | +| `Release` | Regular OPL release with GSM, IGS, PADEMU, VMC, PS2RD Cheat Engine & Parental Controls. | +| `DTL_T10000` | OPL for TOOLs (DevKit PS2) | +| `IGS` | OPL with InGame Screenshot feature. | +| `PADEMU` | OPL with Pad Emulation for DS3 & DS4. | +| `RTL` | OPL with the right to left language support. | + +

+
-## How to use +
+ How to use +

OPL uses the following directory tree structure across HDD, SMB, and USB modes: | Folder | Description | Modes | | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | -| "CD" | for games on CD media - i.e. blue-bottom discs | USB and SMB | -| "DVD" | for DVD5 and DVD9 images if using the NTFS file system on USB or SMB; DVD9 images must be split and placed into the device root if using the FAT32 file system on USB or SMB | USB and SMB | -| "VMC" | for Virtual Memory Card images - from 8MB up to 64MB | all | -| "CFG" | for saving per-game configuration files | all | -| "ART" | for game art images | all | -| "THM" | for themes support | all | -| "LNG" | for translation support | all | -| "CHT" | for cheats files | all | +| `CD` | for games on CD media - i.e. blue-bottom discs | USB and SMB | +| `DVD` | for DVD5 and DVD9 images if using the NTFS file system on USB or SMB; DVD9 images must be split and placed into the device root if using the FAT32 file system on USB or SMB | USB and SMB | +| `VMC` | for Virtual Memory Card images - from 8MB up to 64MB | all | +| `CFG` | for saving per-game configuration files | all | +| `ART` | for game art images | all | +| `THM` | for themes support | all | +| `LNG` | for translation support | all | +| `CHT` | for cheats files | all | OPL will automatically create the above directory structure the first time you launch it and enable your favourite device. @@ -65,7 +73,14 @@ For HDD users, OPL will read hdd0:\_\_common/OPL/conf_hdd.cfg for the config ent If not found a config file and a 128Mb +OPL partition will be created. You can edit the config if you wish to use/create a different partition. All partitions created by OPL will be 128Mb (it is not recommended to enlarge partitions as it will break LBAs, instead remove and recreate manually with uLaunchELF at a larger size if needed). -## USB +

+
+ + +
+ USB +

+ Game files on USB must be perfectly defragmented either file by file or by whole drive, and Dual Layer DVD9 images must be split to avoid the 4GB @@ -76,7 +91,13 @@ Repeat it once you faced defragmenting problem again. You also need a PC program to convert or split games into USB Advance/Extreme format, such as USBUtil 2.0. -## SMB +

+
+ + +
+ SMB +

For loading games by SMB protocol, you need to share a folder (ex: PS2SMB) on the host machine or NAS device and make sure that it has full read and @@ -85,7 +106,13 @@ are supported using the folder structure above with the bonus that DVD9 images don't have to be split if your SMB device uses the NTFS or EXT3/4 file system. -## HDD +

+
+ + +
+ HDD +

For PS2, 48-bit LBA internal HDDs up to 2TB are supported. They have to be formatted with either HDLoader or uLaunchELF (uLaunchELF is recommended). @@ -93,7 +120,13 @@ formatted with either HDLoader or uLaunchELF (uLaunchELF is recommended). To launch OPL, you can use any of the existing methods for loading an executable elf. -## PS3 +

+
+ + +
+ PS3 +

On PS3, you need an original SwapMagic 3.6+ or 3.8 disc (at the moment there aren't any other options). The steps for loading OPL on a PS3 are: @@ -110,9 +143,24 @@ SMBOOT2.ELF = UP + R1 SMBOOT3.ELF = UP + R2 Note: on PS3, only USB and SMB modes are supported. +

+
+ + +
+ Some notes for DEVS +

+ +Open PS2 Loader needs the [__latest PS2SDK__](https://github.com/ps2dev/ps2sdk) + +

+
-## Some notes for devs +
+ OPL Archive +

-Open PS2 Loader needs the latest PS2SDK: +Since 5/07/2021 every OPL build dispatched to the release section of this repository will be uploaded to a mega account, you can access the archive by clicking the mega badge on top of this readme - +

+
From 54e54e495e8006345c16d2c58768228884c3facb Mon Sep 17 00:00:00 2001 From: AKuHAK <621640+AKuHAK@users.noreply.github.com> Date: Thu, 22 Jul 2021 19:40:43 +0300 Subject: [PATCH 3/3] Added Discord badge --- README.md | 35 +++++++++++++++-------------------- 1 file changed, 15 insertions(+), 20 deletions(-) diff --git a/README.md b/README.md index f05ea5c20..73c724ecf 100644 --- a/README.md +++ b/README.md @@ -5,7 +5,8 @@ Licensed under Academic Free License version 3.0 Review the LICENSE file for further details. [![CI](https://github.com/ifcaro/Open-PS2-Loader/workflows/CI/badge.svg)](https://github.com/ifcaro/Open-PS2-Loader/actions?query=workflow%3ACI) -[![CI](https://img.shields.io/badge/Mega-%23D90007.svg?style=flat&logo=Mega&logoColor=white)](https://mega.nz/folder/Ndwi1bAK#oLWNhH_g-h0p4BoT4c556A) +[![Discord](https://img.shields.io/discord/652861436992946216?style=flat&logo=Discord)](https://discord.gg/CVFUa9xh6B) +[![Mega](https://img.shields.io/badge/Mega-%23D90007.svg?style=flat&logo=Mega&logoColor=white)](https://mega.nz/folder/Ndwi1bAK#oLWNhH_g-h0p4BoT4c556A) ## Introduction @@ -30,7 +31,6 @@ For an updated compatibility list, you can visit the OPL-CL site at: -
Release types

@@ -56,18 +56,18 @@ types come with more or fewer features included. OPL uses the following directory tree structure across HDD, SMB, and USB modes: -| Folder | Description | Modes | -| ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | -| `CD` | for games on CD media - i.e. blue-bottom discs | USB and SMB | +| Folder | Description | Modes | +| ------ | ---------------------------------------------------- | ----------- | +| `CD` | for games on CD media - i.e. blue-bottom discs | USB and SMB | | `DVD` | for DVD5 and DVD9 images if using the NTFS file system on USB or SMB; DVD9 images must be split and placed into the device root if using the FAT32 file system on USB or SMB | USB and SMB | -| `VMC` | for Virtual Memory Card images - from 8MB up to 64MB | all | -| `CFG` | for saving per-game configuration files | all | -| `ART` | for game art images | all | -| `THM` | for themes support | all | -| `LNG` | for translation support | all | -| `CHT` | for cheats files | all | +| `VMC` | for Virtual Memory Card images - from 8MB up to 64MB | all | +| `CFG` | for saving per-game configuration files | all | +| `ART` | for game art images | all | +| `THM` | for themes support | all | +| `LNG` | for translation support | all | +| `CHT` | for cheats files | all | -OPL will automatically create the above directory structure the first time you launch it and enable your favourite device. +OPL will automatically create the above directory structure the first time you launch it and enable your favorite device. For HDD users, OPL will read hdd0:\_\_common/OPL/conf_hdd.cfg for the config entry "hdd_partition" to use as your OPL partition. If not found a config file and a 128Mb +OPL partition will be created. You can edit the config if you wish to use/create a different partition. @@ -76,12 +76,10 @@ All partitions created by OPL will be 128Mb (it is not recommended to enlarge pa

-
USB

- Game files on USB must be perfectly defragmented either file by file or by whole drive, and Dual Layer DVD9 images must be split to avoid the 4GB limitations of the FAT32 file system. We do not recommend using any programs. @@ -94,7 +92,6 @@ format, such as USBUtil 2.0.

-
SMB

@@ -109,7 +106,6 @@ EXT3/4 file system.

-
HDD

@@ -123,7 +119,6 @@ executable elf.

-
PS3

@@ -143,15 +138,15 @@ SMBOOT2.ELF = UP + R1 SMBOOT3.ELF = UP + R2 Note: on PS3, only USB and SMB modes are supported. +

-
Some notes for DEVS

-Open PS2 Loader needs the [__latest PS2SDK__](https://github.com/ps2dev/ps2sdk) +Open PS2 Loader needs the [**latest PS2SDK**](https://github.com/ps2dev/ps2sdk)

@@ -160,7 +155,7 @@ Open PS2 Loader needs the [__latest PS2SDK__](https://github.com/ps2dev/ps2sdk) OPL Archive

-Since 5/07/2021 every OPL build dispatched to the release section of this repository will be uploaded to a mega account, you can access the archive by clicking the mega badge on top of this readme +Since 05/07/2021 every OPL build dispatched to the release section of this repository will be uploaded to a mega account, you can access the archive by clicking the mega badge on top of this readme