27 ratings
Mod, 1.3
File Size
2.271 MB
Sep 5, 2021 @ 10:37pm
Sep 10, 2021 @ 7:53pm
2 Change Notes ( view )

Subscribe to download

After much sadness over the author's decision to move on from this project, I eventually decided to give it a whirl. Thanks to the open source nature of the project, it didn't take me long to get started down the rabbit-hole of updating it to work with 1.3... There's still a lot of work left to do, but I wanted to get this amazing project back out into the community.

Original mod by Brrainz

Unsubscribe from the old mod
- Brrainz will no longer be updating it.
- Streamers will need to download a new game token if they had previously use an old one from puppeteer.rimworld.live.

New Server: https://pupp3t.live/

Some known Issues:
  • Pawns sometimes turn invisible
  • Toolkit integration is not always functional
    (viewers sometimes are not able to use the TT tab in Puppet)
  • Updating hairstyles
    • Is not represented in-game immediately
    • Players can choose hairstyles not allowed by ideoligion

Originally posted by "brrainz":
Puppeteer allows RimWorld players to give others control over a colonist. It's completely web-based and does not use things like Twitch chat to do so. As a gamer you install the mod and follow the instructions below to pair your game to your Twitch identity. Then you publish your game and as soon as you are in a game, your viewers will see you in the Lobby. You can now assign colonists to viewers that are waiting for assignment.

As a Twitch viewer, you can open your browser (or mobile phone) to wait until a streamer starts a published game and when you get assigned, you can see all the colonist stats and control your character. The one playing the game can restrict remote controlled colonists from doing bad things and every action is logged in the combat log of the colonist.

Getting started with Puppeteer:

=> For Streamers

- Install the mod by subscribing to it on this page
- Start your game and open a web browser at https://pupp3t.live
- Use the Twitch button to log in
- After logging in, go to Settings -> Streamer and create a game token
- Download the game token and put the file in `AppData\LocalLow\Ludeon Studios\RimWorld by Ludeon Studios\Config`
- Now you can configure your listing under **Stream Information** and put your game online
- After your viewers will enter the game, you can assign them by right clicking on the colonist in the colonist bar or by using the last section on the page
- The upper right corner shows a connection meter that shows you the load on your connection to the server (should normally stay at 0ms)
- Beside that is a small colonist icon with a [+] button that can be used to add a brand new colonist to the colony and assign it in one step
- Creating new colonists in the previous step supports Prepare Carefully and you can even give new colonists weapons to start with if you like

=> For Viewers

- Open a web browser at https://pupp3t.live
- Use the Twitch button (YouTube button currently under review) to log in
- After logging in, wait in the Lobby until a streamer has made their game available, then select it
- When the streamer sees that you are in the game and available, he/she might assign a colonist to you
- Once assigned the colonists data will appear and some commands are already enabled

# Respawning

Puppeteer has a respawn system that makes deaths caused by viewer interactions less fatal. You place a portal in your base and colonists that satisfy the following conditions will respawn with their apparel and fully healed:

- Tickets are given at start of a NEW game
- EXISTING games will get the tickets the first time you load then with the new Puppeteer (and unless you save the game, you can repeat this)
- The amount of given tickets is defined in the Puppeteer settings
- A respawn consumes a ticket
- Selecting the portal shows the remaining tickets in the lower left corner
- No tickets means all deaths are permanent

- A death that is caused by a viewer will be compensated by a respawn
- A death caused by the streamer/player will be permanent
- Any interaction of the streamer/player with the colonist will start a cooldown (blue bar)
- During the cooldown, a death is considered the fault of the streamer/player
- The cooldown time can be set in the Puppeteer settings

- You can have zero or one portal per map
- Placing a portal starts a cooldown
- Removing the portal is only possible after the cooldown to prevent you from moving the portal too quickly
- Without portal, deaths are permanent

< >
Sebastian Jan 18 @ 1:28am 
I would not recommend this mod, it seems very suspect and it gives viewers almost total control over the game. I don't know exactly what it does to your computer but it can't be good.
Captolamia Nov 12, 2021 @ 12:14pm 
11/12/2021 12:50:51 PM|Fatal|<>c__DisplayClass17.<startReceiving>b__16|WebSocketSharp.WebSocketException: The header of a frame cannot be read from the stream.
at WebSocketSharp.WebSocketFrame.processHeader (System.Byte[] header) [0x00017] in <38d3cef14c5a4fc9a92de0991034bc1a>:0
at WebSocketSharp.WebSocketFrame+<>c__DisplayClassa.<readHeaderAsync>b__9 (System.Byte[] bytes) [0x00000] in <38d3cef14c5a4fc9a92de0991034bc1a>:0
at WebSocketSharp.Ext+<>c__DisplayClass9.<ReadBytesAsync>b__8 (System.IAsyncResult ar) [0x000a2] in <38d3cef14c5a4fc9a92de0991034bc1a>:0
Captolamia Oct 21, 2021 @ 1:56pm 
The mod is otherwise working great.
Captolamia Oct 21, 2021 @ 1:55pm 
I have not been able to repeat it. And nothing shows in the log. Crash to desktop. Also if people buy things in puppet it can crash. Might be another mod having issues getting items to spawn. I have not tested full compatibility. Because I am also seeing errors from other mods that add items It might not be puppet. But if I get a crash again from setting restrictions I will let you know. I am just trying to restrict mining, and deconstruction.
TTV_MerlFox Oct 19, 2021 @ 2:57pm 
Scav noticed Puppeteer was slowing him down, but couldn't find the code that was
BleuSquid  [author] Oct 19, 2021 @ 1:30pm 
@TTV_Merl_Fox, this doesn't require toolkit, but unless something has changed, it needs to be in the load order before Puppet.

@Captolamia, can you please give me some more details so I can reproduce? What restrictions are you changing?
Captolamia Oct 14, 2021 @ 12:05pm 
Changing Restricitions Causes Crash to Desktop
TTV_MerlFox Sep 30, 2021 @ 1:59pm 
so i kept crashing today because toolkitutls was loading after puppeteer... please inform people this mod requires toolkit
CanadianSnow Sep 15, 2021 @ 4:41pm 
I'd also love to see something like the RPG inventory systems implemented in Pup - I get that this would be a heck of a lot of work and take a while, but would be nice eventually :) - if this gets into the mix, I'd also suggest a way of showing the viewers what their options are for each slot.
CanadianSnow Sep 15, 2021 @ 4:40pm 
I've heard from a lot of viewers (not just my stream) that Pup is too much for them, too complex or whatever. I'd like to suggest an "easy mode" (perhaps JUST view details of pawn and some super basic commands) and an "advanced mode" (like what it is now)