Documentation

nAgility User Manual

Train Agility on rooftop courses with automatic progression, food/stamina management, and mark of grace collection.

Links: TRiBot Store | Forum Thread | Discord


Table of Contents


Quick Start

Easiest option - Ez-Add 1-99:

  1. Start the script with your character logged in anywhere
  2. Click the "Ez-Add 1-99" button in the Progressive Mode panel
  3. This automatically configures the optimal training path:
    • Draynor (1-20) → Al Kharid (20-30) → Varrock (30-40) → Canifis (40-50) → Falador (50-60) → Seers' Village (60-70) → Pollnivneach (70-80) → Rellekka (80-90) → Ardougne (90-99)
  4. Click Start

Manual setup:

  1. Log in near the agility course you want to train on
  2. Select the course from the "Agility Course" dropdown
  3. Optionally enable food banking if you take damage from failed obstacles
  4. Optionally enable stamina potion banking for run energy maintenance
  5. Click Start

Script Arguments

Load a saved settings profile by passing the profile name as a script argument:

MyProfile

This loads <tribot-folder>/nScripts/nAgility/settings/MyProfile.ini and starts immediately without showing the GUI. Useful for automation and automatically starting scripts on clients.

Additional options:

  • last - Load the most recently used settings
  • Profiles saved to nScripting.com Settings Storage can also be loaded by name

Requirements

Skill Requirements

Each course has a minimum Agility level requirement:

Course Level Required
Draynor Rooftop 1
Al Kharid Rooftop 20
Varrock Rooftop 30
Canifis Rooftop 40
Falador Rooftop 50
Colossal Wyrm Basic 50
Seers' Village Rooftop 60
Colossal Wyrm Advanced 62
Pollnivneach Rooftop 70
Prifddinas 75
Rellekka Rooftop 80
Ardougne Rooftop 90

Quest/Location Requirements

Course Requirements
Canifis Rooftop Access to Morytania (Priest in Peril)
Prifddinas Song of the Elves quest completed
Colossal Wyrm Access to Varlamore

Items Needed

  • Food (optional): For healing damage from failed obstacles at lower levels
  • Stamina potions (optional): For maintaining run energy on longer courses
  • GP: If using GE restocking to auto-buy supplies

How It Works

The script runs agility courses by:

  1. Finding the next obstacle: Identifies which obstacle in the course sequence is reachable
  2. Navigating to obstacles: Walks to obstacles that are out of reach
  3. Completing obstacles: Clicks obstacles and waits for animations to finish
  4. Collecting marks of grace: Automatically picks up marks that spawn on the course
  5. Managing supplies: Banks for food/stamina when inventory runs out (if enabled)
  6. Tracking progress: Counts laps, obstacles, XP gained, and marks collected

For the Prifddinas course, the script also handles the unique portal shortcuts that randomly appear, and uses the ladders to loop back after completing the course.

For the Colossal Wyrm courses, the script will automatically talk to Worm Tongue to unlock the course on first use if needed.


Settings Reference

Agility Course Selection

Agility Course

  • Select which course to train on
  • The dropdown is searchable - type to filter courses
  • Defaults to the closest course to your current location

Bank for food when out

  • When enabled, banks to restock food when inventory is empty
  • Useful at lower levels when you frequently fail obstacles and take damage

Food Type

  • Select which food to use
  • Choose based on your Hitpoints level and budget

Food Quantity

  • How many pieces of food to carry (1-28)
  • Higher values mean less frequent banking

Bank for stamina potions

  • When enabled, banks to restock stamina potions when out
  • Recommended for courses with lots of running between obstacles

Stamina Potion Quantity

  • How many stamina potions to carry (1-10)
  • Potions are automatically drunk when run energy drops below a threshold

Progressive Mode

Progressive mode allows you to automatically switch courses as you level up.

Use progressive mode

  • Enable to use the progression task list instead of a single course
  • Tasks run sequentially until their stop condition is met

Add Task

  • Adds the currently selected course configuration to the task list
  • Prompts you to enter the Agility level to stop at

Update Selected Task

  • Updates the selected task with current course settings
  • Also allows editing the stop conditions

Remove Selected Task

  • Removes the selected task from the list

