v2.4.1 — Demo Mode, Discord & Bug Fixes

RedruM's Interactive Zombies Tool — v2.4.1

---

Overview

v2.4.1 adds Demo Mode for trying the tool without a live TikTok stream, a community Discord server, and a set of polish fixes covering theme persistence on launch and contact links across the app.

---

🆕 New — Demo Mode

A new Demo Mode button has been added to the bottom bar of the Bot Dashboard.

• Simulates a live session without requiring a TikTok LIVE stream
• Fires randomised likes, gifts, follows, and chat !spin commands on a loop
• Exercises the full event pipeline — TTS, spin wheel, gift routing, like milestones, and cooldown trackers all behave identically to a real stream
• Useful for testing keybinds, tuning the spin wheel, demoing the tool to viewers, or verifying a new setup before going live
• Session summary and stats log as normal when stopped

---

🆕 New — Discord Community

A community Discord server is now live.

• Join the Discord button added to the Active Game Profile row on the Bot Dashboard
• Discord link added to the Credits & Info tab alongside TikTok, GitHub, and Ko-fi
• Discord invite: discord.gg/atgQj8Fa8t
• Server includes setup guides, download links, known issues, bug reports, and feature request channels

---

🐛 Bug Fixes

Theme not restoring correctly on launch
Closing the app and reopening it showed the correct theme name in the dropdown but applied the wrong colours — widgets were rebuilt with the default theme colours and never recoloured to the saved theme.

Fix: Theme restoration on launch now runs the full recolor pass across all widgets, matching the behaviour of switching themes manually at runtime.

Theme dropdown showing wrong name after launch
The dropdown label showed an incorrect theme name on startup even when the correct theme was visually applied.

Fix: The dropdown variable is now always updated when a theme is applied, whether from the selector or from config load.

---

📋 Updating from v2.4.0

1. Run the installer — all files updated automatically
2. No GSC re-export required — these changes are dashboard/UI only
3. Your saved theme will now load correctly on the next launch

2.4.0

RedruM's Interactive Zombies Tool — v2.4.0

---

Overview

v2.4.0 adds an interactive Custom BO3 Actions builder, collapsible sections in Setup & Diagnostics to cut down on scrolling, and Support the Developer / Donate links. It also folds in all dropdown, keybind, and theme switcher fixes from the v2.3.1/v2.3.2 patches.

🆕 New — Custom BO3 Actions

---

A new Custom BO3 Actions section has been added to Setup & Diagnostics, letting you add your own actions using any Sphynx console command — no manual cfg editing required.

---

Quick Add Builder

• Enter an action name, a key, and a Sphynx console command
• Live preview shows the exact bind line as you type
• One click adds the action to Action Binds and appends the bind line to your binds.cfg automatically (if a BO3 path is configured)
• Falls back to a warning if no BO3 path is set, so you know to export manually

Reference Links

• Direct links to the Sphynx Console Commands mod, the full command list, and the perk/powerup alias list — all with hover tooltips explaining what each one is for

---

✅ Improvements — Setup & Diagnostics

---

---

Collapsible Sections

• BO3 Prerequisites, Plutonium Prerequisites, and Settings Backup are now collapsible and closed by default
• Cuts down on scrolling for returning users who already know the setup steps
• Keybind Export, Keypress Test, API Health Check, and Debug remain open by default since they're used regularly

---

🆕 New — Support the Developer

• Donate link and ☕ Support on Ko-fi button added to Credits & Info, matching the existing TikTok/GitHub link style
• ☕ Support the Developer button added to the Bot Dashboard, on the Active Game Profile row
• This tool remains completely free — these are optional, no functionality is gated behind them

---

✅ Improvements — System Tray

• Start/Stop Bot Gateway — toggle the bot directly from the tray menu without restoring the dashboard first
• Mute/Unmute TTS — quick audio toggle from the tray menu
• Live status tooltip — hovering the tray icon now shows 🟢 Online / 🔴 Offline, updating automatically as the bot's status changes

---

🐛 Bug Fixes

Gift, Follow Reward, and Like Reward Dropdowns
Custom action names added in Keys & Binds weren't appearing in the Gift action dropdown, the Follow Reward dropdown, or the Like Reward dropdown — all three were reading from built-in profile defaults instead of your live Action Binds.

Fix: All three dropdowns now read from the live Action Binds panel and refresh automatically as you add, rename, or delete actions.

Action Row Deletion Leaving Ghost Entries
Deleting an action row didn't refresh the Gift, Follow Reward, or Like Reward dropdowns, leaving the deleted action selectable as a ghost entry.

Fix: Deleting a row now refreshes all three dropdowns immediately.

Timescale Reset and 3rd Person Keys Ignoring Remapped Binds
Remapping the Timescale Reset or 3rd Person On/Off keys in Action Binds had no effect at runtime — the bot was still reading the original default key instead of your live configuration.

Fix: Both now check your live Action Binds first, falling back to defaults only if no custom bind is set.

Theme Switcher Requiring Multiple Changes to Apply
Switching themes sometimes required selecting a theme two or three times before all colours updated correctly, since some widgets only matched the previous theme's exact colour values.

Fix: Theme switching now builds a complete colour map across all themes, so every widget recolours correctly on the first switch.

---

📋 Updating from v2.3.0 / v2.3.2

1. Run the installer — all files updated automatically
2. No GSC re-export required — these changes are dashboard/UI only
3. Check out the new Custom BO3 Actions section in Setup & Diagnostics if you want to add your own console-command-based actions

v2.3.2 — Bug Fix Patch

Bug Fixes

---

