jsbots/AutoFish

Table of Contents 📃

• Fishing bot
• Disclaimer
• Guide
• Threshold
• Fishing zone
• Applying Lures
• Interactive key
• Soulbound items
• Download

AutoFish Premium:

• Features
• Remote Control
• Arduino Control
• Multiple Windows
• Sound Detection
• Mammoth Selling
• Random camera/character movements
• AFK Fishing

Fishing bot 🐟

This is a fishing bot designed for wow-like fishing logic (when a model of a bobber has red/blue feather and plunging animation, for example it can work even with Minecraft). It is built using the Electron framework and leverages the keysender library and nut.js library to analyze the screen and automate the fishing process in a manner that mimics human behavior.

This bot is capable of simultaneously handling one or multiple game windows, enabling efficient fishing across different instances. Additionally, it incorporates the use of tesseract.js for loot analysis.

Features:

• Fishing lures support.
• Loot filtering support.
• Automated confirmation for soulbound items.
• Intentional "miss" functionality.
• Randomized log out/log in functionality.
• Advanced automation with various elements of randomness, including random sleep intervals, random reactions, random delays after catching, randomized mouse speed and curvature, and random bobber highlighting.

For more detailed review you can watch AutoFish 1.12

This is commonly referred to as a "pixel bot." It operates without modifying the game's memory or utilizing vision libraries like OpenCV. Instead, it employs a simpler approach: it analyzes the game window for concentrated red colors and monitors that area for any changes. As the bobber moves and gently sways, the bot follows its motion. However, when the bobber suddenly jerks, the bot clicks on it and catches the fish.

It's important to note that the bot requires the game window to be open at all times and does not function in the background. To address this limitation, one can utilize a virtual machine such as VirtualBox or VMware Player.

Disclaimer ⚠️

This project was solely developed for educational purposes, aiming to explore the feasibility of creating a functional gaming bot using JavaScript.

This software can be used with any game that has a similar fishing logic.

It's important to note that using bots in the majority of games is explicitly prohibited. Engaging in such activities carries significant risks, including potential consequences such as account suspension, loss of in-game progress, or even real-world financial losses.

When using this software, it is crucial to understand and accept the associated risks. You assume full responsibility for any outcomes that may arise, as no one else can be held accountable. It's essential to acknowledge that this software is not designed to be "undetectable" in any way, nor was it ever intended for such purposes. As a result, no guarantees or assurances can be made regarding the functionality or outcomes of the bot.

It is provided as-is, without warranties or guarantees.

Guide 📘

1. Launch the game.
2. Are you using Filter feature?
   • Yes: Turn off Auto Loot in the game, set UI scale in the game to default, turn on Open loot window at mouse in the game.
   • No: Turn on Auto Loot in the game.
3. Assign your 'fishing' and 'lures' keys in the game and assign the same keys for the bot.
4. Find a place to fish.
5. Set up your Fishing Zone by clicking the Set Fishing Zone button. Adjust the size and position of the Fishing Zone window to exclude any reddish or bluish elements (depending on the switch you selected). Keep in mind that the Fishing Zone functions as an overlay, so it will also recognize colors from your character and the game's user interface, including texts and health bars.
6. Press the Start button and refrain from using your mouse and keyboard (if you require the bot to function in the background, consider using it within a virtual machine).
7. To stop the bot, press your designated stop key (default: space).
8. Are you encountering an error?

Yes, it says: Found red/blue colors before casting. Change your Fishing Zone or increase the Threshold value or change the fishing place.

Adjust the position or size of your Fishing Zone to exclude any reddish or bluish elements. If you are certain there are none, you may need to increase the Threshold or switch to the other color.

No, but the bot recasts all the time and can't find the bobber. (as says in the log)

It indicates that you may have set the Threshold value too high. Try decreasing it. If the error persists, there might be an issue with the size or position of your Fishing Zone.

