Skip to content

Bee Swarm Simulator - A low-level collection of functions for interfacing with BSS to create your own macros

Notifications You must be signed in to change notification settings

FaethyvveIcye/bss

Repository files navigation

Bee Swarm Simulator Macros & Functions

What is this?

Our attempt at providing a powerful & easily extensible / editable function list for BSS beekeepers to create their own macros. Additionally, an open-source alternative to potentially dangerous compiled executables or less-powerful JitBit macros prevalent in the BSS community.

Features

  • Easily configurable hotkeys, such as the default CTRL+P to play, CTRL+Q to stop
  • Reconnect to the game if you lost connection or the server restarted
  • Set cooldowns for any task (such as bug running every 20/30/60/any minutes, wealth clock every hour, ant pass every 2 hours) that persist through macro sessions
  • Place 1-4 sprinklers, jumping as necessary automatically
  • Support for emptying the hive balloon if desired
  • Fully configureable planter support & management including harvesting, replacing, and rotating them through fields defined in config.ini

How to Use

  1. Download & Install Autohotkey
  2. Download this code and it's dependencies (Code -> Download ZIP) & unzip it into a directory of your choice.
  3. Edit config.ini to your liking (NOT configuration.ahk - run reset config.ahk first if you don't have a config.ini file).
  4. Put your sprinkler in the first slot of your hotbar ingame.
  5. Run an included example such as sunf +bca.ahk or pine balloon.ahk or any user-created file, default hotkeys are CTRL+Q to stop, and CTRL+P to play.

Troubleshooting

  • Make sure your screen resolution is at least 800x600.
  • Make sure Windows Display Scaling is set to 100% (default).
  • If you have a dedicated GPU, make sure you don't have any settings enabled which change image fidelity (such as AI-powered resolution upscaling, system-wide anti-aliasing, etc.) - note that these are usually off by default.
  • Any of the three above issues can cause repeated reconnections due to the functions not properly detecting if you're connected or in-game, and you may have to recapture or resize the pictures inside the errors and images folders.
  • If your wind shrine donations aren't functioning properly, you may need to recapture wind_shrine_next_item.png due to the way roblox draws this character differently for every resolution.
  • Make sure you have your sprinkler in the first slot, and have edited config.ini
  • You can try running the reset config.ahk file and re-editing the fresh config.ini if these functions worked for you in the past but stopped working.

Creating Your Own Macros

  • Browse through the comments inside functions.ahk to create your own macro, or take a look at the implementation in the included examples for ideas or inspiration. For example, the sunf +bca macro:
    • Reconnects if disconnected
    • Activates the Wealth Clock every hour
    • Uses the free Ant Pass dispenser every 2 hours
    • Kills & loots Mondo Chick (make sure your system time is set correctly if you do this)
    • Does a bug run every 30 minutes, turning in polar bear quests & killing vicious bees on the way through
      • Note: See the warnings in functions.ahk
    • Farms in sunflower field if it's not time to grab clock/ant/mondo/bugs
    • Empties the hive balloon if it hasn't been emptied in the last 30 minutes
  • pine balloon.ahk implements some newer features, such as:
    • Activating Beesmas machines
    • Placing, harvesting, looting, and rotating planters through fields as defined in config.ini
    • Donating to the Wind Shrine & activating a field booster
    • Farming Pine Tree Forest in a unique way designed for using the Tide Popper

About

Bee Swarm Simulator - A low-level collection of functions for interfacing with BSS to create your own macros

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published