Crowd Control Setup Guides

1. Start with the App

• Open Crowd Control Desktop App

• Select Valheim from the game list

• Follow the Auto Setup checklist (left side of app) to install the mod

• Launch the game with the Play button in the app

• Press Start and test an effect or two

Prefer manual installs? You can find the full BepInEx + CC mod package here

2. Test Before You Stream

• You can only test effects after pressing "Start Session" in the Crowd Control app

• Always test a few effects before going live to confirm effects trigger as expected

Skipping this step can lead to broken streams and confusion!

Multiplayer & Servers

• Every player who wants to receive effects needs the mod installed

• What changes between setups is where the Crowd Control connection lives: your desktop app, or the server itself

Singleplayer

• You need the mod and the desktop app. Nothing else to do.

Player-hosted worlds

This is a world started from inside the game (Start Game, then Start Server), not a dedicated server.

• The host must be running the mod. If the host does not have it, effects will queue and refund in Crowd Control.

• Every player who wants effects needs the mod and their own Crowd Control session in the desktop app. Effects apply to whoever bought them.

• Players without the mod can still play normally. They just cannot be targeted.

• Size effects (giant/tiny player, giant/tiny enemies) are shown to everyone else who has the mod, so the whole group sees the same thing. Players without the mod see everyone at normal size.

Dedicated servers

Dedicated servers are supported. The server runs the mod and holds the Crowd Control connection itself, so streamers do not need the desktop app running. They link their account in-game instead. See the Dedicated Servers section below.

Joining a server that does not have the mod

• If the server or host does not have the mod, you will see Crowd Control server mod not available. on screen shortly after joining, and effects will queue and refund in Crowd Control.

• If you play on a modded server without the mod yourself, you are never kicked. You get a one-time message telling you what to install, and viewers cannot target you until you do.

Dedicated Servers

Server operators: install

1. Stop the server.

2. Download the server package and extract it into the root of your dedicated server install, next to valheim_server.exe or valheim_server.x86_64.

3. Start the server with the BepInEx launcher instead of the normal one:

4. Check the log for Crowd Control: dedicated-server mode active. On first run the mod writes CrowdControl-Server.json.

• The server only makes outbound connections to Crowd Control. There are no extra ports to open and no desktop app on the server.

Streamers: connecting on a dedicated server

1. Install the client mod as normal (Start with the App steps above).

2. Join the server. Within a few seconds you will see Crowd Control: type /cc link to connect.

3. Open the chat with enter, or open the console with F5, and type /cc link. Your browser opens to finish linking.

4. That is it! Your session runs on the server, and effects target you.

Other /cc commands

• /cc status: whether you are linked, and whether a session is running

• /cc unlink: end your session and disconnect your account from the server

• Your session also ends automatically when you leave the server

Server settings (CrowdControl-Server.json, created on first run)

• broadcast_effects_to_all_players (default false): when on, an effect bought by one streamer also hits everyone else on the server. Off means it only hits the streamer it was bought on.

• allow_player_linking (default true): whether players may use /cc link at all

• check_connectivity_on_start (default true): check Crowd Control is reachable at startup and say so in the log

• effects: one entry per effect. Set inactive: true to hide an effect from the menu instead of letting viewers buy something the server will refuse.

• Any number of streamers can be linked to the same server at once, each with their own session.

Mod Compatibility

• Our mod was made using the BepInEx pack for Valheim

• Other mods may work with ours, but have not been tested. If you run into issues, try with a clean profile. If you find a mod that causes issues, let us know!

• CC mod package: Valheim-CC.zip

Game Version

• Our support has been tested with the Steam version of the game

• Tested on Valheim 1.0

• Other stores, like Xbox Game Pass, may not work

• The client mod and the server mod are the same download and must be the same version on both ends. If they do not match, you will be told on join rather than left with effects that half-work.

Looking for another game store? Submit a request to our Discord, #cc-requests.

Uninstall

To uninstall the Crowd Control mod:

• From the CC desktop app, select your game.

• Click the trash icon 🗑️ next to "Mod Installed" to run the uninstaller.

• This only works if you previously used "Skip Mod Manager".

To uninstall from a dedicated server:

• Stop the server.

• Delete BepInEx/plugins/CrowdControl.dll (or the whole BepInEx folder to remove the loader too).

• Go back to your normal launch script.