Getting Started

Getting Started - Build Guide

Description:

With the updates Crystal Source code has been receiving, the Guide's for building the source and compiling them have become outdated which has led to a lot of confusion and help being requested.

This guide will be a complete step by step guide from downloading visual studio to launching into your server.

Also make sure you download all the files within this repo - https://github.com/JevLOMCN/BlackScreenIssues

Step 1

Downloading Visual Studio 2022

Download VS Community 2022 using the following link - Visual Studio

Once VS is downloaded, Open it up and download the following WorkLoads:

If you can't find this window head over to Tools > Get Tools and Features

Select Individual Components and Select .Net 8.0 Runtime

Step 2

Downloading the Latest Source Code

Head over to github.com/Suprcode/mir2

Once this is downloaded head over to your Desktop and create a new folder called Crystal Mir 2.

Open up your mir2master.zip from your downloads folder and drag the folder into the Crystal Mir 2 folder located on your desktop.

Step 3

Building the code

Open up Legend of Mir.sln located in your Crystal Mir 2 > mir2-master

Right click Solution 'Legend of Mir' (9 of 9 projects)

Click Build Solution

Encounting this error?

If so head over to Visual Studio Couldn't process file fix to fix these errors, Then repeat Step 3.

Step 4

Creating the folders we need

Open Crystal Mir 2 Folder and create the following empty directories.

Now open your mir2-master folder and open the Build Folder.

You should now see these three directories:

Open the Client folder then open the Debug folder.

Copy all of these files into your Client folder located in Crystal Mir 2 > Client

Repeat this with the Server Folder located in the Build folder, copy all those files into the Crystal Mir 2's Server folder.

Step 5

Patching the Client

Open your Client folder that's located in Crystal Mir 2 (Not the build folder)

Now open the Client.exe

This will now open the Client which will download all the required base files for your client.

Step 6

Starting the server

Open your server.exe in Crystal Mir 2 > Server (Not the build folder)

This will now create all the required files for the Server.

You will now see the Server with the following error:

• If you would like to Download a pre-made database, go straight to Step 7.

• If you would like to start your server with no database (Create your own) then close your server down and open Setup.ini located in Crystal Mir 2 > Server > Configs

Change EnforceDBChecks=True > EnforceDBChecks=False and ignore Step 7. (!!Downloading a database is highly recommended!!)

Step 7

Downloading a Database

Head over to Github Suprcode Database Releases

Download the latest Release.

Once downloaded Open the .rar and drag the files/folder into your Server folder inside Crystal Mir 2 Folder.

Click 'Replace the files in the destination'

Note: Copy over the maps from the Server's Map folder to the Client's Maps folder.

Step 8

Getting Online

You have two options. Local Server or Ported Server.

If you want a Ported Server (Allow others to join) please follow the steps in the Port Forwarding Tutorial

Alternatively for a Local Server:

Open your Client Folder and open Mir2Test.ini

Change

[Network]

UseConfig=False

To

[Network]

UseConfig=True

IPAddress=127.0.0.1

Port=7000

Note: For a local Server you do not need to adjust any Server IP as this is defaulted to 127.0.0.1

Now Launch your Server and Client!

Step 9

Admin account creation

When your server is fully loaded Press Account

Now Press Create

Give your account an ID & Set a password

Now Uncheck Require Change & Check Administrator