Atavism Online – Development VM
Platform Recommendations/Requirements:
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), MySQL 8 supported for Atavism X.2
Default Ports: 9005 TCP, 9010 UDP, 5042 TCP, 5052 UDP, 5566 TCP
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, 2019.3, 2019.4
Atavism X.2: Unity 2018.4.2, 2019.1, 2019.2, 2019.3, 2019.4
Atavism X.3: Unity 2018.4.2, 2019.1, 2019.2, 2019.3, 2019.4
Atavism X.4: Unity 2019.4.0, 2020.1, 2020.2, 2020.3, 2021.1
Atavism X.5: Unity 2019.4.0, 2020.1, 2020.2, 2020.3, 2021.1
Atavism X.6: Unity 2019.4.0, 2020.1, 2020.2, 2020.3, 2021.1, 2021.2, 2021.3
Atavism X.7: Unity 2020.3, 2021.3
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
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 the 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
Since Ataivsm 10.2.0, you can use the new Atavism Standalone Editor, which is much more feature-rich with better UX. In order to do that, you will have to install it from the package for your system Windows/Linux/Mac, and set the profile with similar database settings as you set inside the Unity.
The most important to set are:
Profile Name: Defines the profile name. This profile will be shared between Atavism Editors.
Engine Type: Choose between Unity and Unreal. In the later stage, the engine type will define engine-specific settings.
Project Folder: Defines project directory without the Assets directory.
And 4 database connections, to 4 different databases:
- Admin
- Atavism
- Master
- World Content
Each connection has the option to specify:
- Host – IP Address of your server which you setup in the previous step
- Port – port used by the server (by default 3306),
- Name – the name of the database that was imported (from SQL directory in server pack) preconfigured but can be changed if your database has a different name. Keep this field with the default value,
- User – atavism
- 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.
Or in the new Ataivsm Standalone Editor
The 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.