Skip to content

Play AdventureQuest Worlds Worlds directly in your browser using Ruffle. You can run it via a self-hosted Docker container or your own WebSocket proxy.

License

Notifications You must be signed in to change notification settings

anthony-hyo/aqw-on-browser

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AQW On Browser

Docker Ruffle License

Play AdventureQuest Worlds Worlds directly in your browser using Ruffle. You can run it via a self-hosted Docker container or your own WebSocket proxy.

One-Click Install Tampermonkey Script

Install Tampermonkey Script

Click the badge above, and Tampermonkey will prompt you to install the script automatically.

⚠️ Note: The default script uses a localhost proxy. You must run your own proxy locally to play online.

Public Proxy (Optional)

  • Available at: wss://socket2-aq-com.anthhyo.dev (Server Espada)
  • ⚠️ This proxy runs on Cloudflare WARP, so your AQW IP will appear as Cloudflare.
  • To use it, edit your Tampermonkey script and replace the socketProxy URLs with this link.

Preview

Preview 1
Settings

Docker Setup

git clone https://github.com/anthony-hyo/aqw-on-browser.git
cd aqw-on-browser
docker-compose up --build

Open your browser at http://localhost:8080.

Files

  • Dockerfile — container setup
  • docker-compose.yml — orchestrates services
  • entrypoint2.sh — entrypoint script

FAQ / Security Notes

  • Do I need a proxy? Yes — browsers cannot connect directly to AQW’s game servers due to WebSocket/CORS restrictions. The proxy forwards traffic so Ruffle can connect.

  • Is my account safe? ✅ When running your own proxy (via Docker or local setup), no data is stored outside your machine. ⚠️ Using a public proxy is not recommended if you want full control and security.

  • Can I self-host? Absolutely! The Docker setup allows you to run your own proxy locally at http://localhost:8080. Simply update the Tampermonkey script to point socketProxy to your localhost if needed.

Contributing

Contributions, issues, and feature requests are welcome! Feel free to fork the repo and submit pull requests.


License

This project is licensed under the MIT License.

About

Play AdventureQuest Worlds Worlds directly in your browser using Ruffle. You can run it via a self-hosted Docker container or your own WebSocket proxy.

Topics

Resources

License

Stars

Watchers

Forks