View source

= Installation on Windows =


'''1.''' Download & Install [[Download#Ultima Online: Mondains Legacy Client|Ultima Online Mondains Legacy Client]] (Update Mondains Legacy Client to newest Version (up to '''Stygian Abyss Expansion''')).<br>
(don't take the OSI download "setup-1.46.0.x.exe", because they removed the needed 3d character models!)

'''2.''' Download the Windows Installer ( [[Download#Iris2|Iris2_Setup.exe]] ).

'''3.''' Install Iris2.

'''4.''' Start Iris2 Updater (if now automatically started).

'''5.''' Now choose to '''Update Iris2''' or '''just start Iris2''' with the '''Iris2 Button on the bottom''' of the Updater.
* if you have problems running the updater under vista, try running it as admin
<br>
<br>

== How to set up HotKeys and Macros ==

since iris doesn't have a nice editor dialog for hotkeys and macros yet, they have to be set up by editing config/mymacros.lua  

for more infos on how to do that please see [[Macros#quickstart|Macros-Quickstart]]

= Installation on Linux =

== Suse ==

Press this LINK to start the Suse ONE-Click Install of Iris2<br>
[[Image:Ympbutton.png]]: http://packman.links2linux.de/install/iris2



or navigate here:
http://packman.links2linux.de/package/iris2

== Ubuntu ==
=== Setup Iris2 ===

Install Subversion:
<pre>
sudo apt-get install subversion
</pre>
Checkout Iris2 sources (go into Console, create an folder called svn_iris, go into this folder and type):
<pre>
svn co svn://iris.schattenkind.net/iris/trunk

cd trunk

./installdeps.ubuntu.sh
</pre>

* note for ubuntu 9.10 (karmic) : libboost-thread1.37-dev is no longer available, use libboost-thread1.38-dev instead
* we should add an info if fmod is not installed and if installed create a symbolic link or search the right file
* we should add g++ and libogre-dev, libois1, libois-dev and wine here!)

<pre>
sudo apt-get install g++

./makeclean.sh 
./premakelinux.sh
</pre>

if you get linker errors like "undefined reference to ... FMOD_..." (64 bit problem)  you can disable it by editing premake.lua and setting "gbUseSoundFmod = true" to false

=== Setup Ogre3d ===

copy & paste in Terminal
<pre>
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 6FED7057
</pre>

Then got to System->Administration->Software Source. Click on the "Third Party Software" Tab and then click the "Add" Button.


Replace the word jaunty with your version of Ubuntu and add there repositories.

<pre>
deb http://ppa.launchpad.net/andrewfenn/orgedev/ubuntu jaunty main

deb-src http://ppa.launchpad.net/andrewfenn/orgedev/ubuntu jaunty main
</pre>

After you have done this click close.


Hit the Reload button to update your sources.


Than search in Synaptic for "libogre-dev" and install it. Or Go on the left Side on Origin, select ppa.launchpad.net/universe and select "libogre-dev" for installation. Also install "libois1" and "libois-dev". ogre-doc may be also usefull.

=== Setup FMod (optional) ===
grab a copy of fmod from http://www.fmod.org/index.php/download .

* Linux 32bit (Stable 4.xx) or
* Linux 64bit (Stable 4.xx)

Extract this tar in your home directory (go into file Browser, right click on (fmodapixxxxlinux.tar.gz) and select "Extract here").


Then go into the Console:

<pre>
cd fmodapixxxxxxlinux

sudo make install
</pre>
(type in admin password)

<pre>
you probably have to add a symbolic link so that iris can find the fmod lib, since the filename contains the version
to do that run
#> locate libfmod
if it lists something like /usr/local/lib/libfmodex-4.27.06.so
then you should make a symbolic link like this :
#> sudo ln -s /usr/local/lib/libfmodex-4.27.06.so /usr/local/lib/libfmodex.so
then iris will find it during compile : ./makeclean.sh && ./premakelinux.sh
if you get linker errors like 'undefined reference to ... FMOD_...' (64 bit problem) you can disable fmod by editing premake.lua and setting 'gbUseSoundFmod = true' to false
</pre>

=== Install Ultima Online:Mondain's Legacy Client via WINE ===

Install and Download WINE on your Linux.<br>

Download [[Download#Ultima Online: Mondains Legacy Client|Ultima Online Mondains Legacy Client]] (Update Mondains Legacy Client to newest Version (updates Up to '''Stygian Abyss Expansion''').<br>
::<font color="#FF0000">IMPORTANT: Only '''this''' Version of Ultima Online Client works!</font>


Start UO-Installer with WINE.<br>
Install uo.<br>

=== Start Iris2 ===
<pre>
/trunk

./start.sh
</pre>

== Debian ==

Just like Ubuntu with some more work, but if you are a Debian User, you can handle it ;-).


== How to set up HotKeys and Macros ==

since iris doesn't have a nice editor dialog for hotkeys and macros yet, they have to be set up by editing config/mymacros.lua  

for more infos on how to do that please see [[Macros#quickstart|Macros-Quickstart]]

Good Luck :-)