search

StygianTheBest / StygianCore

An AzerothCore v3.3.5a Server Emulator
GNU Affero General Public License v3.0
68 stars 74 forks source link

readme

StygianCore

An AzerothCore 3.3.5a Solo/LAN repack by StygianTheBest | GitHub | Website

NEWS

StygianCore v2019.03.10 has been released!

The StygianCore repack and sources have been completely upgraded to the latest revision of AzerothCore. I did not want to delay the initial v2019.03.01 release of the StygianCore repack, so it did not include the recently revised database structures or important commits that greatly improve the core. If you are running a previous version, I highly recommend moving to this one ASAP.

The StygianCore repack will now be released quarterly and will incorporate the latest AzerothCore changes as well as any updated or additional StygianCore custom content. The project sources will be continually updated as I make changes and pull from the AzerothCore repository.

DOWNLOAD

GREETINGS

Welcome to StygianCore. This repack is powered by AzerothCore and would not be possible without the players, developers, and communities of the MMO emulator and private server scene. A big thanks to everyone for any and all contributions absorbed to make this repack possible. Your hard work is much appreciated!

This project is, and will always be, FREE! I designed it with lots of comments and templates to make life easier for new developers and creators to get started. My hope is that all of the hard work I put into this will inspire others to get involved and create more cool and interesting projects for the WoW Emulation community.

This repack is dedicated to the late Michel Martin Koiter (May 4, 1984 – March 18, 2004). His shrine in World of Warcraft served as a place of solace for myself, my guildmates, and countless others in the classic days of World of Warcraft and beyond.

TRIBUTE TO MICHEL KOITER

Michel Koiter was one of Blizzard Entertainment's premium artists and a member of Sons of the Storm. He went by the moniker "Twincruiser", an artistic collaboration with his twin brother René Koiter. Just a few months before World of Warcraft's release, he died of unexpected heart failure. He was 19 years old. The cause of his death was never really understood and remains shrouded in mystery.

It is said that his ghost still wanders the Barrens looking for a good brawl.

Rest In Peace.. See you on the other side brother.

INTRODUCTION

StygianCore is a custom build of the AzerothCore v3.3.5a MMO server emulator. Last fall I promised to release a repack of this server for friends to host at home. Additionally, I wanted to share a fun levelling server for solo or 4-10 player groups and help others who want to exprience the nostalgia of the past and get started with development, scripting, and building their own server experience.

Included are custom tools and docs for maintaining the game database and automating archive, save, and restore operations for sandboxing, testing, and development.

A bit of history...

In addition to new content, this repack includes updated versions of my C++ modules, SQL templates, custom tools, and client modifications from my AzerothCore Content release in summer 2017 which included 11 new modules and a lot of ported C++ and SQL from TrinityCore.

StygianCore

TL;DR

You should read the rest of this document thoroughly before submitting any questions or bug reports. From here you can continue reading - probably a good idea - or skip to the Getting Started section.

DOCUMENTATION & SUPPORT

This repack is released with no official support. All questions, requests, and bug reports should be directed through the StygianCore GitHub repo(s). Be sure to follow the repos to see when I put out an update or bugfix. I will respond to all questions as time permits.

Documentation for the this repack and its contents can be found throughout the documents, code, SQL, and scripts. For more information you can visit my website or peruse the GIT repos. I've tried to be as detailed as possible to diminish the learning curve and get new users up and running quickly.

READ THE FOLLOWING FILES BEFORE ATTEMPTING TO RESTORE, EDIT, OR DELETE ANY SQL OR CONFIG FILES IN THE REPACK

The Support folder also contains documentation and other support files. You can view many these files by by starting the included Apache Web server and visiting the Account Registration Portal at http://127.0.0.1/.

Support Folder Contents

CORE

BACKUP/RESTORE/UPDATE

HIGHLIGHTS

SERVER, PLAYER, AND GUILD

Guildmaster Characters

Default Guildmaster Characters for Alliance & Horde

LIFE, DEATH, AND COMBAT

SKILLS & CRAFTING

WORLD

A client patch is required to enable this content in the repack.

CUSTOM NPC

CUSTOM VENDORS

StygianCore Specialty Vendors: Over 30 new vendors with custom item sets are placed in various locations throughout the land.

CUSTOM NPC TOOLS

ITEM PRICING

Vendor an items have been repriced using the included item pricing template.

PLAYER ITEMS

A client patch is required to see the icons for the custom items in this repack.

Eluna

This repack includes the Eluna LUA Scripting Engine.

The Eluna Lua Engine© API allows you to add your own Lua code to be executed when certain events (called "hooks") occur.

Add a new in-game command, give life to creatures with new AI, or even light players who try to duel on fire! If the hook exists, you can script it.

MODULES

StygianCore was compiled with the following modules/mods:

Be sure to look at the config files for the world server and modules located in the Server/Core folder. You can modify these files to configure how the server and modules work and what features are available for each during gameplay.

GETTING STARTED

This repack includes a default Administrator account. It is used to log into the server console, the WoW game client, and for SOAP communications via the Account Registration portal.

