User Guide: Jivaro’s OSBot Script Factory Scripts

Written By Harry Negron

Downloading the Scripts & Profiles

Getting Started

What You Need:

  • OSBot.

  • Script Factory.

  • Jivaro’s Script Factory scripts.

  • Jivaro’s OSRS Bot Manager (optional but recommended).

Downloading the Scripts:

  • Two ways of downloading the scripts:

    • Using the Jivaro’s OSRS Bot Manager.

    • Downloading them manually.

  • Two ways of downloading/getting the script profiles:

    • Creating them with the Jivaro’s OSRS Bot Manager.

    • Downloading them manually.

It is important to note that the manager is a Windows App, and it will not work on any other OS. You can find all of this in the Programs section on https://www.jivaro.net.

Downloading the Scripts Via the Jivaro Bot Manager

  1. Navigate to the Programs section and download the Jivaro Old School RuneScape Bot Manager.

  2. Run the program.

  3. On the “Script Factory” panel, click “Update”.

Downloading the Scripts Manually

  1. Navigate to the Programs section and download the Jivaro Script Factory Scripts

  2. Extract the .zip file.

  3. Copy the “FushigiBot” folder directly to your C:\\Users\YOUR_USER\OSBot\Data\ProjectPact\OSRS Script Factory\Private Scripts\

  4. Optional: If the directories do not exist, run Script Factory once or create them yourself.

The folder structure should look like this:

  • ~\Private Scripts\FushigiBot\files\

  • ~\Private Scripts\FushigiBot\scripts\

  • ~\Private Scripts\FushigiBot\scripts-gui\

Creating Profiles with the Jivaro Bot Manager

Run the Bot Manager and navigate to either the “Break Profiles” or “Script Profiles” panel.

  1. To create a Break Profile, follow these steps:

  2. Select the options you wish to enable by ticking the corresponding boxes.

  3. Enter your desired bot and break times.

  4. Choose a name for your break file.

  5. Click save.

To create a Script Profile, follow these steps:

  1. Select the desired script from the dropdown menu.

  2. Enable the options you wish by ticking the appropriate boxes.

  3. Click save.

Downloading the Profiles Manually.

  1. Navigate to the Programs section and download the Jivaro Script Factory Sample Profiles.

  2. Extract the .ZIP file.

  3. Copy the CONTENTS (.txt files) to your C:\\Users\YOUR_USER\OSBot\Data\ProjectPact\OSRS Script Factory\Profiles\

  4. Optional: If the directory does not exist, run Script Factory once or create it yourself.

The folder structure should look like this:

  • ~\Profiles\*.txt

Script Profiles

Getting Started

In Script Factory, Script Profiles allow you to modify parts of a script to change how it functions. For example, you can rename the item "Rune full helm" to "Berserker helm," and the script will update all instances of this iteration within the script accordingly.

To make these changes manually, you would need to create a text file, place it in a specific folder, and specify your changes using the <Find></Find> and <Replace></Replace> tags. However, with the Bot Manager, this process is simplified with an easy-to-use GUI. If you prefer not to use the Bot Manager, you can always utilize the Sample Profiles and edit them accordingly.

Creating Script Profiles with the Jivaro Bot Manager

  1. Run the Bot Manager and navigate to either the “Break Profiles” or “Script Profiles” panel.

  2. If creating a Break Profile, simply tick the options you wish to enable, write in your bot and break times, select the break file name, and click save.

  3. If creating a Script Profile, simply select the script from the dropdown menu, tick the options you wish to enable, and click save.

Creating Script Profiles Manually

  1. Make sure you have downloaded and placed the Script Profile text files in the correct folder as instructed in the “Downloading the Scripts & Profiles” block.

  2. Open the profile file that you wish to edit.

  3. Note: YOU WILL NOT CHANGE ANYTHING WITHIN THE <Find></Find> BRACKETS. You will only change what is in the <Replace></Replace> brackets.

  4. You will have instructions about what kind of value can be written.

    • Some scripts only allow you to write in “true” or “false.”

    • Some scripts will only allow you to select from a list of words.

    • Some scripts will allow you to freely write whatever you want. This is the case for scripts that allow you to use custom gear or food.

  5. Edit the values to your liking, then save the script. Here are some examples of the values you may encounter:

  6. Enable Death Handler: <Find>boolEnableDeathHandler:false</Find><Replace>boolEnableDeathHandler:true</Replace>

  7. Select a Type of Gear (Monk’s Robes) from a List: <Find>None/*/Random/*/DruidsRobe/*/MonksRobe/*/ZamorakMonksRobe</Find><Replace>MonksRobe</Replace>

  8. Use Custom Gear (Berserker helm): <Find>Obsidian helmet</Find><Replace>Berserker helm</Replace>

  9. When you’re done, save the file. DO NOT CHANGE THE FILENAME.

Break Profiles

Getting Started

The same principles discussed in the “Script Profiles” section apply here as well.

All of Jivaro’s scripts come with an active break profile. These breaks are not compatible with OSBot’s in-house breaks, so they must be turned off to avoid a warning message that will halt the script until you click “Ok.”

You can customize both regular breaks and sleep breaks. Regular breaks will activate at consistent intervals, while sleep breaks will trigger after a longer duration. However, there is a known issue with how Script Factory handles timers, which may cause sleep breaks to activate earlier than intended.