• Fixed Gift action dropdowns not populating with custom action names defined in Keys & Binds
• Fixed Follow Reward and Like Reward dropdowns not reflecting custom action names defined in Keys & Binds
• Fixed deleting an action row leaving ghost entries in dropdowns
• Fixed Timescale Reset and 3rd Person On/Off keys ignoring remapped binds — keys were being read from defaults instead of your live configuration
• Fixed theme switcher requiring multiple changes before colors fully applied

No configuration changes required. Existing setups carry over automatically

v2.3.0 - UI Overhaul & T6 Actions

launch# RedruM's Interactive Zombies Tool — v2.3.0

---

Overview

v2.3.0 adds a full Stats tab with session history, personal bests, and lifetime totals. Two new T6 actions replace the old Give Ray Gun and Teleport Random. The dashboard receives a set of UI improvements including toast notifications, an animated launch button, hover effects, themed scrollbars, and a tray toggle. The spin wheel weight scale is simplified to 1–10.

---

🆕 New — Stats Tab

A new Stats tab has been added between Setup & Diagnostics and Credits & Info.

Session History

• Every session is logged automatically when the bot is stopped
• Each entry shows: date, game, duration, likes, gifts, spins, follows, peak viewers, chat spins, bonus spins, like reward fires, top gifter, top gift, and top spin
• Clear History button — deletes session log without affecting personal bests

Personal Bests

• Tracks all-time records across every session
• Records: most likes, most gifts, most spins, most follows, peak viewers, longest session, most gifts from one person, most chat spins, most bonus spins, most like rewards
• New record fires a toast notification and a log entry
• Reset Records button — clears bests without affecting session history

Lifetime Totals

• Cumulative stats summed across all recorded sessions: total time live, likes, gifts, spins, follows, and like rewards

---

🆕 New — T6 Actions

Action	Key	Description
Give Wonder Weapon	End	Gives a map-appropriate wonder weapon. Pool is map-aware (Ray Gun, Ray Gun MK II, and map-exclusive weapons). Anti-repeat logic excludes the last given weapon. Replaces Give Ray Gun.
Spawn Boss	F3	Spawns the map boss. TranZit → Avogadro, MoTD → Brutus, Origins → Panzer Soldat. All other maps show "No boss on this map!"

---

🆕 New — T6 GSC Script

• bot_give_wonder_weapon() — map-aware weapon pool using correct internal weapon names, anti-repeat excludes last given weapon
• bot_spawn_boss() — map-aware boss spawning using native level notifies
• Load message updated to v2.3.0

---

✅ Improvements — Dashboard

Toast Notifications

• Non-intrusive pop-up alerts appear bottom-right for spin results, new follows, like reward fires, and new personal bests
• Multiple toasts stack upward when fired at the same time
• Fade in and out automatically

Animated Launch Button

• Launch button pulses between two shades of the accent colour while the bot is running
• Returns to normal on stop

Minimize to Tray Toggle

• New toggle added next to Auto-Focus (with a separator)
• When enabled (default): closing the window sends it to the system tray as before
• When disabled: the X button closes the app completely
• Setting is saved with your config

Single-Instance Lock

• Prevents opening multiple copies of the app simultaneously
• If a second copy is launched, a dialog appears pointing you to the system tray

Window Memory

• Window size and position are saved automatically and restored on next launch

Theme Selector

• Full colour theme system added — switch themes from the dropdown in the status bar
• Theme is saved and restored automatically with your config
• 15 themes available:
  • Dark Blue
  • Electric Blue & Black
  • Ice Blue & Black
  • Cyan & Black
  • Green & Black
  • Emerald & Black
  • Lime & Black
  • Red & Black
  • Blood Orange & Black
  • Orange & Black
  • Gold & Black
  • Purple & Black
  • Pink & Black
  • Synthwave
  • Dracula
  • Monochrome

UI Modernisation

• Hover effects on all interactive buttons — background lightens on mouse-over
• Slim 8px accent-coloured scrollbars across all panels — updates automatically when you switch theme
• 1px accent-coloured separator lines between dashboard rows
• Pill-style stat badges in the live stats row (follows, gifts, spins, viewers)
• Follow Reward dropdown moved to the same row as Like Reward

---

✅ Improvements — Spin Wheel

Weight Scale — 1 to 10

• Weight field replaced with a 1–10 Spinbox control
• Cleaner to manage — arrows increment/decrement, probability bars update live
• Prevents invalid values from being entered

---

✅ Improvements — TTS

Follower TTS Toggle

• Follower TTS is now its own separate toggle in the TTS row
• Follow Reward action and the TTS shoutout can be enabled or disabled independently
• Previously the toggle existed in config but had no effect

---

✅ Improvements — Keys & Binds

• Spin pool reorganised into labelled category groups: Points → Ammo → Powerups → Perks → Weapons → Chaos → Events → Round
• Event toggles renamed: Likes → Like Reward, Follows → Follow Reward

---

🐛 Bug Fixes

Follower TTS — Toggle Had No Effect
The tts_follows BooleanVar was saved and loaded with config but was never used to gate the actual TTS speak call. The shoutout fired regardless of the toggle state.

Fix: The speak call is now wrapped in a tts_follows.get() check so the toggle works as labelled.

Follows Tooltip — Incorrect Description
The tooltip on the Follows event toggle stated that followers would be registered as gifters, which was not true. Followers are tracked and counted but are not added to the gifters set.

Fix: Tooltip corrected to accurately describe what the Follow Reward toggle does.

---

📋 Updating from v2.2.2

