Microsoft-Rewards-Bot/docs/humanization.md

🤖 Humanization

Make automation look natural to avoid detection

---

💡 What Is It?

Humanization adds random delays and subtle gestures to mimic real human behavior.

Why Use It?

• ✅ Lower detection risk — Looks less like a bot
• ✅ Natural patterns — Random timing, mouse moves
• ✅ Built-in — No configuration needed

---

⚡ Quick Start

Edit src/config.jsonc:

{
  "humanization": {
    "enabled": true
  }
}

That's it! Default settings work for most users.

---

🎯 What It Does

Random Delays

• 150-450ms pauses between actions
• Mimics human decision-making time
• Prevents robotic patterns

Subtle Gestures

• Mouse movements — Small cursor adjustments (40% chance)
• Scrolling — Minor page movements (20% chance)
• Never clicks random elements (safe by design)

Temporal Patterns

• Random off days — Skip 1 day per week by default
• Time windows — Run only during certain hours (optional)

---

🎛️ Presets

Default (Recommended)

{
  "humanization": {
    "enabled": true
  }
}

Balanced safety and speed.

---

Conservative (More Natural)

{
  "humanization": {
    "enabled": true,
    "actionDelay": { "min": 300, "max": 800 },
    "gestureMoveProb": 0.6,
    "gestureScrollProb": 0.4,
    "randomOffDaysPerWeek": 2
  }
}

Slower but safer.

---

Fast (Less Natural)

{
  "humanization": {
    "enabled": true,
    "actionDelay": { "min": 100, "max": 250 },
    "gestureMoveProb": 0.2,
    "gestureScrollProb": 0.1,
    "randomOffDaysPerWeek": 0
  }
}

Faster execution, higher risk.

---

⏰ Time Windows (Optional)

Run only during specific hours:

{
  "humanization": {
    "enabled": true,
    "allowedWindows": ["08:00-10:30", "20:00-22:30"]
  }
}

Script waits until next allowed window if started outside.

---

📅 Random Off Days

Skip random days per week:

{
  "humanization": {
    "enabled": true,
    "randomOffDaysPerWeek": 1  // Skip 1 random day/week
  }
}

Options:

• 0 — Never skip days
• 1 — Skip 1 day/week (default)
• 2 — Skip 2 days/week

---

🛠️ Troubleshooting

Problem	Solution
Too slow	Lower actionDelay, reduce probabilities
Too fast/robotic	Increase delays, higher probabilities
Not running at all	Check allowedWindows time format

---

📚 Next Steps

Need vacation mode?
→ See Scheduler Vacation

Want scheduling?
→ Scheduler Guide

More security?
→ Security Guide

---

← Back to Hub | Config Guide