Space Adventure Game
C C++ Lua Other
Failed to load latest commit information.
Build Merge git:// Jul 4, 2012
Doxygen Add comments and remove blank lines. May 29, 2011
Resources added sound files Oct 22, 2012
Source Added seperate sounds for JumpGate and JumpDrive Oct 22, 2012
.gitignore Added XCode 4.4 IDE files May 29, 2012
.mailmap Updated the AUTHORS file Dec 7, 2010
AUTHORS Add More Station Images from Irbis Sep 7, 2011
BUILDING Fixed some typos in BUILDING and INSTALL files Nov 16, 2010
COPYING Initla import. Jan 17, 2009
CREDITS.GNU-FreeType Adding GNU FreeType fonts and Credits. Jan 13, 2010
ChangeLog Updated ChangeLog May 16, 2012
Epiar.cmd Fixed windows permission problems... Mar 22, 2010
INSTALL Fixed some typos in BUILDING and INSTALL files Nov 16, 2010
LICENSE Initla import. Jan 17, 2009
LICENSE.bitstream_fonts Added new font: Visitor Feb 2, 2009 Changed music to new default. Possibly not the final song. Sep 7, 2011
LICENSE.other_fonts Changed certain fonts, adjusted size for readability. Jan 25, 2012
LICENSE.visitor_fonts Added new font: Visitor Feb 2, 2009
LISCENSE.usuzi.txt Add Usuzi TTF and Licences. Feb 4, 2011 Implemented calendar Jun 25, 2012
NEWS Put basic content in NEWS to satisfy GNU recommendations. May 17, 2011
PACKAGING Mac OS X Packaging Nov 21, 2010
README Misc. textual cleanup May 16, 2012
SDLMain.h Fixed animation loading bug. Fixed brown planet bug. Tell me if this … Nov 3, 2009
SDLMain.m Fixed animation loading bug. Fixed brown planet bug. Tell me if this … Nov 3, 2009
acinclude.m4 Initla import. Jan 17, 2009 Fixed windows permission problems... Mar 22, 2010 Minor permissions change on Aug 25, 2010 Updates for building on OS X May 29, 2012
epiar.desktop Added .desktop file for Unix installations. May 17, 2011
epiar.xsl Add xsl formatting for the xml logs Jun 28, 2011 Chmod +x on the script Jun 25, 2012


Version 0.5.0
Written by Christopher Thielen, Matthew Zweig, others (see AUTHORS)

Copyright (C) 2002-2012 Christopher Thielen.
Licensed under GNU GPL version 2. Some parts (e.g. fonts, sounds) licensed differently
and indicated where appropriate.

-       NOTICE       -
This document and source code are under heavy development and may contain
inaccurate information, bugs, and other issues. Use at your own risk!

1. What is Epiar?
2. System Requirements
3. Playing Epiar
	i. Controls
	ii. Single Player Epiar
	iii. Multi-Player Epiar
4. Epiar Editor
5. Reporting Problems
6. Credits

1. What is Epiar?
Epiar is a space exploration/combat/trading game.  The Escape Velocity (EV)
series for the Mac was the major point of inspiration for this game.  Other
notable games of this genre include:

- Elite (the original game EV was based on)
- Star control 1/2 (and it's now open source successor Ur-Quan masters)
- Star Flight
- Solar Winds

2. System Requirements
Epiar has been tested on Linux, OS X 10.6/10.7 and Windows XP/Vista/7.

3. Playing Epiar
Epiar is still under development and so the gameplay is in flux. If you
have any suggestions, please let us know.

i. Controls
The Escape key will quit Epiar.  When Epiar quits it saves your current game
settings and player progress.

You can open the settings window by hitting Question Mark (?).  This is where
you can adjust the Sounds volumes, change the key layout, or turn on Debugger

Manuever your ship with the Arrow keys.  The Left and Right Arrows will turn
your ship and the Up Arrow will accelerate your ship in the direction that it's
currently pointing.  The Down arrow will spin the ship to point in the opposite
direction that it is currently moving.  This can be useful for
slowing down and stopping your ship when you want to land.  The 'C' Key will
turn you towards the center of the universe (0,0).

SPACE - Fire the weapon that you currently have armed.  If nothing happens then you might be out of ammo or not have a weapon attached.
TAB - Cycle through all the nearby Ships.
t - Target the closest ship.
SHIFT - Cycle through your different Weapons.
P - Pause or Un-Pause the game.
m - Display a map of the entire universe.
M - Display a map of the current Quadrant.
i - Display player information.
l - Land on a planet.
w - Watch your target.
q - Quit watching your target.

ii. Single Player Epiar

iii. Multi-Player Epiar
We don't have any Multi-Player right now.  Sorry.

4. Epiar Editor
You can start the Editor by opening Epiar with the command line option
"--editor-mode".  You can also change the <editor-mode>0</editor-mode> option
in the settings file (Resources/Definitions/options.xml).

The controls in Editor Mode are a bit different than in the Normal mode.  The
Options (?), Pause(?), Map (m or M), Radar (0 through 9) keys all work
exactly the same.  Escape will still quit the game, but unlike in the Normal
mode, it will only save your game settings but does NOT automatically save your
Game changes.

The arrow keys pan the camera relative to the Radar
visibility, so use visibility '1' to do fine grained movement and visibility
'9' to zoom across the universe.

The Space-bar will open up a "goto" window so that you can jump to any point that you want.

The 'i' key will give you more information about whatever Sprite is currently
being targetted.  The camera will also lock on to that sprite and follow it

The Editor allows you to customize the Game Components (Alliances, Commodities,
Engines, Models, Planets, Technologies, and Weapons) however you want.  You can
add new Components or you can duplicate components simply by picking a new
name for an existing.

When you're done, hit the "Save" button to save all of your changes.

5. Reporting Problems
Please visit the IRC channel #epiar on freenode.
You can also sign up for the developer email list by visiting and subscribing to epiar-devel.

6. Credits
See AUTHORS file.