1. Run the installer — all files updated automatically
2. For T6: go to Setup & Diagnostics → Export bo2_tiktok_bot.gsc and replace your existing file, then map_restart in console
3. Give Wonder Weapon and Spawn Boss appear in Action Binds and Spin Pool automatically
4. Teleport Random and Give Ray Gun will be removed from your config automatically on first launch

v2.2.2 - T6 Expansion & Bug Fixes

RedruM's Interactive Zombies Tool — v2.2.2

---

Overview

v2.2.2 adds six new T6 actions, fixes a perk HUD removal bug, adds a live viewer counter to the dashboard, and resolves several session tracking issues. Teleport Random is reworked to use the zombie AI navigation graph for reliable interior positions on all maps.

---

🆕 New — T6 Actions

Six new actions added to BO2 Plutonium (T6):

Action	Key	Description
Red Light Green Light	p	30-second event. Green light phases let the player move freely. On red light, movement is detected via origin delta — any movement removes 30% health.
Teleport Random	n	Teleports the player to a random interior position using level.waypoints (the zombie AI nav graph — always valid, never at map boundaries).
Spawn Zombies	k	Adds 5 zombies to the current wave via level.zombie_total += 5.
Freeze Controls	j	Disables player controls for 3 seconds via freezeControls(true/false).
Drunk Mode	t	10-second effect — applies screen blur and cycles timescale randomly.
Remove All Points	y	Strips all player points via minus_to_player_score(self.score).

---

🐛 Bug Fixes — T6 GSC

Take Perk / Take All Perks — HUD icons not disappearing

Calling self unsetPerk(perk) directly bypasses the perk_think() thread that handles HUD removal (set_perk_clientfield(perk, 0)), the num_perks-- counter, and perk_purchased = undefined. After removing a perk this way the icon stayed on screen and the machine appeared still purchased, blocking repurchase.

Fix: Replaced with self notify(perk + "_stop") — triggers the existing perk_think() cleanup thread which handles all perk state correctly.

Teleport Random — "No spawn points found"

level.powerup_spawns is not guaranteed to exist on all maps. When undefined the action failed silently.

Fix: Changed to level.waypoints — the zombie AI pathfinding graph, populated by the engine on every ZM map. Always contains hundreds of valid interior walkable positions.

Skip Round — incomplete transition

bot_skip_round() was killing zombies but not zeroing level.zombie_total, leaving the wave in a partial state.

Fix: Added level.zombie_total = 0 before the kill loop.

---

✅ Improvements — Dashboard

Live Viewer Counter

• Listens for RoomUserSeqEvent from the TikTok API and displays the current viewer count in real time
• Shown in the stats row as 👁 1,234 viewers
• Resets to 👁 — viewers on each new connection

Spin History — Username

• Every entry in the Last 5 Spins panel now shows who triggered it: username — Effect Name
• Applies to all spin sources: gift spins, chat !spin, bonus like spins, and manual admin spins

Chat Feed — Message Cap

• TikTok Live Chat panel now caps at 50 messages, trimming oldest entries automatically

Reconnect TTS Alert

• Bot now announces "Connection dropped. Reconnecting." via TTS when the API drops and a reconnect is triggered — streamer hears it immediately without watching the log

Comments Checkbox Removed

• The Comments toggle on the dashboard was redundant — comment processing is always required for !spin to work. Removed to avoid confusing streamers into disabling their own !spin command. The !spin checkbox remains as the sole control.

---

🐛 Bug Fixes — Session Tracking

Session Summary — Top Spin Stat

The session summary popup read the spin history listbox to calculate the most common spin result. The listbox is capped at 5 entries, so after the 6th spin the stat became meaningless.

Fix: All spins now increment a session_spin_counts dict directly in _append_spin. The summary reads from this dict, which tracks the full session accurately regardless of listbox size.

Like Reward — Resets on Reconnect

last_like_reward was reset to 0 on every ConnectEvent, including reconnects. If the bot dropped mid-stream and reconnected, the like reward threshold restarted from 0 and fired again immediately.

Fix: last_like_reward is now properly reset to 0 only on a fresh connection — it is cleared alongside total_likes so the reward interval counts correctly from the start of each session without double-firing after a reconnect.

---

📋 Updating from v2.2.1

1. Run the installer — all files updated automatically
2. For T6: go to Setup & Diagnostics → Export bo2_tiktok_bot.gsc and replace your existing file, then map_restart in console
3. New T6 actions (Red Light Green Light, Teleport Random, Spawn Zombies, Freeze Controls, Drunk Mode, Remove All Points) appear in Action Binds and Spin Pool automatically
4. No key conflicts — all six new actions use keys not previously assigned in T6

v2.2.1 — BO3 Expansion & QOL

RedruM's Interactive Zombies Tool — v2.2.1

---

Overview

v2.2.1 is a quality-of-life, stability, and expansion patch. BO3 receives new actions, a fully reorganised spin pool, and a cleaner key layout. T5/T6 gift accumulation and wheel spin queueing are added to prevent overlapping GSC animations. The dashboard gets new toggles, improved tooltips across every tab, and a restructured TTS/Chat row. Several migration and config persistence bugs are resolved.

---

🆕 New — BO3 Actions

Seven new actions added:

Action	Key	Command
God Mode Timer	j	godmode timer 30 — Sphynx handles its own countdown
Spawn Zombies	c	zombie 5
Spawn Special Zombie	v	specialzombie random 1
Infinite Ammo	l	infinite_ammo on all — toggles off automatically after 30s
Teleport Random	b	teleport random
Points Reset	end	points reset — punishment
Take All Weapons	n	takew all — punishment

