Secret contracts by DM
Once a day 3–4 active members become agents. Each gets a private contract against another player, e.g. "get @Sam to start an argument about the weather". Members with closed DMs are skipped.
🎭
Social Puppeteer
✓ AppLiveSecret contracts in your DMs. Get someone to say the thing without them noticing, and the bot sounds the siren.
how-it-works
Social Puppeteer turns everyday chatter into a game of hidden manipulation.
Every day at issue_time it picks a few active members as agents and DMs each a secret contract against another player. A contract is written from the recent chat and the target’s own messages. Examples: bait someone into a 300-character rant, start an argument about food, or get the chat to repeat a made-up idiom.
Then it watches. When the target takes the bait in the main chat, the bot goes off with a siren, quotes the message and names the winner. If nobody pulls the strings in time, the contract is revealed when it expires: “The curtain falls. These strings were never pulled.”
Nobody knows who holds a contract, so everyone suspects everyone. That’s the fun.
See it in action
🎭
🎭 The curtain rises. 3 secret contracts just went out. Someone in this chat is pulling your strings... Trust no one.
🔒 Direct message, only the agent sees this
🎭
A
honestly that plan is like trying to butter the moon
S
lol yeah, classic moon buttering
🎭 1
🎭
🚨🚨🚨 @Alex @Sam
Social Puppeteer is typing…
your-members
What the bot actually does to people in your server.
The bot watches
Every few messages, an AI model checks the main chat for a victim who fell into a trap. Asking the victim outright, or revealing the contract, doesn't count.
The siren
When the trap snaps shut, the bot replies to the victim's message with a siren, the contract and the winner. Unfinished contracts are revealed when they expire.
Points, orders and the Puppet
The agent earns 1–3 points and an order (the right to commission a contract against someone). The victim wears the purple 🎭 Puppet role for 30 minutes, with a 🎭 on everything they say.
🛟 Safety nets
- Anyone can stop playing with
/contract optout: no contracts for them or against them, and running ones are cancelled. - The Puppet role is removed automatically; on start the bot removes it from anyone without a debuff on record.
- Orders are filtered. A contract is only built from a wish if the wish is harmless.
- Set
debuff_minutesto0to keep the game without any role at all. - Messages from the main chat are sent to an AI model to write and judge contracts. The bot stores contracts, scores and the proof quote, not the chat.
permissions
The invite link asks for exactly these. Nothing else, and no Administrator.
Server permissions
- View ChannelsSees the main chat you pick.
- Read Message HistoryReads recent messages to write contracts and to check whether one was completed.
- Send MessagesPosts the round teaser, the 🚨 siren and expired contracts, and DMs each agent their contract.
- Embed LinksContracts and sirens are rich embeds.
- Add ReactionsPuts a 🎭 on messages from someone who is currently a Puppet.
- Manage RolesCreates the purple 🎭 Puppet role and gives it to a fooled victim for a while.
Privileged intents
- Server MembersKnows who the players are and gives or removes the Puppet role.
- Message ContentNeeds the text of the chat to write contracts and spot when a trap snaps shut.
⚠️ Drag the bot's role above the members it should be able to debuff, so it can give them the 🎭 Puppet role.
setup
- Invite the bot. It joins with safe defaults and does nothing yet.
- Run
/puppeteer channel #generalto pick the main chat, where contracts are played out. - Optionally describe your server so contracts fit it:
/puppeteer set theme a gaming clan that argues about patch notes.
settings
| Setting | Default | Allowed | What it does |
|---|---|---|---|
enabled | on | on / off | Hand out contracts every day |
issue_time | 12:00 | HH:MM | Time of the daily round in the server timezone |
timezone | UTC | IANA name, e.g. Europe/Moscow | Timezone for the schedule |
language | auto | auto or a language, e.g. English | Language of the contracts (auto = the chat's language) |
theme | a former language-exchange community | up to 300 characters | What the server is like |
min_contracts | 3 | 1–10 | Contracts per round |
max_contracts | 4 | 1–10 | …and at most (random in between) |
contract_hours | 24 | 0.5–168 | How long an agent has to complete a contract |
active_hours | 72 | 1–720 | Only members who wrote in the last N hours take part… |
active_min_messages | 3 | 1–500 | …with at least this many messages |
check_every | 12 | 3–100 | Check the chat for completed contracts every N messages |
check_window | 40 | 10–200 | How many recent messages each check reads |
debuff_minutes | 30 | 0–1440 | How long a fooled victim stays a 🎭 Puppet (0 = never) |
operators | none | @users or none | Who may use the @Puppeteer debug commands (none = anyone with Manage Server) |
Change one with /puppeteer set <setting> <value>. Each server has its own settings.
commands
For admins
Needs Manage Server (adjustable in Server Settings → Integrations).
/puppeteer channel #channel- The main chat, where contracts must be completed and the siren goes off. Nothing happens until this is set.
/puppeteer settings- Show all settings and when the next round is due.
/puppeteer set <setting> <value>- Change one setting.
/puppeteer reset <setting>- Back to the default.
For everyone
Any member can use these.
/contract mine- Your secret contract, score and orders (only you see it).
/contract order @victim [wish]- Spend a win: the next round gives someone a contract against that victim.
/contract leaderboard- The best puppet masters of the server.
/contract optout- Stop playing: no contracts for you or against you.
/contract optin- Play again.
Operator & debug
Mention the bot at the start of a message. Only the server's operators, or Manage Server if none are set.
@Puppeteer issue [n]- Hand out a round now (optionally exactly n contracts).
@Puppeteer give @agent @victim- One contract right away, skipping the activity rules.
@Puppeteer check- Check the main chat now.
@Puppeteer status- DMs you the active contracts (they're secret).
@Puppeteer cancel 12 / cancel all- Cancel contracts without revealing them.
@Puppeteer lift @user- End someone's 🎭 Puppet debuff early.