ALBot

Installation Debian 8

1. Update system

   sudo apt update
   sudo apt upgrade
   

2. Install packages

   sudo apt install git nano screen curl
   

3. Install nvm

   curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.37.2/install.sh | bash
   bash
   

4. Use nvm to install node 7.9.0

   nvm install stable
   

5. Download ALBot

   git clone https://github.com/NexusNull/ALBot.git
   

6. Install package dependencies

   cd ALBot
   npm install 
   

7. Rename copy config file and enter credentials. If you don't know how, refer to Section Understanding userData.json

   cp userData.example.json userData.json
   nano userData.json
   

8. Run the bot once with

   node main
   

   The bot will then try to log in to your account and save your character ids to userdata.json

9. Open userData.json again and delete all the character objects you don't want to run. However, there currently is no client side check for character limitations, if you forget this your bot will keep disconnecting.

10. Congratulations you now have a working copy of ALBot, if you experience unexpected behavior please raise an issue.

Installation Windows

1. Install git https://git-scm.com/download/win

2. Install node https://nodejs.org/en/download/

3. open folder in which you would like to install ALBot

4. shift + Right Click -> Open Command Window Here

5. execute the following commands in the console

   git clone https://github.com/NexusNull/ALBot.git
   cd ALBot
   npm install
   copy userData.json-example userData.json
   

6. Open the config file (userData.json) in your favorite editor and enter your credentials. If you don't know how, refer to Section Understanding userData.json

7. Run the bot once with

   node main
   

   The bot will then try to log in to your account and save your character ids to userdata.json

8. Open userData.json again and delete all the character objects you don't want to run. However, there currently is no client side check for character limitations, if you forget this your bot will keep disconnecting.

9. Congratulations you now have a working copy of ALBot, if you experience unexpected behavior please raise an issue.

Understanding userData.json

Config

With ongoing updates the properties of config are becoming more and more complex, so I want to take some time to explain them in detail here.

fetch

The fetch property sets the bot up in a way that it will discard any existing data about characters and then try to fetch them from the server. This is set to true when ever you recieve a fresh copy of ALBot simply because ALBot needs to get this information first before anything else can be done. The fetched data is then put into the the "bots" array ready for editing.

botWebInterface

Bot-web-interface or BWI is another module that I developed which displays data using a graphical interface. Granted it doesn't look as fancy as I would like it to, but it does its job. ALBot uses BWI to display basic information about the running characters, this information is constanty updated without requiring user interaction.

As you can see it contains the name and level but also TLU which stands for 'time to level up'. BWI also has the option to display and update pictures, we use this here to automatically display what the bot sees and what is happening around it. The green dot represent the current character, red dots are monsters and red lines are attacks. White lines are the collision boxes of the map.

BWI can be enabled/disabled by setting the start property, by default this is set to false. One thing to note is that BWI uses 2 consecutive ports meaning with you want to expose BWI to the internet by port forwarding you will have to port forward the port listed here and one higher. If need be I can change that behaviour but as long as nobody complains it's staying that way. If you do decide to open BWI to the internet, there is still the option to protect it with a password so only you can access it. Such a setup can be useful if you have it running on a server but want to check up on it from work.

First a word of caution, the mini map is a nice little feature that has been added recently and is still not as polished as I want it to be. The way the mini map is implemented is very hacky, it works by sending data url converted PNG images to the client, high frame rates can cause many issues such as high cpu usage on the server side and GPU crashes on the client side. I recommend a frame rate of 1.

If you want to enable the mini map, set enable to true. The speed property determines the interval in which images are generated and send to the client, you can make it faster by decreasing the speed value. Size controls the resolution of the generated image.

{
    "config": {
        "fetch": true,
        "botKey": 1,
        "botWebInterface": {
            "start": false,
            "port": 2080,
            "password": "",
            "minimap": {
                "enable": false,
                "speed": 1000,
                "size": {
                    "height": 200,
                    "width": 376
                }
            }
        }
    },
    "login": {
        "email": "[email protected]",
        "password": "password123456"
    },
    "bots": []
}

If you have questions and/or suggestions please refer to repo. If fetch is set to true, it will fetch your character data on the next run. This means previous entries in bots will be overwritten.

By default, the bot will connect to the server, fetch the data for all available characters and then close again. After the fetch is complete, you can edit the CODE script that is run for each character, and the server it should connect to.

The character name is irrelevant when running ALBot. The bot will use the character id to identify the character and only refer to its name if the id is missing. The runScript entry must contain a relative path to the script that should be run for the character. server is the server name the character should connect to, the possible servers are "US I", "US PVP". There used to be more but sadly they were taken down.

Running your own code

The default code located at ./CODE/default.js, the runScript entry in userData.json corresponds with the name of the script that should be run for the character. The environment is fundamentally the same as a browser with some exceptions, for example references to window, document, and PIXI are not supported. Every character can run a different file, the default.js script will send characters to farm tiny crabs on the main beach.

Contributing

Feel free to make contributions, they are always welcome!