T5/T6 — Gift Queueing

• Wheel spin queue — spins now execute sequentially with an 8 second gap between each on Plutonium, matching the GSC animation duration. Previously, stacked gifts would fire all spins simultaneously and the GSC would ignore all but the first
• Gift accumulation window — rapid separate gift events for the same gift are batched within a 2 second window before firing, preventing duplicate actions from quick sends

T5/T6 — Bug Fixes

• Removed BO3-only actions that had merged into T5/T6 profiles via migration: Points Reset, Take All Weapons
• T5 Random Upgraded Weapon naming mismatch fixed — GSC handler was botcmd_random_upgraded_weapon, profile was generating botcmd_random_weapon_upgraded — never fired
• T6 key conflicts resolved — +500 Points and Low Gravity were sharing keys
• T5 key conflict resolved — Take All Weapons and Take One Perk were sharing n

Dashboard — New Toggles

Four new toggles added to the dashboard:

• Gift TTS — mute gift action callouts without affecting other TTS
• Spin TTS — mute all spin result announcements (chat, gift, and bonus spins)
• Bonus Spin — disable automatic bonus spins from like milestones while keeping points rewards active
• !spin — enable or disable the chat !spin command independently of other comment processing

Dashboard — Layout

• Follow TTS removed — redundant with the Follows event toggle. The Follows checkbox now controls both TTS shoutout and gifter registration
• TTS row restructured: TTS: Gifter Chat | Gift TTS | Spin TTS — Chat: !spin — Cooldown: Gifter | Viewer
• Tooltips added to every control across all four tabs — buttons, spinboxes, comboboxes, checkboxes

Setup & Diagnostics

• Smart Scan — completely rewritten for Plutonium. Now checks %LOCALAPPDATA%\Plutonium\storage\ directly for all four paths (T6 GSC, T6 cfg, T5 GSC, T5 cfg), saves them automatically, and shows a result popup. Was previously only finding the Plutonium launcher /bin folder (useless)
• Export Binds (Plutonium) — now saves the correct filename per active game (bot_binds.cfg for T6, pluto_t5_binds.cfg for T5). Was always saving bot_binds.cfg regardless of game
• Path status dots now light up correctly on startup without requiring a Save first

---

🐛 Bug Fixes

• Manual override — was passing the TikTok gift name as action_name instead of the mapped action name. This meant timed routing checks (Powerup Rain, 3rd Person On etc.) never matched for gift-triggered actions
• Smart Scan — silently crashed with AttributeError: 'BotApp' object has no attribute '_setup_paths' — popup never appeared
• Migration — removed actions in BO3 (Give Ammo, PAP Upgrade, +10 Points etc.) now correctly disappear from both Action Binds and Spin Pool on first launch after update

---

🔧 Troubleshooting — Plutonium Chat Message

When the bot fires an action in T5/T6, you may see a brief !botcmd_X message appear on your HUD. This is the say command the bot uses to pass commands to the GSC. To hide it, disable in-game text chat in your Plutonium settings — the GSC will still receive and process all commands correctly.

---

📋 Updating from v2.2.0

1. Run the installer — it updates all files automatically
2. For BO3: go to Keys & Binds → Reset to Defaults to apply the new key layout, then re-export binds.cfg and run /exec binds.cfg in console
3. Re-map any gifts that used the old BO3 keys

v2.2.0 - T5 Support

RedruM's Interactive Zombies Tool — v2.2.0

---

Overview

v2.2.0 is a major expansion update. BO1 Plutonium (T5) is now a fully supported third game alongside BO3 and T6. BO3 receives a complete keybind overhaul, four new actions, and a full action reorganisation. T6 gets two new GSC actions and several gameplay fixes. A config persistence bug affecting BO3 gift types on restart has been resolved.

---

🆕 New Features

BO1 Plutonium (T5) — Full Support

T5 is now a complete game profile from setup to in-game interaction.

• New game profile with 24 actions grouped by category
• Custom GSC (bo1_tiktok_bot.gsc) with 22-action weighted wheel spin and slot machine animation
• Full action set — Nuke, Insta Kill, Double Points, Fire Sale, Give/Take All Perks, Give/Take One Perk, +1000/+500/-1000 Points, Max Ammo, Take Ammo, Random Weapon, Random Upgraded Weapon, PAP Upgrade, PAP Downgrade, God Mode 15s, Teleport, Low Gravity 30s, 3rd Person 15s, Bonus Health 30s, Round Skip, Wheel Spin
• Export GSC button in Setup & Diagnostics — complete file ready to drop into your T5 scripts folder
• Dedicated binds file pluto_t5_binds.cfg — one exec pluto_t5_binds.cfg in console loads all binds permanently
• Setup wizard T5 page with GSC folder and players folder path configuration and auto-detect
• Auto-write on Save writes directly to your configured T5 players folder

BO3 — Four New Actions

• God Mode Timer — godmode timer 30 — Sphynx handles its own 30 second countdown, no reset needed
• PAP Upgrade — upgrade_weapon — Pack-a-Punches your current weapon instantly
• Points Reset — points reset — wipes score to zero, great punishment option
• Take All Weapons — takew all — strips all weapons, great punishment option

T6 — Two New GSC Actions

• Low Gravity — reduces gravity for 30 seconds then fully restores. Noticeably higher jumps with floaty feel
• Aimbot Timer — 15 second aimbot using accurate camera-based aim. Only activates when the player is actively aiming in (ADS), targets zombie head height for headshots

---

✅ Improvements

BO3 — Keybind Overhaul

All 34 actions reorganised into logical F-key groups matching T5/T6 style:

