Skip to content

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

 _____
/  ___|
\ `--.   ___  _ __ __   __  ___  _ __
 `--. \ / _ \| '__|\ \ / / / _ \| '__|
/\__/ /|  __/| |    \ V / |  __/| |
\____/  \___||_|     \_/   \___||_|
 _____                                       .------------------------.
/  __ \                                      | >_ [Island] Rex: hi!_  |     ((( o )))
| /  \/  ___   _ __ ___   _ __ ___   ___     '-----.  .---------------'         |
| |     / _ \ | '_ ` _ \ | '_ ` _ \ / __|          | /                         /|\
| \__/\| (_) || | | | | || | | | | |\__ \          |/  [Discord] Sue: o/      / | \
 \____/ \___/ |_| |_| |_||_| |_| |_||___/                                    /  |  \

Cross-server chat for ARK clusters. Global chat links every map in a cluster and relays to and from Discord through one bot per cluster. It also covers chat styling by group, tribe or player, moderation (mutes, anti-spam, word filter), Discord account linking, live player and admin lists, button panels, and an RCON Commander for admins. Data is stored in MariaDB.

Status: complete. Both versions and the bot are tested and running in production. This software will receive only bug fixes for future game state version updates. No new feature sets will be added beyond what is presented here.

Folder Part Runs on Player key
ASA ARK: Survival Ascended plugin, AsaApi at ASA/extern/AsaApi each game server EOS ID
ASE ARK: Survival Evolved plugin, ArkServerApi (AseApi) at ASE/extern/AseApi each game server SteamID64
Bot Discord bot (.NET 10, single exe) one per cluster, outside the server folders —

ASA and ASE are self-contained Visual Studio solutions. Bot is a .NET solution. Clone with submodules:

git clone --recurse-submodules https://github.com/bushome/ServerComms.git

or, in an existing clone:

git submodule update --init --recursive

Each cluster uses its own servercomms MariaDB database, its own Discord channels and its own bot token. The plugin and the bot are separate installs that talk only through that database. Never put the bot in ArkApi\Plugins\. The plugin creates its tables on first start, and the bot runs its own schema migrations. src/ChatLogic.h is the same in both plugin folders and is covered by tests/logic_tests.cpp. src/Main.cpp and the project files differ by API.

Releases ship three zips: ServerComms-ASA.zip, ServerComms-ASE.zip and ServerComms.Bot.zip (the self-contained bot, no .NET install needed). Install, commands, configuration and build steps are in each folder's README.