Ez-Add 1-99

  • Automatically populates the optimal 1-99 training progression
  • Uses rooftop courses that award marks of grace
  • Progression: Draynor → Al Kharid → Varrock → Canifis → Falador → Seers' Village → Pollnivneach → Rellekka → Ardougne

Task List

  • Shows all configured progression entries
  • Drag and drop to reorder tasks
  • Double-click to load a task's settings into the main panel

Advanced Settings

Access advanced settings via the "Advanced" button in the script shell.

Food GE Restocking

  • Enable GE restocking for food: Automatically buys food from the Grand Exchange when your bank runs out
  • Number of inventory setups to buy: How many complete inventory setups worth of supplies to purchase at once
  • Only works when food or stamina banking is enabled in the main GUI

Other Categories

  • Utility: Discord webhooks, auto-bond, failsafes, logout settings
  • Antiban: AFK mode, mini-breaks, ABC2, artificial delays
  • Controls: Basic controls, preferred zoom level
  • Muling: Configure automatic muling of marks of grace or GP
  • World Hopping: Automatic world hopping settings
  • Stop Conditions: Stop after reaching a level, runtime, or XP goal

Supported Courses

Course Level XP/Lap Marks of Grace Notes
Draynor Rooftop 1 120 Yes Good starter course
Al Kharid Rooftop 20 216 Yes 8 obstacles
Varrock Rooftop 30 270 Yes 9 obstacles
Canifis Rooftop 40 240 Yes Best marks/hr until Ardougne (no 20-level penalty)
Falador Rooftop 50 586 Yes 13 obstacles, longest rooftop
Colossal Wyrm Basic 50 504 No Low-intensity, awards termites
Seers' Village Rooftop 60 570 Yes 6 obstacles
Colossal Wyrm Advanced 62 750 No Low-intensity, better XP than basic
Pollnivneach Rooftop 70 890 Yes 9 obstacles
Prifddinas 75 1,340 No Awards crystal shards, portal shortcuts
Rellekka Rooftop 80 780 Yes 7 obstacles
Ardougne Rooftop 90 889 Yes Best marks/hr at high level

Note: Mark of grace spawn rates are reduced to 20% once you are 20 levels above a course's requirement, except for Canifis which is unaffected. The Ez-Add 1-99 progression accounts for this.


Troubleshooting

"Progressive mode is enabled but no progression entries are configured"

Cause: You enabled progressive mode but didn't add any tasks to the progression list.

Fix: Either disable progressive mode and select a single course, or add progression entries using the "Add Task" or "Ez-Add 1-99" buttons.

"We need to eat, but don't have any food"

Cause: Your HP is low and you need to eat, but you have no food and food banking is disabled.

Fix:

  • Enable "Bank for food when out" in the settings
  • Or manually add food to your inventory before starting
  • Or ensure your bank has food if banking is already enabled

Getting Help

If you run into issues not covered in Troubleshooting:

  1. Generate a bug report - In TRiBot: Dev Tab → Generate Bug Report (includes logs, settings, and screenshot)
  2. Post on Discord - Share the zip and describe what happened vs. what you expected at discord.gg/BFtypSSbjp

For issues that are hard to capture in a screenshot, a short screen recording helps.


Tips

  • Start with Ez-Add 1-99 if you're training from a low level. The progression is optimized for both XP rates and mark of grace collection.

  • Enable food banking at low levels when you frequently fail obstacles. Once you stop failing on a course, you can disable it to save banking time.

  • Stamina potions are most useful on longer courses like Falador, Pollnivneach, and Prifddinas where you spend more time running.

  • Prifddinas course awards crystal shards instead of marks of grace, and has random portal shortcuts that speed up laps. The script automatically uses these when they appear.

  • Colossal Wyrm courses never fail and are very low-intensity (only 6 clicks per minute on advanced). They award termites instead of marks of grace, which can be exchanged for amylase packs that convert to marks.

  • Mark spawn rates decrease once you're 20 levels above a course's requirement. The Ez-Add progression switches courses at optimal levels to maximize mark collection. If you specifically want marks over XP, consider staying at Canifis longer since it's exempt from this penalty.

  • Ardougne Rooftop at 90+ is the best course for marks of grace per hour at high levels, and marks stack on a single tile so you won't miss despawns.