Geoscape

 

 

Site by Intri

Utto

    Home   Manual   Screenshots   Downloads   Links   About  

 

Manual for Utto 0.2.3

Utto

Contents:

1. About

2. Requirements

3. Running/compiling

4. Using

4a. General
4b. Chat
4c. Options
4d. Shortcut keys

5. Troubleshooting

6. More informations and credits


1. About

Utto is support application for Ufo2000 game made in C++/Qt 4.6 (previously 4.2 for Utto 0.2.2 and older), so application's status is Open Source.

NOTE : THERE IS NO GUARANTEE FOR THIS APPLICATION - YOU USE IT ON YOUR OWN RISK.

See "ChangeLog.txt" file for the application's history and the 'License.txt' for license information (also available at 'License' section in Utto).

Visit http://utto.yoyo.pl for latest news about Utto.

2. Requirements

System requirements : if you can run Ufo2000 you should be able to run Utto with the same system resources too.
For compiling : Qt 4.6 (or highter).

There is no need for having Ufo2000 game installed to run this application but 'Ufo2000 help' and 'Launch Ufo2000' functions will be disabled and other might not work properly in that case. Also it is Ufo2000 game support application so using it without the game is quite silly (but there are known cases for doing that anyway).

3. Running/compiling

3a. Running on Windows (no need for having Qt installed):
Run 'Utto.exe' from 'Utto' directory.
Make sure you've got important Qt's DLLs placed next to Utto.exe file (or in directory included in your PATH variable) - these DLLs are available for download from the same source as Utto.

NOTE: DLLs from previous versions of Utto (0.2.2 and older) won't work with current one so make sure you have proper files.

List of DLLs :
- libgcc_s_dw2-1.dll
- mingwm10.dll
- QtCore4.dll
- QtGui4.dll
- QtNetwork4.dll
- QtXml4.dll
3b. Compiling on Windows/Linux (you need to have Qt version 4.6 or higher - 4.6 would be the best because it has been used to make this application)
I. Run the console (in Windows "Qt 4.x.x Command Prompt" from Start=>Programs=>Qt by Trolltech v4.x.x) and go to 'Utto\src' directory.
II. Type qmake (or qmake-qt4 if you have qt3 installed too) and press Enter.
III. Type make and press Enter.
IV. Go to 'Utto' directory and run 'Utto'.

4. Using

4a. General
I suggest to set Ufo2000's directrory and other things at the options tab firstly.
Secondly, you should read informations at 'about' tab.

Utto window

