SphereServer

Game server for Ultima Online

Download

Automatic builds

Building

Project can be compiled on Windows (Visual Studio) and Linux (GCC).

Even using 64bit OS, Sphere must be compiled/executed in 32bit mode to work properly. Project files included on source code will compile it in 32bit mode by default.

Windows (Visual Studio)

• Open the project file SphereSvr.vcxproj using Visual Studio
• On top menu, select the build configuration (Debug/Local/Nightly/Release) and click on Build > Build Solution to compile

NOTES:

• Required version: VS2012 or later (VS Code is not supported)
• On VS >= 2013: When opening SphereSvr.vcxproj for the first time it will request an update on project file, just click OK to update
• On VS >= 2017: Newest VS have an modular installation which comes with just basic components, and extra components must be installed as needed. To compile Sphere you must open Visual Studio Installer to install Desktop Development with C++ workload

Linux (Ubuntu)

Add architecture support

• To compile on 32bit OS:

  # Skip this step (architecture is already supported by OS)
  

• To compile on 64bit OS:

  # Add 32bit support using:
  sudo dpkg --add-architecture i386
  sudo apt-get update
  sudo apt-get dist-upgrade
  

Install MySQL 5.7 client

• Ubuntu 14.10 or older:

  # Default package repository only have support up to MySQL 5.6, so add MySQL 5.7 support and install it using:
  sudo add-apt-repository 'deb http://repo.mysql.com/apt/ubuntu/ trusty mysql-5.7'
  sudo apt-get update
  sudo apt-get install libmysqlclient-dev:i386
  

• Ubuntu 15.04 to 19.04:

  sudo apt-get install libmysqlclient-dev:i386
  

• Ubuntu 19.10 or later:

  # Default package repository dropped support for MySQL 5.7, so add it back and install using:
  sudo add-apt-repository 'deb http://repo.mysql.com/apt/ubuntu/ disco mysql-5.7'
  sudo apt-get update --allow-insecure-repositories
  sudo apt-get install libmysqlclient-dev:i386=5.7*
  

Install required packages

sudo apt-get install git
sudo apt-get install gcc-multilib
sudo apt-get install g++-multilib
sudo apt-get install make

Linux (CentOS / Red Hat)

Install MySQL 5.7 client

• CentOS 6 / Red Hat 6:

  sudo rpm -Uvh https://dev.mysql.com/get/mysql57-community-release-el6-11.noarch.rpm
  

• CentOS 7 / Red Hat 7:

  sudo rpm -Uvh https://dev.mysql.com/get/mysql57-community-release-el7-11.noarch.rpm
  

• CentOS 8 / Red Hat 8:

  sudo rpm -Uvh https://dev.mysql.com/get/mysql80-community-release-el8-1.noarch.rpm
  sudo yum-config-manager --disable mysql80-community
  sudo yum-config-manager --enable mysql57-community
  

Install required packages

sudo yum install git
sudo yum install gcc-c++
sudo yum install glibc-devel.i686
sudo yum install mysql-community-devel.i686 mysql-community-libs.i686

Get the source code and compile it

git clone https://github.com/SphereServer/Source.git
cd Source
make NIGHTLY=1

Coding notes for new contributors

• Make sure you can compile and run the program before pushing a commit.
• Rebasing instead of pulling the project is a better practice to avoid unnecessary "merge branch master" commits.
• Removing/Changing/Adding anything that was working in one way for years should be followed by an ini setting if the changes cannot be replicated from script to keep some backwards compatibility.

Licensing

Copyright 2019 SphereServer development team

Licensed under the Apache License, Version 2.0 (the "License").
You may not use any file of this project except in compliance with the License.
You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0