NWNadm documentation (sort of)

How to upload a BIC file into an account

The steps are as follows:

• 0 Prepare the file
  
• 1 Upload the file
  
• 2 Move it to the "incoming" vault.
  
• (3 missing here as it is an informational step)
  
• 4 Rename the uploaded account to the account to move the file into.
• 5 Move this account from "incoming" to "vaultbase".

This way it is merged with the existing account.

Step zero: Prepare the file

You can upload the file (the BIC) directly, uncompressed. But you can ZIP the BIC file to save upload bandwidth. Sorry, RAR is not yet supported!

If you upload a file named this_is_the_name.bic, it will show up as "vault/incoming/this_is_the_name.bic/this_is_the_name.bic".

If you upload a files named "this_is_the_name.bic" in a ZIP named "this_is_the_zip.zip", the it will show up as "vault/incoming/this_is_the_zip.zip/this_is_the_name.bic".

So, to name the file, you have to give the correct filename. There is no way to rename the file later on.

First step: Upload it into the UpDown area

Go to "UpDown" (1), select the file you want to upload (2) and press "Upload" (3). The file is uploaded which may take quite a while.

If the window is not updated automatically, you can reload it:

It shall look like in the next screenshot.

Second step: Move it to "vault" named "incoming"

The file is moved into a special vault named "incoming". This is not the vault where all the character files are stored, it's an intermediate vault such that you can test everything before you are sure that everything is ok.

Select the file you want to move and press "move to vault".

After you pressed the button, your screen looks like following:

In the Viper logfile you will see something like following:

Third step: Go into "Logfiles" "vault" "incoming"

There you will find the directory named after the uploaded filename. The directory will contain the file, or if the upload was a .ZIP it will contain the contents (without path information).

As the uploaded file name was "uploadarchive.zip" you will find the directory under the letter "u". Press the "action" Link:

You can look into the directory by clicking on the name on the right of the text " action "

Fourth step: Rename the directory to the account name

This is case sensitive, so please be sure to use the correct spelling. You can find the correct spellin in ghe "vaultbase" vault (this is the main character vault). But please do not be confused, you must use the action in the "incoming" vault!

Let's say that the Accountname is "TinoTest", then it looks like:

This, again, is done by Viper. In the Viper-log there will be something like:

To "reload" the page click on "incoming" and then the letter "T" (as TinoTest starts with it) and there it is. Please note that the letter "u" vanished, as it is no more present:

Fifth (last) step: Move it into the real character vault

Everything up to here has taken place in the "incoming" vault. This is a scratch area, where nothing shall harm the running NWN server. Now, if you are happy with the result, you can "merge" the new stuff into the real vault.

"Merge" means, files from the source "overwrite" existing files with the same name. Existing files with a different name are untouched. However, the files which are overwritten do not vanish. They are renamed "moveXXX.bic" where XXX is a number (counts up).

So if uploaded a file "a.bic" and another "a.bic" is present in the vault, the latter file "a.bic" is renamed to "move1.bic" (or similar) and the new "a.bic" is the file, you just uploaded. Please note that NWN does not look into file names, as the names can be mangled anyway (it, instead, looks into the contents).

So bring the character file active, you must move it into "another" (the main) vault. This is done as follows:

Again, Viper tells you something in the log:

Cleanup step: If something goes wrong

Shit happens. This is normal. You upload something, and you are dissatisfied.

How to clean up things in "incoming" vault? There is a "bitbucket" called "deletebase" and listed as "deleted". The files are moved there, so they still exist (for some time), but they do no more harm this way.

So just "move" it to "deleted" instead of somewhere else.

Important! Be sure you are in "Incoming Vault". You start again like in the last picture of Step 4:

Now, instead the last step, just move it into "deleted" as follows:

This works for all vaults, not only incoming. However, due to the "merge" feature, you might get into trouble, as Gravedigger already might have expired some accounts, and those will show up under "deleted", too! There is no real logfile which helps you to check if a BIC file was valid or not.