💻
⚡
🌸
✨

SamBot v4.5.0 Changelog ⚔️ MMO Expansion

Massive RPG Update! Introducing Classes, Turn-Based Combat, and Dungeons. A fully persisted MMO experience with atomic MongoDB operations, location-based gameplay, and procedural encounters.

Release Date: February 3, 2026
Status: Live Feature

💡 Tip: click any command chip to copy it!

3 Classes Titan • Assassin • Mage
Turn-Based Strategic PvE Combat
MongoDB Native Atomic State • Persisted
Locations Travel • Context Actions
📚

v4.5.1 - Guide & Documentation Rebuild

Complete command reference with 242 commands across 16 categories.

🆕 NEW

📖 Documentation System

  • 242 Commands: All commands extracted and categorized.
  • 16 Categories: Proper grouping matching help.js.
  • Requirements Display: Cooldowns, permissions, energy, location.
  • Search/Filter: Real-time search across name, alias, description.

🔧 Technical Details

  • extract_commands.js: Parses help.js categories.
  • commands.generated.json: Auto-generated registry.
  • help.js Fix: Added guilds, crafting, raids to categoryOrder.
  • guide.html: Dynamic rendering from JSON.
📁 Files Changed ❯
File Change
extract_commands.js Rewrote with help.js category parsing, cooldown/permission detection.
commands/help.js Fixed categoryOrder: added guilds, crafting, raids (11→14).
web/public/guide.html 16 category filters, enhanced command cards with requirements.
web/public/commands.generated.json Generated registry with 242 commands.
⚔️

v4.5.0 - MMO Expansion (Classes & Combat)

Complete RPG system overhaul with persistent state and atomic integrity.

🆕 MAJOR 🔥 HOT

🛡️ Classes & Stats

  • Titan: Tanks, +20% HP, Defense affinity.
  • Assassin: DPS, +15% Crit, Luck affinity.
  • Mage: Utility, +20% Energy, XP Bonus.
  • Stats: Migrated to short keys (str, int, cha, lck).

⚔️ Combat System

  • Turn-Based: Interactive state machine (Player/Enemy turns).
  • Atomic Rewards: Safe XP/Gold drops on victory.
  • Dungeons: Procedural enemy generation based on level.
  • Integrity: validateAction checks for cheating.
🔧 Technical Details ❯
Component Implementation Detail
Combat Logic Seeded RNG for reproducible but unpredictable outcomes.
Atomic Cooldowns findOneAndUpdate with `$lt` checks for race-condition safety.
Location State Server-validated location enforcement for all commands.
Legacy Patch Fixed `getUser` reference errors in dungeon logic.
🐞

v4.4.2 - Async Audit & Stability

Critical fixes for missing assets, names, and async safety.

🩹 CRITICAL 🔥 Optimization

🛡️ Critical Fixes

  • Missing Business: Fixed race condition (missing await).
  • Free Pack Exploit: Patched loophole in opening logic.
  • Display Names: Fixed sync/async resolution bug.

🧹 Code Audit

  • Refactor: 15+ Command files audited for MongoDB safety.
  • Legacy: Removed old sync wrappers.
  • Stability: Visual bugs squashed permanently.
🏴‍☠️

v4.4.0 - Multi-Tier Heist System

Risky, Safe, and Bank Raid modes with MongoDB backing.

🆕 FEATURE 🔥 HOT

🧨 3 New Modes

  • Risky: 30% win, ₹500k cap (High Risk)
  • Safe: 70% win, ₹300k cap (Beginner)
  • Bank Raid: PvP Attacks (25% loot)

🛡️ Advanced Mechanics

  • Defense: Targets get 90s to react
  • Cooldowns: Universal 2-hour timer
  • Atomic: No race conditions on loot
🔧 Technical Details ❯
Feature Implementation
Heist State Stored in MongoDB `heists` collection
Cleanup Background job auto-expires stale raids
Concurrency Atomic `$push` and `$inc` operators
🛡️

v4.3.1 - Critical Stability & Stocks

Major persistence fixes, multi-instance safety, and Stock Market 2.0.

🆕 CRITICAL 🩹 Fixes

🚨 Critical Fixes

  • Persistence: Fixed data not saving to DB (root cause found)
  • Multi-Instance: Fixed race conditions & overwrites
  • Reminders: Fixed duplicate msg bug (Atomic Delete)

📈 Stock Market 2.0

  • Expanded: 13 Stocks across 6 categories
  • Limits: Max 1,000 shares per stock/user
  • Safety: Investment cap set to 1M
🔧 Technical Fixes ❯
Issue Fix
Data Revert Added dirty tracking to local ensureUserData
Duplicate Reminders Atomic MongoDB delete-before-send
CoinToss Crash Defined missing MIN_BET variables
🚀

v4.3.0 - Complete MongoDB Migration

Full removal of TursoDB. Transition to pure MongoDB Architecture.

🆕 MAJOR 🔥 Architecture

🧱 Full Removal

  • TursoDB Gone: Removed all legacy SQL code & deps
  • Single Source: MongoDB is now the ONLY database
  • Cleanup: Deleted 18 old packages + migration scripts

🧠 Multi-Instance Ready

  • Atomic Ops: Thread-safe money transfers
  • Consistency: Zero race conditions
  • Shared Cache: Syncs across all bot instances
🔧 Technical Fixes ❯
Issue Fix
RDP SSL Error Fixed Node/OpenSSL compatibility issue
Race Condition Cache now loads BEFORE connection
Dual Database Removed fallback logic (Simpler code)
🎯

