Skip to content

Add HSBlackJack plugin - #544

Open
HalalSkiller wants to merge 4 commits into
chsami:developmentfrom
HalalSkiller:feature/hs-blackjack-plugin
Open

Add HSBlackJack plugin#544
HalalSkiller wants to merge 4 commits into
chsami:developmentfrom
HalalSkiller:feature/hs-blackjack-plugin

Conversation

@HalalSkiller

Copy link
Copy Markdown

Summary

Adds HSBlackJack, a plugin that automates blackjacking Menaphite Thugs in the Pollnivneach
tent area: finding and luring a thug into a private tent, managing the curtain, knocking it
out, and pickpocketing twice before repeating the cycle.

Features

  • Full lure → tent → knock-out → pickpocket cycle. Uses the NPC's own animation IDs (confirmed
    via manual testing) to detect a successful knock-out as fast as possible, instead of relying
    on fixed delays.
  • Multi-tick verification of a lure attempt (interaction + proximity, checked over several ticks)
    to correctly detect a rejected "Go away! I'm busy" instead of a false positive.
  • Detects when the tent is already occupied (by another NPC or another player) and hops worlds
    automatically rather than getting stuck.
  • Recovers from real combat (the "You can't do this during combat." block) by unequipping the
    blackjack, breaking the NPC out of combat, then re-equipping and resuming on the same NPC.
  • Automatic Jug of wine restocking from Faisal the Barman, including a minimum-stock check that
    hops worlds if the shop itself is running low.
  • Opens coin pouches automatically once 27+ are held.
  • Smart, transport-aware travel to the start position from anywhere in Gielinor at plugin start
    (fairy rings, Shantay Pass, etc.), with a stuck-detection fallback that tries opening nearby
    doors if progress stalls.
  • Overlay panel with live status, a short rolling action history, knock-out/pickpocket counts,
    and XP/hr.

Configuration

  • Blackjack - which tier/type of blackjack to use.

Known limitations

  • Hardcoded to the west tent in the Pollnivneach blackjacking area (fixed coordinates) - not
    currently configurable to other tents/locations.
  • Targets Menaphite Thugs specifically.

Testing

Manually tested over multiple live sessions, including combat-recovery, restock trips, world
hops, and multi-hour runs.

@chsami chsami left a comment

Copy link
Copy Markdown
Owner

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Current head 3510289 builds locally against Microbot 2.6.20, but it is not merge-ready:

  1. HSBlackJackOverlay hard-codes C:\Users\MAIN\Downloads\halalskills menaphite thug blackjack.jpg and reads it from the user filesystem. Package an image resource or remove the header; a contributor-local path must not ship.
  2. HSBlackJackPlugin still publishes the placeholder author JouwNaam, and the Readme is an extensionless file under src/main/java instead of the plugin documentation resource tree.
  3. The PR rewrites src/test/java/net/runelite/client/Microbot.java to remove the shared debug list and select only this plugin. Restore that repository debug launcher; this is local test configuration unrelated to the plugin.
  4. HSBlackJackScript runs on its scheduled executor but directly reads client state at the XP snapshots and traverses TopLevelWorldView player data in the room checks. Marshal those complete reads to the client thread or use snapshot/cache data.
  5. The expected CI Build pull-request job is absent from this head. Push/sync a corrected head so the repository workflow runs.

Please keep the fix scoped to the plugin, published docs/resources, and executable validation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants