Difference between revisions of "Setting up the project"

Revision as of 10:41, 6 October 2017

Updated as of commit a4d3e91 (2016-07-27)

Introduction

Final Fantasy XIV 1.0, like most large scale MMO's, consists of multiple servers working in unison to manage connected clients and their interactions with the game world.

Server Layout

A working install of Classic Server installation consists of the following:

1. Login Server: A web server that manages user accounts and the login process for the game client

2. Database Server: Contains the user accounts, their characters, and game assets (such as item and NPC information)

3. Lobby Server: Manages the characters associated with each user account, and their connection states, also tracks the status of the game servers

4. Game Servers: Game Server instances (one instance per world) that tracks the player state and interacts with the client as the user plays the game

While there can be multiple game servers to represent multiple worlds, there are only a single Login/Lobby/Database server per site. The servers do not require that they are all installed on the same machine, only that they can communicate with each other, either though the local network, or though the internet. A small installation might consist of all 4 servers being hosted on the same machine as the client, whereas a large install might have each individual server hosted on separate OS/machine instances.

Unlike the official/retail servers, currently there can only be a single game server instance per world. Future plans are to optionally break up the game server to be per region, instead of one game server per world, similar to how the official servers run.

Running and installing Classic Server

Unlike the game client, which mainly consists of installing, launching, and optionally patching the game as needed, setting up a working Classic Server site requires the ability to install multiple pieces of software and configuring them so that the servers can communicate with each other.

A person interested in setting up their own Classic Server site must be able to do the following:

1. Have the ability to install software on one or more machines, and following the instructions on how to do so
2. Understand how to find their IP and what an IP is
3. Understand the basic concepts what GIT is and compiling software (actual ability to code is not required)
4. Able to read and understand tables of data/database entries (extensive SQL knowledge is not required)

Requirements

Running the Server

Running the client

Note: The Seventh Umbral Launcher can patch any existing client install to the latest version

Optional Downloads/Quick-setup

• WAMP All in one installer: Quick-setup installer that includes the following:

• HeidiSQL: A SQL manager/GUI
• SourceTree: A git client

Compiling from source

Compiler Requirements

Note: Community editions of Visual Studio are acceptable
Note: In addition to the OS requirements as stated above
*Visual Studio 2013 users may need to install a modern compiler via NuGet, or will receive errors from the source.

Compiling

Getting the Source Code

Building

1. Set up your compile environment/IDE to support compiling NET 4.0

2. Open FFXIVClassic Map Server.sln from where the source code was copied to in the previous steps

3. Get the dependencies via NuGet

Select the Solution Explorer Tab

Right Click Solution 'FFXIVClassic Map Server' (3 Projects)

Select Restore NuGet Packages

4. Select Debug/Release (as desired)

5. Go to the Build Menu and select Build Solution

Note: You do not need to do this step until you have finished configuring your server below

6. If everything compiled correctly, the output log should look like:

========== Build: 3 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========

Server Setup

Setting up with WAMP

Installing WAMP

1. Download and install WAMP

2. Start the server by clicking on the WampServer64 icon created by the installer

3. Verify all services are properly started by checking on the W Icon in the notification bar:

• Green: All services started properly
• Yellow: Some services started properly
• Red: All services have stopped

Note: Start/restart/stop the WAMP server by clicking on the W icon and selecting Start/Stop/Restart All Services

Setting Up the Database

1. Confirm all WAMP services are installed

2. Left Click the WAMP status icon

3. Open MySQL → my.ini

4. Find the line containing

sql-mode="STRICT_ALL_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ZERO_DATE,NO_ZERO_IN_DATE,NO_AUTO_CREATE_USER"

and change it to

sql-mode="NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"

5. Restart the MySQL service (if not already started) by left clicking the WAMP status icon and selecting MySQL → Service Administration → Restart Service

6. Download, install, and run HeidiSQL

7. Select the New button to create a new connection and select Open

Note: If the SQL server IP/username/password differ from the defaults, change them here, otherwise continue to the next step

8. Verify you are connected:

A newly set up/blank mysql server should have the following databases listed:

Default tables

information_schema

mysql

performance_schema

sys

9. Right Click Unnamed and go to Create new → Database and name the new database: ffxiv_server

Note: If you changed the name of the server in step 3, the name will be that instead of Unnamed

10. Click the new ffxiv_server database entry

11. Go to File → Run SQL File and navigate to the <Classic Server source code location>\sql\ folder

12. Select all SQL files in the folder, and execute them.

Note: HeidiSQL may warn you about mixed linebreaks, or an empty warning prompt after executing the query. Ignore them, it'll still run the query successfully.

Setting Up the Login Server

1. Confirm all WAMP services are running

2. Navigate to the location of the server source code

3. Copy the www folder from the source code folder to the WAMP install location

The default location is: C:\wamp64\www

4. OPTIONAL: If you have modified the database login settings, change them at:

<web server www folder>\config.php

5. Restart the WAMP services

Compiling Lobby and Game Server

1. Navigate to the location the game client has been installed to and copy the following file:

<FINAL FANTASY XIV client install location>\client\script\rq9q1797qvs.san

2. Navigate to the location of the server source code and rename rq9q1797qvs.san to:

<Classic Server source location>\data\staticactors.bin

3. OPTIONAL: If the server and client are on different machines, edit the server IPs in the following locations:

• <Classic Server source location>\data\config.ini
• <SQL database>\ffxiv_server\servers

4. Compile the server (See #Compiling)

Note: If you had compiled it before this, use Rebuild Solution instead of Build Solution to confirm that all the data files are copied properly

5. Copy staticactors.bin and the scripts folder from <Classic Server source location>/data/

to <Classic Server source location>\FFXIVClassic Map Server\bin\(Debug\Release)\

Installing Manually

sql-mode="NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION"

Starting the servers

1. Confirm all WAMP/web services are running

1. Run the lobby server: <Classic Server source location>\FFXIVClassic Lobby Server\bin\(Debug\Release)\FFXIVClassic_Lobby_Server.exe

2. Run the map server: <Classic Server source location>\FFXIVClassic Map Server\bin\(Debug\Release)\FFXIVClassic Map Server.exe

Client Setup

Configuring the client

1. Install the Final Fantasy XIV client

2. Install the Seventh Umbral launcher

3. Open <Seventh Umbral launcher install location>\servers.xml

4. Create a new entry:

<Server Name="Localhost" Address="127.0.0.1" LoginUrl="http://localhost/login.php" />

Note: If the server is on a different machine then the client, change Address and LoginUrl to reflect that

5. Run <Seventh Umbral launcher install location>\Launcher.exe

6. Go to Game Settings and enter the path to <FINAL FANTASY XIV client install location>

7. Restart the launcher and patch client if necessary

8. Make an account

http://localhost/create_user.php

Note: If the server is on a different machine, use it's IP instead of localhost

Starting the client

1. Run <Seventh Umbral launcher install location>\Launcher.exe

2. Select the correct server from the Server dropdown box

3. Log in with previously created account