Skip to content

Latest commit

 

History

History
139 lines (97 loc) · 6.52 KB

README.md

File metadata and controls

139 lines (97 loc) · 6.52 KB
Raw

Limedrop Guide

About Limedrop

What is it?

Limedrop is a web-based item dropper; it is a program that will manage joining games and dropping specific items.

How do I install it?

Limedrop is an API added to D2Bot # and a web-based frontend. The d2bot-with-kolbot kolbot has Limedrop built in.

How does it work?

There are two parts to Limedrop. One part is the API, and one part is a web page that calls the API. The web page can be accessed at www.limedrop.org

When the web page requests an item, Limedrop will launch the configured profile, join the game specified, and drop the item(s) selected.

Self-hosting

If you want to access the latest version, use www.limedrop.org, if you would like to host the static front-end yourself, you can download it blizzhackers/limedrop and copy it to the "Limedrop" folder of your d2bot-with-kolbot download. To access locally use http://localhost:8080.

If you're using Git to clone d2bot-with-kolbot it will ask you if you want to automatically download the sub-repository.

Hosted (recommended)

You can also use the externally hosted version here: http://www.limedrop.org

The benefit of this version is that it is always up-to-date

Note: If you want to access Limedrop from an external network you will need to open router ports. The frontend only delivers the static site, it uses your instance of D2Bot to power the API. Note, the Limedrop API has not been security tested so if you choose to open your network externally, you need to assume all risks associated with that.

Setup Limedrop

  1. Download the Limedrop version from here or clone from: https://github.com/blizzhackers/kolbot.git

  2. Extract to a folder: Extracted Files

  3. Edit the server.json config file:

    • Server Config File
    • Server Config Edit
    • This default config says to:
      • Use the D2BS profile called "GameAction"
      • Create a user with the name "public", password "public" who is not able to drop items
      • Create a user with the name "test", password "test" who is able to drop items
      • The path to the web page files are in the "\limedrop" folder underneath the D2BS directory
      • The IP we will respond on is "localhost" (also known as 127.0.0.1)
        • If you want to access from another computer, you will need to use your real local IP like 192.168.1.100
      • The Port we will listen on is 8080

  4. Turn on D2Bot and enable the Limedrop API by going to "Settings" and clicking the enable API option.

  5. Follow the standard setup guide for adding cdkeys.

  6. Create a new profile, we will use GameAction for an example - this needs to match what is in server.json

    • Make sure you set your own game name to avoid conflicts with other people
      • Add Profile
    • Make sure you use the D2BotGameAction.dbj as the Entry Script

Using Limedrop

To start Limedrop, just open D2BS.exe . You DO NOT have to launch the profile manually. Limedrop will launch the profile on its own when it needs to do something.

Logging In

  • To login, either go to http://www.limedrop.org or your self-hosted page
  • At the upper right, click the profile icon to log in:
    • Login
    • Enter your server address (including port) according to your server config
    • Enter your username
    • Enter your password
    • Click Login
      • Right now you have to manually click Login. You cannot just press enter.

Muling Options

  • You can create a profile using the standard MuleLogger profile
    • All mules logged this way will appear in the Limedrop web page

The creation of games was removed from limedrop, so don't try to log mules/accounts with it, because in some cases limedrop was creating a new game and it was dropping items, then left that game.

Emergency Stop

You may notice that if you "stop" the GameAction profile that it immediately starts up again.

If you need to force the profile to stop you need to open the profile and erase the "tag" information.

  • Edit Profile
  • Erase information in Tag
  • Click Apply
  • Stop the profile

Note: If you have queued many drops, you will need to clear it for each drop, or you will need to restart D2BSharp.

Frequently Asked Questions

Will Limedrop steal my information?

No. The web page part of Limedrop only makes calls to the API running on your D2BS. Your account passwords are not stored directly in the web page. Also, it's open source so if you don't trust it you can always take a look at the code yourself!

Can it run side-by-side with my existing bots?

Yes. If you want to quickly try Limedrop you can copy it to a separate folder and configure it

Can I use my existing mule logs with Limedrop?

No. You will have to re-scan your existing mules in order to add them to the Limedrop Inventory

Will Limedrop automatically update my inventory after dropping items?

Yes.

How to select all items in limedrop?

Just type this in your address bar on the limedrop page:

javascript:document.querySelectorAll('#items-list>div').forEach(el => el.click())

Works in chrome, but might take a while depending on item count. Make sure that all items are loaded beforehand (scroll to the end as long as new items are loaded) (thanks discord/@ToDoWaldi#8021)