apathyboy / stationapi

An open implementation of the chat gateway that SOE based games used to provide various social communication features such as mail, custom chat rooms, friend management, etc.

stationapi

A base library at the core of applications that implement chat and login functionality across galaxies.

stationchat

An open implementation of the chat gateway that SOE based games used to provide various social communication features such as mail, custom chat rooms, friend management, etc.

Like my work and want to support my free and open-source contributions?

Implementation

Uses the SOE libraries to implement chat features in a standalone utility. Ideally, the completed implementation would allow for multiple galaxies to connect and allow players to communicate across them.

External Dependencies

• c++14 compatible compiler
• boost::program_options
• sqlite3
• udplibrary - bundled in the Star Wars Galaxies official source

Building

Copy the udplibrary directory from the Star Wars Galaxies offical source to the top level swgchat directory, install the remaining dependencies via a package manager, then run the following:

mkdir build; cd build
cmake ..
cmake --build .

Database Initialization

By default, a clean database instance is provided and placed with the default configuration files in the build/bin directory; therefore, nothing needs to be done for new installations, the db is already created and placed in the appropriate location.

To create a new, clean database instance, use the following commands:

sqlite3 chat.db
sqlite> .read /path/to/extras/init_database.sql

Then update the database_path config option with the full path to the database.

Running

A default configuration and database is created when building the project. Configure the listen address/ports in build/bin/stationchat.cfg. Then run the following commands from the project root:

Windows

cd build/bin
.\Debug\stationchat.exe

Linux

cd build/bin
./stationchat

Final Notes

It is recommended to copy the build/bin directory to another location after building to ensure the configuration files are not overwritten by future changes to the default versions of these files.

stationapi's Issues

Reconnecting to swgchat does not clear previous online avatars

When a game server reconnects to the swgchat server avatar login fails if the avatar was online at the time the game server restarted.

Consider how to handle the situation. Ideas are as follows:

• Clear the online avatar list when SetApiVersion messages are received (the first message a server sends when connecting to swgchat).
• Do not treat existing online avatars as a failure and "resume".

Of the options above, clearing the avatar list when SetApiVersion is received would appear to have the least amount of potential side effects.

[Request] Assistance fixing for Win32

Hello Apathy & other devs. First of all wanted to say thanks for your contribution to the scene.

I'm in the process of compiling a "bug free" package for win32 users. I know it's not the "preferred" method of deploying for servers, but some us are just down right fools. Anyway, in the current state of things, unfortunately stationapi is not currently functioning 100% for win32. As of right now, friends list, and mail are the only functioning features -> so that means group, guild and chat channels are not working ~ at all. Chat channels sort of "work", but not really.

I've got everything set up and compiling for win32, and I've been trying to route out the issues with the non-working functions. So far without much progress, I've yet to find anything useful.

Would anyone mind joining me on this adventure to see if we can resolve this for the betterment of the SWG scene? Thanks. You can hit me up on Discord (𝙋𝙤𝙋𝙤𝙒𝙖𝙣𝙊𝙗𝙞#5453) or use this post.

P.s., once everything is up and running I am planning on releasing source (for fixes) and binaries to swgsource for everyone to start contributing on. SB opening up their code graciously on Linux but Win needs love too :)