How jonathansilva/8ballpool works
This Android overlay helper launches 8 Ball Pool, then displays a floating aiming guide when the phone is shaken. Users choose Normal, Trickshot, or the legacy Nine Ball guide; Trickshot also supports a second reflection line. The sampled code shows the permission and foreground-service flow, sensor handling, and guide geometry. README-described modes are included; unsampled service logic and resource details are not inferred beyond the documented behavior and visible references.
Main entry points: ViewService.java Overlay service · MainActivity.java Main activity · Control.java Service control · Trickshot.java Trickshot guide
Components 15
Launch and service
- Main activity
app/src/main/java/app/hack/eightballpool/MainActivity.java - Service control
app/src/main/java/app/hack/eightballpool/Control.java - Game launcher
app/src/main/java/app/hack/eightballpool/Helper.java - App setup
app/src/main/java/app/hack/eightballpool/App.java
Floating overlay
- Overlay service
app/src/main/java/app/hack/eightballpool/ViewService.java
Aiming guides
- Normal guide
app/src/main/java/app/hack/eightballpool/Normal.java - Trickshot guide
app/src/main/java/app/hack/eightballpool/Trickshot.java - Nine Ball guide
app/src/main/java/app/hack/eightballpool/NineBall.java - Wall intersections
app/src/main/java/app/hack/eightballpool/LineIntersection.java
UI resources
- Overlay layout
app/src/main/res/layout/main.xml - Table dimensions
app/src/main/res/values/dimens.xml - Touch sound
app/src/main/res/raw/touch.mp3
Other components
- User
- Android system
- 8 Ball Pool
Connections 21
- User → Main activity: opens app
- Main activity → Android system: checks overlay permission
- Android system → Main activity: returns permission result
- Main activity → Service control: starts service
- Service control → Game launcher: launches game
- Game launcher → 8 Ball Pool: starts game
- Service control → Overlay service: starts foreground
- App setup → Android system: creates notification channel
- Overlay service → Android system: registers accelerometer
- Android system → Overlay service: sends sensor events
- Overlay service → Overlay layout: inflates
- Overlay service → Android system: adds overlay window
- Overlay service → Normal guide: positions and toggles
- Overlay service → Trickshot guide: positions and toggles
- Overlay service → Nine Ball guide: positions and toggles
- Overlay service → Table dimensions: reads sizing
- Overlay service → Touch sound: loads playback
- Trickshot guide → Wall intersections: calculates wall hit
- User → Overlay service: shakes phone
- User → Normal guide: drags guide
- User → Trickshot guide: adjusts guide