SSMP

SSMP

What is Silksong Multiplayer?

As the name might suggest, Silksong Multiplayer (SSMP) is a multiplayer mod for the popular 2D action-adventure game Hollow Knight: Silksong.

The main purpose of this mod is to allow people to host games and let others join them in their adventures.

There is a dedicated Discord server for the mod where you can ask questions or generally talk about the mod.

Moreover, you can leave suggestions or bug reports. The latest announcements will be posted there.

Install

When using an installer that is compatible, everything should work auto-magically.

Manual install

Please refer to the Github repository for details on how to manually install the mod.

Usage

The mod can be accessed by using the "Start Multiplayer" option in the main menu of the game.

Once the multiplayer menu is opened, you will be greeted with a dashboard from which you can choose to play online or on a local network.

Steam Support

SSMP fully supports Steam networking.

This means you can easily host a game and invite your friends through the Steam overlay without worrying about port forwarding or IP addresses.

• Hosting: To host a Steam lobby, simply select the "Steam" option in the hosting menu.
• Inviting: Once hosting, you can use the Steam overlay to invite friends, or use the /invite command in-game.
• Joining: Friends can join your game directly through their Friends list or by accepting your invite.

Matchmaking Service (MMS)

The mod includes a built-in server browser powered by our Matchmaking Service.

• Lobby Browser: You can browse public lobbies directly from the multiplayer menu.
• Hole Punching: The MMS facilitates NAT hole-punching, which allows players to connect to each other directly (P2P) without needing to port forward in most cases.

Direct Connection & LAN

For those who prefer a traditional connection, you can still connect directly via IP address.

• Hosting: Forward the port (default 26960) on your router to your device.
• LAN: Playing on the same local network works out of the box.
• VPN: Tools like Hamachi can be used to simulate a LAN over the internet.

If you start hosting or joining a server, the mod will prompt you to select a save file to use.

This save file is only used locally and will not synchronise with the server.

Commands

The mod features a chat window that allows users to enter commands.

The chat input can be opened with a key-bind (Y by default), which features the following commands:

• /help: Show the list of available commands.
• /list: List the names of the currently connected players.
• /invite or /inv: Open Steam's invite dialog to invite friends to your lobby.
• /addon [addon(s)]: Enable, disable, or list client addons.
• /set [value]: Read or write a setting with the given name and value.
• /skin: Change the currently used skin ID for the player.
• /team: Change the team that the player is on.
• /announce: Broadcast a chat message to all connected players (Admin only).
• /kick: Kick a player (Admin only).
• /ban: Ban a player (Admin only).
• /unban: Unban a player (Admin only).
• /banip: Ban an IP address (Admin only).
• /unbanip: Unban an IP address (Admin only).
• /copysave: Copy save data from one player to another (Currently disabled).
• /debug: Output various debug information to the log.

Authentication/authorization

Each user will locally generate an auth key for authentication and authorization.

This key can be used to whitelist and authorize specific users to allow them to join

the server or execute commands that require higher permission.

• /whitelist [args]: Manage the whitelist with following options:
• on|off: Enable/disable the whitelist.
• add|remove [name|auth key]: Add/remove a user.
• clear [prelist]: Clear the whitelist.
• /auth: Authorize a player.
• /deauth: De-authorize a player.

Standalone server

It is possible to run a standalone server on Windows, Linux and Mac.

The latest executable of the server can be found on the releas