Group	Keys	Actions
Points	F8–F11, end, z	+1000, +500, +100, +10, −1000, Reset
Ammo	F7, ], [	Max Ammo, Give, Take
Powerups	F1–F6	Insta Kill, Double, Nuke, Fire Sale, Rain, Minigun
Perks	pgup, pgdn, del, ins	All Perks, Perk 1, Take All, Take 1
Weapons	-, /, ', x, =, n	PAP, Rnd Upgraded, Ray Gun, Pistol, Downgrade, Take All
Chaos	q, t, y, u, i, o, j	3P On/Off, TS Fast/Slow/Reset, Aimbot, God Mode
Round	, r	Round Skip, Map Restart

• All Sphynx commands verified against the official command list
• Action binds panel now groups all 34 actions by category with section headers

T6 — Gameplay Fixes

• Fire sale — fixed invisible orb issue
• Powerup rain — rate increased, 10 drops over ~7.5 seconds
• Both new actions added to the T6 GSC wheel spin (25 total spin effects)

TTS

• Full TTS coverage for every action across all three games
• Milestone callouts now cover up to 25,000 likes
• Expanded response pools across follows, gifts, spins, and milestones for more variety

App & UI

• Game profile dropdown added to Keys & Binds tab — switch game without leaving the tab
• × delete button on every action row — remove any individual action cleanly
• Spin pool checkbox recompiles immediately on toggle
• Setup & Diagnostics hint now correctly reflects the active game when switching profiles

---

🐛 Bug Fixes

• Gift type not persisting on restart — 3rd Person 15s, Random Timescale and other BO3 gift types now correctly save and restore after closing and reopening the app
• Config load crash — not enough values to unpack (expected 3, got 2) error on startup resolved
• Export GSC button not appearing in Setup & Diagnostics when T5/T6 was the saved active game on launch

---

📋 Updating from v2.1.1

1. Run the installer — it will update all files
2. For BO3: go to Keys & Binds → click Reset to Defaults to apply the new F-key layout, then re-export binds.cfg and run /exec binds.cfg in the developer console
3. Re-map any gifts that were using the old BO3 letter keys — the Type dropdown options are unchanged
4. For T5: run the setup wizard to configure your GSC and players folder paths

v2.1.1 — Dashboard & QOL

RedruM's Interactive Zombies Tool — v2.1.1

---

Overview

v2.1.1 is a major quality-of-life, dashboard, and stability update. The dashboard now functions as a full live stream monitor. TTS has been split into its own file for easier customisation. BO3 and T6 both receive new actions. A critical connection regression introduced during development has been fully resolved.

---

🆕 New Features

Live Dashboard Stats

• Viewer counter — live viewer count shown top-right of the likes row, updates via polling every 10 seconds
• Session stats strip — 👤 follows 🎁 gifts 🎰 spins 📈 Peak: X all update live throughout the stream
• Window title shows live status — 🟢 LIVE @handle while connected, 🟡 Connecting... during startup, resets on terminate
• Session summary — popup on terminate showing duration, peak viewers, total likes, top gift, most common spin, total follows, reconnect count

Terminate Bot Stays Open

• Clicking Terminate Bot stops the TikTok connection and shows the session summary — the app stays open
• The X button still minimises to tray as before
• Full exit available from the tray icon

Configurable Like Rewards

• Like Reward action dropdown — choose any action from your Action Binds as the like reward. Switches automatically when you change game profiles.
• Like reward interval spinbox — how many likes trigger the reward (default 1,000)
• Bonus Spin threshold spinbox — how many likes trigger a bonus spin (default 5,000). Progress bar and "Next Bonus Spin In" update automatically.

TTS Speed Slider

• New Speed: slider on the Dashboard audio strip next to the volume slider
• Range: 100 wpm (slow) to 300 wpm (fast), default 190
• Saved to config and restored on launch

TTS Toggles

• Follow TTS toggle — silence follow welcome messages without disabling follow events
• Gifter Chat TTS toggle — silence gifter chat readout without affecting gift actions

Adjustable Spin Cooldowns

• Gifter cooldown spinbox — default 180s, adjustable 10–3600s
• Viewer cooldown spinbox — default 600s, adjustable 10–3600s
• Both wired into the !spin handler and cooldown tracker

Key Conflict Detector

• On every Save Configuration, Action Binds are scanned for duplicate keys
• Warning lists each conflict: 'F1' → Insta Kill and Double Points
• Save completes regardless — warning is informational

Path Status Indicators

• Three coloured dots in Setup & Diagnostics below the export buttons
• 🟢 Green — path configured and folder exists
• 🔴 Red — path set but folder not found
• ⚫ Grey — not configured
• Refreshes after installer import and after every auto-write

Settings Backup & Restore

• Export — one click zips your entire config folder to a timestamped backup file
• Restore — select a backup zip, config and Keys & Binds reload automatically

Update Checker

• Pings GitHub releases API 3 seconds after launch in a background thread
• Non-intrusive popup if a newer version is available with a direct download link
• Fails silently if offline

Auto-Merge on Update

• New actions added to profiles in future updates appear automatically in Action Binds
• New spin effects appear automatically in the Wheel Spin Pool, ticked with default weight
• No Reset to Defaults required

---

🎮 BO3 — New Actions & Spin Effects

6 new actions added to Action Binds and binds.cfg:

Action	Key	Command
+10 Points	z	points 10
+100 Points	p	points 100
Ray Gun Upgraded	j	give ray_gun_upgraded
Downgrade All	t	downgrade_weapon all
Round Skip	3	round next
Aimbot Timer	=	aimbot timer 20

6 new effects added to the BO3 Spin Wheel:
Downgrade All, Round Skip, Aimbot Timer, Ray Gun Upgraded, All Perks, Take All Perks

BO3 total: 31 actions, 25 spin effects

---

🎮 T6 (BO2 Plutonium) — New Actions

3 new confirmed working in-game actions:

Action	Key	What It Does
Max Ammo	F7	Drops Max Ammo powerup orb
Take One Perk	u	Removes one random owned perk
Skip Round	h	Kills all alive zombies to force round advance

T6 total: 24 actions

---

🔧 Improvements

Dashboard Redesign

• Preset Deck moved to Keys & Binds tab spanning all three panels
• Event toggles (Likes, Gifts, Follows, Comments, Auto-Focus) merged inline with the Game Profile row
• TikTok Account label shortened
• TTS controls, cooldowns, and like reward settings each on their own compact row
• Section titles and button labels cleaned up throughout — shorter, no redundant descriptions
• Mousewheel scrolling now works on the Setup & Diagnostics tab

TTS Overhaul

• All TTS response pools moved to a dedicated tts_responses.py file — edit without touching main app code
• All response lines rewritten — shorter, more natural, less robotic when spoken by TTS
• Per-effect spin callouts added for all new BO3 and T6 actions
• Spin fallback, gift fallback, gift stack, milestone, and timescale reset pools all rewritten

Like & Follow Reward Fixes

• Like reward key now resolves from Action Binds — switching game profiles automatically uses the correct key
• Follow reward key same fix — no more hardcoded keys that break on game switch

Connection Stability

• Fixed: @client.on("room_update") string-based event registration corrupting TikTok client state — this was causing the connection to permanently hang at "Connecting..."
• Fixed: missing global declarations in all event handlers (on_gift, on_follow, on_like, on_comment, execute_mapped_action) causing UnboundLocalError — gifts, follows, and TTS were silently crashing
• Fixed: client.stop() now called on terminate to properly unblock the lifecycle thread
• Added lifecycle generation counter — prevents old threads re-entering the reconnect loop after terminate and re-launch
• Viewer count falls back to client polling every 10 seconds if RoomUpdateEvent is not available in the installed TikTokLive version

---

🐛 Bug Fixes

• Fixed connection permanently stuck at "Connecting..." after adding viewer counter
• Fixed gifts and follows not firing TTS or in-game actions after session tracking was added
• Fixed session stats (gifts, follows, spins) not incrementing
• Fixed like reward always pressing hardcoded i key regardless of game profile
• Fixed follow reward always pressing hardcoded 0 key regardless of game profile
• Fixed progress bar hardcoded to 5,000 regardless of configured bonus spin threshold
• Fixed app hanging on close after removing a gift row
• Fixed gift rename causing phantom duplicate row in gift matrix
• Fixed BO3 keypresses not firing — game window now focused before each keypress

---

⬆️ Upgrade Notes

Coming from v2.1.0:

• Your configuration is fully preserved
• New BO3 actions and T6 actions appear automatically in Action Binds — no reset needed
• Like Reward defaults to +1000 Points — change via the new Dashboard dropdown
• Bonus Spin threshold defaults to 5,000 — adjust with the new spinbox
• Preset Deck has moved to the top of the Keys & Binds tab
• Re-export your binds.cfg / bot_binds.cfg after updating to pick up new actions
• Plutonium users: re-export the GSC from Setup & Diagnostics to get the new T6 commands

Coming from v2.0.0 or earlier:

• See v2.1.0 upgrade notes for the Action Bind Architecture migration

---

Previous release: v2.1.0

v2.1.0 - QOL/BUG FIXES Update

RedruM's Interactive Zombies Tool — v2.1.0

---

Overview

v2.1.0 is a major quality-of-life and content update. The entire keybind system has been redesigned around a single source of truth — change a key once and everything updates automatically. BO3 and T6 both receive significant new actions, the T6 GSC gains 5 new in-game commands, and a suite of new tools have been added for settings backup, auto-update detection, and long-term config maintenance.

---

🎯 Action Bind Architecture — Complete Redesign

The Keys & Binds tab has been completely rebuilt. This is the biggest change in this release.

Before: Keys were stored separately in the spin wheel, gift matrix, and cfg export. Changing a key in one place didn't update the others. The exported binds.cfg always wrote hardcoded stale defaults regardless of what you had configured.

Now — three panels, one source of truth:

• Action Binds (left) — the only place you ever change a key. One name, one key per action.
• Wheel Spin Pool (middle) — action names and weights only. Keys resolve from Action Binds automatically.
• Gift Routing Matrix (right) — gifts reference action names via dropdown. Keys resolve automatically.

Change a key in Action Binds → spin wheel uses it, gift matrix uses it, binds.cfg exports it. One change, zero sync issues, forever.

BO3 cfg export is now fully dynamic. Each action stores its key and its Sphynx command together. The exported binds.cfg reads your current key assignments and writes every bind correctly. The old hardcoded static section is completely gone.

---

🆕 New Features

Auto-Write Binds on Save

• Save Configuration now silently writes binds.cfg to your BO3 players folder automatically
• Save Configuration now silently writes bot_binds.cfg to your Plutonium config folder automatically
• Paths set during installer wizard — no manual file management needed
• Plutonium: exec reminder shown every time binds are auto-written
• Manual export buttons remain for full control

Update Checker

• Fires 3 seconds after launch in a background thread
• Pings GitHub releases API and compares version numbers
• If a newer release is available: logs to activity feed and shows a non-intrusive popup with a direct download link
• Fails silently if offline — no error messages

Settings Backup & Restore

New panel in Setup & Diagnostics:

• Export — one click zips your entire config folder to a timestamped backup file. Includes all game profiles, keybinds, presets, and paths.
• Restore — select a backup zip, confirm, done. Config and Keys & Binds reload automatically.
• Use before any major update or reinstall to guarantee nothing is lost.

Version-Aware Migration System

• On launch, if the app version has changed since last run, migration code runs automatically
• Applies structural config changes needed for the new version
• Fully transparent — logs what it applied
• Future updates will add migration blocks without requiring user action

TTS Speed Slider

• New Speed: slider on the Dashboard audio strip, right next to the volume slider
• Range: 100 wpm (slow and clear) to 300 wpm (fast), default 190
• Takes effect on the next TTS announcement — no restart needed
• Saved to config and restored on launch

TTS Toggles

• Follow TTS toggle — silence follow welcome messages without disabling follow events
• Gifter Chat TTS toggle — silence gifter chat readout without affecting gift actions

Adjustable Spin Cooldowns

• Gifter spin cooldown spinbox on Dashboard — default 180s, adjustable 10–3600s
• Viewer spin cooldown spinbox on Dashboard — default 600s, adjustable 10–3600s
• Both wired into the !spin command handler and the live cooldown tracker

Installer Path Collection Expanded

• Setup wizard now collects three paths: BO3 directory, Plutonium GSC folder, Plutonium config folder
• All three passed to the app automatically — no re-entry needed after install

---

🎮 BO3 — New Actions & Spin Effects

6 new actions added to Action Binds and binds.cfg:

Action	Key	Sphynx Command
+10 Points	z	points 10
+100 Points	p	points 100
Ray Gun Upgraded	j	give ray_gun_upgraded
Downgrade All	t	downgrade_weapon all
Round Skip	3	round next
Aimbot Timer	=	aimbot timer 20

6 new effects added to the BO3 Spin Wheel:

Effect	Weight
Downgrade All	2
Round Skip	3
Aimbot Timer	3
Ray Gun Upgraded	3
All Perks	5
Take All Perks	4

BO3 total: 31 actions, 25 spin effects

---

🎮 T6 (BO2 Plutonium) — New GSC Commands

5 new in-game actions added to the T6 GSC, profile, and spin wheel:

Action	Key	What It Does
Max Ammo	F7	Drops Max Ammo powerup orb
Take One Perk	u	Removes one random owned perk — shows which one was taken
Skip Round	h	Kills all alive zombies to force round advance — shows count cleared

T6 GSC upgrades:

• bot_wheel_spin expanded to 24 in-game actions
• Added #include maps\mp\zombies\_zm_laststand

T6 total: 24 actions, 24 spin effects

---

✅ Auto-Merge on Update

New actions added in future updates will automatically appear in your existing configuration without requiring a Reset to Defaults:

• Action Binds — new actions appended at the bottom of your existing list with default keys
• Spin Wheel — new effects appended ticked with default weight

Your customised keys and weights are always preserved.

---

🔧 Stability & Bug Fixes

Fix	Detail
Gift rename causing phantom duplicate row	Merge logic removed from gift matrix — gifts are user-defined, merging couldn't distinguish a rename from a new entry
App hanging on close after removing a gift row	TclError guard added to all snapshot iterations — destroyed widgets skipped cleanly
BO3 keypresses not firing	Game window now focused before each keypress in the input worker thread
binds.cfg always writing stale default binds	Entire hardcoded section replaced with fully dynamic generator
_safe_fn not imported — Plutonium binds export crash	Added to gsc_generators import
New profile actions not appearing after update	Merge logic added for both Action Binds and Spin Wheel on load
ValueError: not enough values to unpack crash on launch	_build_tab4 was still unpacking spin_effects as old 3-tuples
T6 -1000 Points potentially broken on some maps	Changed from minus_to_player_score to add_to_player_score(-1000) which is guaranteed to exist

---

🧰 Installer Fixes

Fix	Detail
Finish page text cut off	Label now positioned below RunList checkboxes with AutoSize — never clips regardless of message length
StringReplace unknown identifier	Replaced with EscapeBS() helper using StringChange
AddDefenderExclusion called before defined	Moved defender procedures above CurStepChanged
#13#10 preprocessor directive error	Moved inline within string expressions
Missing Plutonium config folder path	Added as separate field on Plutonium wizard page

---

⬆️ Upgrade Notes

Coming from v2.0.0:

• Your configuration is fully preserved — keys, weights, gifts, presets all intact
• New BO3 actions (Round Skip, Aimbot Timer, +10 Points etc.) will appear automatically in Action Binds
• New T6 actions will appear automatically in Action Binds
• New spin effects will appear automatically in the Wheel Spin Pool, ticked with default weight
• No Reset to Defaults required
• Re-export your binds.cfg / bot_binds.cfg after updating to pick up the new actions in your cfg files
• For Plutonium: re-export the GSC script from Setup & Diagnostics — the new commands are not in your existing installed .gsc

For new users: see the Setup Guide in the README

---

Previous release: v2.0.0

v2.0.0 - T5/T6 Added

RedruM's Interactive Zombies Tool — v2.0.0 (Updated)

---

Overview

Version 2.0.0 is a complete platform expansion. What started as a Black Ops 3 interaction tool is now a full multi-game interactive zombies streaming platform supporting Black Ops 3 (Steam), Black Ops 2 Plutonium (T6), and Black Ops 1 Plutonium (T5).

This release also introduces the Action Bind Architecture — a complete redesign of the keybind system that eliminates sync issues, makes cfg files fully dynamic, and means users never have to manually edit a bind file again.

---

🎯 Action Bind Architecture (Major New System)

The entire keybind system has been redesigned around a single source of truth.

Before: Keys were stored separately in the spin wheel table, gift matrix, and cfg export sections. Changing a key in one place didn't update the others, leading to mismatches and broken exports.

Now: The Keys & Binds tab has three panels:

• Action Binds — one name, one key per action. This is the only place you ever change a key.
• Wheel Spin Pool — action names and weights only. Keys resolve from Action Binds automatically.
• Gift Routing Matrix — gift names mapped to action names by dropdown. Keys resolve automatically.

Change Insta Kill from F1 to F2 in Action Binds → spin wheel uses F2, gift matrix uses F2, exported cfg writes F2. One change, everywhere updated, zero sync issues.

For BO3 specifically: Each action now stores both its key and its Sphynx console command together. The exported binds.cfg is fully generated from your live configuration — no hardcoded sections, no stale default binds.

---

🆕 New Features Since Initial v2.0.0

Auto-Write Binds on Save

• App silently writes binds.cfg to your BO3 players folder on every Save Configuration
• App silently writes bot_binds.cfg to your Plutonium config folder on every Save Configuration
• Paths remembered from the installer wizard — no manual file management needed
• Plutonium: reminder shown every time to run exec bot_binds.cfg to reload
• Manual export buttons remain for full control

Installer Path Collection

• Setup wizard now collects three paths: BO3 directory, Plutonium GSC folder, Plutonium config folder
• Paths written to setup_paths.json in AppData, imported by the app on first launch
• App merges installer paths into saved config automatically — no re-entry needed

Keybind Drift Detector

• On Save Configuration, app compares current keys against last exported snapshot
• If keys have changed since last export, a warning shows listing exactly what changed
• Prevents the common mistake of changing a key but forgetting to re-export and reload

Returning User Protection

• Installer uses onlyifdoesntexist for GSC and binds files — reinstalls never overwrite user edits
• Installer finish page detects new vs returning users and shows appropriate instructions
• App version check on launch: detects update, shows What's New notice with action steps
• New actions added to profiles in future updates merge automatically without resetting customisations

BO3 Actions Expanded

Added to Action Binds and binds.cfg export:

• +10 Points → z
• +100 Points → p
• Ray Gun Upgraded → j
• Downgrade All → t
• Round Skip → 3
• Aimbot Timer → =

Spin/Gift Cooldown Controls

• Gifter spin cooldown spinbox on Dashboard (default 180s, adjustable 10–3600s)
• Viewer spin cooldown spinbox on Dashboard (default 600s, adjustable 10–3600s)

TTS Toggles

• Follow TTS toggle — silence follow welcome messages without disabling follow events
• Gifter Chat TTS toggle — silence gifter chat readout without affecting gift actions

---

🎮 Multi-Game Support

• Three game profiles — BO3 (Steam), BO2 Plutonium (T6), BO1 Plutonium (T5)
• Auto game detection — scans running processes every 5 seconds
• Per-game configuration stored independently — switch games and back, everything restored
• Reset to Defaults per game — one click, only affects the selected game

---

✅ Core Improvements

• Tooltip system — every major UI control has contextual help on hover
• TikTok Live Chat panel — separate chat display with gifter star prefix
• Spin history — last 5 spin outcomes with timestamps
• Cooldown tracker — live countdown per user with gifter/viewer tier indicators
• Gift counter — live per-gift receive count in the gift matrix
• Action-based TTS — 30+ per-effect rich callout pools
• One-command bind loading for Plutonium — exec bot_binds.cfg loads everything permanently
• Launch disclaimer — one-time scam warning with "Don't show again" checkbox and GitHub link

---

🔧 Stability Fixes

• Fixed T6 GSC take_all_perks — replaced unresolved externals with unsetPerk() engine built-in
• Fixed T6 powerup drops not appearing — added missing self.origin parameter
• Fixed T6 GSC key listener never firing — corrected level waittill("say", msg, player) signature
• Fixed installer MkDir → ForceDirectories (correct Inno Setup Pascal function)
• Fixed installer StringReplace → StringChange + EscapeBS helper
• Fixed installer #13#10 preprocessor directive errors
• Fixed AddDefenderExclusion declaration order causing compile error
• Fixed BO3 keypresses not firing — game window now focused before each keypress
• Fixed cfg export writing hardcoded stale binds regardless of user key changes
• Fixed gift sync — gifts no longer store raw keys, action names resolve to keys at runtime
• Fixed new profile actions not appearing after update — merge logic added to reload

---

⬆️ Upgrade Notes

Coming from v1.0.1:

• Config loads automatically via legacy reader
• BO3 spin effects and gift binds preserved under BO3 profile
• T6 and T5 profiles load with default configurations

Coming from early v2.0.0:

• Your saved keys are fully preserved
• New actions (Round Skip, Aimbot Timer, +10 Points, etc.) will appear automatically in Action Binds
• No reset required — new actions merge at the bottom of your existing list
• Re-export your binds.cfg / bot_binds.cfg after updating to pick up new actions

Plutonium users:

1. Setup & Diagnostics → Export GSC → place in correct folder
2. Export Binds .cfg (Plutonium) → run exec bot_binds.cfg once in console
3. Load a zombies map, run map_restart

---

Previous release: [v1.0.1](https://github.com/RedruM-AU/RedruMs_Interactive_Zombies_Tool/releases/tag/1.0.1)