Odd... Can't get NWNX4Demo to load

[erikbreau]

[Zebranky]

Please do. I'll put them on the main site if they're generally useful.
_________________
Win32 SVN builds: http://www.mercuric.net/nwn/nwnx/

<Fluffy-Kooshy> NWNx plugin is to this as nuclear warheads are to getting rid of fire ants.

<ThriWork> whenever I hear nwn extender, I think what does NWN need a penis extender for?

[erikbreau]

Has there been reports of the Toolset not being able to open the test-demo modules? I can open it in single player mode, but to load in multi-player it needs to have the content hosted so the Auto-Down-Loader can retrieve it.

I think that may be the reason I was unable to access the test module during the installation.

Does that make sense at all?

Erik.
_________________
"Europa is coming, and there isn't anything you can do to stop it!..."
http://nwn-europa.blogspot.com/
Europa Pic Gallery: http://picasaweb.google.ca/erikbreau/EuropaPics

[Zebranky]

I think you're asking a few different questions in there. NWNX4Demo.mod does open in the toolset for me (with a couple non-fatal issues).

As far as multiplayer, it shouldn't need any content hosted for the ADL. The ADL is an optional feature, and the demo mod doesn't need it. You may need to build a PWC or some other content package for a client to log in; I'm not that familiar with the requirements for non-ADL logins. To load the mod, however, it shouldn't matter either way.
_________________
Win32 SVN builds: http://www.mercuric.net/nwn/nwnx/

<Fluffy-Kooshy> NWNx plugin is to this as nuclear warheads are to getting rid of fire ants.

<ThriWork> whenever I hear nwn extender, I think what does NWN need a penis extender for?

[erikbreau]

Revised Instructions.

Note: when rewritten on Dec 9th, 2009, NWNX4 version 1.09 was current.

Note: This tutorial only deals with the SQLite database option.

1. Download NWNX4

You can download NWNX4 here: http://www.nwnx.org/index.php?id=nwnx4

Download and save the ZIP file. Now create a new folder for NWNX4 on your computer, name and suggested location is: C:\NWNX4

Extract the contents of the ZIP file and place the 14 items into the newly created folder.

2. What is inside the NWNX4 package

There are 14 files in the ZIP file, they are listed as:
-[folder] demo
-licence.txt
-nwnx.ini
-nwnx_include.erf
-nwnx_sql.erf
-nwnx_time.erf
-NWNX4_Controller.exe
-NWNX4_GUI.exe
-NWNX4_Hook.dll
-xp_mysql.dll
-xp_mysql.ini
-xp_sqlite.dll
-xp_sqlite.ini
-xp_time.dll

3. Configuring NWNX

File moving and .ini configurations:

3.1 Installation of NWNX4 files
First thing to do: Copy the file “NWNX4_Hook.dll” from the unzipped content into the main folder of your NWN2 installation (where your nwn2server.exe file is).

Make sure you copy the file, do not move it!

3.2 Edit NWNX.INI file
(The nwnx.ini contains descriptions for every setting, so these will not be explained in detail here)

There is one setting which absolutely needs to be set:

# Path to NWN2 installation (where nwn2server.exe is located)
# no default. You really have to specify it, currently.
nwn2 = C:\Program Files\Atari\Neverwinter Nights 2

Replace "C:\Program Files\Atari\Neverwinter Nights 2" (the default location) with the root directory of NWN2 on your computer, e.g. "C:\Program Files\Atari\Neverwinter Nights 2", (or if installed elsewhere, C:\Games\NWN2).

Note, Windows Vista may have 2 program files folders, make sure you select the correct one.

If you want to run the included NWNX4 demo module later on, we can set the module's name right now:

# Command line parameters to start the server with
# default: no parameters
parameters = -module NWNX4Demo

Note: If your module name contains spaces, be sure to quote it like this:

parameters = -module "The Name Of Your Module"

Note: If your module is a directory, then the path must be listed as:

parameters = -moduledir module_name

