TransGaming Point2Play Beginners Guide April 16th 2003 This document applies to using version 1.0 of Point2Play as released with WineX 3.0 =================== System Requirements =================== Operating System ---------------- Core requirements are: - Linux Kernel 2.2 or higher. Stock Kernels recommended over RedHat 7.x/8.x kernels. - XFree86 4.0 or higher (4.1 and above recommended) - glibc 2.2 or higher - Working hardware accelerated OpenGL video card CPU Type and Speed ------------------ Recommended minimum hardware is - 500 MHz or faster Pentium or Athlon CPU - 64MB of memory; 128 MB or higher recommended - 1-2 GB free hard disk space for games - Linux Supported 3D graphics card with 16MB of video RAM is required. nVidia GeForce-class GPU recommended. ========================= How To Install Point2Play ========================= Point2Play is available in a variety of pre-built binary packages designed to suit your Linux distribution. First select the package that is right for you: rpm - RedHat Package Management (RedHat Linux, Mandrake Linux, etc) To install the Point2Play rpm package open a console/terminal window and execute the following command as 'root': # rpm -ivh Point2Play-[version].rpm deb - Debian Package (Debian GNU/Linux, Corel/Xandros Linux, Lindows, etc) To install the Point2Play deb package open a console/terminal window and execute the following command as 'root': # dpkg -i Point2Play_[version].deb tgz - Tar GZipped Package (Slackware Linux, etc) To install the Point2play tgz package open a console/terminal window and execute the following commands as 'root': # cd / # tar -xvzf Point2Play-[version].tgz =================== Starting Point2Play =================== You can start Point2Play from the start menu of your window manager: start -> WineX -> Point2Play. You may also start Point2Play from the command line. Open a terminal and type 'Point2Play &'. ======================================== Configuring Your Computer For Point2Play ======================================== Point2Play is simply a graphical front end for TransGaming's core WineX technology which enables you to run Windows applications on Linux. To facilitate setting you computer up Point2Play can help you determine if your setup is sufficient for gaming using WineX. The easiest way to determine if your system is setup correctly is to choose the "System Tests" tab. Once you click this tab, you will be presented with 3 tests: "check CD/DVD drive", "Basic test for hardware acceleration" and "check the capabilities of the system". These will test your CD-ROM setup, your graphics setup and your sound setup - all the essential portions of your computer to run games. If you are unsure if your computer is setup correctly it is suggested that you run all of these tests and verify that each of them passes. If, for some reason, one or more of these tests fail, please refer to, and follow the instructions in, the "TransGaming WineX Beginners Guide" section titled "Configuring Your Computer for WineX". ================================= Installing WineX using Point2Play ================================= If you wish to use Point2Play to install and run games, you will need to download a version of WineX from TransGaming. This is accomplished by choosing the "Update" tab. When you click on the "Update" tab, you will be presented with fields to enter your TransGamer username and password. These are the same username and password you use for logging into TransGaming's web site. Additionally, if web access from your machine to the internet needs to go through an http proxy, you can provide the host and port number to reach the proxy. Note that if you do need to use the "Http Proxy" that you must click the checkbox to enable it's use. To get the latest version of WineX click the Get Latest Version button. Point2Play will then connect to a TransGaming Technologies downloads server, get and install WineX. Once this is finished you are ready to install a game. ================================== Installing a Game Using Point2Play ================================== If you already have games already installed on your computer, through WineX, you can make all these games accessible though Point2Play by following the instructions in the section entitled "Converting existing .transgaming directories to Point2Play". To install a new game there are 3 steps to follow: 1) Make sure the program you wish to install is on your computer and accessible. This means either inserting the CD-ROM into the drive or copying a demo onto your drive. 2) Install the file by choosing the "Install" button from the "Main" tab. This will prompt you to find the installer program for your software (usually 'setup.exe' or 'install.exe' on your CD-ROM). When you have found the installer you want, click on it select OK. You will then be prompted to enter a Program Title. All software installed by the installer will be accessible through this title. Your program should now install and create icons in Point2Play only - with Point2Play running no icons will be created on your desktop. 3) You're done. Take a break. That was hard work wasn't it? ========================================= Installing a Game Update Using Point2Play ========================================= Some games require a patch to run properly. Point2Play is capabable of easily patching installed games. 1) Ensure that the patch is available on your computer. If the patch comes in a compressed file format be sure to uncompress it before continuing. 2) Click the "Install" button on the "Main" tab. Browse to the location of patch executable, select it and click okay. 3) Make sure that the Program Title of the game you wish to patch is selected. 4) Click continue. The patch should install as normal. =============================== Running a Game using Point2Play =============================== As you started up Point2Play for the first time you no doubt wondered why everything was blank on the "Main" tab! Well this is where all the games that you have installed are listed. Highlight a game, push the "Play" button and you're off to the races. If you'd like to tweak some operational parameters for the game, such as passing a flag to the application, highlight the game, select configure and configure away. ==================================== Uninstalling a Game using Point2Play ==================================== >From the "Main" tab again. Hilite the game and push the "Remove" button and presto wizzo the game uninstalls. ========================================================== Converting existing .transgaming directories to Point2Play ========================================================== To convert an existing .transgaming directory to use for Point2Play follow these steps while making appropiate substitutions: 1) mv $HOME/.transgaming $HOME/.point2play/WineX-Pre3 2) Edit the .point2play/WineX-Pre3/config file and change the line that reads: "Path" = "${HOME}/.transgaming/c_drive/" to read: "Path" = "${HOME}/.point2play/WineX-Pre3/c_drive/" 3) Start Point2Play and use the add/remove icon feature to add icons for your old games into Point2Play. See the section on adding and removing icons in Point2Play for more detail. ======================================= Adding and Removing Icons in Point2Play ======================================= Some game installers add icons that you don't want to Point2Play, or do not add icons that you do want. Point2Play has the ability to add and remove icons from its icon lists. To remove an icon: 1) Highlight the icon and game title you wish to remove. 2) Select tools, icons, remove. 3) If you are sure say yes. To add an icon: 1) Highlight the "Program Title" where you wish to add the icon. 2) Select toosl, icons, add. 3) Type in a display name for the icon. 4) Enter the full path for the game executable or click on the "Browse" button and browse to the game executable. 5) Enter the full path for the icon you wish to use or click on the "Browse" button and browse to the icon. 6) Set your working directory in the final box. If you are unsure what to put here enter the directory that the game executable is in. 7) Click OK You're Done! Your icon should appear in the list on the right side of the main tab. ============ Known Issues ============ CD-ROM/DVD Drive Setup ---------------------- In order for Point2Play to be able to mount or unmount your CD-ROM, you must have sufficient permission for the unix device. If you do not have sufficient permission to do this, Point2Play will be unable to mount your CD-ROM or DVDs and fail with an error. For Point2Play to not fail, you will need to modify your system's configuration in order to give permission to mount and unmount CDs for the user id that is executing Point2Play. Here are a set of general instruction which can be used to provide sufficient permissions if you do not wish to setup something like supermount. Be aware that doing this could pose a SECURITY RISK if your machine is not located in a secure environment. As root, load /etc/fstab into your favourite editor. Locate a line that appears to be for your CDROM, like this one: /dev/scd0 /mnt/cdrom iso9660 iocharset=iso8859-15,codepage=850,umask=0 0 0 Each entry is divided into a number of fields, divided by 1 or more spaces, telling Linux how to handle mounting that particular device. What you want is the 4th one, fs_mntops, which give mount options associated with the file system. Add "user" to the comma seperated list of options, like this: /dev/scd0 /mnt/cdrom iso9660 user,iocharset=iso8859-15,codepage=850,umask=0 0 0 This will allow any user on your system to mount and unmount that CDROM drive. (If you had the CDROM already mounted, you may need to unmount it as root before it will allow you to mount/unmount it as a user)