Difference between revisions of "Quick Start Guide"

From EVEmu Wiki
Jump to navigation Jump to search
m (1 revision imported)
Line 1: Line 1:
 
== '''Client configuration''' ==
 
== '''Client configuration''' ==
'''Get the Client  [http://downloads.yzs.me/evemu/ >>> DOWNLOAD HERE <<<]'''
+
'''Get the Client  [https://files.evemu.dev/cruc/client/ >>> DOWNLOAD HERE <<<]'''
  
 
Make sure to uncheck the run eve box before finishing the install, this may be difficult to see on some wine builds as the dialog is partially obscured.
 
Make sure to uncheck the run eve box before finishing the install, this may be difficult to see on some wine builds as the dialog is partially obscured.
  
'''Get a copy of the blue patcher  [https://github.com/bluepatcher/blue_patcher >>> DOWNLOAD HERE <<<]  '''and follow the instructions in README.md.
+
'''Get a copy of the blue patcher  [https://files.evemu.dev/cruc/BlueAutoPatcher.exe >>> DOWNLOAD HERE <<<]  '''and follow the instructions in README.md.
  
 
Your client is now ready to run.   
 
Your client is now ready to run.   
  
<div style="background: rgb(38, 52, 62) none repeat scroll 0% 0%; padding: 5px;">'''NOTE:''' Do NOT run the Client from the icon you get after installation. Change it to run the '''/bin/exefile.exe''' instead of the '''eve.exe '''or you will get the launcher and that will attempt to contact CCP and automatically update the client.</div>
+
'''NOTE:''' Do NOT run the Client from the icon you get after installation. Change it to run the '''/bin/exefile.exe''' instead of the '''eve.exe '''or you will get the launcher and that will attempt to contact CCP and automatically update the client.</div>
  
 
== '''Server configuration (From source)''' ==
 
== '''Server configuration (From source)''' ==
<div style="background: rgb(38, 52, 62) none repeat scroll 0% 0%; padding: 5px;"> '''NOTE:'''
 
* ''%serverRoot%'' is where the server is installed.
 
* ''%devRoot%'' is where the development files are located.
 
* These may be the same location but that is not necessary
 
</div>
 
  
'''SERVER SETUP:'''
+
'''SERVER COMPILATION'''
 +
  sudo apt-get update && sudo apt-get upgrade
 +
  sudo apt-get install build-essential g++ cmake git
 +
  sudo apt-get install libtinyxml2.6.2-dbg libtinyxml2.6.2 libmysql
 +
  sudo apt-get install zlib1g-dev zlib1g-dbg
 +
  sudo apt-get install libboost1.54
 +
 
 +
  git clone https://github.com/EvEmu-Project/evemu_Crucible
 +
  cd evemu_Crucible
 +
  cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=dist ..
 +
  make -j(Number of cores you have available)
 +
  make install
 +
  
# Create the directories '''%serverRoot%/etc/''' and  '''%serverRoot%/log/'''
+
'''DATABASE SETUP:'''
# Copy the '''%devRoot%/evemu_server/utils/devtools.raw''' file to '''%serverRoot%/etc/'''
 
# Open a command prompt and go to the directory '''%devRoot%/evemu_server/sql/utils/'''
 
# Run the script merge-ofic-updates.sh if your running Linux or merge-ofic-updates.bat on windows
 
  
'''MYSQL SETUP:'''
+
'''NOTE:'''
 +
* ''%devRoot%'' is where the development files are located.
 +
* These may be the same location but that is not necessary.
  
