Generic selectors
Exact matches only
Search in title
Search in content
Search in posts
Search in pages
Search in project

Atavism Online – Development VM

Recommended Platform:

Preferred OS: Linux 64bit (tested on CentOS 7, Ubuntu 16.04/18.04 and Debian 8/9)
Java: 8 (Java 9+ currently not supported)
DB: MySQL 5 / MariaDB up to version 5.7 (or MariaDB equivalent)
Atavism 2.7: Unity 5.6 / 2017.1
Atavism 2018.1: Unity 5.6, 2017.x
Atavism 2018.2: Unity 5.6, 2017.x, 2018.1, 2018.2
Atavism 2018.3: Unity 5.6, 2017.x, 2018.x
Atavism 2019.1: Unity 2018.2, 2018.3, 2018.4, 2019.1
Atavism X: Unity 2018.4, 2019.1, 2019.2
Atavism X.1: Unity 2018.4, 2019.1, 2019.2
 

To speed up the start of development, the Atavism Team provides for all atavism customers virtual machine (VM) build on VirtualBox.

This VM can be downloaded from Atavism Online Apanel.

Atavism development VM

https://www.virtualbox.org/

http://download.virtualbox.org/virtualbox/UserManual.pdf

Import VM to VirtualBox

To import Atavism development VM to VirtualBox© go to:

File > Import Appliance (ctrl + I)

In this window, you will need to select the OVA file that you downloaded from APanel.

Thane clicks Next

Next screen will provide you the summary of import:

Click on Import

An import progress window will pop up:

After successful import, you will see the new VM in VirtualBox Manager

You can modify Settings of this VM (especially network card) by clicking on Settings button:

In the network section ensure that VM is attached to Bridged Adapter and Name of adapter is the name of NIC that is connected to your home/office network.

After you change settings to preferred by you can click on Start arrow

This will start VM in on your computer (new window can popup).

After some time (depend on your hardware) system will start and you can log in to it.

Login: root

Password: atavism

To change the password for root please run the command: passwd root

The system will ask you for the new password and will ask to confirm the new password.

Check your network configuration:

In Windows OS open CMD and enter command ipconfig /all and press enter – this will show something similes to this:

This will show you your:

IP address

Subnet Mask

Gateway

Base on this information’s assign IP address for your VM.

Please note that if you have more devices connected to the network ensure that IP address that you will like to use is not in conflict with other systems (don’t use this same IP).

To change the IP address of Atavism Development VM go to:

On Ubuntu do:

nano /etc/netplan/01-netcfg.yaml

Window witch network configuration will open:

In this config file assign an IP address from your LAN subnet and change gateway address to match your firewall.

After you amend file to save it pressing F2 – on the bottom of the screen you will see dialogue (if you are happy with changes press Y):

After you press Y system will ask where to save file/filename:

Just press ENTER

Now to activate this config just run the command: netplan apply

You can check if the provided IP is active by running the command: hostname -I (this will display active IP address).

You can also run a ping test from this VM to network / Internet and from local PC to this new server.

 

On CentOS do:

nano /etc/sysconfig/networking/devices/ifcfg-eth0

Window witch network configuration will open:

In this config file assign an IP address from your LAN subnet and change gateway address to match your firewall.

After you amend file to save it pressing F2 – on the bottom of the screen you will see dialogue (if you are happy with changes press Y):

After you press Y system will ask where to save file/filename:

Just press ENTER

Now to activate this config just run the command: service network restart

This should give you output similes to this:

You can check if the provided IP is active by running the command: hostname -I (this will display active IP address).

You can also run the ping test from this VM to network / Internet and from local PC to this new server.

Uploading Atavism Server software to VM

After you change network card settings you can upload Atavism_Server.zip to this VM.

One of the tools that you can use is WinSCP.

You can download it from the WinSCP website: https://winscp.net/eng/download.php

After you download and install this program you Can connect to the server using it.

After you open it WinSCP it will ask for connection details:

After configuring this connection (IP Address minimum) you can save these settings or just press Login.

When you press Login you will be prompt for username and for a password:

After you login you should upload atavism_server_xxxx.zip into default directory /root/:

Select file for upload and press F5.

In next step Virtual Machine within 2 minutes should unpack that package and after that, you should open your browser and try to enter the address as follows: http://<YourServerIPAddress>/atavism/installation/install.php

where <YourServerIPAddress> is IP which you setup in the previous step for the server.

You should see information as on the screen below:

Fill the data in the form:

Atavism Account Email: It’s your email on which you have you registered your Atavism License

Atavism Server Key: Key which is assigned to your Atavism License. You can check it in your apanel account: https://apanel.atavismonline.com

DB Username: atavism (it’s default database user which is prepared for you)

DB Password: atavism (it’s default database password for user atavism)

IP/FQDN of this server: Put your IP Address for your server which you set up in the previous step, for example, 192.168.0.102

IP/FQDN for External Public connections to the server: For connections within the network where your Virtual Machine resides put your IP Address for your server which you set up in the previous step, for example, 192.168.0.102

Install Type: Select Installation Type, for new users we recommend to make New Install with Demo Data, which will give you many examples of how to configure specific elements of Atavism.

Click the Submit button.

After the installation process, you should see a similar resume.

At this point only one thing left, it’s importing Unity package into your Unity project and fill credentials for your apanel account and details related to Database:

You should fill data in the first form and if the “Same Database Credentials” checkbox will be ticked then data credentials will be propagated to rest of the fields.

Database Host: IP Address of your server which you setup in the previous step

Database Port: Can be left empty, by default it will use 3306 MySQL port

Database Name: You can leave default values there

Database User: atavism

Database Password: atavism

After you will put all credentials you should see red dots near A: and W: which means accordingly: Authentication Server and World Server Statuses.

Click Start/Restart button and wait till the dots change the color to blue.

Atavism server is up and running.

Setting up Unity to connect to the server

This is part of the Getting Started with Atavism section.

The steps below show how to get a project in Unity connecting to the server setup in the previous step: Setting up the Server

  • Create a new project,
  • Import atavism package,
  • Load up Login scene,
  • Set server connection details

To set the server connection details you need to select the AtavismCore object in the hierarchy and look for the Master Server property. Set it to whatever the address of the server is (if it is on the same machine you can use localhost).

  • Add scenes to the build settings

The Login, CharacterSelection and MainWorld scenes need to be added to the build settings or you will have trouble entering the world. From Atavism 2018.1 more scenes presenting new features like Arenas or private instances were included into the project, so here is a screen presenting scenes you should put into the build window.

it is also recommended to refresh lighting and Asset Bundles because both are related to a specific Unity version. In order to rebuild your Asset Bundles (Bomber Bug is using them), you should head into the top menu in Unity Editor and chose Assets->Atavism Build AssetBundles (it will rebuild your asset bundles and then you should navigate to your project directory and copy file infinitypbr from project_directory\AssetBundles to project_directory\Assets\StreamingAssets.

Open the Login scene and select AtavismCore game object.

Put IP or FQDN to your Master Server parameter and save the scene.

Playing the demo

Your Unity project should now be ready to connect to your Atavism Server.

  • Click Play,
  • Click Create Account

Make an account for yourself. You will then be able to log in and create a character and enter the world! Enjoy your travels.