Boat Eye on Wayland

Before setting up boat eye, first setup waywall for window resizing, magnifiers and sensitivity changes.

For boat eye, Wayland users have 2 main methods to change your mouse's sensitivity:

• Waywall sensitivity
  • Uses mcsr-calcsens.
  • Lets you decrease your sensitivity automatically when you change to tall resolution, or manually with either a mouse button or keyboard key (not limited to mouse buttons like usual).
  • Also easily allows the use of a "god sensitivity" without changing how the mouse feels whatsoever.
    • With a god sens, the default boat mode in Ninjabrain Bot may be set to green boat, removing the need to get in a boat and F3+C to get green boat before measuring, assuming you haven't steered a boat at any point beforehand.
  • Does not require increasing DPI/decreasing pointer speed, avoiding any issues with other games that do not have a raw input option or when using your mouse on other PCs.
• Windows-like setup + raw input/DPI toggle
  • This mirrors what you would do on Windows, which involves changing your mouse's DPI and your system's pointer speed to ensure things feel the same after changing your Minecraft sensitivity.
  • Quickest to setup if your mouse's DPI is already set accordingly, i.e. if you had boat eye set up on Windows beforehand.

Method 1: Waywall sensitivity

Skip steps 1.1 and 1.2 if you've never set up boat eye before.

1.1: Find DPI and Minecraft sens for Windows sens of 10

• Go to the Waywall Boat Eye Utility Website.
• Input your DPI, Minecraft Sensitivity and Windows Sensitivity on the "Reverse Boat Eye Calculator".
• Note down the new DPI and Minecraft sens.

1.2: Configure your mouse DPI

• Using your mouse's software, change your DPI to the final DPI you noted in the previous section, or the closest possible value.
  • If your mouse is in this list of devices, install and use either piper or ratbagctl to configure its DPI.
  • If you have a Razer mouse, install and use openrazer.
  • If your mouse doesn't have a Linux driver, you will need to boot back into Windows, use a Windows VM (if you're daring enough), or another device with Windows installed to configure its DPI.
    • OR use software like maccel instead.
      • In the Sens Multiplier field in maccel, input the new DPI you found in the previous section divided by 1000. For example, if your new DPI was 350, change the Sens Multiplier to 0.350.
  • Note that not using the exact DPI will not affect the accuracy of your eye measurements.

1.3: Get new waywall and boat eye sensitivities

• Go back to the Waywall Boat Eye Utility Website.
  • You could use the original mcsr-calcsens python program if you prefer.
• Input the new Minecraft sens you got from step 1.1 on "MCSR Calcsens Online".
  • If you skipped step 1.1, instead input your current Minecraft sens from options.txt.
    • You can find your current options.txt sensitivity by right clicking your instance in Prism Launcher > Folder > minecraft > options.txt > searching for mouseSensitivity.
• Note down the outputs.

1.4: Setup your waywall config

• If you're using one of Gore's pre-made configs, see the section below.
• If you're using your own config:
  • Set config.input.sensitivity to the "New normal sensitivity coefficient" given by mcsr-calcsens.
  • Use waywall.set_sensitivity() to change your sensitivity when moving to tall and back to normal.

1.4.1: Gore config setup

• Generic Config

  • Find this line in config.lua:

    local sens_change = { enabled = false, normal = 1.0, tall = 0.1 }
    

  • Set enabled to true, and normal and tall to the normal and tall sensitivity coefficients from mcsr-calcsens.

• Barebones Config

  • Find these lines in init.lua:

    -- ==== SENSITIVITIES ====
    local normal_sens = 1
    local tall_sens = 0.1
    

  • Set normal_sens and tall_sens to the sensitivity coefficients from mcsr-calcsens.

1.5: General boat eye setup

• Set your Minecraft sensitivity to what was given by mcsr-calcsens.
  • Remember to update your sensitivity in minecraft/config/mcsr/standardsettings.json if you're using StandardSettings, otherwise just change minecraft/options.txt.
• Complete the steps from 2:30 to 3:40 in this boat eye setup video.
• In Ninjabrain Bot options > Optional Features > Boat Measurements, set the Default boat mode to "Green boat (with boat angle of 0)".
• Finally, turn off raw input ingame (change it in StandardSettings if you're using it) - the waywall sens will only take affect if you do this.

Method 2: Windows-like setup

2.1: Converting Windows sensitivity

• Convert your Windows cursor speed to the corresponding Linux pointer speed using the following table:

2.2: Change sensitivity in your settings

• With the value from the table above, change your pointer speed in your compositor's configuration.
• Below are some examples for some common compositors.

KDE

• Press Alt+F2 to open KRunner, and search for "mouse settings".
• Set "Pointer speed" to your new sensitivity.

Hyprland

• Open the Hyprland config file in a text editor: ~/.config/hypr/hyprland.conf.

• If you haven't added your devices config yet, run hyprctl devices in your terminal and you'll see an output like this:

  $ hyprctl devices
      ...
  
      Input Device: turtle-beach-burst-ii-air-mouse
  
      ...
  

• Then add the following block of code to the config file, setting the name to what you got from the previous step, and sensitivity to your new sensitivity:

  # eg: for a windows sensitivity of 3
  device {
      name = turtle-beach-burst-ii-air-mouse
      accel_profile = flat
      sensitivity = -0.875
      natural_scroll = false
  }
  

• Save the file and reload your config with hyprctl reload.

Sway

• Open your config file in a text editor: ~/.config/sway/config.

• If you haven't added your devices config yet, run swaymsg -t get_inputs in your terminal and you'll see an output like this:

  $ swaymsg -t get_inputs
      ...
      Input device:Turtle Beach Burst II Air Mouse
      Type: pointer
      Identifier: 4341:20482:Turtle_Beach_Burst_II_Air_Mouse
      ...
  

• Then add the following block of code to the config file, setting the input identifier to what you got from the previous step, and pointer_accel to your new sensitivity:

  # eg: for a windows sensitivity of 3
  input "4341:20482:Turtle_Beach_Burst_II_Air_Mouse" {
      natural_scroll disabled
      accel_profile "flat"
      pointer_accel -0.875
  }
  

• Save the file and reload your config with swaymsg reload.

2.3: General boat eye setup

• Complete the steps from 2:30 to 3:40 in this boat eye setup video.

Measuring an eye

• After setting your sensitivity with one of the methods above, watch the boat eye setup video from 5:24 for an example boat eye measurement.
  • On either of Gore's template configs, the default key for tall resizing & magnifying is F4.
  • If you followed the waywall sensitivity method above, note that you can skip pressing F3+C when exiting the boat - the boat icon on Ninjabrain Bot should be green by default.
    • This is made possible by using the god sens in Minecraft and the specific waywall sensitivity values given by mcsr-calcsens.