Difference between revisions of "Getting Started" - LOMCN Wiki

Line 1: Line 1:
==Requirements==
+
With the updates Crystal Source code has been receving, the Guide's for building the source and compiling them have become outdated which has led to alot of confusion and help being requested.
The requirements below will cover being able to run both the server and client applications. If you encounter a black screen issue when attempting to load the client please ensure you have all the prerequisites listed.
 
  
*Windows 10 Version 1607+ / Windows 11 Version 22000+ / Windows Server 2012+ / Windows ServerCore 2012+
 
*.Net 7
 
*DirectX 9 or higher
 
*Windows SDK (10.0.22621)
 
  
If you continue to have Black Screen issues, please review the information discussed in this help thread: [http://www.lomcn.org/forum/showthread.php?88388-FAO-People-with-black-screen-issues Black Screen Issues]
 
  
==Required Downloads==
+
This guide will be a complete step by step guide from downloading visual studio to launching into your server.
The following link will provide you with up-to-date files for both the server and the client. Client files are required to play the game, server files are required to run a server.
 
  
''The link below contains the config details to connect directly to the autopatch client'' 
 
  
*[https://github.com/Suprcode/mir2/releases/download/v2023.05.19.00/Stable.Release.2023.05.19.00.zip Stable.Release.2023.05.19.00.zip] (v2023.05.19.00 / 19-05-2023)
 
  
==Installing main data/core files==
 
# Download the stable release (above). Once downloaded, extract the included folders to your required destination (e.g. C:\)
 
  
==Updating client files to the latest version==
 
# Double-click the Client.exe file (found in the /Client folder). This will start up the game launcher and begin to patch any outdated or missing files
 
  
==Running the server and client==
 
# To open the server up, open the Server.exe file in your 'Server' Directory. Wait for the server window to open and run through its opening process (4 lines appear - Maps Loaded, Drops Loaded, Envir Started, Network Started). This means the server is now running, locally.
 
# Open 'Config' -> 'Server' which opens the config form. On the general tab you need to either a) Untick the 'check version' or b) Use the version path to locate your client.exe in the client directory. Close the ConfigForm.
 
# Now the server is running and ready for your client to connect to.
 
# Navigate to your Client folder (in the server folder) and run client.exe. Create an account, login, create a character etc etc
 
  
====To make a char a GM/Admin====
+
Step 1
# In the server.exe, go to 'Account' which opens account info-form window.
+
Downloading Visual Studio 2022
# Click on your account to load that particular account's settings in the bottom half of the window.
 
# Tick the box entitled 'Administrator'.
 
# Every char created on that account will now automatically be an Admin, new or already created.
 
  
==Additional Information==
+
Download VS Community 2022 using the following link - [https://visualstudio.microsoft.com/vs/community/ Visual Studio]
 +
 
 +
Once VS is downloaded, Open it up and download the following WorkLoads:
 +
 
 +
<gallery>
 +
Step_1.jpg|Caption1
 +
</gallery>
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
 
 +
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.
 +
 
 +
 
 +
===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.

Revision as of 17:16, 22 December 2023

With the updates Crystal Source code has been receving, the Guide's for building the source and compiling them have become outdated which has led to alot 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.




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.


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.