ViewVC Help
View File | Revision Log | View Changeset | Root Listing
root/Oni2/ps2launchargs/Instructions.rtf
(Generate patch)

Comparing ps2launchargs/Instructions.rtf (file contents):
Revision 1102 by iritscen, Sun Feb 18 15:18:35 2018 UTC vs.
Revision 1108 by iritscen, Sat Jul 7 01:37:21 2018 UTC

# Line 1 | Line 1
1 < {\rtf1\ansi\ansicpg1252\cocoartf1561\cocoasubrtf200
1 > {\rtf1\ansi\ansicpg1252\cocoartf1561\cocoasubrtf400
2   {\fonttbl\f0\fswiss\fcharset0 Helvetica;}
3   {\colortbl;\red255\green255\blue255;}
4   {\*\expandedcolortbl;;}
5   \margl1440\margr1440\vieww12600\viewh10380\viewkind0
6   \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\qc\partightenfactor0
7  
8 < \f0\b\fs28 \cf0 How to Pass Launch Arguments to the Dev Build of Oni 2 (Angel Studios)
8 > \f0\b\fs28 \cf0 How to Pass Launch Arguments to a PS2 Game\
9 > (such as the developer build of Oni 2)
10   \b0 \
11   by Iritscen\
12   \
13   \pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0
14   \cf0 Requirements:\
15 < - the contents of this package\
15 > - all the files in the top level of ps2launchargs/\
16   - PCSX2\
17 < - the Oni 2 ISO\
17 > - a PS2 game on disc or an ISO\
18   - (recommended) a USB gamepad\
19   \
20 < As of Jan. 2018, there is no existing way to pass launch arguments to a game on your PlayStation 2, nor in the PCSX2 emulator, nor in the homebrew boot loader uLaunchELF ("uLE" for short).  So I have created a custom build of an older version of uLE (v4.40h, the last known version compatible with PCSX2) which accepts launch arguments from a text file.  This is the BOOT.ELF file in this package.\
20 > As of Jan. 2018, there is no existing way to pass launch arguments to a game on your PlayStation 2, nor in the PCSX2 emulator, nor in the homebrew boot loader uLaunchELF ("uLE" for short).  So I have customized an older version of uLE (v4.40h, the last known version compatible with PCSX2) to accept launch arguments from a text file and pass them to the game when launching it.  The BOOT.ELF file in this package is the custom build of uLE.\
21   \
22 < The following process must be performed in Windows, as uLE 4.40h does not run in the Mac build of PCSX2 (as of v0.97), nor in virtualized Windows on a Mac (at least, not in Fusion vmWare as of v10.1.1).  Follow these steps to start sending launch arguments to Oni 2:\
22 > The following process must be performed in Windows, as uLE 4.40h does not run in the Mac build of PCSX2 (as of v0.97), nor in virtualized Windows on a Mac (at least, not in Fusion vmWare as of v10.1.1).  Follow these steps to start sending launch arguments to a game:\
23   \
24 < 1. On the command line, move to the directory that contains ps2client.exe (in this package's folder) and call "ps2client.exe -h 192.168.0.10 listen".  ps2client will begin offering to share with PCSX2 the directories listed in elflist.txt.  This file must be kept next to ps2client.exe, and it is currently set to "C:" (meaning "share all of the C: drive").  Note that all hard drive access is read-only by default and that uLE is only interested in the LaunchArgs.txt file.\
24 > 1. On the command line, move to the directory that contains ps2client.exe (in this package's folder) and call "ps2client.exe -h 192.168.0.10 listen".  ps2client will open a port for sharing with PCSX2 the directories listed in elflist.txt.  This file must be kept next to ps2client.exe, and it is currently set to "C:", meaning "share all of the C: drive".  Note that all hard drive access is read-only by default and that uLE is only interested in the LaunchArgs.txt file.\
25   \
26 < 2. Ensure that LaunchArgs.txt contains what you want to be passed to Oni 2.  Each new line is a separate argument.  This file must be kept next to BOOT.ELF.  Known launch arguments are documented on the wiki (the shortcut "Oni2AS" will eventually lead you to the right place).\
26 > 2. Ensure that LaunchArgs.txt contains what you want to be passed to the game.  Each new line is a separate argument.  This file must be kept next to BOOT.ELF.  Known launch arguments for Oni 2 are documented on the wiki (the redirect page "Oni2AS" will eventually lead you to the right place).\
27   \
28 < 3. Open PCSX2 (this was tested with v1.4.0).\
28 > 3. Open PCSX2.  (These instructions were written for v1.4.0.)\
29          A. Enable filesystem access by choosing System>Enable Host Filesystem.\
30 <        B. Under the CDVD menu, choose the Oni 2 ISO as the disc to be mounted.\
30 >        B. Under the CDVD menu, you need to pick "ISO" if you have an image file (like Oni 2) or else "Plugin" if the game is on disc.  Your choice will be mounted within uLE.\
31          C. Choose System>Run Elf\'85 and choose BOOT.ELF (in this package's folder).\
32 <        D. Navigate in the file browser to cdfs:, then choose SCPS123.45 with the circle button.  The game will be launched with the arguments you chose in step 2.\
32 >        D. Navigate in the file browser to cdfs:, then choose the game binary (for Oni 2, this is SCPS123.45) with the circle button.  The game will be launched with the arguments you chose in step 2.  If you cannot see the game in cdfs: (this may happen for any DVD-ROM game), you can always go to the main menu's MISC directory and choose "PS2Disc".\
33   \
34   4. There are two ways to ensure that launch arguments are being passed properly:\
35 <        A. They have an effect in-game.  The simplest working argument that you can test is "-noui", which will cause Oni 2 to start with the first mission instead of the main menu.\
36 <        B. The PCSX2 Console (see Misc menu if it is not already open) will show uLE reading LaunchArgs.txt and printing the contents received, then uLE's separate loader binary will be called, and then the loader will show the arguments being received on its side and passed to the game.\
35 >        A. Look for an effect in-game.  The simplest working argument that you can test with Oni 2 is "-noui", which will cause the game to immediately load the first mission instead of the main menu.\
36 >        B. Open the PCSX2 console (Misc menu) and search for "uLaunchELF" to see messages from uLE as it reads LaunchArgs.txt and passes the arguments to uLE's loader, a separate binary stored inside BOOT.ELF which actually launches the game.\
37   \
38   Have fun!}

Diff Legend

Removed lines
+ Added lines
< Changed lines (old)
> Changed lines (new)