StractiAI is a powerful, vision-based automation platform designed to create, manage, and deploy sophisticated bots for any game or desktop application. By analyzing the screen just as a human does, StractiAI avoids intrusive methods, offering a safer and more flexible way to automate tasks.

This guide will walk you through everything from the initial setup of your environment to building complex, multi-step bots with conditional logic. Whether you're a beginner or an experienced scripter, you'll find all the information you need here.

Before you can build your first bot, you need to set up your account and local environment correctly. Follow these steps carefully.

Step 1: Prerequisites

The StractiAI desktop client relies on two essential pieces of software. Please install them before proceeding:

• Node.js (Version 20): The client runs on the Node.js environment. You must use Version 20. If you have another version installed, please uninstall it first. You can get the correct version here: Download NodeJS v20.
• Python (Version 3.10+): Python is used for underlying computer vision tasks. You can download the latest version here: Download Python.

Step 2: Your Account PIN

Your PIN is the key that links your web account to the desktop client. You must generate one to use the software.

1. Log into your StractiAI account on the website.
2. Open the Settings panel (usually via the user icon or menu).
3. Navigate to the Setup Guide
4. You must first have an active subscription. Your unique PIN will be displayed.
5. Important: Keep this PIN safe and do not share it. You will need it to connect your client.

Step 3: Download and Unzip the Client

The StractiAI desktop client is available for download after you have an active subscription or trial. You can find the download link in the Setup Guide tab within the Settings panel on the website. Once downloaded, unzip the file to a permanent location on your computer (e.g., C:\StractiAI) or desktop.

A "Client" in StractiAI is a connection to a machine where a game or application is running. The client setup script allows you to connect machines on your local network or anywhere else.

On the Web Dashboard:

1. Click Add New Client to open the setup wizard.
2. Choose to set up a Local Client (same PC) or an External Client (different PC/VM).

For a Local Client:

1. In the client folder, run node setup.js.
2. Select Setup a Local Client from the menu.
3. Enter your Account PIN when prompted (first-time only).
4. Choose the application window you want the bot to interact with from the list.
5. The script will generate a temporary Pairing Code. Copy it.
6. Back on the web dashboard, give your client a name and paste the Pairing Code to finish.

For an External Client:

1. On the web dashboard, select "External Client", enter a name, and click Generate Connection Key. Copy the key.
2. On the external machine, run node setup.js and select Setup an External Client.
3. Paste the Connection Key when prompted. The machine is now linked to your account.

The main dashboard is where you manage all your clients and bots from a single interface.

• Connected Clients List: On the left, you'll see all your configured clients. You can see their status (Online, Offline, Running) and select one to manage.
• Client Control Panel: When you select a client, this central panel becomes active. Here you can see a live view of the client's screen, assign a bot to it, and use controls like Start, Stop, and Pause.
• Bot Library: This section lists all the bots you have created.
• Recently Ran: A history of your recent botting sessions for quick access.

StractiAI is built to handle automation across multiple machines from a single interface.

Client States

• Running: The client is connected and a bot is actively running.
• Paused: The client is connected, but the assigned bot has been paused.
• Idle: The client is connected and waiting for a bot to be started.
• Offline: The client is not connected to the StractiAI service.

Split View

For users running bots on multiple clients, Split View is an essential feature. Click the Split View icon in the control panel to see a live grid of all your active clients. This provides a command-center overview of all your automation tasks at once.

The Bot Editor is where you'll build, test, and refine your automation tasks. It features a powerful, color-coded timeline and an intuitive interface.

• Timeline Categories: Actions are organized into three color-coded categories: Search (visual detection), Action (clicks, key presses), and Timing (delays).
• Drag & Drop: Easily reorder actions by dragging and dropping them on the timeline.
• Enable/Disable Commands: Temporarily disable any action or an entire row to debug specific parts of your logic without deleting anything.
• Bot Tabs: Work on multiple bots at once. Each bot opens in its own tab, and your session is saved automatically.

A bot in StractiAI is a Task. A Task contains a timeline of Actions that are executed in sequence. Let's build a simple bot that finds an object and clicks it.

Step 1: Create a New Bot

From the main page, click the "Add Client +" button and select Create New Bot.