ADMIN LOGIN

1) UNZIP THE STYGIANCORE REPACK ARCHIVE

This server and tools are portable. You can run it from any folder.

2) CONFIGURE THE SCC LAUNCHER

StygianCoreControls.exe - Launcher and Process Monitor

Controls

Run StygianCoreControls.exe - This is a launch tool built for StygianCore and assists with running the processes and admin tools in the repack. It is preconfigured to run all of the server components. It offers the following features:

ICONS StygianCore Tools

Each icon launches a tool or performs a function:

StygianCoreTools.bat - Repack Maintenance Tool

When you're ready to run an archive, backup, or restore process, click the small Sword in the bottom right of the launcher to bring up the tool which performs the following tasks:

StygianCore Tools Menu

The menu and options on this tool are dynamic and will change as you perform different tasks. The default menu looks like this:

StygianCoreTools Menu

MENU OPTIONS

ADDITIONAL TOOLS

I've packaged a few custom tools I use for administration of the server. Batch files are used extensively to automate many file handling and database import/export functions.

2) CONFIGURE EACH GAME CLIENT

Set your realmlist.wtf file to point to the server. For local play it should work with the default of 127.0.0.1.

NOTE: If you are using the StygianCore Client Pack, a batch tool called SCUpdateIP.bat is included that automates this procedure and gives you flexibility for using one client with serveral different servers.

If you are putting the server on a different system, you will need to use that system's address. In addition, you will need to edit the auth database realmlist table to point to that system. In the example, the server is listening for remote connections on 192.168.1.20 with a local address of 127.0.0.1. Here's a sample query to change the IP.

INSERT INTO `stygian_auth`.`realmlist` (`id`, `name`, `address`, `localAddress`, `localSubnetMask`, `port`, `icon`, `flag`, `timezone`, `allowedSecurityLevel`, `population`, `gamebuild`) VALUES ('1', 'StygianCore', '192.168.1.20', '127.0.0.1', '255.255.255.0', '8085', '0', '0', '2', '0', '0', '12340');

3) UPDATE YOUR WOW CLIENT INSTALLATION

Copy the client patch files from the repack's ClientPatch folder to your client's Data folder. These files are required to support custom items, objects, and other content in the repack.

NOTE: Be sure to delete your client's cache folder after copying the new patches!

This is the client support patch required to display and enable custom content in the repack.

If this patch is NOT installed:

To complete the StygianCore experience, I suggest downloading my 3.3.5a Client Upgrade which includes HD Player and Creature Models, Random Animated Login Screens, Custom Add-Ons and more.

REPACK UPDATES

This repo is the home of all future updates to any of the content in this repack. The folder structure is a mirror of the file structure within the repack archive, so you can easily download and copy file updates into your repack or restoration archive.

- Client
  - Interface
    - Custom Addons
  - Data
    - Required Game Patches
- Server
  - Server
    - Apache
      - httpdocs
        - Account Registration Portal
        - Online Documentation
    - Core
      - lua_scripts
        - LUA scripts for Eluna
- Support
  - Docs
    - Server Documentation
  - Icons
    - For shortcuts and the like
  - Template
    - SQL templates for creating items, npcs, etc.
- Tools
  - Patch
    - Instructions on how to apply StygianCore repack updates
  - Work
    - restore_stygiancore
      - The master restoration archive.
      - All game SQL, conf, and other updates are stored here.
      - This is where the magic happens.. The Codex of Ultmate Wisdom!

OTHER INFORMATION

COMPILING

You will need a few things to compile the source of this repack. The source can be found in the GitHub Repo. Below are the specific tools and versions I used to compile the repack on my virtual machine. You may be able to use updated versions.

TRINITYCORE DATABASES

The MySQL server included in this repack also contains the TrinityCore databases from 2019-01-27. These are used for a TrinityCore Sandbox repack I've created for adding custom content with Rochet's GOMove and DressNPC tools. It shares the database server with StygianCore to make imports from core to core a breeze. You can find more info on that project at my website.

DEVBOX

CORE MODIFICATIONS

All mods are labled with SCMOD in the source

ADDITIONAL TOOLS USED

RESTORE TIMING

This is the timing for Restore (Option #5) in StygianCoreTools.bat.

- 0:00 - DEFAULT CONTENT (START RESTORE)
- 1:47 - UPDATE CONTENT
- 2:13 - CUSTOM CONTENT (FINISH RESTORE)

CREDITS

Styx StygianCore

An AzerothCore 3.3.5a Solo/LAN repack by StygianTheBest | GitHub | Website

Additional Credits

Hellscream's Chosen Guild of Stonemaul

LICENSE

All code and scripts are released under GNU AGPL v3.

World of Warcraft© and Blizzard Entertainment© are all trademarks or registered trademarks of Blizzard Entertainment© in the United States and/or other countries. These terms and all related materials, logos, and images are copyright Blizzard Entertainment©. This site and content is in no way associated with or endorsed by Blizzard Entertainment©.

:top: