Open Source Platform
for interconnected virtual worlds

Getting Started with Naali 0.1.0

From Rex community wiki

What is Naali?

Naali is the realXtend's new Virtual World Viewer.

Technical limitations

Due to the Naali project being in early development stage there is no multiregion support in the Naali 0.1 release. That is, you can log-in to an Opensim grid like osgrid, but you will only see the initial region where you logged on to.

System requirements

GPU with Shader Model 3.0 support

Viewer features

OpenSim, realXtend and OpenID authentication and login
Inventory (OpenSim for OS logins, Webdav inventory for OpenID logins to Taiga)
Jabber IM
In World chat
Creating prims
Simple World Editing (object move, rotate and scale)
Internal Web Browser
Avatar Editing

Controls

Control	Action
W, A, S, D	Navigate in the world
F	Toggle the fly mode
SPACE	Jump / fly upwards in fly mode
C	Crouch (doesn't work in ModRex server) / fly downwards in the fly mode
MOUSE WHEEL	Move the camera closer / further off the avatar
TAB	Toggle the free-look mode
LEFT MOUSE	Touch object
RIGHT MOUSE	Look around in mouse-look mode (see below)
APOSTROPHE / SECTION	Toggle console

You can enter the mouse-look mode by zooming "into" the avatar with mouse wheel. In mouse-look and free-look modes, hold down the right mouse button to look around and, if you are moving simultaneously, to steer the avatar.

Console commands

Toggle the console overlay by pressing the button above TAB: apostrophe (´) on US keyboard layout and section sign (§) on scandic layout. Type help to get the summary of the available console commands.

Python

It is possible to run arbitary Python code within the viewer. A way is to put the code to bin/pymodules/usr/command.py and then press alt and the period key (alt-.) in the viewer window. See bin/pymodules/readme.txt for info about how to make own modules, bind arbitary keys etc. The early editing tool is implemented as a plugin, and 0.1 also comes with a Naali webserver plugin that can serve live screenshots over http (is disabled by default).

Getting and running Naali

Download the installer http://code.google.com/p/realxtend-naali/downloads/list
Install: run the executable and install to your preferred location. Follow the instructions given by the installer.
Run Naali 0.1 from your start menu or browse to your installation folder and execute viewer.exe

Building Naali from sources

To get started with viewer development or people who wants to build Naali for fun, check out the source code (via SVN) from Google Code: http://realxtend-naali.googlecode.com/svn/trunk/. Then see Building Naali from Source.

Login to worlds

realXtend Taiga servers

OpenSim authentication

OpenSim authentication can be found on the starting screen of the Naali 0.1 viewer.

Firstname and lastname into username field.
Password
Your Taiga CableBeach World server IP and port
- When testing locally use 127.0.0.1
- Default CableBeach WorldServer port is 8002
Click the Connect button

OpenID authentication

NOTE: 0.1 Web login functionality is somewhat different, this tutorial will be updated shortly.

OpenID authentication can be found from the second tab of the login window in the Naali 0.1 viewer. Insert the following and hit connect.

After clicking connect you will see a new window of the internal Web Browser of Naali. Input your OpenID identity you just created to the text input line and click the Sign In button.

You will be redirected to OpenID Providers login page where you need to give your password. Check the remember me checkbox. Click the Login button to proceed.

After hitting login the web browser should close and Naali will start the login into the world.

Note: If you get a black page with error message after hitting Login don't close the browser, just write http://127.0.0.1:8002/login again in the address bar (or gt it from the address bar drop menu that stores your browsing history). Insert your OpenID identity again and hit Sign In. Now that you checked 'remember me' last time, OpenID Provider wont ask your password again and your login should be successful on the second try. This error comes kind of randomly and we are trying to fix it, but this is the temporary fix in the 0.0.2 release.

Google Account login

Follow same steps as #Login with Naali using your Taiga OpenID identity until you are in the login page of your Taiga WorldServer, click the Google image to login with Google Account. This will redirect you to a Google page where it will ask you of your Google Account email and password. After this Google will ask if you want the world server to have access to your account to do login with it. Grant this and Naali should start logging you into the world.

Be assured that your personal Google account information is not exposed to anyone here. Google is only used as a OpenID Provider, to get some kind of identity for you in order to join the world.

Login successfull?

You now should be seeing a simple default terrain with a small island and water surrounding it. You avatar in the center and your firstname and lastname on top of it.

realXtend 0.5 servers

realXtend authentication style login can be found from the login window in the Naali 0.1 viewer

Insert username and authentication address (example.user@avatar.realxtend.net:10001)
Insert password
Insert world server address and port as in http://IP:PORT
- Default port 9000 (set to 8002 if connecting to a Taiga server)

Standalone OpenSim servers

OpenSim authentication can be found on the main login window in the Naali 0.1 viewer

Insert firstname and lastname as username
Insert password
Insert server IP and port as in http://IP:PORT
- Default OpenSim port is 9000
- http:// will be added automatically if missing
- If port is not given 9000 is used

OSGrid

You can connect to OSGrid with Naali 0.1, but there is no support for multiple regions. This causes you to be only in one region and the starting region cannot be chosen. More in #Technical limitations

More information about OSGrid at http://opensimulator.org/wiki/Grid_List/OSGrid
OSGrid default port is 8002

Communication

Using IM communication

Naali viewer supports jabber protocol for IM communication. You can use any jabber provider or event Google Talk accounts since they use jabber for IM protocol. You can find public jabber services here: Public Jabber servers

After you have a jabber account you can create connection to jabber server by activating IM login widget, giving your jabber credentials and pressing "connect" button.

By pressing "IM" button you will get the IM widget where you can manage your friend list and your presence status.

You can send friend request by pressing "Add friend" button and giving jabber id of your friend. After your friend has accepted your friend request she/he will appear on the friend list.

You can start text chat session with any friend on the friend list by clicking on a friend's name and choosing "Start chat".

Using in-world chat

You can chat locally in the world by activating chat widget

The chat feature is enabled only when you are logged in the world.

Using VoIP chat

VoIP chat works a lot like IM, just choose "Start video conversation" (Note: Video sending disabled in Naali 0.1) instead of "Start chat" in the friendlist.

Here's a nice video tutorial on the voice chat feature: http://www.youtube.com/watch?v=4iiE66hY-RU

Logging out of the Jabber account

Open the IM widget, select "Status" and set it to "Sign out".

Known issues: relogin may not work properly with Naali 0.1.

Using the Avatar Editor

To bring up the avatar editor, press the "Avatar Editor" button on the top-left toolbar.

From top to bottom, there are controls for adjusting appearance (morph and skeletal modifiers), changing textures, and editing attachments.

In the bottom row there are buttons for loading a new avatar, loading a new attachment, reverting to last saved avatar, and saving the new appearance.

Avatars and attachments are loaded to the editor from local hard disk. You can download and extract the ExtraAvatars-package http://dev.realxtend.org/gf/download/frsrelease/117/58/Naali-ExtraAvatars.zip for some of the avatars and attachments from the old realXtend viewer.

Note that currently (0.1) saving the avatar, and thus making it visible for others, is only supported when using the old realXtend authentication and avatar storage servers.

Content Creation Tools

In the current Naali version the content creation tools are still under construction. Here's a short overview of what features are already functional.