This takes you to the Bot Editor. In the left panel, click "Create Bot", give it a name (e.g., "My First Miner"), and click on it to open its timeline.

Step 2: The Target Action

Every bot must begin with a Target action. This is the primary object the bot will look for to start its sequence.

1. Make sure your game or application is running and visible on the client machine.
2. In the Bot Editor, click the "Target" tool from the toolbelt on the left.

3. On the live stream image, click and drag a box around the object you want the bot to find.

4. A [Save Frame] button will appear. Click it to create the first action on your timeline.

Step 3: The Click Action

Now, let's tell the bot what to do after it finds the target. Click the "Click" tool from the toolbelt. This action is automatically added to the timeline and tells the bot to left-click the center of the object it just found.

Step 4: Save and Run Your Bot

Click the main "Save" button for the bot. To run it, ensure your client is running and press the "Start" button in the control panel.

The timeline is the heart of your bot. It's a sequence of actions executed from left to right. Understanding how to manipulate it is key to building powerful bots.

• Assets vs. Regions: An Asset is the specific image you want to find (e.g., a copper ore rock). A Region is a larger area on the screen where the bot should limit its search (e.g., only the inventory panel). Using regions makes detection faster and more accurate.
• Modify Selection: Right-click an action and choose this to change the image asset(s) it looks for.
• Update Region: Right-click an action and choose this to change the rectangular area the action searches in, without changing the image asset.

StractiAI offers several detection modes to handle different situations with precision.

• Regular Mode: The standard image-matching mode. It looks for an exact visual match of the asset you provided.
• Color-Only Mode: Ignores shape and looks only for a specific color or HSV range. Perfect for targeting health bars, glowing items, or other color-defined elements.
• Hybrid Mode: The most powerful option. It combines both shape (Regular) and color matching, drastically reducing false positives by requiring both criteria to be met.

Debugging Detections

The overlay provides visual feedback with color-coded bounding boxes to help you debug:

• Red: A successful match! Confidence is at or above your threshold.
• Orange: A near miss. Confidence is very close to the threshold.
• Yellow: A medium miss. Confidence is further from the threshold.
• Light Blue: A distant miss. Confidence is significantly below the threshold.

The Multi-Target handling mode is a massive efficiency boost for bulk tasks. Instead of finding and acting on objects one by one, it finds all of them at once and then acts on them sequentially.

Example: Dropping a full inventory.

• Single Mode (Old): Scan -> Find Fish #1 -> Drop Fish #1 -> Scan -> Find Fish #2 -> Drop Fish #2... (28 scans total)
• Multi Mode (New): Scan once -> Find all 28 fish -> Drop #1, Drop #2, ... Drop #28. (1 scan total)

This is ideal for dropping, looting, or crafting multiple items in a row.

You can assign multiple, independent search zones to a single command. This allows for precise targeting without needing to create complex scenarios or duplicate tasks.

Example: Mining two specific rocks.

Instead of making two separate tasks, you can use one "Find Ore" command. Right-click it, select "Modify Region," draw a box around the first rock, click "Add Region," then draw a box around the second rock and click "Add Region" again. The bot will now only search in those two specific areas.

An Action Set is a powerful macro that condenses a complex sequence of actions into a single block on your timeline. It's designed to clean up repetitive logic like Find -> Click -> Delay.

Instead of a long, cluttered timeline, you can create one Action Set that contains all the steps. You can even set a "Master Search Area" from the initial target, forcing all subsequent steps to search only within that region.

Scenarios are pre-planned "what if" routines that you attach to an action. They allow your bot to react intelligently to different outcomes.

• On Failure: Define what the bot should do if it fails to find its target (e.g., after 3 failures, run a "get unstuck" scenario).
• On Success: Trigger a special subroutine the moment an action succeeds.

Each Scenario has its own separate timeline. You can even chain multiple "On Failure" scenarios to a single action; the bot will try each one in sequence until one succeeds.

Focus Mode

When you set up logic that jumps between actions (Go to Action, Start Task), new icons will appear on your timeline. Click an icon to enter Focus Mode, which draws a line to the connected action and fades everything else out for perfect clarity.

