Place Names

Learn how you can purchase a place name and assign it to your domain.

Overview

A place name is a domain's unique name within the High Fidelity Metaverse. One of the easiest ways for other users to reach your domain is to use the domain's place name. We'll walk you through how you can purchase a place name of your choice and assign it to your domain.

Introduction

When set up your domain, it is assigned a randomly generated place name. This randomly generated place name can’t be shown in the High Fidelity Directory or be authenticated (meaning, it can be impersonated).

You can obtain a place name of your choosing (one that better represents you or your business) for your domain by purchasing a place name from High Fidelity. Purchased place names can be authenticated and can be listed on the High Fidelity Directory.

A High Fidelity account is required to purchase and manage place names. If you don't already have one, you need to sign up for a High Fidelity account now.

Purchasing a Place Name

A place name costs $20.00 USD for one year and you can pay via PayPal or credit card.

To purchase a place name:

  1. Log in to the High Fidelity using your High Fidelity account username and password. After you have logged in, the login menu item at the top-right of the High Fidelity website will be your username.

  2. Click on your username and from the pull-down menu, select Place Names. .

  3. If you have never purchased a place name, you will see an empty table titled Places and a button prompting you to create a place name. (If you have set up a domain and received a randomly generated place name, it won't be listed as only purchased place names are listed here.)

  1. Click Create a Place Name.

  2. Enter the place name you want to purchase. Place names must be 4-64 characters in length. Letters, numbers and hyphens are allowed. If the place name you have entered is already taken, you will receive an error message. If the name you entered is available, you will see the Checkout Now button.

  1. Click Checkout Now .

  2. Enter your credit card number, PayPal account information or a coupon code to complete the purchase.

You are now the proud owner of a place name in the Metaverse! You can point this place name to a domain or point it to another place name.

Pointing a Place Name to a Domain

To point a place name to your domain, you need to complete these steps:

  1. If you don't already have one, add a domain ID to your High Fidelity account.
  2. Point the place name to the domain ID.
  3. Configure your domain server to use the domain ID the place name points to.

The following sections cover these steps in more detail.

Add a Domain ID to Your Account

To add a domain ID to your account, complete the following steps:

  1. On the High Fidelity website, click on your username in the top menu bar and from the pull-down menu, select Domain. If you don't see your username, you aren't logged in. Login to see your username on the top-right corner of the website.
  2. If you don't have any domains associated with your account, you will see an empty table titled Domains and a button prompting you to create a new domain.
  3. Click Create New Domain to add a new domain to your account.
  4. In the New Domain view: Enter a description in the Description field and in the Automatic networking drop down, select Full.

Changing the automatic networking setting for the domain ID here won’t force the domain to use automatic networking. It must be set to full in the server settings for the domain to use full automatic networking. If you change the domain's automatic networking to full from the domain server settings, the domain will update this setting in the High Fidelity database.

  1. Click Create Domain . You'll see the Domain view with the new domain listed.

You can now point a place name at the domain ID you just added.

Point a Place Name to a Domain ID

To point a place name to a domain ID, complete the following steps:

  1. Open the Domain view by clicking username in the top menu bar on the High Fidelity website and selecting Domain from the pull-down menu.

    Note: If you don't see your username, you aren't logged in.

  2. Copy the domain ID you want to point the place name at from the ID column.

  3. Open the Place Names view by clicking on your username in the top menu bar on the High Fidelity website and selecting Place Names from the pull-down menu.

  4. Click on the pencil icon to the far right of the place name you want to associate with the domain. This opens the Edit Place view.

  5. In the Points to field, paste the domain ID you copied in step two.

  6. Enter a Path, Description, and Preview Image (optional). The Path field specifies the position and orientation of visitors when they first come to your domain. A path is defined in this format: /x,y,z. For example, /23,42,125. The x, y, and z values are the coordinates of the user's position. These values can be approximated manually, or by placing an avatar in the desired location and copying its path. For more information, see Get Path For Landing. The Description and Preview Image are used when your domain is listed in the High Fidelity Directory.

  7. Click Update Place to save your changes.

The place name now points to a domain ID.

Configure Your Domain Server to Use the Domain ID the Place Name Points to

To configure your domain server to use the domain ID for your place name, complete the following steps:

  1. Open the Server Settings. To open server settings, assuming Sandbox is running, click on the High Fidelity icon in your system tray (Windows) or in the top menu bar (OS X) and in the menu that opens, select Settings. This opens the server settings page in your default web browser at http://localhost:40100.

  2. Select Metaverse / Networking from the side menu.

  3. If you aren't already connected, connect to your High Fidelity account. You will be required to generate an authorization token. Follow the instructions on screen to create and use the token.

  4. Once authenticated and connected to your High Fidelity account, on the server settings page, under MetaVerse/Networking select Choose from my domains.

  5. In the dialog box that appears, select the domain ID that the place name points to and click Choose domain.

You and other users will now be able to access your domain using Interface by typing the place name into the Address Bar. You may also use the URI hifi:// in this manner hifi://MyPlaceName.

Pointing a Place Name to Another Place Name

To point a new place name at an existing place name— meaning a place name that was previously purchased — complete these steps:

  1. In the Place Names view, click on the pencil icon to the far right of the place name that you want to point to another place name.
  2. In the Edit view, enter the existing place name in the Points to field. Note: A Domain ID is not necessary if you have entered a target place name.
  3. Transfer or add other relevant place information, such as Path, Description, and Preview Image. The Path field specifies the position and orientation of visitors when they first come to your domain. A path is defined in this format: /x,y,z. For example, /23,42,125. The x, y, and z values are the coordinates of the user's position. These values can be approximated manually, or by placing an avatar in the desired location and copying its path. When pointing a new place name to a different one, any path information for the new place name will override the path specified in the original. Likewise, if the path for a new place name is left blank, it will inherit the path of the place name it points to. The Description and Preview Image are used when your domain is listed in the High Fidelity Directory.
  4. Click Update Place to save your changes.

Assuming the place name you point to points to a domain ID used by a domain, you and others should now be able to access your domain using Interface by typing the place name into the Address Bar. You may also use the URL hifi://MyPlaceName.

Listing a Place Name in the High Fidelity Directory

Important.gif High Fidelity Directory is temporarily disabled.
These instructions will be updated when the Directory becomes available again.

Your domain is automatically listed in the High Fidelity Directory when:

  • Your place name has a Preview Image set. This image represents your place name in the directory. To set a preview image, go to the Place Names view, then click on the pencil to the far right of the place name you want to list to get to the Edit view. Here you can also set the Description for the directory listing.
  • Your domain has access restrictions configured so that others may visit, that is, in Server Settings in the Security Settings, Restricted Access is set to Off.
  • Your domain is online with a valid access token and domain ID (the one the place name points to).

If all of the above conditions are true, you will see your preview image and description in the High Fidelity Directory and users may visit your domain by clicking on it.

Sharing a Place Name as a URL

Pasting a link to a High Fidelity location does not work well for everyone when using the hifi:// style link. While this issue is still being considered, an interim solution of a specifically formatted URL is available.

The syntax for the link is http://hifi.place/''playa''/''10''/''10''/''10'', with your domain name in place of "playa" and the coordinates in place of the three numbers.