Home - MrKinau/FishingBot GitHub Wiki

What exactly is this?

This is a bot for Minecraft to automate fishing. Technically it's a headless Minecraft Client, so there is no need for a running Minecraft Instance. It is also able to run it completely without any GUI using the -nogui option (more options).

How do I use the bot?

Important

Oracle ended shipping JavaFX from it's legacy Java 8 builds since March 2025. As this application is built upon JavaFX the GUI won't work if you still use Java 8. Your options are:

  1. Use a somewhat recent Java version (everything above Java 11 should work) (e.g. Oracle JDK or Eclipse Temurin JRE or JDK or Azul Zulu JRE or JDK)
  2. If you are dependend to legacy Java 8, you can use Azul Zulu Java 8 JRE FX which still contains a maintained version of JavaFX within legacy Java 8.
  1. Download the latest .jar-File and save it in an empty folder.
  2. Run the bot with Java. (Either double clicking or RIGHT CLICK → Open with... and select something like Java, JRE, JDK) to start the application.
  3. In the opened window click on Settings and adjust them to your needs (you can set the server you want the bot to connect there).
Video

open_fishingbot

Click on the Gif to open it on YouTube.

How do I connect to a server?

  1. Setup the bot as described in How do I use the bot? above.
  2. Adjust the settings to your needs and make sure to set your server address/port.
  3. If the version can not be detected automatically (i.e. BungeeCord or version detection not working) set the "Default MC version" to the version you want the bot to use.
  4. Close the settings, click on Start and get guided through the authentication process. Once authenticate the bot will connect to the server and start fishing.
Video

run_fishingbot

Click on the Gif to open it on YouTube.

How do I connect to Realms?

  1. Setup the bot as described in How do I use the bot? above.
  2. In the settings tick the checkbox "Use realms (Select realm at first start)" and accept the Realms ToS by ticking the checkbox "Accept the Realms ToS".
  3. Start the bot. It should display the possible realms in a dialog. Select your desired realm and click "ok". If the realm you want the bot to connect to is not listed make sure the invitation is accepted by the used account.

How can I use the bot with a 3rd party launcher (MultiMC/PolyMC/Prism Launcher)?

  1. Download the latest .jar-File.
  2. Create a new instance in MultiMC/PolyMC/Prism Launcher.
  3. Click "Edit Instance" » Select the "Version" tab » "Replace Minecraft.jar" » Select the previously downloaded FishingBot.jar
  4. Launch the instance with any account you've configured in your launcher.
Video

onesix

Click on the Gif to open it on YouTube.

How do I use the bot without GUI? (Windows)

  1. SHIFT + RIGHT CLICK at a free space in the folder where you've downloaded the jar
  2. Click on "open PowerShell window here"
  3. In the upcoming console type java -jar FishingBot-X.X.X.jar -nogui (replace X.X.X with the correct version)
  4. The bot should start and all it's console output is visible in the PowerShell-Console

Where can I report a bug or request a feature

You can report bugs or request new features it in the issues section or join the official Discord and get support there.

Troubleshooting

See Troubleshooting

Config-Options

See Config

Command-Line-Options

See Command-Line-Options

Bot-Commands

See Commands

Use the bots docker image

See Use with docker

Add a custom footer
⚠️ **GitHub.com Fallback** ⚠️