Overview

You can create many Managed Users quickly by uploading a CSV file that contains their details.

This feature can only create Managed Users (not Independent Users).

To start, click the button "Batch Create Users" in the Users page.

CSV Format

Here's an example of a valid CSV file:

NameEmailPasswordAgeMaturityGroup# Remarks
# Staff





Albus Dumbledore

18+
AdminsThe headmaster
Minerva McGonagallminerva@hogwarts.edu
18+
Teachers
Severus Snape
theprince18+
Teachers
Rubeus Hagrid

18+









# Students





Harry Potter

<13GeneralGryffindor
Cedric Diggory

13-16
Hufflepuff
Luna Lovegood

<13
Ravenclaw
Draco Malfoy

<13GeneralSlytherin

Blank lines and comments (lines that begin with the character #) are ignored. So the lines "# Staff" and "# Students" are ignored.

The first line (that isn't a comment) contains the headings, which are the names of the fields that you want to use. In this example, the headings are: "Name", "Email", etc. We support many fields, but most of them are optional, so the headings let us know which fields you're actually using.

Headings that begin with the comment character # are ignored: that's why we ignore the column "# Remarks". You might want to include such columns for your own use.

The lines after the headings contain users: one user per line. You may leave any of the non-required fields blank.

Note: for simplicity, we've shown the CSV file as a table. Most people use a spreadsheet program such as Excel to write CSV files, so this table matches what you will see on-screen. Here's what the actual CSV file looks like (if you open it in a simple text editor instead of in a spreadsheet program):

Name,Email,Password,Age,Maturity,Group,# Remarks
# Staff,,,,,,
Albus Dumbledore,,,18+,,Admins,The headmaster
Minerva McGonagall,minerva@hogwarts.edu,,18+,,Teachers,
Severus Snape,,theprince,18+,,Teachers,
Rubeus Hagrid,,,18+,,,
,,,,,,
# Students,,,,,,
Harry Potter,,,<13,General,Gryffindor,
Cedric Diggory,,,13-16,,Hufflepuff,
Luna Lovegood,,,<13,,Ravenclaw,
Draco Malfoy,,,<13,General,Slytherin,

Required Fields

Optional Fields

User Name

Specifying the Name

You can choose to specify the name in one of two ways:

You should use whichever method is easier for you.

Converting the Name For OpenSim

Every user needs an OpenSim Avatar Name. We will automatically convert the name that you supply into an OpenSim name. However, you should be aware that OpenSim has strict limitations on avatar names:

Therefore, if the user name is already in use in OpenSim then we will automatically create a unique name by adding a suffix. For example:

Sometimes we won't be able to generate an OpenSim Avatar Name despite our best efforts. For example, this can happen if you supply a name that uses non-Latin characters, e.g. a name in Greek. In such cases we won't create the user, and you will get an error message for that user.

Results Report

Creating users is a slow process, so you will see a progress bar while the operation is ongoing. Once it's done, we'll tell you how many users were created successfully, and how many failed. You will also get a link where you can download a CSV report that lists all of the users: both those that succeeded and those that failed. (If you closed the browser before the operation was completed then it will keep running anyway, but you won't get a link to the report. Contact Kitely in that case and we'll provide you with the link to download the report.)

For users that were created successfully: the report contains their Opensim Username (aka Avatar Name) and Password. You should send this information to your users, since this is how they will login in Firestorm.

For users that failed to be created: the report specifies the problem that caused them to fail. You should copy-and-paste this part of the report to a new CSV file; fix the problems; and then upload the new file to the server in order to retry creating the users.