A lightweight 2D mouse automation engine built with Python, Eel, and a whole lot of spite. 💀
Developer Note 🛑: English is not my native language. I apologize if my grammar is a bit weird, but I did my best to write this! If something sounds wonky, just pretend it's an inside joke. 😅
👉 Click here to read Why I built this
It all started on a lazy afternoon. I was lying in bed with my cat 🐈, doom-scrolling through TikTok, when I stumbled across a video showcasing a recoil macro for a popular FPS game. I was fascinated. I immediately fell down an internet rabbit hole, digging through Reddit threads, YouTube tutorials, and Google searches just to figure out how these scripts actually interacted with the OS. 🕵️♂️
What surprised me wasn't the tech, but the economy around it. Bro, people were selling "private macros" for $10, and some even pushed the price to a ridiculous $50-$60. I couldn't help but wonder—why on earth is this so expensive? It’s literally just moving a cursor down on a 2D plane. It didn’t seem that complicated, ngl. 🤨
At first, I tried taking the easy route. I loaded up standard hardware macro software like Logitech G HUB and Razer Synapse to see if I could replicate the results for free. While they technically worked, they were rigid af. The performance, dynamic variables, and flexibility just weren't there. If I wanted something dynamic that felt smooth and adjustable, I needed to code it myself. 😤
There was only one massive problem: I didn't know Python. In fact, I had never touched HTML, CSS, or JavaScript in my life. 🤡
To give you some context, I actually used to be a Computer Engineering student. However, I dropped out of my Bachelor's program because I absolutely despised advanced mathematics. I have no CS degree. But fueled by sheer curiosity (and maybe a healthy dose of spite against people charging $60 for basic scripts), I went back to YouTube University 🎓. I watched countless programming tutorials, read documentation, and slowly pieced things together line by line.
(BTW: I am currently about to graduate with a degree in Multimedia 🎮. Since I was building this project anyway, I figured it was a great excuse to actually apply my design skills and flex some UI/UX concepts!)
This project is the culmination of that hyper-fixation. It’s my very first time building a software application completely from scratch. In the eyes of a senior developer, the code structure might literally be the "Worst Macro Ever." But it features multithreading, Windows API integration (ctypes), a mathematical lerp function, and a full Web UI connected to a Python backend. 🔥
It works, and I built it myself. W. 🏆
While the codebase might look like a beginner's plate of spaghetti 🍝, the actual feature set is kinda goated:
- Profile-Specific States 🧠: Settings (Sensitivity, Vertical/Horizontal Multipliers) are saved dynamically per profile. Switching from a Heavy Rifle to a Custom Profile automatically loads the exact configuration you previously set. No more re-typing!
- Smart ADS (Aiming Down Sights) 🎯: The automation engine only activates when you hold down both Right-Click (Aim) and Left-Click (Shoot). It intelligently ignores hip-firing or random clicking.
- Neuro-Jitter (Humanization) 🤖❌: Nobody has a perfectly straight hand. This feature adds randomized, micro-pixel deviations to the mathematical curve to simulate human imperfections. Basically, it makes the cursor path look less like a robot and more like a caffeinated gamer. ☕
- Dynamic Stance Multipliers 🤸♂️: Custom multiplier settings for Standing, Crouching, and Proning. The engine dynamically scales the drag calculations based on your active stance.
- Fast Drag Utility ⚡: A side-utility mapped to Mouse 5 that executes an instant click-and-drag motion. Super useful for fast inventory management or UI interaction (aka looting at the speed of light).
One of the main reasons standard hardware macros bothered me was their boring, rigid user interfaces. If I was going to build my own engine, I wanted it to look incredibly premium. ✨
I designed the UI entirely from scratch using Vanilla HTML, CSS, and JS (no bulky UI frameworks here, sir!). It features custom CSS variables, glassmorphism (backdrop-filter), dynamic glowing gradients, and custom webkit scrollbars.
Huge shoutout to the K-pop group aespa! 🦋✨
The entire visual concept of this project was heavily inspired by their iconic Y3K / Chrome Aesthetic. I wanted the interface to feel like a sleek, futuristic, and slightly edgy cyber-tool pulled straight out of an aespa music video concept. Supernova vibes only. 🌌
This project serves as a Template / Educational Resource for understanding System-level Mouse Inputs and Python-to-Web bridging:
- Frontend 🌐: HTML5, Vanilla CSS, Vanilla JavaScript.
- Backend 🐍: Python 3,
ctypes(Win32 API),threading,json. - The Bridge 🌉:
Eel(A neat little Python library for making simple offline HTML/JS GUI apps). - Win32 API Hooking 🪝: Utilizes
ctypes.windll.user32.SendInputfor OS-level mouse simulation. - Linear Interpolation (Lerp) 📈: Implements math-based curve calculation (
_lerp_2d) for smooth, time-based 2D movement. - Multi-Threading 🧵: Runs the UI, the main automation loop, and the fast-drag utility on separate daemon threads to prevent everything from freezing up.
Before anyone in the comments says, "Bro, you didn't use a kernel-level driver, you're gonna get banned in 5 seconds"—Yeah, I know. 😂
This engine uses ctypes.windll.user32.SendInput, which is a User-Mode API hook. Any modern anti-cheat system (Vanguard, BattlEye, EAC) will flag this immediately. I didn't write a custom .sys driver to bypass the Windows kernel because:
- I'm a beginner and I'd probably Blue-Screen my PC. 💀
- This project is purely a proof-of-concept and a UI/UX exercise. It's not meant to bypass multi-million dollar security systems.
If you use this in a protected game, you will get banned. You have been warned!
First of all, I deeply apologize if the code logic, structure, or formatting is an absolute mess. 😭 This is literally the first software project I have ever built in my entire life. If it looks like spaghetti, that's because it is! 🍝
I built this project purely for educational purposes 📚 and simply because I wanted to see if I could.
Feel free to download the code, tear it apart, modify it, and use it however you want. I don't care about hoarding code or making money off of it. If I get curious and decide to build other random software in the future, I'll open-source those and share them for free too. 🤝
Please note: I do not condone using automation tools to ruin competitive online games for others (skill issue, just practice). Users are solely responsible for ensuring that their use of this software complies with the Terms of Service of any application they use it alongside. 🛡️
Anyway, play games to have fun, not to stress out.
Peace! ✌️ (Peach! 🍑)
P.S. I'm not a professional developer. I just play games, lift weights 🏋️♂️, and run on Thai Tea 🧋. My cat constantly judges my code 😾, and I might accidentally blow up my condo one day building random hardware things. If it works, it works. 🤷♂️