Interactive Menu System

Replaced static text menu with numbered category selection for better UX.

🆕 New 💖 UX
  • .menu → shows 10 numbered categories
  • Reply 1-10 → shows that category's commands
  • .menu all → full menu (all commands)
  • .menu economy → direct category access
  • 5-minute session timeout

🌸 Categories

1 🌐 2 💰 3 🎮 4 🛡️ 5 🏢

🧁 Quick Actions

.menu .menu all .menu economy
🗄️

TursoDB Cloud Migration

Economy data now stored in cloud database with zero downtime.

🆕 New 💫 Infrastructure

🔐 Migration Details

  • Cloud Database: TursoDB (libSQL)
  • 32 Tables: Users, clans, stocks, config, etc.
  • 212 Users: All data preserved
  • Real-time Sync: Async writes to cloud

🛡️ Benefits

  • ✅ No data loss from crashes
  • ✅ Cloud handles scalability
  • ✅ Memory cache = instant reads
  • ✅ Automatic cloud backups
📁 Files Changed ❯
File Change
lib/db.js New database connection module
lib/economyDB.js Cache layer with DB sync
lib/economy.js Refactored to use economyDB
index.js Added cache loading on startup
scripts/init-schema.js 32 tables + indexes
💰

Economy System Enhancements

New earning commands + advanced economy features.

🆕 New 💖 Expanded

🪙 Earning Commands

.work .crime .fish .hunt .daily
work = hourly cooldown ($50–200), crime = high risk/reward, daily = streak rewards (up to 2×)

💎 Advanced Economy

.duel .stock .heist .invest .auction
  • .invest → 5% daily interest (24h lock)
  • .heist → group robbery (min 2 players)
🎮

New Games

Fresh card, word, multiplayer, and story-mode content.

🆕 New

🃏 Card & Word Games

.wordle .blackjack
  • .wordle → daily word guessing (6 attempts, streaks)
  • .blackjack → classic 21 with hit/stand/double

👥 Multiplayer & Adventure

.tournament .rpg
  • .tournament → quiz tournament + leaderboard (5 rounds)
  • .rpg → story-mode adventure "The Dragon's Treasure"
🐾

Pets & Crafting System

Adopt pets for passive income + craft items from materials.

🆕 New 💖 Systems

🐶 Pets

.pet buy .pet feed .pet collect .pet list
  • Buy dogs, cats, dragons, phoenixes
  • .pet feed required every 24h

🧪 Crafting

.craft .craft list
  • Materials from .fish and .hunt
  • Craft items from raw materials
🏰

Clans System

Create clans, manage members, and climb the leaderboard.

🆕 New
.clan create .clan join .clan leave .clan deposit .clan info .clan leaderboard
  • .clan create costs $10,000
  • .clan deposit donates to clan bank
  • .clan leaderboard shows top clans
🛠️

Utility Features

Calculator, currency conversion, polls, reminders, and more.

🆕 New
.calc .convert .poll .remind .schedule .lyrics .confess .bio .title .rank .trigger .note .open
🛡️

Admin / Moderation Features

Anti-flood protection, scheduling, and owner-only controls.

🆕 New 💖 Policy 🩹 LID
  • .antiflood on/off → spam/flood protection (warn/mute/kick)
  • .schedule <time> <msg> → schedule announcements
  • .ban @user is now owner-only
  • .unban @user is now owner-only
  • Fixed participantAlt handling for WhatsApp's new LID-based ID system
  • Owner verification works in both LID and phone number formats
🔧

Technical Changes

v4.0 modularization and stronger session-based handling.

💖 Improved
  • Updated bot version to 4.0
  • Modular export in help.js (helpCommand, handleMenuReply, hasActiveMenuSession)
  • Interactive message response parsing in main.js
  • Session-based menu state tracking
  • Improved error handling across commands
📁

New Files Created

New command modules added for v4.0 features.

🆕 New
Open the file list (24 files) ›
File Description
commands/calc.js Mathematical calculator
commands/convert.js Currency converter
commands/poll.js Polling system
commands/wordle.js Word guessing game
commands/blackjack.js Card game (21)
commands/invest.js Investment with interest
commands/trade.js Player trading system
commands/auction.js Item auction house
commands/antiflood.js Anti-spam protection
commands/tournament.js Quiz tournaments
commands/rpg.js Story-mode adventure
commands/clan.js Clan management
commands/pet.js Pet system
commands/craft.js Crafting system
🧷

Files Modified

Core rewrites, permission changes, and system expansions.

💖 Improved 🩹 Updated
Open the modified list (6 files) ›
File Changes
commands/help.js Complete rewrite with numbered menu
commands/ban.js Owner-only + LID support
commands/unban.js Owner-only + LID support
commands/alive.js Version updated to 4.0
lib/economy.js Added achievements, crafting, pets, clans, stocks
main.js Menu handling, new command imports
📊

Summary

Total New Commands: 27+ across multiple categories.

💖 Overview
Category Commands Added
v4.1.0 Security officer (12 subcmds), admintake, give (enhanced)
Economy Fixes applyPenaltyFromWealth, calculateNetWorth, logFinancialTransaction
Utility calc, convert, poll, schedule
Games wordle, blackjack, tournament, rpg
Economy invest, trade, auction
Moderation antiflood
Previous work, crime, fish, hunt, duel, stock, heist, achievements, clan, pet, craft

Made with ♥ by SamKiraKun

↑ Back to top
Copied!