Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
198 changes: 198 additions & 0 deletions README_API_FIX_NL.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,198 @@
# 🔧 API Fix voor OSRS-Bot-COLOR

## 📋 Snel Overzicht

**Probleem:** MorgHTTP en andere RuneLite plugins werken niet meer omdat:
1. Ze zijn verwijderd van de RuneLite Plugin Hub
2. RuneLite heeft anti-bot detectie toegevoegd (LLMHF_INJECTED flag via DLL)

**Oplossing:** KInput + Image Mode (GEEN plugins nodig!) of Linux gebruiken

---

## 🪟 Windows Setup (GEEN Plugin Sideloading) ⭐ NIEUW

**Meest gevraagde oplossing:** Werken op Windows ZONDER plugins te sideloaden!

```bash
# 1. Download/compileer KInputCtrl.dll
# Zie: https://github.com/ThatOneGuyScripts/KInput

# 2. Plaats DLL
# Locatie: /src/utilities/Plugins/KInputCtrl.dll

# 3. Test KInput
python test_kinput.py

# 4. Run voorbeeld bot (100% image mode)
python src/model/osrs/example_image_bot.py
```

**Complete guide:** [WINDOWS_SETUP_KINPUT.md](WINDOWS_SETUP_KINPUT.md)

**Voordelen:**
- ✅ Geen plugin sideloading nodig
- ✅ Werkt met normale RuneLite launcher
- ✅ Bypass LLMHF_INJECTED via KInput
- ✅ 100% image/color based (zoals Chris gebruikt)

---

## 🚀 Alternatief: Linux Gebruiken

De **gemakkelijkste oplossing** zonder KInput is Linux:

```bash
# 1. Installeer Ubuntu/Debian (VM of dual-boot)
# 2. Setup bot
git clone [deze repo]
cd OSRS-Bot-COLOR
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt

# 3. Installeer RuneLite
wget https://github.com/runelite/launcher/releases/latest/download/RuneLite.AppImage
chmod +x RuneLite.AppImage

# 4. Build plugins en sideload (zie volledige guide)
```

**Waarom Linux?**
- ✅ RuneLite's anti-bot DLL werkt NIET op Linux
- ✅ `pyautogui` werkt gewoon zonder kinput
- ✅ Geen extra configuratie nodig

---

## 🪟 Windows Oplossing

Voor Windows gebruikers:

### Stap 1: Plugins Verkrijgen

Je moet de plugin JAR files zelf compileren of vragen in Discord:

```bash
# MorgHTTPClient compileren
git clone https://github.com/MorgApps/morghttpclient
cd morghttpclient
./gradlew build
# JAR: build/libs/morghttpclient-*.jar
```

### Stap 2: RuneLite Developer Build

```bash
git clone https://github.com/runelite/runelite
cd runelite
./gradlew run
```

### Stap 3: Plugins Sideloaden

1. Maak folder: `C:\Users\<username>\.runelite\sideloaded-plugins\`
2. Kopieer JAR files naar deze folder
3. Start RuneLite developer build
4. Enable plugins in Plugin Hub

### Stap 4: Kinput Installeren (Bypass Mouse Detection)

1. Verkrijg `KInputCtrl.dll`:
- Zoek naar "ThatOneGuy's repo" op GitHub
- Of vraag in Discord

2. Plaats in: `/src/utilities/Plugins/KInputCtrl.dll`

3. De bot gebruikt automatisch kinput als DLL aanwezig is!

```python
# RemoteIO.py gebruikt automatisch kinput
from utilities.RemoteIO import RemoteIO
remote_io = RemoteIO(runelite_process_id)
remote_io.click(x, y) # Omzeilt LLMHF_INJECTED flag
```

---

## 🎯 Welke Oplossing Voor Jou?

| Situatie | Aanbeveling |
|----------|-------------|
| **Windows zonder sideloading** ⭐ | KInput + Image Mode - [WINDOWS_SETUP_KINPUT.md](WINDOWS_SETUP_KINPUT.md) |
| **Beginner** | Linux in VM (geen DLL detection) |
| **Windows met API** | Sideload plugins + kinput - [RUNELITE_API_FIX.md](RUNELITE_API_FIX.md) |
| **Maximale stealth** | Linux + Arduino HID device |
| **Quick & dirty** | Remote Desktop (Parsec) - triggert ook detection flag |

---

## 📚 Meer Informatie

Zie **[RUNELITE_API_FIX.md](RUNELITE_API_FIX.md)** voor:
- Gedetailleerde stap-voor-stap instructies
- Troubleshooting
- Alternatieve methoden (Arduino, Raspberry Pi)
- Volledige technische details

---

## ❓ Hulp Nodig?

1. **Discord:** https://discord.gg/Znks7Smya4
- Vraag naar plugin JAR files
- KInputCtrl.dll
- Setup hulp

2. **Community Resources:**
- Chris heeft "own morg look-a-like" - vraag in Discord
- Anderen gebruiken al werkende setups

3. **Belangrijke mensen in Discord:**
- Chris - ervaren, heeft eigen plugin
- Das Trickmeister - Linux expert
- DATASET - kan helpen met kinput
- Hai Ke - weet hoe LLMHF_INJECTED te bypassen

---

## ⚠️ Disclaimer

**LET OP:** Volgens de Discord community (sept/okt 2025):
> "they've really stepped up their anti botting since the last wave. loads of people get banned now"

- Botting is tegen OSRS ToS
- Jagex heeft nieuwe ML detectie
- Gebruik op eigen risico
- Bot verantwoordelijk en niet te agressief

**Nieuwe detectie methoden:**
- Mouse movement patterns (ML/AI)
- LLMHF_INJECTED flag monitoring
- Behavioral analysis
- Verbeterde pattern recognition

**Tips voor veiligheid:**
- Gebruik Linux (geen DLL detection)
- Varieer je bot patterns
- Speel ook handmatig
- Gebruik breaks en random intervals
- Overweeg hardware input (Arduino) voor max stealth

---

## 🔄 Updates

**2025-11-13 (Update 2):**
- ⭐ Windows-only oplossing ZONDER plugin sideloading toegevoegd!
- KInput setup guide met test scripts
- Voorbeeld bot voor pure image mode
- Helper utilities voor PID detection

**2025-11-13 (Update 1):**
- Volledige guide gemaakt voor plugin sideloading
- Kinput support gedocumenteerd
- Linux oplossing toegevoegd
- Discord context geïntegreerd

**Houd deze repo in de gaten voor updates!**
Loading