After doing that you can see what is displayed on each tab (1). As you can see most of the tabs are read-only (2).
You can notice that 'traffic' tab is reloaded every 5 seconds (default value).
You can talk with Ufo2000 players directly through Utto's messaging system (3, 4) (See 'Chat' section of this manual).
When you see that someone is at the Ufo2000 server you can launch the Ufo2000 game. (gameplay in this mode shouldn't be buggy but if it causes bugs, report them - see 'More informations' section).

There are two modes of running Ufo2000 available:
- First mode is normal - after pressing F9, "Launch Ufo2000" button or "Launch Ufo2000" from tray icon menu, the game will start.
- Second one is quick - after pressing Ctrl+F9 or "Launch Ufo2000 directly on server", the game will start and put you directly on the Ufo2000 official server (lobby screen).

NOTE: You should have got an unique nickname and password in the Ufo2000 game before using second mode.

If you click a link, a default browser will open it.
You can minimize application to tray by pressing F12, 'To tray' button or 'To tray' from tray icon menu (10).
Number of users online appears as tray icon tooltip.
Each connection/disconnection to Ufo2000 server is reported by a message ("balloon") from tray icon.
Also, sound is played - you can disable sound effects in tray icon menu.
If tab's content wouldn't load at first time, you can use 'refresh' button.
'Stay on top' and 'compact mode' buttons bring some display possibilities.
Two clocks display your local time and xcomufo.com time (7).
List of connected players is visible all the time at the bottom of the window (8) - you can see it no matter on which tab you are currently.
You can switch between official server (ufo2000.xcomufo.com) and unofficial one (ufo2000.kostax.cz) by using a combobox above the clocks (6) - server's switching is applied only to traffic monitoring, not to chat.

There are five translations available now (Dutch, English, German, Estonian and Polish) - you can switch between them at 'options' tab.
You can also prepare your own translation - see "translations.txt" file in "translations" directory.
4b. Chat
Messaging system included to Utto allows to chat with Ufo2000 players and other Utto's users in easy way.
It is available at 'Traffic' tab and also in Compact Mode.

Lobby

To run it, press 'Now : Disconnected' button (5). Its caption informs you that you aren't currently connected to the Ufo2000's lobby.
After doing that, the caption will change into 'Now : Connected' (it will be invisible for five seconds) - messaging system is ready to use and input field is active (4).
If you want to disconnect, press that button again (it will change back to 'Disconnected' state, invisible for five seconds too).
You will be logged to server as 'Utto#nickname' where 'nickname' is your Ufo2000's login.

NOTE : Chat works only at the official server (ufo2000.xcomufo.com:2000).

Maximum size of a single message is 70 characters - that's because it should be visible properly for Ufo2000 players too.
Every written message will be also visible for Ufo2000 players at the game lobby.
You can talk as long as you want - when you decide to play, just run Ufo2000 by 'Launch Ufo2000' button.
Your Utto's nickname can still be available for chat during your match - but this is not a must, you can switch to disconnect state at any time.
Everytime you send/receive a message or Utto displays important information, additional sound is emitted. You can disable it in tray icon menu.

NOTE : List of tags, smilies and pictures is available by typing 'help' and pressing 'Enter'.

You can use input's edition toolbar (6) for quick message editing, inserting smilies and unit's pictures.

There is a list of connected users on the right side of frame of messages (3).
Users can be visible in three modes (2):
- all users - people with any version of the Ufo2000 game and Utto's users
- same Ufo2000 version + Utto users - people who have got the same Ufo2000 version as you and Utto's users
- only Utto users - people who use Utto only

NOTE : Filter was prepared for list of users purpose only, it WILL NOT filter your messages to certain users (all users will see them).
4c. Options
The 'Options' tab contains some changable parameters :

Options

- Your Ufo2000 directory (1)
You can write it directly or pass it through 'Browse...' button. Utto needs this information for proper working.
NOTE : Invalid Ufo2000 directory name may cause Utto to work incorrectly.
- Your Ufo2000 version (2)
This information is used e.g. at chat's user filter. If you don't know which version of Ufo2000 you've got, run the game - version's number should be avaiable after clicking on 'About'.
NOTE : Every dot is important here! Spaces are not allowed - only numbers and dots.
- Your language (3)
You can choose Utto's translation file here.
- Traffic refresh frequency (4)
It describes, how often informations at 'Traffic' section should be refreshed (in seconds).
- News\Updates\Tournament refresh frequency (5)
It describes, how often informations at other sections should be refreshed (in minutes, hours or only at application's startup).
- Color scheme (6)
There are four color schemes available at this place : blue, red, green and darkslategray. If you want to see other color scheme (e.g. yellow), you should edit 'options.xml' file at 'colors' tag. baseColor0, baseColor1, baseColor2 and baseColor3 have got values mentioned above. Replacing one of them with #FFFF00 (yellow) or any other color allows you to use new color scheme (but name from combobox is not editable).
4d. Shortcut keys
Tabs
F1Traffic
F2Updates
F3News
F4Tournament
F5Ufo2000 Help
F6Options
F7Links
F8About
Launching
F9Standard launch of the Ufo2000 game
Ctrl + F9 Quick launch of the Ufo2000 game
Interface
Ctrl + F1Switching chat's background color
Ctrl + mouse wheelIncrease/decrease font's size at any browsed frame (manual, chat, etc.)
Ctrl + RReload content of current tab (if possible)
Ctrl + TAllows to see application's window all the time
F11Compact mode
F12Minimize to tray

5. Troubleshooting

Q: I got error message instead of tab's content ("Server access failed" or "Server is not available!").
A: You haven't connected to internet OR site isn't available OR site content was changed to other format. Try to connect to the internet or refresh content by "refresh" button.

Q: Ufo2000 doesn't start after pressing "Launch Ufo2000" button.
A: You haven't installed Ufo2000 OR you have put invalid directory name at 'options' tab OR your ufo2000.ini file doesn't contain password and/or unique nickname.

Q: The application crashes after running or work with reduced functionality.
A: This may happen if important files were removed or uncorrectly edited.

Q: I can't see tray icon in system tray/notification area.
A: Your operating sytem doesn't support tray icon OR Qt 4.6.3 doesn't support tray icon's displaying on your operating system.

Q: I can't hear any sound when someone is connecting or disconnecting to Ufo2000 server.
A: You haven't checked "Enable sound effects" in tray menu OR your sound emitting device (e.g. earphones) is switched off/not working OR your sound card is not compatible with Qt sound system OR you haven't got a sound card :-).

Q: I can't write a message to other users.
A: You haven't connected to server's lobby by 'Now : Disconnected' button.

Q: I can't write some characters in the chat's input.
A: Some sets of characters are forbidden to use (e.g. HTML tags).

Q: I received information : "Text was too short or contained forbidden phrase".
A: You entered too short message and/or it contained forbidden phrase - try to write it again correctly.

Q: I can't see the part of text which has been written by someone in a certain color.
A: Try to use "Ctrl + F1" - it will change the backcground color of messages.

Q: Font is too small/too big to read.
A: Try to use "Ctrl + mouse wheel" - it will change size of font at the current frame.

Q: Some kind of bug/error/problem occured not listed above.
A: See 'More informations' section for bugs reporting procedure.

6. More informations and credits

Utto 0.2.3 Copyright (C) 2008-2010 Intri ( intri2000@onet.eu )

Programming : Intri

Programmer Art : Intri, hurz

Translations : FUEL (Dutch), hurz (German), Intri (Polish), Trolly (Estonian), Nidhegg (Russian)

Special thanks to :
- Ufo2000 Development Team - for making the ufo2000 game
- MicroProse - for making the X-Com games
- Trolltech/Qt Software - for making Qt4

For more informations see Utto main page http://utto.yoyo.pl or thread at Ufo2000 forums http://www.xcomufo.com/forums/index.php?showtopic=242028814.
If you have some ideas/suggestions/opinions/bug informations or got prepared translation(or other) files, put them at http://www.xcomufo.com/forums/index.php?showtopic=242028814. or send to intri2000@onet.eu

This manual was prepared by Intri. The manual is part of the Utto package.

 


 

Valid HTML 4.01 Transitional Poprawny CSS!