UoPilot is a powerful automation tool frequently used for gaming and repetitive desktop tasks. Its scripting language allows users to simulate mouse clicks, keystrokes, and complex logic like loops and conditional checks.
Below is a comprehensive guide to the essential script commands in UoPilot, categorized by their function. 1. Mouse Control Commands
These commands are the bread and butter of UoPilot, allowing the script to interact with the UI.
left [x y]: Performs a left mouse click at the specified coordinates. If coordinates are omitted, it clicks at the current cursor position. right [x y]: Performs a right mouse click.
move [x y]: Moves the cursor to the specified coordinates without clicking.
drag [x1 y1] [x2 y2]: Simulates a click-and-drag motion from the first set of coordinates to the second. double_left [x y]: Executes a double left-click. 2. Keyboard Simulation
Commands used to input text or trigger hotkeys within an application.
send Key: Sends a specific keystroke. For example, send Enter or send f.
say [text]: Types out an entire string of text. This is often used for automated chat messages.
keydown Key / keyup Key: Holds a key down or releases it. This is useful for simulating long presses (e.g., holding 'W' to move forward in a game). 3. Logic and Flow Control
To make a script "smart," you use logic commands to react to changes on the screen.
if [condition] / else / end_if: The standard conditional block. uopilot script commands
Example: if 100, 200 16777215 checks if the pixel at (100, 200) matches a specific color code.
while [condition] / end_while: Repeats a set of commands as long as the condition remains true.
for #i 1 10 1 / end_for: A standard loop that runs a set number of times (in this case, 10).
goto [label]: Jumps the script execution to a specific :label elsewhere in the code. 4. Color and Image Detection
These commands allow UoPilot to "see" what is happening in the window.
get color #var [x y]: Grabs the color code of a pixel at coordinates (x, y) and saves it to a variable.
findcolor (x1 y1 x2 y2) (color) %result: Searches a defined rectangular area for a specific color. The coordinates of any matches are stored in the %result array.
findimage (x1 y1 x2 y2) (image_path) %result: A more advanced version of findcolor that looks for a specific image (.bmp) within a region. 5. Variables and Math
set #var [value]: Assigns a numerical value to a variable (variables starting with # are local, $ are strings).
set #result #var1 + #var2: Performs basic arithmetic. UoPilot supports addition, subtraction, multiplication, and division. 6. Script Utilities
wait [ms]: Pauses the script for a specified number of milliseconds. This is crucial for preventing the script from running faster than the game can react. UoPilot is a powerful automation tool frequently used
stop_script: Immediately ends the execution of the current script.
log [text]: Outputs information to the UoPilot log window, which is essential for debugging complex scripts. Best Practices for Scripting
Use Window Handles: Use the set workwindow command to bind UoPilot to a specific window. This ensures clicks go to the right place even if the window isn't in the foreground.
Add Delays: Always include small wait commands between actions. Instantaneous clicks often trigger anti-cheat systems or cause the UI to glitch.
Relative Coordinates: When possible, use coordinates relative to the active window rather than absolute screen coordinates so the script works even if you move the window.
Send keystrokes to the active window.
| Command | Syntax | Description |
|---------|--------|-------------|
| SEND | SEND "text" | Types the given string. |
| SENDK | SENDK KeyCode | Sends a special key (e.g., ENTER, TAB, F1). |
| KEYDOWN | KEYDOWN KeyCode | Presses a key without releasing. |
| KEYUP | KEYUP KeyCode | Releases a key. |
Common KeyCodes:
ENTER, TAB, ESC, SPACE, BACKSPACE, F1-F12, A-Z, 0-9. Also modifiers: CTRL, ALT, SHIFT.
Example 1: Type a message and press Enter.
SEND "Hello from UOPilot"
SENDK "ENTER"
Example 2: Save a file (Ctrl+S) – you must use KEYDOWN/KEYUP for modifiers.
KEYDOWN "CTRL"
SENDK "S"
KEYUP "CTRL"
WAIT 500
SEND "myfile.txt"
SENDK "ENTER"
| Command | Description |
|---------|-------------|
| log text | Print to console/log |
| logclear | Clear log |
| fileread filename,var | Read file contents into var |
| filewrite filename,text | Write text to file (overwrite) |
| fileappend filename,text | Append text to file | Part 4: Keyboard Simulation Commands Send keystrokes to
To automate any application, you must first target its window.
| Command | Syntax | Description |
|---------|--------|-------------|
| WINACT | WINACT Title | Activates (brings to foreground) the window containing "Title". |
| WINCLS | WINCLS Title | Closes the window. |
| WINMAX | WINMAX Title | Maximizes the window. |
| WINMIN | WINMIN Title | Minimizes the window. |
| WINSIZ | WINSIZ Title, X, Y, W, H | Resizes and moves the window. |
| WINGET | WINGET VarName, Title | Gets the handle of a window into a variable. |
Practical example: Activate and resize Notepad.
WINACT "Notepad"
WAIT 500
WINSIZ "Notepad", 0, 0, 800, 600
Pro tip: Use partial window titles. WINACT "Note" will activate Notepad if no other window matches better.
Before diving into commands, understand the basics:
.uop (plain text – edit with Notepad).COMMAND parameter1, parameter2.// for single-line comments.Example of a minimal script:
// My first UOPilot script
WAIT 1000
SEND "Hello World"
Now, let’s explore the core commands.
These commands simulate player interaction with the game world.
| Command | Description |
|---------|-------------|
| getcolor x,y,var | Store pixel color in var |
| ifcolor x,y,color,jmp label | Jump if pixel matches color |
| waitcolor x,y,color,timeout | Wait for pixel to become color |
| waitchange x,y,timeout | Wait for pixel to change |
| waitnot x,y,color,timeout | Wait for pixel to not be color |
Color format: Hexadecimal RRGGBB (e.g., FF0000 = red)