Get a copy of the crucible static data dump [http://eve.alasiya.net/files/cruc/cru16-mysql5-v1.sql.bz2 cru16-mysql5-v1.sql.bz2] and extract the file '''cru16-mysql5-v1.sql''' to '''%serverRoot%'''. Then open a mysql client and execute the following commands in this order: 
+
# Open a terminal and go to the directory '''%devRoot%/evemu_Crucible/sql/'''
 +
# Install and setup your database software, for EVEmu we use MariaDB
 +
  sudo apt-get install mariadb-server
 +
  sudo mysql_secure_installation
  
 +
# Open your MySQL shell and input the following:
 
   create database evemu;
 
   create database evemu;
 +
  GRANT ALL ON evemu.* TO 'evemu'@'localhost' IDENTIFIED BY 'YOURPASSWORD';
 +
# In the same SQL directory, run install.sh if you're running Linux or install.bat on Windows
 +
# Optionally you can seed the market by running these SQL queries:
 
   use evemu;
 
   use evemu;
  source %serverRoot%/cru16-mysql5-v1.sql;
+
   source %devRoot%/evemu_Crucible/sql/seed_and_clean/seed_data.sql;
   source %devRoot%/evemu_server/sql/evemu_dynamic-dump.sql;
+
   source %devRoot%/evemu_Crucible/sql/seed_and_clean/seed_market.sql;
  source %devRoot%/evemu_server/sql/evemu_static-dump.sql;
+
   source %devRoot%/evemu_Crucible/sql/seed_and_clean/seed_station_market.sql;
   source %devRoot%/evemu_server/sql/ofic-updates.sql;
 
  source %devRoot%/evemu_server/sql/prime_db.sql;
 
   source %devRoot%/evemu_server/sql/liveupdates.sql;
 
  source %devRoot%/evemu_server/sql/market_npc.sql;
 
  ALTER TABLE srvAccountApi AUTO_INCREMENT=1000000;
 
  ALTER TABLE srvAccount AUTO_INCREMENT=1;
 
  INSERT INTO srvAccount (accountID, accountName, role, password, online, banned) 
 
  VALUES(NULL, 'YOUR_ACCOUNT_NAME', 5003499186008621056, 'YOUR_PASSWORD', 0, 0);
 
  GRANT ALL ON evemu.* TO EVEMU_USER@localhost IDENTIFIED BY 'EVEMU_PASSWORD';
 
  
In the last two lines replace '''YOUR_ACCOUNT_NAME''' with the account name you want to log into the game with, and '''YOUR_PASSWORD''' with the password you will use. Change '''EVEMU_USER''' to the username you want the server to log into you database with, and '''EVEMU_PASSWORD''' to the password the server should use.
+
'''FINAL STEP:'''
 +
# Open eve-server.xml which if you did everything right, should be in %devRoot$/evemu_Crucible/build/dist/etc
 +
# Scroll towards the bottom of the file, to the database connection info, change <host>db</host> to <host>localhost</host> and save it.
 +
# Optionally, you can also move a directory back to %devRoot$/evemu_Crucible/build/dist/ and make a 'logs' directory. This will be where EVEmu will be able to save log files.
  
'''SERVER CONFIGURATION FILE'''
+
# To finally run your EVEmu server, navigate to the %devRoot$/evemu_Crucible/build/dist/bin folder and run the eve-server executable.
 
+
   ./eve-server
Create the server config file '''%serverRoot%/etc/eve-server.xml. '''Make sure to set the proper database username and password. 
 
 
 
'''FINAL STEP - SERVER COMPILATION'''
 
 
 
   sudo apt-get install build-essential g++ cmake git
 
  sudo apt-get install libtinyxml2.6.2-dbg libtinyxml2.6.2 libmysql
 
  sudo apt-get install zlib1g-dev zlib1g-dbg
 
  sudo apt-get install libboost1.54
 
  sudo apt-get install libmysqlclient-dev
 
  
 
== Test and Report! ==
 
== Test and Report! ==

Revision as of 04:25, 4 April 2021

Client configuration

Get the Client >>> DOWNLOAD HERE <<<

Make sure to uncheck the run eve box before finishing the install, this may be difficult to see on some wine builds as the dialog is partially obscured.

Get a copy of the blue patcher >>> DOWNLOAD HERE <<< and follow the instructions in README.md.

Your client is now ready to run.

NOTE: Do NOT run the Client from the icon you get after installation. Change it to run the /bin/exefile.exe instead of the eve.exe or you will get the launcher and that will attempt to contact CCP and automatically update the client.

Server configuration (From source)

SERVER COMPILATION

 sudo apt-get update && sudo apt-get upgrade
 sudo apt-get install build-essential g++ cmake git
 sudo apt-get install libtinyxml2.6.2-dbg libtinyxml2.6.2 libmysql
 sudo apt-get install zlib1g-dev zlib1g-dbg
 sudo apt-get install libboost1.54
 
 git clone https://github.com/EvEmu-Project/evemu_Crucible
 cd evemu_Crucible
 cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=dist ..
 make -j(Number of cores you have available)
 make install

DATABASE SETUP:

NOTE:

  • %devRoot% is where the development files are located.
  • These may be the same location but that is not necessary.
  1. Open a terminal and go to the directory %devRoot%/evemu_Crucible/sql/
  2. Install and setup your database software, for EVEmu we use MariaDB
 sudo apt-get install mariadb-server
 sudo mysql_secure_installation
  1. Open your MySQL shell and input the following:
 create database evemu;
 GRANT ALL ON evemu.* TO 'evemu'@'localhost' IDENTIFIED BY 'YOURPASSWORD';
  1. In the same SQL directory, run install.sh if you're running Linux or install.bat on Windows
  2. Optionally you can seed the market by running these SQL queries:
 use evemu;
 source %devRoot%/evemu_Crucible/sql/seed_and_clean/seed_data.sql;
 source %devRoot%/evemu_Crucible/sql/seed_and_clean/seed_market.sql;
 source %devRoot%/evemu_Crucible/sql/seed_and_clean/seed_station_market.sql;

FINAL STEP:

  1. Open eve-server.xml which if you did everything right, should be in %devRoot$/evemu_Crucible/build/dist/etc
  2. Scroll towards the bottom of the file, to the database connection info, change <host>db</host> to <host>localhost</host> and save it.
  3. Optionally, you can also move a directory back to %devRoot$/evemu_Crucible/build/dist/ and make a 'logs' directory. This will be where EVEmu will be able to save log files.
  1. To finally run your EVEmu server, navigate to the %devRoot$/evemu_Crucible/build/dist/bin folder and run the eve-server executable.
 ./eve-server

Test and Report!

Yes! We know there are bugs and missing features!

Check out our current project status to see a list of known working and missing/broken features of the EVE Online experience.
You can request to be part of the Testers Group. Just head into our IRC channel and get to know some of them, request a forum account and start testing against the Project Status.
See this article for specific information on how to go about testing and creating reports and submitting bug/feature reports on our Github project page.