Creating Break Profiles with the Jivaro Bot Manager

  1. Open the Bot Manager and navigate to the “Script Profiles” panel.

  2. To use breaks, tick “Enable Breaks” and/or “Enable Sleep Breaks.” These options are not mutually exclusive; you can enable either one or both.

  3. Input the Bot Time and Bot Time Variation values in the provided boxes.

    • Bot Time: Specifies the duration you will bot for.

    • Bot Time Variation: Determines the deviation from the Bot Time. For example, setting a Bot Time of 10 minutes with a Bot Time Variation of 5 minutes will result in a botting duration between 5 and 15 minutes.

  4. Next, input the Break Time and Break Time Variation values in the corresponding boxes.

    • Break Time: Specifies the duration of your break.

    • Break Time Variation: Determines the deviation from the Break Time, expressed as a percentage. For example, a Break Time of 10 minutes with a Break Time Variation of 50% will result in a break duration between 5 and 15 minutes.

  5. The Bot Until Sleep and Sleep Time settings work similarly to these, so apply the same principles when editing them.

Creating Break Profiles Manually

Editing Break Profile files is similar to editing Script Profiles. If you haven’t read that section yet and plan to edit Break Profile files, be sure to check out the Script Profiles section first.

To start editing the values of the Break Profile files, follow these steps:

Download the Break Profile files and place them in the correct folder.

  1. Navigate to the Programs section and download the Jivaro Script Factory Sample Profiles.

  2. Extract the .zip file.

  3. Copy the contents (.txt files) to your `C:\Users\YOUR_USER\OSBot\Data\ProjectPact\OSRS Script Factory\Profiles\` folder.

  4. Optional: If the directory does not exist, run Script Factory once or create it manually.

  5. The folder structure should look like this:

    • ~\Profiles\.txt

Editing the Break Profiles:

  1. Select the file you wish to edit and open it.

  2. All values are in milliseconds, so use a converter or calculator as needed.

  3. Edit the Bot Time & Bot Time Variation values by entering a number within the `<Replace></Replace>` brackets. DO NOT MODIFY THE `<Find></Find>` BRACKETS.

  4. Bot Time: Specifies how long you will bot for.

  5. Bot Time Variation: Specifies how much the Bot Time will vary. For example, a Bot Time of 10 minutes with a Bot Time Variation of 5 minutes will result in a Bot Time ranging from 5 to 15 minutes.

  6. Edit the Break Time & Break Time Variation values by entering a number within the `<Replace></Replace>` brackets. DO NOT MODIFY THE `<Find></Find>` BRACKETS.

  7. Break Time: Specifies how long you will break for.

  8. Break Time Variation: Specifies how much the Break Time will vary, expressed as a percentage from 0.01 (1%) to 1.00 (100%). For example, a Break Time of 10 minutes with a Break Time Variation of 0.50 will result in a Break Time ranging from 5 to 15 minutes.

  9. The Bot Until Sleep and Sleep Time settings work similarly, so follow the same steps when editing them.

    • Examples:

      1. 30 Minutes Bot Time: `<Find>3600000</Find><Replace>1800000</Replace>`

      2. 10 Minutes Bot Time Variation: `<Find>1800000</Find><Replace>600000</Replace>`

      3. 10 Minutes Break Time: `<Find>1200000</Find><Replace>600000</Replace>`

      4. 35% Break Time Variation: `<Find>0.75</Find><Replace>0.35</Replace>`

  10. When you’re done, save the file. DO NOT CHANGE THE FILENAME.

Running the Scripts

Getting Started

There are two primary methods (technically three, but more on that later) to launch the scripts:

  • Launching from the `/scripts/` folder.

  • Launching from the `/scripts-gui/` folder.

If you’re launching from the `/scripts/` folder, you must set a Script Profile; otherwise, the script may not function correctly or at all. On the other hand, if you’re launching from the `/scripts-gui/` folder, setting a Script Profile is unnecessary and even discouraged, as it may unintentionally alter some values when the script launches. Setting up a Break Profile is optional for those who wish to edit or disable the default breaks.

Launching from the /scripts-gui/ Folder

  1. Create a Break Profile at this point if you wish to do so.

  2. Launch OSBot and open Script Factory.

  3. Select “Open” from the Script Factory’s GUI.

  4. Navigate to the `\Private Scripts\FushigiBot\scripts-gui\` folder.

  5. Select the script you wish to launch.

  6. The script will prompt you to select the options you wish to enable or disable, such as automatic restocking, death handling, etc. Go through the prompt and tap the green triangle within the GUI to run the script.

Launching from the /scripts/ Folder

  1. Create a Script Profile by following the instructions in the Scripts Profile section here.

  2. Create a Break Profile at this point if you wish to do so.

  3. Launch OSBot and run Script Factory.

  4. Select “Open” from the Script Factory’s GUI.

  5. Navigate to the \Private Scripts\FushigiBot\scripts\ or \Private Scripts\FushigiBot\files\ folders. Some simpler scripts that function more like addons might be in the latter folder.

  6. Select the script you wish to launch.

  7. Tap the green triangle within the GUI to run the script.

Launching from Jivaro Bot Manager (Recommended)

  1. Create a Script Profile by following the instructions in the Scripts Profile section here.

  2. Create a Break Profile at this point if you wish to do so.

  3. Run the Jivaro Old School RuneScape Bot Manager.

  4. Navigate to the Settings panel and enter your OSBot details, then click save. This information is saved locally at C:\Users\YOUR_USER\Jivaro\Old School RuneScape Bot Manager\.

  5. Click on “Download Java” on that same panel even if you have some form of java installed already.

  6. Navigate to the Script Factory tab and ensure OSBot is downloaded and up to date by clicking the “Download OSBot” button.

  7. Make sure the scripts are up to date by clicking the “Update Scripts” button.

  8. To add your account details, click on “Add Bot.”

  9. Enter all the necessary information for your account. If you are not using a proxy, leave that section blank.

  10. Click on the “Save” button to ensure your bot configuration is saved for future use.

  11. Click on the “Run” button next to the bot you wish to launch.

Harry Negron