Alright first off, I hope my post isn't deleted by Gastric. If so, i'm sorry.
Intro:
Wcell is this emulator I heard of from a friend on MSN. He had told me it was 2.4 and so on. Now anyways I am told it is stable and functions off XML (the core) which then places the tables into your database. Now i'm no pro at this since its a new emulator so, questions can be asked here and ill try to respond as if I knew.
Instructions:
<> First off you need to download the emulator, Zodiac has compiled and uploaded the needed files and such onto filebeam.
- Download Link - Filebeam - Free Fast File Hosting
Now do as following.
-------------------------------------------------------------------------
Preface
Before we go through initial setup, I'd like to thank you for using our software. If it wasn't for you, we'd have no reason to continue making it! Thank you!
Software requirements
Database requirements
- .NET Framework 3.5 (or higher), which you can download here.
- If you plan on working with the source, you will need an IDE, such as Visual Studio 2008. You can use the free IDE Visual Studio 2008 C# Express which can be downloaded here (the link is at the bottom).
- A Database System of your choice
WCell needs access to a database in order to store and access game progress.
We currently support MS SQL 2002/2005, MySQL 4.x/5.x, Oracle 8/9, and PostgreSQL 8.1+. Here are some links to free versions of some of the supported database systems:IMPORTANT NOTE: at this time MySQL is only supported up to the 5.0 branch. So don't try with 6.0. IT WILL NOT WORK!
- MS SQL Server 2005 Express: download link (ships with any commercial version of Visual Studio)
- MySQL 5.0: download link
- PostgreSQL 8.2.6: download link
Setting up the database system is out of the scope of this document, so please refer to the vendor documentation for further information. You should at least have a basic understanding of how to work with SQL and the database system you choose to run.
If you already have WCell fully working and setup, feel free to skip directly to configuration for information on how to make WCell work with your DB.
Compilation
Start by opening up the WCell solution file (WCell.sln) and Visual Studio will pop up. If you have the Express version, it'll complain about not supporting a certain project type for WCell.Core.Tests; don't worry about that, and just click OK. If a big window pops up asking if you want to load a project for reading only or normally, select open normally and uncheck the box where it asks if you want to do this for every project in the solution, and then click OK.
If you are not building for development, you have to remove the Build Symbol Dev which speeds up the startup routine by disabling automatic loading and spawning of static data. To remove it: Right-click the "WCell.RealmServer" project -> Properties -> Select the Build tab and remove DEV from the line that says "Conditional compilation symbols".
Right-click where it says Solution 'WCell' in the Solution Explorer and hit Build Solution.
By default, you'll be building in Debug mode; you can change this by selecting Debug or Release in the build mode drop-down box in the Visual Studio toolbar (Debug keeps information vital to debugging, and Release performs optimizations and removes that debugging information).
Running WCell
The actual application folders are:where BuildMode is either Debug or Release, depending on what one you chose to compile under.
- Auth Server: Applications/WCell.AuthServerConsole/bin/{BuildMode}
- Realm Server: Applications/WCell.RealmServerConsole/bin/{BuildMode}
By default, the configurations are set to get you running with minimal effort. If you use anything other than MS SQL Server 2005 Express for your database, you'll have to make some changes, and if you're behind a router/firewall, and want to enable outside connectivity, you'll also have to do some editing. Those changes are explained in configuration.
- Binary files are: WCell.AuthServerConsole.exe and, WCell.RealmServerConsole.exe.
- Configuration files are: WCell.AuthServerConsole.exe.config and WCell.RealmServerConsole.exe.config.
Assuming you are using SQL Server 2005 Express, and don't want to run your server on anything but a LAN for the moment, the next thing you need to do is copy some files. If you're using binaries, then the content we include is already present, but you still need to extract the DBC files from the WoW client. If you are compiling from source, then you simply need to run the batch file called copy_content.bat in the source root to copy the content files for you.
To extract the DBC files from the client, you must run the WCell.DBCDump tool, which is either in the WCell.DBCDump folder if you're using binaries, or in Utilities/WCell.DBCDump/bin/{BuildMode}. If you simply run the tool from its directory, it will try to locate your WoW installation directory for you. If it fails, try moving the WCell.DBCDump files into your WoW installation directory, and running it from there.
It will extract them to a folder called DBC. Copy this folder into the content folder in the root of the WCell.RealmServerConsole output folder, which would be Applications/WCell.RealmServerConsole/bin/{BuildMode} or WCell.RealmServerConsole depending on if you're compiling from source or using binaries.
Lastly, we need to create two databases. In the future, WCell will probably be able to do this automatically, but for the time being you must create the DBs for the authentication and realm server manually. In case you ran older versions and you're getting errors, you need to remove older databases manually and recreate them. (easiest way is to do it is with SQL Server Management Studio Express freely available from Microsoft if you're using MS SQL Server 2005 Express). The default database names are WCellAuthServer and WCellRealmServer, but you can change the connection strings in the configuration files to whatever you want. You need only create the databases; the servers will populate the database with the table schema.
At this point, you should be able to run WCell. You should have edited your configuration files, ran the content copy script, extracted/moved the DBC files to the necessary folder, and created the proper databases. Now, just run the server executables: authentication server, then realm server, and you should be able to connect. The default listening address is 127.0.0.1 (or: localhost).
Credits:
Wcell Comminuty at wcell.org for making the core in general and for the guide above in gray.
Zodiac from honorhold.org for compiling the core and uploading it.