OSRS-TCG Event Spoofer Guide
The OSRS-TCG Event Spoofer is a built-in Developer Tools window (com.n3plugins.n3DevTools.OsrsTcgEventSpooferFrame) designed for safe, zero-packet client-side event simulation. It allows developers to trigger event-driven features in osrs-tcg (such as raid completions, boss kill counts, and clue scroll rewards) directly via RuneLite's internal EventBus and in-game chat buffer.
1. Architecture & Dispatch Flow
┌──────────────────────────────────────────────────────────┐
│ Developer Tools: OSRS-TCG Event Spoofer │
│ (Category / Preset / Custom Editor / Chat Type) │
└────────────────────────────┬─────────────────────────────┘
│ User clicks "Post & Show in In-Game Chat"
▼
┌──────────────────────────────────────────────────────────┐
│ RuneLite ClientThread Execution │
├────────────────────────────┬─────────────────────────────┤
│ 1. client.addChatMessage() │ 2. eventBus.post() │
│ (Renders in chatbox) │ (Posts ChatMessage event)│
└────────────────────────────┴──────────────┬──────────────┘
│
▼
┌──────────────────── ─────────┐
│ osrs-tcg │
│ GameMessageCreditTracker │
│ (Matches Regex/Prefix) │
└──────────────┬──────────────┘
│
▼
┌─────────────────────────────┐
│ CreditAwardService │
│ (Adds credits to TCG) │
└─────────────────────────────┘
Key Safety Guarantees
- No Live Game Packet Generation: All events are posted strictly to RuneLite's internal event bus (
eventBus.post()). No outgoing packets are sent to the game server. - ClientThread Synchronization: Chat additions and event posts are wrapped in
clientThread.invokeLater()to ensure thread-safe execution on RuneLite's main game loop.
2. UI Controls & Usage
| Control | Description |
|---|---|
| Category Selector | Filters presets by category: Raids & Minigames, Boss Kill Counts, Treasure Trails (Clues), or Custom Message. |
| Preset Selector | Populated with all game message templates for the active category, annotated with the expected base credit award (e.g. +18,500 cr). |
| Chat Type Radios | Selects the ChatMessageType: • GAMEMESSAGE (Standard): Default game message. • SPAM (Filtered): Simulates filtered message routing when in-game spam filtering is enabled. |
| Visible Chatbox Checkbox | When enabled (default), inserts the message visibly into the local player's chat history via client.addChatMessage(). |
| Message Payload Editor | Editable text area pre-filled with the exact in-game string. Allows instant custom edits (e.g. modifying KC counts or text strings). |
| Dispatch Button | Executes the dispatch on ClientThread and updates the status bar with outcome and expected credits. |
3. Preset Catalog & Credit Mapping
Raids & Minigames
| Activity / Mode | Exact Message Format | Base Credits |
|---|---|---|
| ToA: Expert Mode | Your completed Tombs of Amascut: Expert Mode count is: 45. | 18,500 |
| ToA: Regular Mode | Your completed Tombs of Amascut count is: 75. | 12,500 |
| ToA: Entry Mode | Your completed Tombs of Amascut: Entry Mode count is: 10. | 3,500 |
| ToB: Hard Mode | Your completed Theatre of Blood: Hard Mode count is: 10. | 18,500 |
| ToB: Regular Mode | Your completed Theatre of Blood count is: 100. | 12,500 |
| ToB: Entry Mode | Your completed Theatre of Blood: Entry Mode count is: 5. | 3,500 |
| CoX: Challenge Mode | Your completed Chambers of Xeric Challenge Mode count is: 25. | 18,500 |
| CoX: Regular Mode | Your completed Chambers of Xeric count is: 50. | 12,500 |
| Corrupted Gauntlet | Your Corrupted Gauntlet completion count is: 100. | 4,500 |
| The Gauntlet | Your Gauntlet completion count is: 15. | 1,750 |
Boss Kill Counts (Chat-Triggered Bosses)
| Boss | Exact Message Format | Base Credits |
|---|---|---|
| TzKal-Zuk (Inferno) | Your TzKal-Zuk kill count is: 1. | 25,000 |
| TzTok-Jad (Fight Caves) | Your TzTok-Jad kill count is: 5. | 10,000 |
| Phosani's Nightmare | Your Phosani's Nightmare kill count is: 50. | 1,024 |
| The Nightmare | Your Nightmare kill count is: 80. | 814 |
| Phantom Muspah | Your Phantom Muspah kill count is: 150. | 741 |
| The Hueycoatl | Your Hueycoatl kill count is: 40. | 642 |
| Royal Titans | Your Royal Titans kill count is: 30. | 525 |
| Grotesque Guardians | Your Grotesque Guardians kill count is: 120. | 476 |
| Alchemical Hydra | Your Alchemical Hydra kill count is: 250. | 426 |
| Abyssal Sire | Your Abyssal Sire kill count is: 70. | 350 |
| Shellbane Gryphon | Your Shellbane Gryphon kill count is: 25. | 235 |
Treasure Trails (Clue Scrolls)
| Clue Tier | Matching Regex Pattern | Preset Message Template | Base Credits |
|---|---|---|---|
| Master | ^You have completed \d+ master Treasure Trails?\.$ | You have completed 15 master Treasure Trails. | 5,000 |
| Elite | ^You have completed \d+ elite Treasure Trails?\.$ | You have completed 20 elite Treasure Trails. | 4,000 |
| Hard | ^You have completed \d+ hard Treasure Trails?\.$ | You have completed 100 hard Treasure Trails. | 3,000 |
| Medium | ^You have completed \d+ medium Treasure Trails?\.$ | You have completed 50 medium Treasure Trails. | 2,000 |
| Easy | ^You have completed \d+ easy Treasure Trails?\.$ | You have completed 25 easy Treasure Trails. | 1,000 |
| Beginner | ^You have completed \d+ beginner Treasure Trails?\.$ | You have completed 10 beginner Treasure Trails. | 500 |
4. Troubleshooting & Verification Tips
- Credit Award Cooldown on Login / Hop:
osrs-tcgsuppresses credit rewards for the first 3 game ticks (CREDIT_AWARD_COOLDOWN_TICKS) immediately after login or world hopping to allow stat baselines to stabilize.- If spoofing immediately upon entering the game, wait 2 seconds before dispatching.
- Spam Filter Verification:
- If the player has enabled the in-game setting "Filter out boss kill-count with spam-filter", OSRS directs KC lines to
ChatMessageType.SPAM. - Selecting the SPAM radio button tests this exact condition, ensuring
osrs-tcg'sGameMessageCreditTrackerprocesses filtered messages identically.
- If the player has enabled the in-game setting "Filter out boss kill-count with spam-filter", OSRS directs KC lines to