NOTE: UNLESS YOU ARE PLANNING TO USE MYSQL AS THE DEFAULT DATABASE PROVIDER, STEP 3.3 MAY BE SKIPPED OVER, LEAVING THE SETTINGS TO DEFAULT; SQLITE.
3.3 Edit XP_SQLITE.INI
The SQLite plugin is the default database provider.

You can control which database plugin will be used by specifying the plugin class in the INI file:

# The function class that is provided by this plugin
class = SQL

Make sure that the class in xp_sqlite.ini is set to SQL and the class in xp_mysql.ini is set to SQLoff (or something else, doesn't matter). This is the default, so if you are working with the original files, everything should be peachy.

Now set the path where the internal SQLite database will store its data file:

# The database file that the SQLite engines stores its data in
file = C:\NWNX4\sqlite.db

If you are using the recommended installation path C:\NWNX4, you can leave this value as it is. The file size will depend on how much data you put into it, but generally, it will stay relatively small.

Save the file if you made any changes, and close your text editor.

3.4 Copy the demo modules
NWNX4 comes with three demo modules, which are a nice way of exploring NWNX , testing if the installation was successful and setting up basic data structures in new databases.

These modules are in the demo folder:

NWNX4Demo.mod: Main demonstration module, serves as gateway to the plugin demo modules.
nwnx_demo_sqlite.mod: Demonstration, setup, and test of a SQLite database
nwnx_demo_mysql.mod: Demonstration, setup, and test of a MySQL database
nwnx_demo_time.mod: Demonstration of the TIME plugin
Copy all four files into your module folder, e.g. C:\Program Files\Atari\Neverwinter Nights 2\Modules.
NOTE: I personally was unable to load these modules, but in using a module of my own, I succeeded.

4. Starting NWNX

Hold your breath, it's time to start NWNX and see how easy it was to set it up.

Double-click on NWNX4_GUI.exe in your recently created NWNX4 folder and the fun should begin.


4.1 The NWNX4 GUI
Shortly after starting the NWNX4_GUI, the dedicated NWN2 server window will come up. Make sure that the NWNX4Demo module, or whichever module you have chosen to load, was loaded successfully.
If the Module Name box stays empty, double check the path where you copied the demo modules into and make sure you have set the parameter option in nwnx.ini as described above.
NWNX4 will create two different kinds of log files in your NWNX4 folder. The first, nwnx.txt, contains messages for the main program, which is loaded into nwn2server.exe. Once the module is successfully loaded, it should look like this:

NWN Extender 4 V.1.0.9
(c) 2008 by Ingmar Stieger (Papillon)
visit us at http://www.nwnx.org

* Loading plugins...
* Loading plugin xp_mysql.dll: Successfully registered as class: SQLoff
* Loading plugin xp_sqlite.dll: Successfully registered as class: SQL
* Loading plugin xp_time.dll: Successfully registered as class: TIME
* General protection fault error dialog disabled.
* NWNX4 activated.

Note: An error during xp_mysql initialization is ok. During the creation of this tutorial, my MySQL server was not running, so the plugin could not connect to it. You will probably receive the same message. If you want to disable the plugin entirely, rename the DLL to something like disabled_xp_mysql.dll.

The other kind of log file is generated by each plugin individually, e.g. xp_sqlite.txt:

NWNX SQLite Plugin V.0.0.8
(c) 2007 by Ingmar Stieger (Papillon)
visit us at http://www.nwnx.org
(built using SQLite 3.3.17)

* Log level set to 2 (everything)
* SQLite database file is C:\NWNX4\sqlite.db
* Plugin initialized.
* Registering under function class SQL

Make sure you do not get any error messages (except the one mentioned above) in your log files.



Log into your selected module, if successful, then you did well...congratulations!
_________________
"Europa is coming, and there isn't anything you can do to stop it!..."
http://nwn-europa.blogspot.com/
Europa Pic Gallery: http://picasaweb.google.ca/erikbreau/EuropaPics