No, but the bot clicks too early before fish is even hooked.

There are a couple of solutions for this. First, try switching to the 1st person view. If that doesn't help, navigate to the Advanced Settings and adjust either the Bobber Sensitivity (disable the Auto adjust Sensitivity and Density option) or the Bobber Density (particularly if it's not Retail) values in the Critical section.

No, the bot finds the bobber (as says in the log) but it doesn't react to the bobber being hooked.

Then you do the opposite to the previous issue: navigate to the Advanced Settings and decrease either the Bobber Sensitivity (particularly if it's Retail) or the Bobber Density (especially if it's not Retail) values in the Critical section. In the case of Vanilla (splash), you can decrease the Splash Color value."

Hints and Issues

• The bot has been exclusively tested with the default user interface (UI) and default UI scale, without any addons. Therefore, before using the bot, ensure that all addons are turned off and the UI scale is set to default. This is particularly important for fishing addons like Fishing Buddy and others. Disable any UI features they provide.
• During the initial casting process, the bot performs a preliminary check for red/blue colors. If any such colors are detected, the bot will stop functioning.
• The bot will make 5 attempts to cast and find the bobber (default: 5). If it fails, it will stop the application.
• If you use Filter feature in different from English languages for the first time, wait until the bot downloads the data for your language. Also read about Soulbound items.
• If the bot doesn't move/press/clicks your mouse, try to launch it as administrator. (especially if you use it on private servers)
• Filter works properly only with 16:9 resolutions right now: 1366x768 or 1920x1080 or 3840x2160
• Don't fish near other players, the bot might confuse their bobber for yours.
• If you use many monitors the game should be on the primary one.
• Sound Detection feature might not work with some audio devices, in that case you need to switch to another device (e.g. you are using headphones and sound detection doesn't work, then plug in speakers and test again).
• The bot might not work properly if you have latency issues.
• You can turn off all the "sleeping" and random values to make the bot work 2-3 times faster.
• If you want to use the bot with multiple windows don't forget to switch the game to DirectX 11.
• Supported keys for the bot (except num's and Fs)
• If Lunkers bother you in Retail, you might need to turn off sleeping or decrease it to around 0.5 - 5 seconds.

Threshold 🔴

Since 2.0.0 Threshold value is obsolete and available only in Manual mode

The Threshold value represents an RGB value of a red or blue color, depending on the switch used. It serves as a color threshold below which the bot will ignore all corresponding colors.

For instance, if the red switch is used and the threshold is set to 60, the bot will only recognize colors that are redder than this threshold value. This allows the bot to focus on the reddest parts of the screen, such as a red feather on the bobber.

Increasing the threshold value will result in the bot recognizing fewer red colors, while decreasing the threshold value will cause the bot to recognize more red colors on the screen.

Dynamic Threshold

The bot incorporates a simple mechanism to adjust the threshold value. After a certain number of failed attempts to find the bobber (default: 5), the bot will decrease the threshold by the provided value (default: 5). It will then make another set of attempts to find the bobber, continuing to decrease the threshold until it reaches a value of Threshold < 20. This feature is particularly useful in adverse weather conditions when the color or brightness of the bobber is significantly reduced, enabling the bot to continue functioning effectively.

Fishing Zone 🎯

The Fishing Zone is an adjustable area in the water where your bobber may land. The bot specifically searches for the bobber within this designated area.

The Fishing Zone is displayed as an overlay window, meaning that the bot will also recognize the colors of your character and user interface.

To assist you in assessing the presence of red or blue colors within the Fishing Zone, there is a "Check" button. This feature relies on the Threshold value. If, upon pressing the Check button, the window turns red, close the window, gradually increase the Threshold value, and test again. Repeat this process until the window turns green.

A general guideline to follow is that the better you can perceive the red or blue feather, the better the bot will be able to detect it as well. Consider the following tips:

• Optimize your video settings to enhance visibility, excluding weather effects.
• Disable weather effects to prevent the bot from confusing rain or fog with bobber movements. However, note that extremely harsh weather conditions, such as blizzards, may significantly reduce the bot's efficiency. In such cases, you can either find an alternative fishing spot, switch between blue and red feathers, or wait for better weather.
• Keep in mind that different camera directions can affect the brightness, size, and visibility of the red feather on the bobber, subsequently impacting the bot's performance. While the specific location may not be critical, the direction and positioning are crucial.
• Although camera position is not highly significant, in dark or snowy areas, a closer view of the bobber might improve visibility. Generally, a normal third-person view is ideal.
• Adjust gamma, brightness, and contrast settings to enhance the brightness and vibrancy of the bobber.
• In very dark zones, consider using alternative bobbers with distinctive red or blue colors instead of the default one.

Watch AutoFish 1.12 for video explanation.

Applying Lures 📌

For Retail and Classic/Vanilla type of fishing you need to use a macro that will apply the lures onto your fishpole and assign that macro to Lures Key option:

retail:

/use *lure_name*
/use *fishpole_name*

Classic:

/equip *fishpole_name*
/use *lure_name*
/use 16

Vanilla:

/script UseAction(*your lures key*);
/script PickupInventoryItem(16);
/script ReplaceEnchant();

Interactive key

In Retail-like games You can use interactive key to catch your fish, if you want to use it with the bot, turn on Int. Key option and assign the same key you use for interactive key in the game.

To make the interactive key work, you use this commands (write them in the chat and press enter, one by one):

/console SoftTargetInteractArc 2  - This will allow you to interact with the bobber no matter which way you are facing.
/console SoftTargetInteractRange 30  - This increases the interaction range to 30 yards. Adjust to your needs

Soulbound items auto-confirmation 🔷

If the item requires confirmation on looting, the bot will confirm it automatically. This won't work with AutoLoot turned on, so if you need such items always use whitelist. This feature also doesn't work with any other language except English. As a solution (both if you need AutoLoot on and if your WoW isn't in English) use AutoLooter instead.

AutoFish Premium 👑

AutoFish Premium is available for supporters who donate more than 15$ and has some additional features.

Premium Features:

• You support the project! (main feature)
• Remote control via Telegram.
• Control with Arduino Board (complete hardware emulation).
• Multiple game windows support (up to 4).
• Sound Detection.
• Mammoth Selling (junk selling).
• Profiles support.
• AFK Fishing Mode (auto-focusing the window only when catching/casting).

Arduino Control 🕹️

This feature is available only for Premium version of the app

Watch Arduino Control Test Video

The bot is able to connect to your Arduino Board and use it to emulate a mouse/keyboard device, it will look like a real keyboard or mouse to the OS and the game. What you need to do to make it possible:

1. Get an Arduino with an ATmega32U4 on board (any cheap copies for 2-3$ will do too, you can find them on Chinese online markets).
2. Connect it to your computer.
3. Install Arduino IDE.
4. Click New Sketch and replace everything there with this sketch: Arduino Sketch.
5. Click Tools -> Port and choose the port your Arduino Board connected to.
6. Click Sketch -> Upload and wait until the code uploads to your board.
7. Launch AutoFish, click Advanced Settings turn on Use Arduino Board option and choose the port your Arduino Board connected to, press Connect button.

Telegram remote control 📱

This feature is available only for Premium version of the app

Watch Telegram remote control Test Video

1. Get the token from BotFather by using /newbot command and following the instruction. Imagine some long and random name for the bot so that someone won't accidentally join your bot and gain control over your fishing process.
2. Paste the token to Telegram token input field in Remote Control section in the Advanced Settings and press enter.

3. Press Connect button and wait until the name of the button changes to either done or *error (might take awhile).
4. Open the bot in your Telegram and either press /start or write /start command.
5. If evertyhing is OK, the bot will reply with:

6. Now set your Chat Zone as on the screenshot below by pressing Set Chat Zone button on the main window of the AutoFish.

7. If you want to make the bot notify you about any errors or whipser messeges, you need to start it from Telegram (not by pressing Start on the bot's interface). Whisper detection will work much better and reliable if you turn off all the other chat messages.

Multiple Windows 🚀

This feature is available only for Premium version of the app

Watch Multiple Windows Test Video

The Multiple Windows feature enables you to fish simultaneously in multiple game windows, with support for up to four windows. The bot will seamlessly switch between the game windows as needed for casting and catching fish. This feature enhances your fishing efficiency by allowing you to manage multiple fishing spots or engage in multi-character fishing activities.

Watch this if you wonder how it looks like.

Sound Detection 🔊

This feature is available only for Premium version of the app

Watch Sound Detection Test Video

Sound Detection is an alternative to pixel recognition logic. The bot will hook the bobber only after "splash" sound and won't rely on checking the animation of the bobber plunging.

With both Int. Key and Sound Detection turned on you can be completely independent from Threshold and Fishing Zone options. If you don't use Int. key or the game doesn't support it, the bot still needs to find a bobber first but checking will be done by sound recognition if you turn on Sound Detection option.

Before using sound detection turn off Music and Ambient Sounds in the game, leave only Sound Effects. Your volume should be at normal/default level. Try to find a place secluded from the sounds made by other players to avoid false detections.

You can also use AFK Fishing Mode in DX12 now, with Int.Key + Sound Detection the bot will focus the window only when it needs to cast and when it detects splash sound (turn on Sound in Background for that).

Warning! Sound Detection feature might not work with some audio devices, in that case you need to switch to another device (e.g. you are using headphones and sound detection doesn't work, then plug in speakers and test again).

Mammoth Selling 🐘

This feature is available only for Premium version of the app

Watch Mammoth Selling Test Video

As an alternative to filtering you can use a trader on your mammoth mount to sell all the junk items during the fishing. The bot will summon your mount, target your trader, interact with it by using interaction key in the game, unsummon the mount and go on fishing.

Because of the novelty of the interaction key this feature is available only for Retail.

Depends on the mount the name of your trader might be different, so change the default value.

Random Camera/Character Movements 🤖

This feature is available only for Premium version of the app

Watch Random Camera/Character Movements Test Video

The bot will randomly move and change your camera view from time to time within the given value. It will also balance itself every n minutes (default: 5) and return to the initial camera and character position.

AFK Fishing 😴

This feature is available only for Premium version of the app

Watch AFK Fishing Test Video

To facilitate the use of the bot when you have a single monitor and cannot run it in the background or set up a virtual machine, the AFK Fishing mode is available. This mode enables the bot to focus on the game window only during the casting and fish-catching process. After that, it will automatically switch back to the previous window using the Alt + Tab keys.

With AFK Fishing mode, you can engage in other activities such as watching videos, browsing the internet, or reading a book while the bot continues to monitor the bobber in the background. It's important to note that this mode requires DirectX11 (turned on in the game) for proper functionality.

Download 📂

AutoFish 2.1.2 beta Public: Download

AutoFish 2.2.0 beta Premium: Download

The software is open-source, allowing you to clone the repository, review the code, and launch it directly from the command-line interface if you have concerns about downloading the executable file.

If you choose to download the executable file, it functions as a setup file that installs the bot in the following directory: c:/users/your_user/App Data/Local/random_folder/. Additionally, a shortcut with a randomly generated name will be created on your desktop.

If you wish to uninstall the bot, you can do so through the Windows Settings. The uninstaller will have the same name as the shortcut on your desktop.

Please note that if you download a new setup file, it is necessary to uninstall the previous version of AutoFish before proceeding. The application and folder names are generated randomly during each installation, preventing automatic installation of a new version in the previous folder.