File size: 2,642 Bytes
364eb96 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 | # MnkLightning
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/)
[](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
[](#)
[](https://monkeytype.com/)
MonkeyLightning is a performance-oriented automation script designed for Monkeytype. It implements sophisticated human-like typing behavior with real OS-level keyboard events to bypass bot detection.
## Technical Overview
This v3.0 release shifts from client-side JavaScript to **Python-based automation (PyAutoGUI)**. This creates "trusted" keyboard events that are indistinguishable from real human input to the browser.
- **`mnk_typer.py`**: Python script that simulates real keyboard input.
- **`injector.js`**: Helper script to bridge text from browser to Python.
- **Human-like Imperfections**: Full suite of 12+ imperfection types (typos, hesitations, fatigue).
## Usage Instructions (Bypass Method)
The new bypass method uses a 2-step process:
### Step 1: Setup
1. Install Python (if not installed).
2. Install required packages:
```bash
pip install -r requirements.txt
```
### Step 2: Run the Bot
1. **Open Monkeytype** in your browser.
2. **Open Developer Console** (`F12` or `Ctrl+Shift+J`).
3. **Paste & Run** the contents of [`injector.js`](./injector.js) into the console.
- You should see a message: "MnkLightning Injector Active".
4. **Run the Python script** in a terminal:
```bash
python mnk_typer.py
```
5. **Trigger the Bot**:
- Focus the Monkeytype window.
- Press **`Insert`** key to copy current words to clipboard.
- Press **`Insert`** key again to START typing.
- Press **`Esc`** to stop at any time.
## Configuration
You can customize the bot's behavior in `mnk_typer.py`:
```python
CONFIG = {
"min_wpm": 310,
"max_wpm": 550,
# Imperfections (0.0 - 1.0)
"wrong_char_rate": 0.025,
"adjacent_key_rate": 0.02,
"hesitation_rate": 0.04,
"burst_rate": 0.08,
# Timing
"hesitation_multiplier": 3.5,
"burst_speed_multiplier": 0.5,
}
```
## Disclaimer
This software is provided for educational and research purposes only. The authors do not encourage or condone the use of automation scripts on competitive platforms. Use at your own risk.
|