1OpenSSN - What is OpenSSN? 2========================== 3 4OpenSSN is a submarine simulation (subsim) which tries to emulate 5the behaviour of modern submarines. The player is placed in command 6of a submarine and is able to move about in a deep ocean environment. 7 8Combat missions are now being added to OpenSSN, and ships with 9sonar will run from torpedoes and, if they can detect the player, 10will return fire. 11 12 13 14Why a subsim? 15====================== 16 17I've always been a fan of subsims and played commercial games, 18but couldn't find a modern subsim for open source operating systems 19(such as Linux and FreeBSD). Danger from the Deep is available, 20but it's stictly for World War II u-boats, and has relatively high 21graphics requirements. Looking around I found a half dozen or so 22subsims that had begun and dropped away shortly after beginning development. 23 24The LinuxSSN project had laid a solid foundation before the developers 25dropped the project and I decided to pick up where they left off. 26The heart of OpenSSN comes from their project and attempts to further 27their work. 28 29 30 31 32Licensing info 33==================== 34 35The OpenSSN project is licensed under the GNU General Public License, 36version 2. The LinuxSSN project was also GNU GPL licensed and we 37carry on that tradition. Copyright Jesse Smith <jessefrgsmith@yahoo.ca> 38Please see the LICENSE file for further details. 39 40Data files, missions, artwork and images included in OpenSSN are 41licensed under the Creative Commons CC0 1.0 Universal license. 42Please see the ART-LICENSE file for full details. 43 44 45 46 47What do I need to build OpenSSN? 48================================= 49 50To build OpenSSN you'll need a C++ compiler (GNU's Compiler Collection 51is recommended) and the following development libraries: 52 53SDL 54SDL_gfx 55SDL_image 56SDL_mixer 57 58Assuming the above libraries are installed, it should be possible to 59build OpenSSN with the following commands 60 61tar zxf openssn-1.4.tar.gz 62cd openssn 63make 64 65 66 67 68 69Running OpenSSN 70================================== 71 72Once OpenSSN has built, an executable file (called openssn) will 73be placed in the top level directory. From there 74the game can be run with the command: 75 76./openssn 77 78The following command line parameters are recognized: 79 80-w Run in windowed mode, this is the default 81-f Run in full screen 82-s Enable sound effects 83-v Display version number and exit 84-h Display help and exit 85-m <mission> Load a specific mission 86 87 88 89 90Control Keys 91=========================== 92 93The player's submarine can be controlled with either the mouse 94or keyboard commands. The following key commands are recognized. 95 96Pilot the submarine.............. 97Plus key Increase sub's speed 98Minus key Slow down 99Left keypad (4) Turn left 100Right keypad (6) Turn right 101Down keypad (2) Dive deeper 102Up keypad (8) Rise toward the surface 103Q Go up one thermal 104A Hold depth here 105Z Go down one thermal 106S Surface 107X Go to periscope depth 108 109 110System controls................... 111F1 Sonar screen 112F2 Map screen 113F3 Weapons station 114F4 Helm console 115F5 ESM signals screen 116F6 Radar screen 117F10 Take screen shot 118TAB Select next target 119Delete Increase map scale 120Insert Decrease map scale 121Up, down, left, right Manipulate map 122P Pause the game 123Page Up Compress Time 124Page Down Slow time 125ESC Quit 126 127 128 129Weapon controls 130T Load a torpedo 131N Load a noise maker 132U Unload a tube 133F Fire a tube 134 135Each of the weapon station keys should be followed by 136a number indication which tube should be loaded or fired. 137The tubes are numbered 1-6. 138 139 140Sonar controls 141G Send active sonar pulse. 142E Extend sonar array 143R Retract towed sonar array 144W Hold towed sonar in place 145 146 147 148 149Contact information 150============================ 151 152Did you find a bug? Would you like to request a feature? Did 153you patch something and want to share it? Send an e-mail to 154jessefrgsmith@yahoo.ca. Please place "OpenSSN" in the subject line. 155 156