# Multiplayer - Direct Connect through in-game UI

**URL:** <https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660>\
**Category:** Suggestions\
**Created:** [March 23, 2019, 7:44pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660 "2019-03-23T19:44:48Z")\
**Posts on this page:** 10\
**Page:** 1

<div class="post-metadata">

**Author:** ![Agent654](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/agent654/32/61799_2.png) [@Agent654](https://discourse.stonehearth.net/u/Agent654)\
**Post date:** [March 23, 2019, 7:44pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/1 "2019-03-23T19:44:48Z")

</div>

Please, I understand that the game’s active development is going to be winding down, but is there any way we can get an in-game main menu UI option to direct connect to an IP address?

Please?

---

<div class="post-metadata">

**Author:** ![Wouter\_Sikkema](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/wouter_sikkema/32/61482_2.png) [@Wouter\_Sikkema](https://discourse.stonehearth.net/u/Wouter_Sikkema)\
**Post date:** [March 23, 2019, 7:59pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/2 "2019-03-23T19:59:46Z")

</div>

the game is pretymuch dead in the water except for mods. unless someone figures out how to mod it in: its not going to happen unfortunatelly. now to be fair we still have one or two absolute grandlevel wizards of modding shuffeling around, but this sounds like a bridge too far to me.

---

<div class="post-metadata">

**Author:** ![Agent654](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/agent654/32/61799_2.png) [@Agent654](https://discourse.stonehearth.net/u/Agent654)\
**Post date:** [March 23, 2019, 8:06pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/3 "2019-03-23T20:06:01Z")

</div>

Yeah, I was hoping for one more last-ditch dev effort - considering the game isn’t going to be supported, being able to have multiplayer host/connect functions wired into the UI bypassing steam seems the best way to “open it up”.

---

<div class="post-metadata">

**Author:** ![max99x](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/max99x/32/40094_2.png) [@max99x](https://discourse.stonehearth.net/u/max99x)\
**Post date:** [March 23, 2019, 8:44pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/4 "2019-03-23T20:44:26Z")

</div>

> [@Wouter\_Sikkema](#):
>
> this sounds like a bridge too far to me.

Should be possible. It’s all just `user_settings.json` configuration, which you can do through the API. Opening the port in your firewall or figuring out peer IP from some other contact info is the hard part which isn’t possible through a mod alone.

---

<div class="post-metadata">

**Author:** ![Agent654](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/agent654/32/61799_2.png) [@Agent654](https://discourse.stonehearth.net/u/Agent654)\
**Post date:** [March 23, 2019, 9:28pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/5 "2019-03-23T21:28:47Z")

</div>

I guess the real point is the idea that I can try repeatedly through the menu to hash out connection problems, rather than restarting the game each time.

Kind of a pain … not to mention it’s not very user-friendly. 🤷‍♂️

---

<div class="post-metadata">

**Author:** ![ayazar](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/ayazar/32/53742_2.png) [@ayazar](https://discourse.stonehearth.net/u/ayazar)\
**Post date:** [March 27, 2019, 6:10am UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/6 "2019-03-27T06:10:04Z")

</div>

Unfortunately since there’s no way to call BeginConnect from lua, the easiest way to do this would be through a separate launcher. A hypothetical launcher would:

1. Fetch a list of IP/ports that are currently hosting a game of Stonehearth from a 3rd party server that hosts game meta data.
2. Display that list, with join buttons & metadata
3. When a join button is clicked, launch Stonehearth with these options:

```auto
Stonehearth.exe --steam.enabled=false --multiplayer.remote_server.enabled=true --multiplayer.remote_server.ip='192.168.1.1' multiplayer.remote_server.port=42

```

With multiplayer.remote\_server.ip & multiplayer.remote\_server.port set to whatever the server’s IP:Port combo is. Also, the single quotes around the IP address are important, double quotes don’t work.

If the launcher was written with electron, the launch function could look like this:

```auto
const { spawn } = require('child_process');

function launchStonehearth(ip, port) {
  let args = [
    `--steam.enabled=false`,
    `--multiplayer.remote_server.enabled=true`,
    `--multiplayer.remote_server.ip='${ip}'`,
    `--multiplayer.remote_server.port=${port}`
  ];
  spawn("Stonehearth", args, { shell:true });
}

```

Assuming the launcher lived in the same folder as Stonehearth. I’ve attached an empty-ish electron app to help anyone interested get started: [stonehearth-launcher.zip](https://discourse.stonehearth.net/uploads/short-url/kzOZkpNSgyUk7WcGZqKoI3rf0hr.zip) (43.4 KB)

In the end, the tricky part is not launching the game, it’s maintaining the server list. I think @Bolune made good progress on a headless mode a while ago, I’m not sure where it ended up but it was very impressive.

Depending on where he got with that, you could have a list of headless servers that run on AWS or something that you can connect to. That would make managing the list of available servers a little less painful. A cheap hack for that might be a google spreadsheet that the launcher pulls the data from.

I understand this is waaay less than ideal, but I hope it helps someone or is mildly interesting!

---

<div class="post-metadata">

**Author:** ![Bolune](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/bolune/32/69884_2.png) [@Bolune](https://discourse.stonehearth.net/u/Bolune)\
**Post date:** [March 27, 2019, 3:09pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/7 "2019-03-27T15:09:22Z")

</div>

I did consider making an external launcher but I disliked the idea that people would need to load up an exe file that isn’t apart of Stonehearth so I didn’t bother.

> [@ayazar](#):
>
> Also, the single quotes around the IP address are important, double quotes don’t work.

Sounds like my multiplayer.remote\_server.ip issue was because I used double quote.

Headless mode does work. I ran it on a variety of AWS instances. You do not need the GPU addon. For AWS, I used either c5.xlarge or c5.2xlarge.

Saving the game works if you use a pre-loaded save.

You can check out the README for notes and the mod code to enable multiplayer settings at run time for (auto generated worlds)

> **[GitHub - ssinakhot/stonehearth-mpe: Improves multiplayer functionality](https://github.com/ssinakhot/stonehearth-mpe)**
>
> Improves multiplayer functionality. Contribute to ssinakhot/stonehearth-mpe development by creating an account on GitHub.

---

<div class="post-metadata">

**Author:** ![ayazar](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/ayazar/32/53742_2.png) [@ayazar](https://discourse.stonehearth.net/u/ayazar)\
**Post date:** [March 27, 2019, 4:13pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/8 "2019-03-27T16:13:33Z")

</div>

Awesome! I’m really happy you put that together and hosted it on github!

Sorry about the double quotes thing, I thought they should work because I specifically had to write a hack to support them at one point: `boost::algorithm::trim_if(remoteServerHost, boost::algorithm::is_any_of("\"'"));` So technically you don’t even need the second quote, it’s just a hack to get the argument parser to treat the address as a string.

Anyway I had another thought as I drifted off to sleep last night, one could use firebase to keep track of hosts, and just let the launcher declare new hosts. Slightly more involved than a google sheet though: [Firebase Realtime Database | Store and sync data in real time &nbsp;|&nbsp; Firebase](https://firebase.google.com/products/realtime-database/)

---

<div class="post-metadata">

**Author:** ![Bolune](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/bolune/32/69884_2.png) [@Bolune](https://discourse.stonehearth.net/u/Bolune)\
**Post date:** [March 27, 2019, 4:39pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/9 "2019-03-27T16:39:16Z")

</div>

Firebase is a great suggestion. Free SSL and html hosting. For low traffic sites, I always recommend to use firebase since you can get away with the free plan or by adding in a credit card to increase the basic limits.

---

<div class="post-metadata">

**Author:** ![RepeatPan](https://sea2.discourse-cdn.com/flex022/user_avatar/discourse.stonehearth.net/repeatpan/32/46418_2.png) [@RepeatPan](https://discourse.stonehearth.net/u/RepeatPan)\
**Post date:** [March 27, 2019, 7:19pm UTC](https://discourse.stonehearth.net/t/multiplayer-direct-connect-through-in-game-ui/39660/10 "2019-03-27T19:19:26Z")

</div>

Creating a master server should be relatively easy. You just need to specify the protocol, for which I’d suggest “borrowing” the one I’ve seen a few years ago in another game.

Basically, there’s a client and a masterserver, which holds the list. The masterserver has a few operations:

- List: Shows the list of currently running games.
- Add: Adds a game to the list.
- Update: Updates a game on the list.
- Remove: Removes a game on the list.

Update is necessary to avoid having “dead” games. If a game doesn’t send an update within a reasonable timeframe (30s-5min), it’s considered dead and de-listed.

Each game information contains the necessary meta-information, such as the IP/Port of the server/player (preferably determined by the server, i.e. the client just sends 0.0.0.0 and the master server replaces it with the remote IP from the request), game name, player name, player count, and other data that could be relevant, such as playtime, or players that are playing in said game. Of course, a mod list might also be useful to enable/acquire or just list mods prior to joining.

In order for the announcement part to work, you’d need to HTTP to the server though - which isn’t that difficult, if you’re willing to break some rules (_cough_ HHH). Since the hosting/announcing would probably work independent of any launcher (and could be done for local hosted games as well), you could easily separate the actions. Launcher lists games and launches the game; game itself announces itself on the server and keeps tab on it.

Bonus: If you are already breaching the game’s sandbox by allowing HTTP calls, you could have the launcher host a local http server (bound to localhost to avoid external exploits) to issue commands. That would allow an in-game server browser in the following, very hacky style:

1. Game contacts master server, lists games to player.
2. Player selects a game and clicks join.
3. Game contacts launcher; passes the necessary game information as content. After the request is done, game exits itself.
4. Launcher waits until the process is dead, then starts Stonehearth again, passing the necessary args to join the game.

Not exactly nice, but could work.