A Guide to Running Planeshift on Mac OS X.
P.P.P.S. Those who want to launch Planeshift with an extra command (such as "-fullbright", which will completely illuminate all maps), read the following:
I have brought back PSClientCMD to help Planeshifters that would like to run Planeshift with special arguments but don't want to launch it from the command line. There is basically a two-step setup procedure which I've elongated to six steps to make it easy for anyone to use.
The steps required to use PSClientCMD are as follows:
1. Downlaod the application: PSClientCMD.jar (2 k)
2. Move the application into your Planeshift 3D folder.
3. Open TextEdit (/Applications/TextEdit(.app)). Create a new document if one is not already open (from the "File" menu, select "New"). Pull down the "Format" menu. If the option "Make Plain Text" is available, select it. If the option instead reads "Make Rich Text" then do nothing.
4. Type any arguments you want to send to Planeshift when it runs. Include a dash ("-") before each argument and separate each argument with a space (" "). Do not enclose the arguments in quotes. All the arguments must be on one line (line wrapping is ok; just don't press the return or enter key).
5. Save the file in your Planeshift 3D folder as "PSClientCMDlist.txt" (a plain text document). This exact name must be used.
6. Double-click "PSClientCMD.jar" whenever you want to run Planeshift. The arguments will be passed when the client launches.
You can get a list of available arguments by running psclient with "-help" as an argument. Note that this list is not exhaustive: some options exist that are not listed (such as "-fullbright" removes lighting so that everything is illuminated). I've copied the current list here:
Code:
Options for MacOS X 2D graphics drivers:
-screen=<num> Screen number to display on (default=0)
Options for Crystal Space 2D driver for MacOS/X (OpenGL):
-depth=<val> Display depth (32)
-[no]fs Fullscreen if available (no)
-mode=<val> Window size or resolution (1280x854)
Options for Crystal Space 3D Engine:
-fov=<val> Field of Vision (0)
-[no]relight Force/inhibit recalculation of lightmaps (no)
-renderloop=<val> Override the default render loop ()
General options:
-help this help
-video= the 3D rendering driver (opengl, software, ...)
-canvas= the 2D canvas driver (asciiart, x2d, ...)
-plugin= load the plugin after all others
-verbose be more verbose; print better diagnostic messages
>
