Learn how to modify the server settings for your domain.
Once you've finished setting up your home domain, you can now start exploring server settings that would best meet your needs.
This page covers how you can
Access your server settings.
Enable your updated settings.
View your Metaverse/Networking settings.
Add a description for your account, select users who can share your domain, and set hours of operation.
Manage the security of your domain.
Define the scripts that run in your home domain.
Manage the audio settings in your sandbox.
Manage the Entity Server's settings.
This document assumes that you already have Sandbox running on your local machine. If you don't, check out how you can install and set up your sandbox here.
Launch your sandbox by clicking the icon in the system tray (Windows) or in the top menu bar (OS X) and clicking Go Home.
To view the settings page click on the Settings option.
This opens the server settings page ([http://localhost:40100]) in your default web browser.
You can navigate to specific settings using the navbar. By default, only the basic settings can be viewed. To see advanced settings, click Show Advanced.
If you modify your settings, you'll need to save and restart for the new settings to be reflected. You can do this by clicking Save and restart once you're done with your modifications. This saves your settings and restarts your domain server.
You can configure your domain ID and networking settings using the Metaverse/Networking settings. Go to Metaverse/Networking on the navbar.
Before you edit these settings, you have to be logged in to your High Fidelity account. If you don't already have one, you can sign up for a High Fidelity account now.
Once you log in to High Fidelity, you can generate an access token. You can do this by:
You can enter a Name here for the token to help you remember what this token is for.
Clicking I've copied the token does NOT copy the token. You must copy the token by highlighting it and using command-C (Mac) or Ctrl-C (Windows).
When you run sandbox, it generates a domain ID and a temporary place name for you.
To change the domain ID, you can select Create new domain ID or Choosing from my domains. Learn more about domain ids and place names here.
You can choose one of the following network settings for your domain:
Changing the domain's automatic networking settings will update this settings in the High Fidelity database.
A place name is a domain's unique name within the High Fidelity Metaverse and it is one of the easiest ways for other users to reach your domain.
Your randomly generated place name cannot be show in the High Fidelity Directory or be authenticated (it can be impersonated). You also cannot choose the generated place name.
You can purchase a place name of your choice for your domain.
You can use the Description settings to describe your account and set the operating hours. In the navbar, click Description.
These setting are a framework and are still in development.
To create a description for your account, fill in the following fields:
You can specify users who have permission to show your domain to other users. Enter their High Fidelity usernames Hosts.
You can specify operating hours for your domain using the Operating Hours fields.
You can use the Security settings to define who can can visit your domain, edit your domain, and add entities to your domain. In the navbar, go to Security.
To have a basic level of security for your domain settings, simply put in your username in HTTP Username and any password in HTTP Password field.
Everytime, you or any user tries to access your server settings, you'll be prompted to enter your username and password.
You can limit the number of users connected at a time. to your domain using the Maximum User Capacity field.
If you set this to 0, it means there is no limit to the maximum number of users who can connect to your domain at one time. If you set this to 1, it means only one user will be able to visit your domain at one time. Avatars connected to the same local machine are not restricted by this limit.
You can define who visits your domain and their rights using the security settings. These settings also enable you to assign rights to parameter-level groups (anonymous users, users on the local host, users that are logged in, users specified by username).
For each user or group specified, you can set the following permissions:
Permissions assigned to a specific user supersede any parameter-level permissions that also apply to the user. Additionally, if more than one parameter is applicable to a single user, the permissions given to that user will be the sum of all applicable parameters. For example, if only localhost users can connect and only logged in users can lock and unlock entities, if a user is both logged in and on a local host, the user will be able to both connect and lock/unlock entities.
Note: For entities with a finite lifetime, the maximum lifetime defaults to 3600 seconds. This default can be changed by clicking Show Advanced on the sidebar and looking in the Entity Server Settings section. The field is labeled Maximum Lifetime of Temporary Entities.
You can define the scripts you want to run when you launch and host your home domain.
Scripts are cached. If the content on the URL host changes, you may want to use some cache-defeating trick, such as specifying a URL with query parameter such as http://whatever.com/path/file.js?version=17*
The audio settings affect how sound is transmitted and received throughout the domain.
The first parameter, Default Domain Attenuation, allows you to set the degree to which things get quieter as you get further away from them. High Fidelity domains default to a distance attenuation curve roughly like the real world. If you see two avatars talking in the distance, you can hear them, but not very well. If you approach them, they become more audible in a manner that approximates what you're likely to be used to.
A domain's default attenuation can be changed in audio settings, so that no matter how far away a sound source is, it still plays at full volume (attenuation = 0). Likewise, the default attenuation for a domain can be set very high (to a max value of 1), making only things very near to you audible.
The Noise Muting Threshold sets up a "Noise Gate", so that when the sound of an audio source is below the set level, no audio is transmitted. If someone is in an environment with a lot of background noise, this feature will suppress the background noise except when the person speaks at a volume loud enough (i.e., above the set threshold) to "open the gate." The higher this threshold is set, the louder someone has to speak to be heard. Setting the value to zero effectively disables the features, allowing audio (noise and otherwise) through to the audio mixer.
The Low-pass Filter reduces high-frequency bands (i.e., "treble" for old stereo enthusiasts) when sounds come from above or behind us, which is what our oddly-shaped ears do for us in the real world. If you enable this feature and spin in place with someone speaking to you, you'll note they sound a bit muted when they're behind you.
The concept of audio zones enables you to define specific parcels of space in 3D space. These zones can then be set with rules for how audio is mixed and rendered. Each zone has a Name and is defined using start and end X, Y, and Z coordinates.
Attenuation Coefficients can be used to designate how a zone transmits sound to another zone. Each profile needs two zones for one-way communication, a Source and a Listener.
Another common example is to build a stage environment for performances. To do this, complete these steps:
The Reverb Settings are used to create the natural ambient reflections we would hear when a sound fires in a real space. It can give the effect of sounding like you are in a large empty room, deep inside a large cave, or inside a tiny room like a tiled shower.
The reverb settings are:
Keep the Wet/ Dry Mix value at or below zero, or prepare to have your ears assaulted. Levels of between -20 (minus 20) and -8 (minus eight) give useful results, with -8 (minus 8) being the more reverberant of the two. For a very thick reverb, you might try a value as high as -3 (minus 3), where the reverb is nearly as loud as the original signal.
These are the rules for automatic backups. The four preset rules set as default are shown in the image below.
The four preset rules.
Each rule has four variables:
For example, the "Half Hour Rolling" preset rule will save every half hour until there are 5 backups, then the 6th backup will overwrite the first one and so on. You will always have 5 backups for the last 2 1/2 hours.
If you want to add a new rule (e.g., every two hours) you can add it in where it shows "Example." Fill out the four variables and click the + button.
Additional settings for the Asset Server (ATP), Audio Buffers, and Avatar Mixer are available by selecting Show Advanced from the sidebar menu. Advanced setting parameters are subject to change. Documentation to come once stabilized.