Skip to content

Latest commit

 

History

History
120 lines (81 loc) · 3.39 KB

README.md

File metadata and controls

120 lines (81 loc) · 3.39 KB
Raw

SWGepub6

forked from SWGEmu Core3

What is SWGpub6?

Ditto SWGEmu but pub 6

Setup guide

Install Docker -- https://www.docker.com/products/docker-desktop

Enable BuildKit (faster) -- https://stackoverflow.com/questions/58592259/how-do-you-enable-buildkit-with-docker-compose

Windows Users Follow -- https://nickjanetakis.com/blog/setting-up-docker-for-windows-and-wsl-to-work-flawlessly#ensure-volume-mounts-work

Git, Docker, and TREs

git clone https://github.com/TheArchitect108/swgepub6.git
Place the required TREs in server/tre. A list can be found under server/conf/config.lua.
git submodule update --init --recursive
docker-compose build * may take 15-20 mins
docker-compose up -d

Database

You can connect to the MySQL database using localhost:3306 using any MySQL compatible tool. The root password can be found in the docker-compose.yml

Restore swgemu.sql and run admin_account.sql if the server does not start automatically.

Server Defaults

Scripts included in the server directory will be copyed over and loaded. Default login: admin Default password: admin

Troubleshooting Docker

If the server does not start on first run, it's likely the database. Make sure the sql files were ran properly.

You can use the following commands to troubleshoot more indepth --

docker container ls
docker attach pub6_server
docker container kill pub6_server
docker logs --tail 50 --follow --timestamps pub6_server

Old Way

Dependencies

  • CMake 3.1.0 or higher
  • BerkeleyDB 5.3
  • MySQL Client and Server
  • OpenSSL libraries
  • pthreads
  • Lua 5.3 libraries
  • Zlib libraries
  • g++ 5.4+ or compatible
  • engine3
  • java jre 1.7+

Build

  • Install dependencies (Debian 9+ or Ubuntu 16.04+)

    sudo apt install build-essential libmysqlclient-dev liblua5.3-dev libdb5.3-dev libssl-dev cmake git default-jre

  • Install dependencies (RHEL/CentOS 8+ or Fedora 28+)

    sudo dnf install automake cmake git gcc gcc-c++ java-1.8.0-openjdk-headless libatomic libdb-devel lua-devel make mariadb-devel openssl-devel

  • Clone core3 repository somewhere (~/git)

    mkdir -p ~/git
cd ~/git
git clone https://github.com/TheArchitect108/swgepub6/

  • Build Core3 with 8 threads

    cd MMOCoreORB
make -j8

  • Import sql database

    mysql -h<MYSQLHOST> -u<MYSQLUSER> -p<MYSQLPASSWORD> < sql/swgemu.sql

How to Run

cd ~/git/swgepub6/MMOCoreORB/bin
./core3

Gratitude

Big thanks to all the developers and contributors to SWGEmu, Core3, and Engine3.

@Lyhtmyst & @Phoenix for pub6 changes

@thmhoag for his original work to dockerize things -- https://github.com/thmhoag/swgemu-docker

License

Copyright (C) 2020 SWGEmu

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU Affero General Public License as published by the Free Software Foundation,
either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with this program.
If not, see <http://www.gnu.org/licenses/>.