The VisionAI action allows you to give the bot instructions in plain English. Instead of manually creating Find and Click actions, you can add a VisionAI action to the timeline with a prompt like "find the nearest tree and click on it". This feature enables more dynamic and flexible bot behavior with minimal setup.

These settings, found in the main settings panel, fine-tune the core behavior of the botting engine.

• Prioritization: Control how the bot selects a target when multiple are found (e.g., prioritize objects inside a radius, near the edge of the radius, or anywhere on screen).
• Object Properties: Adjust AI sensitivity by setting the required color tolerance and visual complexity for a valid target.
• Interaction Radius: Visually define the bot's search area with a slider or expand it to the whole screen.
• Object Dimensions: Filter targets by size, setting a min/max width and height to ignore incorrectly-sized objects.
• Mouse Simulation: Choose between Direct Input (no visible mouse), Specialized Mouse (cursor visible for specific games), or Default.

A safety feature to prevent misclicks. You now have granular control over its behavior.

• Wait Until Player is Still: When on, the bot waits for your character to stop moving before acting. Disable for faster reactions.
• Wait Until Target is Still: When on, the bot waits for the target to stop moving. Disable to act on moving targets.

You can turn both off for instant triggers the moment a target is found.

You can completely personalize the animated cursor shown in the overlay to match your style. This provides better visual feedback and allows for a more customized feel.

Cursor Appearance

• Shape: Choose from classic pointer, dot, crosshair, or chevron styles.
• Style: Make the cursor a solid, filled-in shape or a clean, hollow outline.
• Pulsing Effect: Enable a subtle "breathing" animation to make the cursor pulse gently.

Trail Effects

• Style: Select a trail style like 'Comet' (smooth fade), 'Dotted' (fading dots), or 'Ghosting' (faint echoes of the cursor).
• Color: Apply a gradient to the trail for a rainbow-like color shift.
• Sparkles: Add a glittering particle effect that follows the cursor's movement.

Movement & Animation

• Personality: Choose 'Realistic' (human-like curve), 'Robotic' (straight line), or 'Playful' (slight overshoot).
• Event Animations: Trigger a ripple or particle burst effect when the cursor arrives at its destination or performs a click.
• Takeover Mode: When your real mouse hovers over the client window, it takes control of the animated cursor, hiding your system cursor for seamless interaction.

World Objects are a powerful, community-driven feature that allows users to create, share, and use pre-defined object definitions. Instead of manually creating assets for a common item, you can simply use a World Object from the library.

• Public Library: Browse a public repository of objects created by other users for various games.
• My Objects: Create and manage your own private library of objects. You can choose to submit your objects for public review.
• One-Click Use: Add a World Object to your timeline as a `Target` or `Find` action with a single click.

You can now save any individual task as a reusable Template, share it with a link, and browse powerful templates from the community. This is perfect for sharing specific logic without sharing an entire bot.

• Save & Reuse: Right-click any task and select "Save as Template..." to snapshot your work.
• Template Manager: A new manager gives you access to Public Templates, your own creations, and a list of templates you've installed.
• Share with a Link: Mark templates as Public to generate a shareable link. Visitors can see a rich preview and install the template into their own bots with two clicks.

The Marketplace is the central hub for sharing and discovering complete, ready-to-run bots. Recent updates have fixed issues with downloading shared bots, including those that use StractiAI detection and Scenarios, ensuring a smooth experience.

Client won't start or shows an error.

• If Windows shows a SmartScreen warning ("Windows protected your PC"), click More info → Run anyway. This is normal for a new application.
• Ensure you extracted the entire Stracti folder and are running run.bat from inside it.

The bot isn't finding my Target object.

• Try re-creating the Target asset with a tight selection box.
• In the action's Settings, try lowering the Confidence Threshold.
• Use the advanced Detection Filtering (Hybrid or Color-Only) to isolate the object.
• Enable the low-confidence bounding boxes to see what the bot is detecting, even if it's not a full match.

The live stream view is cropped or the wrong size.

• This is almost always caused by Windows Display Scaling. Right-click your desktop -> Display settings -> set "Scale" to 100%.
• Stracti V3 now includes intelligent UI scaling to improve reliability on different resolutions, but setting your display to 100% is still the best practice.