Go to file
Robin C. Ladiges 122a3cd80d fix: don't output empty player IDs or RemoteEndPoints in the log
Make and use a copy of the RemoteEndPoint at the start of the HandleSocket method.
Because in some cases when the socket is disposed, the RemoteEndPoint inside of it is cleared and isn't available for the following disconnect log entries.
Also: port scanners on the internet don't introduce themselves with a name and ID.

(cherry picked from commit 2f4cd0509a)
2022-10-10 11:13:32 -06:00
.github/workflows Add workflow_dispatch trigger to deploy action 2022-07-17 13:28:09 -06:00
Server fix: don't output empty player IDs or RemoteEndPoints in the log 2022-10-10 11:13:32 -06:00
Shared Add date to log messages 2022-06-20 12:57:45 -06:00
TestClient fix #14 2022-07-29 12:55:01 -06:00
.gitignore Add date to log messages 2022-06-20 12:57:45 -06:00
Dockerfile slightly increase docker build 2022-10-10 11:10:19 -06:00
README.md cleared up some confusion 2022-08-10 15:04:00 -06:00
SmoMultiplayerServer.sln Add README.md 2022-06-17 21:18:57 -06:00
docker-compose.yml slightly increase docker build 2022-10-10 11:10:19 -06:00
smo.service added TTY input 2022-08-02 18:01:59 -06:00

README.md

Super Mario Odyssey: Online Server

The official server for the Super Mario Odyssey: Online mod.

Windows Setup

  1. Download latest build from Releases
  2. Run Server.exe
  3. settings.json is autogenerated in step 2, modify it however you'd like.

Building (Mac/Linux Setup)

Must have the .NET 6 SDK and Git installed. Run these commands in your shell:

git clone https://github.com/Sanae6/SmoOnlineServer
cd SmoOnlineServer
# replace run with build to only build the server
dotnet run --project Server/Server.csproj -c Release

If you ran dotnet build instead of dotnet run, you can find the binary at Server/bin/net6.0/Release/Server.exe

Running under systemd

If you have systemd, you can use the existing systemd serivce.

cp smo.serivce /etc/systemd/system/smo.service
# edit ExecStart to your path for the server executable and change WorkingDirectory to the server directory
chmod +x filepath to the server executable
systemctl enable --now smo.service
# for TTY access i would recommand conspy but there is also reptyr, chvt

Run docker image

If you have docker on your system, you can use the existing docker image. That way you don't have to build this server yourself or manually handle executables.

docker  run  --rm  -it  -p 1027:1027  -v "/$PWD/data/://data/"  ghcr.io/sanae6/smo-online-server
# on Windows, depending on the shell you're using, $PWD might not work. Use an absolute path instead.

To always check for and use the latest server version you can add --pull=always to the options.

Alternatively there's a docker-compose.yml for docker-compose to simplify the command line options:

# update server
docker-compose pull

# start server
docker-compose up -d

# open the server cli
docker attach `docker-compose ps -q` --sig-proxy=false

# watch server logs
docker-compose logs --tail=20 --follow

# stop server
docker-compose stop

Commands

Run help to get what commands are available in the server console. Run the loadsettings command in the console to update the settings without restarting. Server address and port will require a server restart, but everything else should update when you run loadsettings.

Settings

Server

Address: the ip address of the server, default: 0.0.0.0 # this shouldn't be changed
Port: the port of the server, default 1027
Maxplayers: the max amount of players that can join, default: 8
Flip: flips the player upside down, defaults: enabled: true, pov: both
Scenario: sync's scenario's for all players on the server, default: false
Banlist: banned people are unable to join the server, default: false
PersistShines/Moons: Allows the server to remember moon progress across crashes/restarts

Discord

Note: Token and LogChannel needs to a string puts "" around it
Token: the token of the bot you want to load into, default: null
Prefix: the bot prefix to be used, default: $
LogChannel: logs the server console to that channel, default: null