TwitchChatBot

***This Entire Project is a WIP, please keep that in mind***

Welcome to PvtPyle chat Bot!

Your experience in this channel (https://www.twitch.tv/freshmeat911) isn’t just chat — it’s a full interactive game layered on top of the stream.  

You can enlist, train, rank up, complete missions, earn medals, and become part of the channel’s growing military‑themed universe.

The bot also handles automatic shoutouts, community engagement, and behind‑the‑scenes moderation tools to keep the stream running smoothly.

There are a bunch of hidden features that will be triggered by what happens in the chat. Be warned though this bot is NOT polite. 

What You Can Do

1. Enlist as a Soldier

Every viewer can join the in‑stream army.  

You start as a Civilian and work your way up through training, missions, and promotions.

2. Train & Specialize

Complete interactive training tasks:

- Repetition tasks

- Reaction tasks

- Multi‑phase tasks

- Choice tasks

Each level of training:

- Improves your stats

- Unlocks new abilities

- Grants XP

- Can promote you to a new rank

- Opens new mission types

3. Go on Missions

Missions give:

- XP

- Soldier Credits

- Medals (WIP)

- Injuries (sometimes)

- Rank progress

4. Rank Up

Your rank is based on:

- XP

- Missions completed

- Required trainings

- Specializations

- Injury status

The bot automatically checks if you qualify for promotion.

5. Earn Medals & History

Your soldier keeps:

- Promotion history

- Training history

- Mission history

- Injuries

- Stats

Everything is persistent.

6. Automatic Shoutouts

The bot:

- Cycles through configured streamers

- Sends Twitch shoutouts

- Adds hype messages

- Uses cooldowns so nobody gets spammed

- Can be toggled ON/OFF by the streamer   

How to Use the Bot (Viewer Guide)

Step 1 — Enlist

!enlist

Step 2 — Begin Boot Camp

The bot guides you through push-ups, responses, and tasks.

Step 3 — Start Training

!train basic, !train advanced, !train recon, !train medic

(Depending on what’s unlocked)

Step 4 — Check Your Stats

!id

Step 5 — Go on Missions

!mission

Step 6 — Rank Up

The bot will automatically promote you when you meet certain requirements.

Command List (WIP)

Soldier Commands

!enlist – Join the army, !id– View your stats, rank, XP, injuries, and history, !top- view the leaderboard, !mission – Attempt a mission, !heal – Recover from injuries (if available)

Training Commands

!train basic – Begin Basic Training

!train advanced – Begin Advanced Training

!train recon – Recon specialization 

!train medic – Medic specialization 

!canceltraining – Cancel your current training session

Utility

!commands – List of  some available commands

!sr - Custom Spotify integration

And Much More!!!!!