Chimpeon Help

Welcome to the Chimpeon Help. Please take time to read it.

NOTE: Click here to view the help for Chimpeon Legacy.

Contents

1. 1. Introduction
2. 2. Getting Started
3. 3. Configuration Basics
4. 4. Profiles
5. 5. Triggers
6. 6. Conditions
7. 7. Actions
8. 8. Threads
9. 9. Pixel Detection
10. 10. Keys and Mouse
11. 11. Macro
12. 12. Status Hot Keys
13. 13. Preferences
14. 14. Log
15. 15. Troubleshooting

1. Introduction

Chimpeon is a software application that automates almost any game that runs under windows - even Android games in an emulator and games streamed from another computer. It does this by performing actions such as pressing a key when certain conditions are satisfied such as a pixel in the game window being detected. Whether you want to perform a combat rotation in an MMORPG, target an enemy in an FPS, automatically respond to in-game prompts, or simply prevent AFK, Chimpeon is your perfect automation partner.

NOTE: Other than being able to detect pixels within a game, Chimpeon does not know what the game is actually doing (i.e. it does not analyse game code). Therefore, do not expect it to perform actions that a bot dedicated to a particular game is developed to do.

1.1 Terminology

The following table lists general terms that are not described elsewhere in the Chimpeon Help:

Introduction

2. Getting Started

In this section, the following information is provided:

• 2.1. System Requirements
• 2.2. Downloading
• 2.3. Installing
• 2.4. Launching
• 2.5. Files
• 2.6. Interface Overview
• 2.7. Starting and Stopping
• 2.8. Account, Licence and Activation
• 2.9. Updating
• 2.10. Specifying Proxy Settings
• 2.11. About Chimpeon
• 2.12. Exiting
• 2.13. Uninstalling

2.1. System Requirements

Chimpeon has the following system requirements:

• Windows 10/11 (64 bit)
• Internet connection

2.2. Downloading

Chimpeon can be downloaded using the following url:

chimpeon.com#download

2.3. Installing

To begin the installation process, double-click the Chimpeon setup program (Chimpeon_n_Setup.exe) then follow the on-screen instructions.

During installation you are prompted to specify an installation path and folder. The folder name specified will be the name adopted by the Chimpeon exe, process, Start menu folder and shortcut, desktop shortcut and taskbar name.

If another instance of Chimpeon is already launched during the installation process, a Notification window prompting you to exit is opened. Click the Yes button to exit Chimpeon and continue with installation. This usually occurs when updating Chimpeon.

NOTE: To ensure the setup has not been tampered with and is created and published by Fly Software, "Fly Software Ltd" will appear as the Verified Publisher in the Windows User Account Control window that is opened at the start of installation. Do NOT install Chimpeon unless Fly Software Ltd are the verified publisher.

2.4. Launching

To launch (run) Chimpeon, click the Chimpeon option in the Chimpeon folder on the Windows Start menu, or double-click the Chimpeon shortcut icon (see Fig. below) on the Windows Desktop.

Fig. Chimpeon shortcut icon

NOTE: The Chimpeon option and Chimpeon folder name on the Windows Start menu and the name of the Chimpeon shortcut icon on the Windows Desktop, will reflect the name of the folder specified during installation.

2.4.1. Multiple Instances Using the Same Account on the Same PC

When Chimpeon is launched, the account used to activate it is checked for a valid licence. If found, this licence is associated with this instance of Chimpeon. If another instance of Chimpeon on the same PC is activated with the same account or is launched when the same account was previously used to activate it, it is associated with the same licence (even if other valid licences are available). As a result, the previous instance of Chimpeon is no longer associated with the licence and the time restriction is enforced. This process continues for all instances of Chimpeon launched on the same PC. This is because these instances of Chimpeon all have the same ID.

To ensure different instances of Chimpeon using the same account on the same PC are associated with different valid licences, each one must be assigned a different ID. To do this, perform the following actions:

1. Locate a Chimpeon shortcut or create one.
2. Right-click the shortcut then select Properties to open the Chimpeon Properties window (see Fig. below).
3. Click the Shortcut tab.
4. In the Target edit box, specify the following after the chimpeon.exe file name and end quote:
   ID
   For example:
   "C:\Program Files\Chimpeon\chimpeon.exe" ChimpeonA
5. Click the OK button to close the Chimpeon Properties window.

Fig. Chimpeon Properties window (Shortcut tab) (Windows 10)

Repeat the actions above for each instance of Chimpeon that needs to be associated with a different valid licence. Use a different ID (e.g. ChimpeonB) at point 4.

Use the shortcuts created to launch each instance of Chimpeon. Following this, activate each instance.

When an ID is applied, the ID appears in the Title bar of the Main interface and in the About window. This helps to quickly identify instances of Chimpeon.

NOTE: The number of valid licences available in the account used to activate each instance of Chimpeon must match or exceed the number of Chimpeon instances being launched on the same PC.

2.4.1.1. ID Rules

When applying an ID to the Target, the following rules apply:

• a to z
• A to Z
• 0 to 9
• -{}
• No spaces
• Maximum 38 characters

NOTE: Invalid characters are removed within Chimpeon.

EXAMPLE: If Chimpeon@Me was applied to the Target, ChimpeonMe would be used as the ID within Chimpeon.

2.4.2. Launch Windows

When Chimpeon is launched, the following windows may open:

• Notification
• Update
• Critical Update

2.4.2.1. Notification

If a notification is available, the Notification window (see Fig. below) is opened (if the option to do so is enabled) when Chimpeon is launched. Click the OK button to close the Notification window and continue launching. To view further details about the notification, click the Click here link to open the Notifications page on the Chimpeon website in the default browser.

Fig. Notification window

MORE: For further details about enabling and disabling the opening of the Notification window when Chimpeon is launched, refer to Preferences > General Settings > Check For Notification On Launch.

2.4.2.2. Update

If an update for Chimpeon is available, the Update window (see Fig. below) is opened (if the option to do so is enabled) when Chimpeon is launched.

MORE: For further details about the Update window, refer to Getting Started > Updating.

MORE: For further details about enabling and disabling the opening of the Update window when Chimpeon is launched, refer to Preferences > General Settings > Check For Update On Launch.

2.4.2.3. Critical Update

If a critical update for Chimpeon is available, the Critical Update window (see Fig. below) is opened when Chimpeon is launched.

MORE: For further details about the Critical Update window, refer to Getting Started > Updating.

2.5. Files

During installation or after Chimpeon is launched for the first time, the following files are created:

*NOTE: The Chimpeon folder name and Chimpeon executable file is determined by the name specified for the installation folder during installation.

2.6. Interface Overview

The Main interface (see Fig. below) is where Chimpeon is configured, started and stopped.

Fig. Main interface

The Main interface contains the following components:

2.6.3. Menus and Associated Options

The following menus and associated options are provided:

2.6.3. Using Panels and Managing Items

The main interface contains panels (see Fig. below) that contain items such as Profiles, Triggers, Conditions and Actions. All panels can be resized and each normally enables items to be selected, added, deleted, duplicated, cut, copied, pasted and moved.

Fig. Panel (Triggers)

2.6.3.1. Resizing

Panels can be resized either vertically, horizontally or both.

To resize a panel, perform the following actions:

1. Position the mouse pointer over the resize grabber (see Fig. below).
2. Click and hold the primary mouse button.
3. If the resize grabber is horizontal, move the mouse up and down. If the resize grabber is vertical, move the mouse left and right.
4. Release the mouse button when the panel is the required size.

Fig. Resize Grabber (horizontal)

2.6.3.2. Selecting Items

The Profiles panel, Triggers panel, Conditions panel and Actions panel contain items that will need to be selected when configuring Chimpeon.

To select an item in a panel, click anywhere within its row. Following this, a white dot appears to the left of the selected item to indicate it is selected.

2.6.3.3. Adding an Item

The Profiles panel, Triggers panel, Conditions panel and Actions panel can have items added.

To add an item to a panel, click the Add button ().

2.6.3.4. Deleting an Item

The Profiles panel, Triggers panel, Conditions panel and Actions panel contain items that can be deleted.

To delete an item from a panel, perform the following actions:

1. Select the item.
2. Click the Delete button () to open a Confirm Delete window.
3. Click the Yes button to close the Confirm Delete window and delete the item. Click the No button to close the Confirm Delete window and cancel the delete.

2.6.3.5. Duplicating an Item

The Profiles panel, Triggers panel, Conditions panel and Actions panel contain items that can be duplicated.

To duplicate an item in a panel, Select the item then click the associated Duplicate button ().

2.6.3.6. Cutting an Item

The Triggers panel, Conditions panel and Actions panel contain items that can be cut (removed) from the panel ready for pasting within the same type of panel.

To cut an item in a panel, Select the item then click the associated Cut button ().

2.6.3.7. Copying an Item

The Triggers panel, Conditions panel and Actions panel contain items that can be copied ready for pasting within the same type of panel.

To copy an item in a panel, Select the item then click the associated Copy button ().

2.6.3.8. Pasting an Item

Items cut or copied from the Triggers panel, Conditions panel or Actions panel can be pasted within the same type of panel.

EXAMPLE: A Trigger cut or copied from the Triggers panel of Profile A, can be pasted within the Triggers panel of Profile B.

To paste an item that has been cut or copied, click the Paste button () in the panel where the item needs to be pasted within.

2.6.3.9. Moving Items

The Profiles panel, Triggers panel, Conditions panel and Actions panel contain items that can be moved up and down in the list.

To move an item in a panel, perform the following actions:

1. Select the item.
2. Move the mouse cursor over the top of the selected item's white dot.
3. Click and hold the mouse button.
4. Move the mouse up to move the item up in the list. Move the mouse down to move the item down in the list.
5. Release the mouse button when the item is in the required position.

2.6.1. Showing and Hiding Compact View

To ensure Chimpeon does not obscure the game window, the Compact View interface can be shown instead of the Main interface. As a result, only a Title bar and a Start/Stop button are displayed (see Fig. below).

Fig. Compact View interface

To show the Compact View interface and hide the Main interface, click the Compact View button on the Title bar of the Main interface.

To hide the Compact View interface and show the Main interface, click the Main View button (red circle) on the Compact View Title bar.

2.6.1.1. Automatically Showing When Started

When configuration of Chimpeon is complete, it will likely be beneficial to show the Compact View interface automatically when Chimpeon is started - especially if only one monitor is being used. Click the Show Compact View When Started checkbox next to the Compact View button to add and remove a tick. Add a tick to automatically show the Compact View interface when Chimpeon is started. Remove the tick to prevent the Compact View interface being automatically shown when Chimpeon is started.

2.6.2. Keeping Everything On Top

To force the Main interface and all Chimpeon windows to stay on top of other application and game windows, click the Options menu then click the Stay On Top option to add a tick to it. Remove the tick to prevent the Main interface and all Chimpeon windows staying on top.

2.6.3. Enabling and Disabling Sound

Starting and stopping Chimpeon, Triggers being fired and Status Hot Keys being used can all be configured to play a sound. To enable or disable all of these sounds, the Play Sounds setting in the Main interface is provided.

Click the Play Sounds checkbox to enable or disable sound. A tick enables sounds to be played. Blank prevents sounds from being played.

2.7. Starting and Stopping

Chimpeon must be started before the tasks associated with the selected Profile are performed.

Click the Start button (see Fig. below) or the Start/Stop Hot Key to start Chimpeon.

Fig. Start button

Click the Stop button (see Fig. below) or the Start/Stop Hot Key to stop Chimpeon.

Fig. Stop button

The following processes also stop Chimpeon:

• Chimpeon is not activated and the time restriction countdown expires.
• The Stop option for an Action's Perform setting is performed.
• A configuration setting is changed.
• The game specified for the Profile's Send To setting is not launched/running.
• Configuration settings are reloaded or saved.
• A Profile is imported.
• An error is encountered.

Chimpeon will also temporarily stop when the menus or certain Chimpeon windows are focused and will start again when they are unfocused.

2.7.1. Troubleshooting

If Chimpeon does not do anything when started, refer to Troubleshooting.

2.7.2. Monitoring Automation

The Log is used to view the processes being performed while Chimpeon is started.

MORE: For further details about the Log, refer to Log.

2.6.3 Start/Stop Hot Key

To provide a quick and easy mechanism for starting and stopping Chimpeon without the need to click the Start and Stop button, a Start/Stop Hot Key can be specified. When pressed, Chimpeon is started if stopped and stopped if started.

2.7.3.1. Configuration Settings

The following configuration settings are associated with the Start/Stop Hot Key:

2.7.3.2. Specifying a Modifier Key

The Shift, Ctrl and Alt settings determine whether a corresponding modifier key should be pressed at the same time as the key specified for the Start/Stop Hot Key setting.

Click the Shift, Ctrl or Alt setting checkbox then click it again to add or remove a tick. A tick indicates the associated key must be pressed. Blank indicates the associated key is not used.

2.7.3.3. Specifying a Key

The Start/Stop Hot Key setting determines the key used to start and stop Chimpeon.

To specify a key, perform the following actions:

1. Click the Start/Stop Hot Key setting edit list box.
2. If an existing key already exists, delete it then type a key, or
3. Click the arrow to the right of the Start/Stop Hot Key setting edit list box.
4. Click the name of the key in the list.

2.7.4. Start and Stop Sounds

When Chimpeon is started and stopped, default sounds are played (that say Start and Stop). These sounds can be changed as required.

To change the Start or Stop sound, perform the following actions:

1. Click the File button () to the right of the Start or Stop setting edit box.
2. In the Open window, locate and select the required sound (WAV) file then click the Open button.

The Open window now closes and the path and file name of the selected sound file appears in the Start or Stop setting edit box.

NOTE: The Play Sounds setting must be enabled before sounds are played.

2.7.4.1. Default Sounds

MORE: For details about where the default start and stop sound files are located, refer to Getting Started > Files.

2.7.4.2. Preventing Start and Stop Sounds Being Played

To prevent start and stop sounds being played (without disabling the Play Sounds setting), click inside the Start or Stop setting edit box then delete the existing path and file name (i.e. make the edit box blank).

2.8. Account, Licence and Activation

By default, Chimpeon can only be started for a short period of time until it is automatically stopped. To remove this time restriction the following actions must be performed:

1. Sign up for an account
2. Buy a licence
3. Activate Chimpeon

2.8.1. Signing Up for an Account

To sign up for an account, use the following url:

chimpeon.com#signup

2.8.2. Buying a Licence

To buy one or more licences and automatically add them to the account specified during the purchase process, use the following URL:

chimpeon.com#buy

2.8.3. Using Chimpeon Without Activating

If an account containing a valid licence has not been used to activate Chimpeon, a time restriction is enforced.

The time restriction is initially set to approximately 10 minutes and begins to count down when Chimpeon is started. The countdown stops when Chimpeon is stopped and begins again when Chimpeon is started from the point at which it was last stopped.

EXAMPLE: The time restriction is 10 minutes. Chimpeon is started then stopped after 8 minutes. The remaining time restriction is 2 minutes.

When the time restriction countdown reaches 0 Chimpeon is automatically stopped and a Chimpeon Stopped window (see Fig. below) is opened.

Fig. Chimpeon Stopped window

The OK button in the Chimpeon Stopped window has a 30 second countdown. When the countdown expires, click the OK button to close the Chimpeon Stopped window. Chimpeon can then be started again at which point the time restriction countdown begins again.

2.8.4. Activating

To remove the time restriction Chimpeon must be activated. In essence this process associates Chimpeon with a valid licence in a specified account.

To activate Chimpeon, perform the following actions:

1. Click the Help menu then click the Activate option to open the Activate window (see Fig. below).
2. Specify the email and password of an account containing a valid licence.
3. Click the OK button.

Fig. Activate window

If activation is successful, the Activate window is closed and an Activation Successful window is opened. Click the OK button to close this window.

If activation is unsuccessful, a window is opened describing why activation failed. Click the OK button to close this window and try the activation process again.

2.8.5. How Chimpeon Associates Itself with a Valid Licence

Following successful activation and each time Chimpeon is launched after activation, Chimpeon is associated with a valid licence held in the account specified during activation. Chimpeon will try to associate itself with a valid licence using the following priority:

1. A valid licence that the instance of Chimpeon was previously associated with.
2. A valid licence that is not associated with an instance of Chimpeon.
3. A valid licence that is associated with another instance of Chimpeon. It uses the licence with the oldest activation date applied to it.

2.8.6. When Instances of Chimpeon Exceed the Available Valid Licences

If Chimpeon is forced to associate itself with a valid licence that is associated with another instance of Chimpeon (i.e. there are not enough valid licences in the account for all instances of Chimpeon), this instance of Chimpeon no longer uses the licence and the time restriction is enforced. The time restriction is only removed if this instance of Chimpeon is activated or launched again, at which point the instance of Chimpeon that uses a licence with the oldest activation date, has its licence used and the time restriction enforced.

This association with a valid licence is suitable when multiple instances of Chimpeon will be used independently. However, if multiple instances of Chimpeon need to be used concurrently, a licence for each one must be purchased or instances will continually lose their licence and have the time restriction enforced when other instances are activated or launched.

EXAMPLE If you run three instances of Chimpeon independently then only one licence is required. If you run three instances of Chimpeon concurrently, then three licences are required.

MORE: For details about launching multiple instances of Chimpeon on the same PC, refer to Launching > Multiple Instances on the Same PC.

2.8.7. Checking Licence Validity

The number of days a licence associated with Chimpeon remains valid and subsequently how long Chimpeon remains activated, is shown in the About window (see Fig. below) and on the Licences page of the Chimpeon website:

chimpeon.com/account/licences

MORE: For further details about the About window, refer to Getting Started > About Chimpeon.

2.9. Updating

Chimpeon occasionally has new features added and issues fixed. When this occurs, a new version of Chimpeon is released and it is advised the current installation is updated. The update process can be started when Chimpeon is launched or at any time after launch.

2.9.1. When Launching

If a Chimpeon update is available, an Update window (see Fig. below) is opened (if the option to do so is enabled) when Chimpeon is launched.

Fig. Update window

To start the update process, click the Yes button. Following this, the Download page on the Chimpeon website is opened in the default browser and the latest version of Chimpeon begins to download. To cancel the update process (which is not recommended), click the No button.

Following download, Chimpeon will need to be installed.

MORE: For further details about enabling and disabling the opening of the Update window when Chimpeon is launched, refer to Preferences > General Settings > Check For Update On Launch.

2.9.2. After Launching

To see if an update is available any time after launching click the Help menu then click the Update option.

If an update is available the Download page on the Chimpeon website is opened in the default browser and the latest version of Chimpeon begins to download.

If an update is unavailable, an Update unavailable window (see Fig. below) is opened notifying you of this.

Fig. Update Unavailable window

Alternatively, use the following URL to download the latest version of Chimpeon:

chimpeon.com#download

Following download, Chimpeon will need to be installed.

2.9.3. Critical Updates

There may be an occasion when Chimpeon requires a critical update. When this occurs, a Critical Update window (see Fig. below) is opened when Chimpeon is launched.

Fig. Critical Update window

The Critical Update window will continue to appear when Chimpeon is launched and Chimpeon cannot be used until the update is performed.

To start the critical update process, click the Download button. Following this, the Download page on the Chimpeon website is opened in the default browser and the latest version of Chimpeon begins to download. To cancel the critical update process and exit Chimpeon, click the Exit button.

Alternatively, use the following URL to download the latest version of Chimpeon:

chimpeon.com#download

Following download, Chimpeon will need to be installed.

2.10. Specifying Proxy Settings

If the PC/laptop that Chimpeon is installed on uses a proxy server to connect to the Internet, proxy settings must be specified before Chimpeon can be used.

When Chimpeon is first launched on a PC/laptop where a proxy is used, a Connection Error window is opened. This is because Chimpeon cannot connect to the Internet because proxy settings have not yet been specified. To specify proxy settings, click the Proxy Settings button in the Connection Error window. Following this, the Preferences window (see Fig. below) is opened.

The following proxy settings are provided:

When all settings are specified, click the OK button to save the proxy settings and close the Preferences window.

MORE: For details about opening the Preferences window, refer to Preferences

CAUTION: Specifying invalid proxy settings will cause the Chimpeon server to be inaccessible and prevent Chimpeon from being activated.

2.11. About Chimpeon

The Chimpeon version, ID, EULA, copyright information and licence details are viewed in the About window (see Fig. below).

Fig. About window

To open the About window, Click the Help menu then click the About option.

To close the About window, click the Close button.

2.12. Exiting

To exit Chimpeon, click the File menu then click the Exit option. Alternatively, click the Exit button (red circle) on the Title bar.

If configuration settings have changed since the last save, a Confirmation window is opened asking you to confirm whether you want to save them. Click the Yes button to save then exit. Click the No button to not save then exit. Click the Cancel button to not save, close the Configuration window and not exit.

2.13. Uninstalling

To uninstall Chimpeon, use the Add or Remove Programs feature in Windows.

Getting Started

3. Configuration Basics

In this section, the following information is provided:

• 3.1. Overview
• 3.2. Configuration Settings

3.1. Overview

Configuring Chimpeon is relatively simple and consists of a four-step process:

1. Add a Profile then specify the game you want to interact with.
2. Add one or more Triggers to the selected Profile. Normally one Trigger is added per task that needs to be performed.
3. Add one or more Conditions to the selected Trigger then configure what each Condition should do (e.g. detect a pixel or wait for a timer). This creates an Expression.
4. Add one or more Actions to the selected Trigger then configure what each Action should do (e.g. press a key or mouse button) when the associated Expression is satisfied.

MORE: If Chimpeon does not interact with a game, refer to Troubleshooting

3.1.1. The Relationship Between Profiles, Triggers, Conditions and Actions

To successfully configure Chimpeon, it is important to understand the relationship between Profiles, Triggers, Conditions and Actions. The following diagram demonstrates this:

Fig. The relationship between Profiles, Triggers, Conditions and Actions

3.2. Configuration Settings

Configuration settings determine what Chimpeon does and how it interacts with a game when started. Profiles, Triggers, Conditions and Actions have configuration settings that can be manipulated to perform tasks.

3.2.1. Storage

Configuration settings for all Profiles and their associated Triggers, Conditions and Actions, are stored in a single configuration file.

MORE: For details about the default location of the configuration file, refer to Getting Started > Files

3.2.2. Loading

Configuration settings contained in the configuration file are automatically loaded when Chimpeon is launched.

3.2.3. Reloading

To reload configuration settings, click the File menu then click the Reload option. Following this, a Confirmation window is opened asking you to confirm the reload. Click the Yes button to reload or the Cancel button to cancel.

CAUTION: When reloading, changes to configuration settings made after the last save are lost.

3.2.4. Saving

To save the current configuration settings, click the File menu then click the Save option.

CAUTION: When saving, configuration settings already stored in the configuration file are overwritten.

3.2.5. Importing Legacy Configuration Strings

Configuration strings exported from Chimpeon Legacy cannot be imported into the current version of Chimpeon. This is because the differences between the two are considerable making an import unreliable or impossible. Use the current version of Chimpeon to replicate and improve configurations previously created using Chimpeon Legacy.

Configuration Basics

4. Profiles

In this section, the following information is provided:

• 4.1. Overview
• 4.2. Configuration Settings
• 4.3. Managing
• 4.4. Naming
• 4.5. Selecting a Game
• 4.6. Importing and Exporting

4.1. Overview

A Profile is a container for one or more Triggers. Each Profile determines the game Chimpeon interacts with while started and represents the overall task that Chimpeon performs.

EXAMPLE: If you want to automate a combat rotation for a warrior in an MMORPG then you would add a Profile to accomplish this.

Profiles are displayed and managed in the Profiles panel (see Fig. below).

Fig. Profiles panel

The selected Profile determines the Profile used and the game Chimpeon interacts with while started.

NOTE: Multiple Profiles cannot be selected and used while Chimpeon is started.

4.2. Configuration Settings

Each Profile has the following configuration settings:

4.3. Managing

Profiles can be selected, added, deleted, duplicated, cut, copied and moved.

MORE: For details about these processes, refer to Getting Started > Interface Overview > Using Panels and Managing Items.

4.4. Naming

The Name setting of a Profile should normally represent the overall task it performs.

EXAMPLE: If you need to automate a combat rotation for a warrior in an MMORPG you could name the Profile, "Warrior Combat Rotation".

To name a Profile, perform the following actions:

1. Click inside the Name setting edit box of the Profile.
2. Delete the existing name.
3. Type a name.

NOTE: There is a 100 character limit for the Name setting.

4.5. Selecting a Game

Each Profile can interact with a single game, and before Chimpeon can be started, a game must be selected.

To select a game (or any application that is running) for a Profile, perform the following actions:

1. Click the Send To setting list box of the Profile.*
2. Click the arrow to the right of the Send To setting list box.
3. Click the name of the game in the list.

*NOTE: The game must be running for it to appear in the Send To setting list box.

4.5.1. Finding and Selecting a Specific Game Window

The games listed in the Send To setting list box reflect the main window of each game, and selecting one normally allows Chimpeon to successfully interact with it. However, some games have one or more windows within their main window (see Fig. below) and one of these may need to be selected for the following reasons:

• So keystrokes and mouse actions are successfully sent to the game
• To specify Live.
• To specify the Scan Area.

To select a window within the main window of a game, perform the following actions:

1. Click the Send To setting list box of the Profile.
2. Move the mouse cursor over an area of the game you think may be a window.
3. Press then release the Ctrl key.

Following this, the name of the game appears in the Send To setting list box. If it is the main window of the game it will only be the name of the game that appears. If it is a window within the main window of the game it will be the name of the game followed by a semicolon (;) and a number that appears.

EXAMPLE: If Kill All Monsters is the name of the main window, Kill All Monsters;3 could be a window within the main window.

NOTE: If Chimpeon does not automate a game, selecting a window within the main window of the game is one of the first things to try. Remember, a game can sometimes contain multiple windows, so find, select and try each one.

4.5.1. Dealing With Multiple Instances

If multiple instances of the same game (or application) are running, select the required Profile then click the associated Instance speed buttons until the required instance number is shown.

The first game launched is Instance 1. When the same game is launched again it becomes Instance 1 and the first game becomes Instance 2. If the second game is exited, the first game becomes Instance 1.

4.6. Importing and Exporting

A Profile (including all of its Triggers, Conditions and Actions) can be imported and exported as a Profile File (.pro).

NOTE: Configuration strings exported from Chimpeon Legacy cannot be imported into the current Chimpeon, and Profile Files exported from the current Chimpeon cannot be imported into Chimpeon Legacy.

4.6.1. Importing

Profiles are imported as Profile Files (.pro) which can be obtained from numerous places including the Profiles page on the Chimpeon website:

chimpeon.com/support/profiles

To import a Profile File, perform the following actions:

1. Save/download the Profile File from its source (e.g. chimpeon.com or Discord) to a location accessible by the computer where Chimpeon is installed.
2. Click the Import Profile button () in the Profiles panel to open the Import Profile window (see Fig. below).
3. Click the Open button in the File Name edit box to open an Open window.
4. Locate then select the required Profile File.
5. Click the Open button.
6. Optionally click the Send To list box then click the name of the game the Profile is intended for.*
7. Click the OK button.
8. If a Send To Not Specified window appears and you intended not to select a Send To, click the Yes button, otherwise click the No button.

Fig. Import Profile window

If the import is successful a Profile Imported window is opened. Click the OK button to close the Profile Imported window. The Profile that was stored in the Profile File now appears at the bottom of the Profiles panel.

If the import is unsuccessful an Import Failed window is opened. Click the OK button to close the Import Failed window.

*NOTE: If a Send To is selected during the import process, Chimpeon will try to correctly adjust screen-based functionality such as pixel positions and Scan Areas. It does this by using the screen resolution of the game specified for the Send To setting where the export was performed, and the game specified for the Send To setting in the Import Profile window. If a Send To is not selected then screen-based functionality remains unchanged.

NOTE: It is highly likely certain configuration settings contained in an imported Profile will require changing before they work for your game configuration.

4.6.2. Exporting

A Profile is exported in a Profile File (.pro). From here it can be shared on media such as a web page, Discord and in an email.

To export a Profile File, perform the following actions:

1. Select a Profile in the Profiles panel.
2. Click the Export Profile button () in the Profiles panel to open the Export Profile window (which is a standard Windows File window).
3. Locate then select where the Profile File should be saved.
4. Click inside the File Name edit box then specify a file name for the Profile File.
5. Click the Save button.

If the export is successful a Profile Exported window is opened. Click the OK button to close the Profile Exported window.

If the export is unsuccessful an Export Unsuccessful window is opened. Click the OK button to close the Export Unsuccessful window.

Profiles

5. Triggers

In this section, the following information is provided:

• 5.1. Overview
• 5.2. Configuration Settings
• 5.3. Managing
• 5.4. Determining the Order Triggers are Checked
• 5.5. Naming
• 5.6. Assigning to a Thread
• 5.7. Changing the On and Off Status
• 5.8. Activating and Deactivating
• 5.9. Applying a Sound

5.1. Overview

A Trigger is a container for one or more Conditions and Actions. Normally, a Trigger is added to a Profile for each task Chimpeon needs to perform.

EXAMPLE: If you want to automate a combat rotation in an MMORPG then you would add a Trigger for each spell used in the combat rotation.

When the Expression derived from each Condition associated with a Trigger is satisfied (e.g. a pixel is detected or a timer expires), the Action or Actions associated with the same Trigger are performed (e.g. a key or mouse button is pressed).

Triggers are displayed and managed in the Triggers panel (see Fig. below).

Fig. Triggers panel

5.2. Configuration Settings

Each Trigger has the following configuration settings:

5.3. Managing

Triggers can be selected, added, deleted, duplicated, cut, copied and moved.

MORE: For details about these processes, refer to Getting Started > Interface Overview > Using Panels and Managing Items.

5.4. Determining the Order Triggers are Checked

The order of Triggers in the Triggers panel determines the order they are checked within the same Thread.

EXAMPLE: The following Triggers are listed in the Triggers panel:

Trigger A (Thread 1)
Trigger B (Thread 1)
Trigger C (Thread 2)

Trigger A and Trigger C are checked concurrently and Trigger B is checked after Trigger A.

Move the Triggers up and down in the Triggers panel until the required order is attained.

MORE: For details about randomizing the order Triggers are checked, refer to Threads > Randomizing the Order Triggers are Checked

5.5. Naming

The Name setting should normally represent the task a Trigger performs.

EXAMPLE: If you need to automate a spell called Fire Lance in an MMORPG you could name the Trigger, "Fire Lance".

To name a Trigger, perform the following actions:

1. Click inside the Name setting edit box of the Trigger.
2. Delete the existing name.
3. Type a name.

5.6. Assigning to a Thread

To assign a Thread to a Trigger, perform the following actions:

1. Click the Thread setting list box of the Trigger.
2. Click the name of the required Thread.

NOTE: There is always a Thread available called Default and new Threads can be added if required.

MORE: For further details about Threads, refer to Threads.

5.7. Changing the On and Off Status

The Status setting determines whether a Trigger is on or off. On means it will be checked and used while Chimpeon is started. Off means it will not be checked and used while Chimpeon is started.

To enable tasks associated with a Trigger to be checked and used only when required, a Trigger can be turned on and off (and executed just once if the Expression of the associated Condition or Conditions are satisfied) while Chimpeon is started in the following ways:

• Using the [Trigger Name] On or [Trigger Name] Off option of an Action's Perform setting.
• Using a Status Hot Key.

To specify the on and off status of a Trigger, select the Trigger then click the associated Status setting. If the Status setting shows On it will change to Off. If the Status setting shows Off it will change to On.

5.8. Activating and Deactivating

The Active setting determines whether the associated Trigger is activated or deactivated. When the Trigger is activated, it is checked and used while Chimpeon is started. When the Trigger is deactivated, it is ignored while Chimpeon is started.

To activate or deactivate a Trigger, click the associated Active setting checkbox then click it again to add or remove a tick. A tick indicates the Trigger is activated. Blank indicates the Trigger is deactivated.

NOTE: If the game specified for the associated Profile's Send To setting is not launched/running, the tick of each Active setting checkbox is red to indicate the associated Triggers are deactivated. Relaunch the game to get going again.

5.9. Applying a Sound

Being able to hear when the Expression of one or more Conditions associated with a Trigger is satisfied (i.e. when the Trigger is fired) can be advantageous - especially when there is a lot of frenetic action going on in a game. A sound file can therefore be applied to each Trigger.

To apply a sound to a Trigger, perform the following actions:

1. Click inside the Sound setting edit box of the Trigger.
2. Click the Open button that appears to the right of the Sound edit box.
3. In the Open window, locate and select the required sound (WAV) file then click the Open button.

The Open window now closes and the path and file name of the selected sound file appears in the Sound setting edit box.

NOTE: The Play Sounds setting must be enabled before sounds are played.

Triggers

6. Conditions

In this section, the following information is provided:

• 6.1. Overview
• 6.2. Configuration Settings
• 6.3. Managing
• 6.4. Determining Whether a Condition Must be Satisfied or Not Satisfied
• 6.5. Naming
• 6.6. Determining What a Condition Does
• 6.7. Linking Conditions with an Operator
• 6.8. Activating and Deactivating
• 6.9. Working With Expressions

6.1. Overview

A Condition is a component of a Trigger and determines a process that Chimpeon performs when started such as detecting a pixel in the game window or waiting for a timer to expire. As Conditions are added to a Trigger, an Expression is created. Each Condition must be satisfied before the Expression is satisfied after which the Action or Actions associated with the same Trigger are performed (i.e. the Trigger is fired).

EXAMPLE: If you want to determine whether a spell in an MMORPG is ready to use, you would add a Condition to accomplish this. If you also want the spell to only be used when an enemy is targeted, you would add another Condition to the same Trigger to accomplish this.

Conditions are displayed and managed in the Conditions panel (see Fig. below).

Fig. Conditions panel

6.2. Configuration Settings

Each Condition has the following configuration settings:

6.3. Managing

Conditions can be selected, added, deleted, duplicated, cut, copied and moved.

MORE: For details about these processes, refer to Getting Started > Interface Overview > Using Panels and Managing Items.

6.4. Using the Not Setting

The Not setting determines whether the associated Process setting must be satisfied or not satisfied before the Condition is satisfied.

EXAMPLE: If the Condition needed to be satisfied when a pixel in the game window is not found then the Not setting would be enabled (ticked). If the Condition needed to be satisfied when a pixel in the game window is found then the Not setting would be disabled (blank).

Click the Not setting checkbox then click it again to add or remove a tick. A tick indicates the associated Process setting must not be satisfied. Blank indicates the associated Process setting must be satisfied.

6.5. Naming

The Name setting should normally represent the task a Condition performs.

EXAMPLE: If you need to detect a pixel in a spell icon called Fire Lance you could name the Condition, "Fire Lance icon".

To name a Condition, perform the following actions:

1. Click inside the Name setting edit box of the Condition.
2. Delete the existing name.
3. Type a name.

NOTE: The name specified must be unique to the associated Profile (i.e. another Condition within the same Profile must not have the same name).

6.6. Determining What a Condition Does

The Process setting determines what a Condition does and whether the Condition is satisfied or not satisfied as a result of this.

6.6.1. Process Setting Options

The Process setting has the following options:

6.6.2. Ensuring a Condition is Always Satisfied

There may be occasion when you want Chimpeon to perform a task without any logic needing to be satisfied.

EXAMPLE: Manually pressing a Status Hot Key to turn off Triggers associated with single target spells and turn on Triggers associated with multi-target spells.

The Always option of the Process setting causes the Condition to always be satisfied

To configure a Condition so it is always satisfied, click the Process setting list box then click the Always option.

6.6.3. Waiting for a Date and Time

There may be occasion when you want Chimpeon to perform a task at a specific date and/or time.

EXAMPLE: Stop Chimpeon at 17:00 every day.

EXAMPLE: Click a button in the game at 17:00 on a Wednesday.

The Date/Time option of the Process setting determines the date and/or time when the Condition is satisfied.

To specify a date and/or time, perform the following actions:

1. Click the Process setting list box.
2. Click the Date/Time option.
3. Click the Settings button () to the right of the Process setting list box to open the Date/Time window (see Fig. below).
4. Specify a date and/or specify a time.
5. Click the OK button to apply the date and/or time and close the Date/Time window.

Fig. Date/Time window

6.6.3.1. Specifying a Date

To specify a predefined date such as today, tomorrow or a day of the week, click the Date setting list box in the Date/Time window (see Fig. above) then click an option.

To specify a specific calendar date, perform the following actions in the Date/Time window:

1. Click the Calendar button () in the Date/Time window to open the Calendar pop-up (see Fig. below).
2. Use the controls to locate the required date.
3. Click the required date to select it and close the Calendar pop-up.

Fig. Calendar pop-up

6.6.3.2. Specifying a Time

To specify a time (as hh:mm:ss), perform the following actions in the Date/Time window:

1. Click inside the Time setting edit box.
2. Type the hours, minutes and seconds. Alternatively, use the speed buttons to increase or decrease the value of whatever part of the time is highlighted.

6.6.4. Detecting a Pixel

The pixel detection functionality of Chimpeon allows decisions to be made based upon the presence, absence or movement of a pixel in the game window.

EXAMPLE: Detect when an MMORPG spell is ready to use; detect when a health bar in an FPS is almost depleted; detect when a gold resource is full in a strategy game; detect a target in an FPS.

The Pixel Detection option of the Process setting provides access to a wide range of configuration settings and components that determine how a pixel is detected, not detected or how it must move in the game window before the Condition is satisfied.

MORE: For details about how to configure pixel detection, refer to Pixel Detection.

6.6.5. Waiting for the Thread to be Idle

There may be occasion when you want Chimpeon to perform a task when Chimpeon has not performed any other tasks for a specific amount of time.

EXAMPLE: Pressing a key to use a spell when no other spells have been used for several seconds; playing a sound to announce when nothing has been performed in a game for over a minute.

The Thread Idle option of the Process setting determines how long the Thread used by the associated Trigger should be idle before the Condition is satisfied.

Thread Idle works as follows:

1. Chimpeon is started and the Thread Idle timer begins.
2. If an Expression associated with another Trigger in the same Thread is satisfied, the Thread Idle timer begins again.
3. If the Thread Idle timer reaches the specified time, the associated Condition is satisfied.

NOTE: Triggers in different Threads to the one used by the Trigger associated with the Condition, do not affect the Thread Idle timer.

To specify a thread idle timer for a Condition, perform the following actions:

1. Click the Process setting list box.
2. Click the Thread Idle option.
3. Click the Settings button () to the right of the Process setting list box to open the Thread Idle window (see Fig. below).
4. Click the radio button of the required unit of time.
5. Click inside the Idle edit box.
6. Delete the existing value then type the required value (1 to 9,999). Alternatively use the speed buttons to increase or decrease the value.
7. Click the OK button to apply the thread idle timer and close the Thread Idle window.

Fig. Thread Idle window

6.6.6. Waiting for a Timer to Expire

There may be an occasion when you need Chimpeon to wait for a timer to expire before performing a task.

EXAMPLE: Pressing the jump key to prevent AFK; sending a message to the chat window; clicking an icon to collect resources.

The Time Interval option of the Process setting determines how long it takes before the Condition is satisfied. When the timer expires, and the Condition is satisfied, it begins again and continues until Chimpeon is stopped or the associated Trigger is turned off.

To specify a time interval for a Condition, perform the following actions:

1. Click the Process setting list box.
2. Click the Time Interval option.
3. Click the Settings button () to the right of the Process setting list box to open the Time Interval window (see Fig. below).
4. Click the radio button of the required unit of time.
5. Click inside the Every edit box.
6. Delete the existing value then type the required value (1 to 9,999). Alternatively, use the speed buttons to increase or decrease the value.
7. Click the OK button to apply the time interval and close the Time Interval window.

Fig. Time Interval window

The Instant setting in the Time Interval window is used to determine whether the Condition is first satisfied immediately when Chimpeon is started or when the timer expires. Click inside the Instant checkbox to add or remove a tick. A tick indicates the Condition is first satisfied immediately when Chimpeon is started. Blank indicates the Condition is first satisfied when the timer expires.

6.6.7. Waiting for a Trigger Count

There may be occasion when you only want Chimpeon to perform a task when Chimpeon has performed another task a specific number of times.

EXAMPLE: Use a spell in an MMORPG when another spell has been used three times.

The Process setting's Trigger Count option determines the number of times another Trigger must be fired (i.e. its Expression is satisfied) before the Condition is satisfied.

To specify the number of times another Trigger must be fired before a Condition is satisfied, perform the following actions:

1. Click the Process setting list box.
2. Click the Trigger Count option.
3. Click the Settings button () to the right of the Process setting list box to open the Trigger Count window (see Fig. below).
4. Click the Trigger list box.
5. Click the name of a Trigger.
6. Click inside the Count edit box.
7. Delete the existing value then type the required value (1 to 9,999). Alternatively use the speed buttons to increase or decrease the value.
8. Click the OK button to apply the trigger count and close the Trigger Count window.

Fig. Trigger Count window

6.7. Linking Conditions with an Operator

The Operator setting enables Conditions for the same Trigger to be linked with either an And, Or or Xor operator. The order of Conditions in the Conditions panel determines how they are linked and how the associated Expression is created. The top Condition is linked with the Condition below and that Condition is linked with the Condition below that and so on.

EXAMPLE:

Condition A And
Condition B Or
Condition C

Condition A And Condition B Or Condition C

6.7.1. Operator Setting Options

The Operator setting has the following options:

6.7.2. Adding and Modifying

To add or modify an operator for a Condition, perform the following actions:

1. Click the Operator setting list box of the Condition.
2. Click the arrow to the right of the Operator setting list box.
3. Click either the And, Or, Xor or blank value in the list.

NOTE: The Operator setting for the last (bottom) Condition in the Conditions panel is ignored/disabled until another Condition is added below it or the Condition is moved above another Condition.

6.8. Activating and Deactivating

The Active setting determines whether the associated Condition is activated or deactivated. When the Condition is activated, it is used while Chimpeon is started. When the Condition is deactivated, it is ignored while Chimpeon is started.

To activate or deactivate a Condition, click the associated Active setting checkbox then click it again to add or remove a tick. A tick indicates the Condition is activated. Blank indicates the Condition is deactivated.

6.9. Working With Expressions

An Expression is automatically created and displayed below the Conditions panel to demonstrate the logic of all the Conditions associated with the selected Trigger.

EXAMPLE: A and B or not C

The letters (A, B, C, etc) that appear in an Expression represent the ID of each Condition.

All Conditions represented in an Expression must be satisfied (i.e. all must return true) before the Action or Actions associated with the same Trigger are performed.

6.9.1. Manually Creating an Expression

If the Expression that is automatically created is unsuitable or a more complex Expression is required, an Expression can be created manually.

EXAMPLE: ((A and B) or not C) and D

Perform the following actions to create an Expression manually:

1. Click the Use Expression checkbox to add a tick to it.
2. Click inside the Use Expression edit box.
3. Type the required Expression.

To use the Expression that is created automatically, click the Use Expression checkbox to remove the tick.

6.9.1.1. Valid Components

When specifying an Expression manually, the following components can be used:

• ID of a Condition
• And
• Or
• Xor
• Opening and closing brackets ()

Conditions

7. Actions

In this section, the following information is provided:

• 7.1. Overview
• 7.2. Configuration Settings
• 7.3. Managing
• 7.4. Naming
• 7.5. Determining What an Action Does
• 7.6. Delaying the Thread
• 7.7. Activating and Deactivating

7.1. Overview

An Action is a component of a Trigger and each one determines what Chimpeon does when the Expression derived from the Condition or Conditions associated with the same Trigger is satisfied.

EXAMPLE: If you want to press a key to use a spell in an MMORPG, you would add an Action to accomplish this.

Actions are displayed and managed in the Actions panel (see Fig. below).

Fig. Actions panel

7.2. Configuration Settings

Each Action has the following configuration settings:

7.3. Managing

Actions can be selected, added, deleted, duplicated, cut, copied and moved.

MORE: For details about these processes, refer to Getting Started > Interface Overview > Using Panels and Managing Items.

7.4. Naming

The Name setting should normally represent the task an Action performs.

EXAMPLE: If the Action presses the 1 key you could name the Action, "Press 1 Key".

To name an Action, perform the following actions:

1. Click inside the Name setting edit box of the Action.
2. Delete the existing name.
3. Type a name.

NOTE: The name specified must be unique to the associated Trigger (i.e. another Action within the same Trigger must not have the same name).

7.5. Determining What an Action Does

The Perform setting determines what an Action does when the Expression derived from the Condition or Conditions associated with the same Trigger is satisfied.

7.5.1. Perform Setting Options

The Perform setting has the following options:

7.5.2. Pressing Keys and/or Performing Mouse Actions

Pressing keys and performing mouse actions in a game is one of the core features of Chimpeon.

EXAMPLE: Press the key associated with a MMORPG spell; move the mouse to a specific position in the game window and perform a left click.

The Key/Mouse option of the Perform setting presses one or more keys and/or performs a mouse action.

MORE: For details about how to configure Chimpeon to press keys and perform mouse actions, refer to Keys and Mouse.

7.5.3. Performing a Sequence of Previously Recorded Key Presses and/or Mouse Actions

The Macro option of the Perform setting plays a sequence of previously recorded key presses and/or mouse actions.

EXAMPLE: A sequence of crafting actions in an MMORPG; an attack combo in an FPS.

MORE: For details about how to configure Chimpeon to record a sequence of key presses and/or mouse actions, refer to Macro.

7.5.4. Doing Nothing

The Nothing option of the Perform setting causes nothing to be performed.

EXAMPLE: Use when you want to "pause" the associated Thread (by specifying the associated Pre Delay or Post Delay).

To configure an Action to do nothing, click the Perform setting list box then click the Nothing option.

7.5.5. Playing a Sound

The Play Sound option of the Perform setting plays a specified sound file.

EXAMPLE: Play a sound to indicate a spell has been used.

To specify a sound for an Action to play, perform the following actions:

1. Click the Perform setting list box.
2. Click the Play Sound option.
3. Click the Settings button () to the right of the Perform setting list box to open the Play Sound window (see Fig. below).
4. Click the File button () to the right of the File Name edit box to open the Open window.
5. Locate and click the required sound (WAV) file then click the Open button to close the Open window and add the path and file name of the selected sound file to the File Name edit box.
6. Click the OK button to apply the sound file and close the Play Sound window.

Fig. Play Sound window

7.5.6. Resetting the Thread Loop

The Reset Thread Loop option of the Perform setting resets the Thread loop used by the associated Trigger. This means the checking of Triggers in the Thread starts again at the topmost Trigger in the Triggers panel.

EXAMPLE: Perform a priority combat rotation where the Triggers associated with the highest priority spells are assigned to the same Thread and positioned in priority order (top down) in the Triggers panel.

To configure an Action to reset the associated Thread loop, click the Perform setting list box then click the Reset Thread option.

7.5.7. Stopping Chimpeon

The Stop option of an Action's Perform setting stops Chimpeon.

EXAMPLE: Limit the time Chimpeon automates a game for.

HINT: Combine the Stop option with the Date/Time option or the Time Interval option of the associated Condition's Process setting.

To configure an Action to stop Chimpeon, click the Perform setting list box of the Action then click the Stop option.

7.5.8. Sending a Text String

The Text String option of the Perform setting sends a specified text string to the game (or application).

EXAMPLE: Automatically send messages to a game's chat system to promote a guild or advertise loot or currency for sale.

HINT: Combine the Text String option with the Date/Time option or the Time Interval option of the associated Condition's Process setting.

To specify a text string for an Action to send to the game, perform the following actions:

1. Click the Perform setting list box.
2. Click the Text String option.
3. Click the Settings button () to the right of the Perform setting list box to open the Text String window (see Fig. below).
4. Click inside the Text edit box then type the required text.
5. Click the OK button to apply the text string and close the Text String window.

Fig. Text String window

MORE: For details about specifying Sending Options, refer to Keys and Mouse > Specifying How a Key or Mouse Action is Sent to a Game, and Keys and Mouse > Specifying How Long a Key Press or Mouse Action is Performed For.

7.5.9. Using a Status Hot Key

The [Status Hot Key name] option of an Action's Perform setting uses the named Status Hot Key to turn on, turn off and/or execute one or more Triggers.

To specify a Status Hot Key for an Action to use, click the Perform setting list box then click the [Status Hot Key name] option.

NOTE: When needing to turn on, turn off or execute a single Trigger, it may be preferable to use either the [Trigger name] On, [Trigger name] Off or [Trigger name] option for the Perform setting.

MORE: For further details about Status Hot Keys, refer to Status Hot Keys

7.5.10. Turning On, Turning Off or Executing a Trigger

For each Trigger in the Profile, the following options appear in the Perform setting list box:

To specify a Trigger for an Action to turn on, turn off or execute, click the Perform setting list box then click the associated [Trigger name] On, [Trigger name] Off or [Trigger name] option.

NOTE: When multiple Triggers need to turned on, turned off or executed, instead of using multiple Actions, it may be preferable to use the [Status Hot Key name] option for the Perform setting.

7.6. Delaying the Thread

Each Action has a Pre Delay and a Post Delay setting and associated Random settings all of which delay the Thread the associated Trigger is assigned to.

NOTE: Other Threads are not affected by the delay.

7.6.1. Specifying a Pre Delay

The Pre Delay setting determines the number of milliseconds the Thread of the associated Trigger is delayed for before the Action is performed.

EXAMPLE: Specify a pre delay to prevent a mouse being instantly pressed when the associated Expression is satisfied.

To specify a pre delay for an Action, perform the following actions:

1. Click inside the Pre Delay setting edit box of the Action.
2. Delete the existing value.
3. Type a value in milliseconds.

7.6.2. Specifying a Post Delay

The Post Delay setting determines the number of milliseconds the Thread of the associated Trigger is delayed for after the Action is performed.

EXAMPLE: Specify a post delay after a fishing bobber in an MMORPG is cast so it has time to "settle".

To specify a post delay for an Action, perform the following actions:

1. Click inside the Post Delay setting edit box of the Action.
2. Delete the existing value.
3. Type a value in milliseconds.

7.6.3. Making a Delay Random

If Actions are continually performed at the same time, game developers may be able to determine Chimpeon is being used. Therefore, introducing a random element to their use will make in-game actions more human-like and less detectable.

The Pre Delay setting and the Post Delay setting both have an associated Random setting. Each determines the number of milliseconds either side of the associated delay setting value a random delay is derived from.

EXAMPLE: If the Random setting value is 2000 milliseconds and the associated delay setting is 10000 milliseconds, the random delay is any value between 8000 and 12000 milliseconds.

NOTE: Specifying 0 as the value for a Random setting means the associated delay is not random.

To make a delay random (or not random if 0 is specified), perform the following actions:

1. Click inside the Random setting edit box.
2. Delete the existing value.
3. Type a value in milliseconds.

7.7. Activating and Deactivating

The Active setting determines whether the associated Action is activated or deactivated. When the Action is activated, it is used while Chimpeon is started. When the Action is deactivated, it is ignored while Chimpeon is started.

To activate or deactivate an Action, click the associated Active setting checkbox then click it again to add or remove a tick. A tick indicates the Action is activated. Blank indicates the Action is deactivated.

Actions

8. Threads

In this section, the following information is provided:

• 8.1. Overview
• 8.2. Configuration Settings
• 8.3. Managing
• 8.4. Naming
• 8.5. Randomizing the Order Triggers are Checked

8.1. Overview

A Thread is an independent component of the Chimpeon process and each Trigger must be assigned to one using the Thread setting. When Chimpeon is started, each Thread is executed independently and concurrently allowing performance to be faster than if a single process without Threads was used (like Chimpeon Legacy).*

*NOTE Although the use of Threads normally improves the performance of Chimpeon, it can, under certain circumstances, be detrimental to performance. It is therefore advised you monitor performance when using multiple Threads and adjust their use as required.

There is always a Thread called Default available for the Thread setting but other Threads can be added if required.

Threads are displayed and managed in the Threads window (see Fig. below) which is opened by clicking the Thread setting then clicking the Settings button ().

Fig. Threads window

8.2. Configuration Settings

Each Thread has the following configuration settings:

8.3. Managing

Threads can be selected, added and deleted.

MORE: For details about these processes, refer to Getting Started > Interface Overview > Using Panels and Managing Items.

8.4. Naming

The purpose of a Thread is to act as an independent component for one or more Triggers. It is therefore advised the Name setting relates to what the Trigger(s) that use the Thread are configured to do.

EXAMPLE: For Triggers that automate the cooldowns of a combat rotation in an MMORPG, the Thread they are assigned to could be named "Cooldowns".

To name a Thread, perform the following actions in the Threads window (see Fig. above):

1. Click the Name setting edit box of the Thread.
2. Delete the existing name.
3. Type a name.

8.5. Randomizing the Order Triggers are Checked

By default, the order of Triggers in the Triggers panel determines the order they are checked within the same Thread. To help prevent game developers detecting the use of Chimpeon, the order Triggers are checked within their associated Thread, and as a result, what task the Trigger performs, can be randomized.

To randomize the order Triggers are checked within the same Thread, click the associated Random setting checkbox in the Threads window then click it again to add a tick.

MORE: For further details about determining the order Triggers are checked, refer to Triggers > Managing > Determining the Order Triggers are Checked.

Threads

9. Pixel Detection

In this section, the following information is provided:

• 9.1. Overview
• 9.2. Configuration Settings and Components
• 9.3. Specifying a Live View of the Game Window
• 9.4. Taking a Snapshot of Live
• 9.5. Specifying How a Pixel is Positioned
• 9.6. Specifying the Position of a Fixed Pixel
• 9.7. Specifying the Scan Area Where a Variable Pixel Appears
• 9.8. Specifying Whether a Single Colour or a Colour Range is Used
• 9.9. Specifying the Single Colour
• 9.10. Specifying the Colour Range
• 9.11. Using the Colour List
• 9.12. Using the Colour Window
• 9.13. Dealing With Moving Pixels
• 9.14. Not Detecting or Detecting a Pixel
• 9.15. Monitoring Detection

9.1. Overview

The pixel detection functionality of Chimpeon is used when a task must be performed as a result of an object a pixel is part of being present, not being present or moving within the game window.

EXAMPLE: Detecting a pixel in a spell icon that is ready to be used; detecting the absence of a pixel in an enemy portrait so an enemy can be targeted; detecting a pixel in a fishing bobber that has just moved to indicate a fish has been hooked.

When configured, Chimpeon looks for a pixel, or more specifically, its colour, in a fixed or variable position within the game window. When the pixel is detected, not detected or when it moves in a particular way, the associated Condition is satisfied.

Configuring pixel detection is a five or six stage process:

1. Select the Live area within the game window where the pixel to be detected and/or the colour of the pixel to be detected can be seen.
2. Take a Snapshot of the Live area so a fixed pixel position and/or one or more colours of the pixel to look for can be specified.
3. Determine whether the pixel to be detected is in a fixed or variable Position.
4. Use Snapshot to specify the position of a fixed pixel, or specify the Scan Area where a variable pixel appears.
5. Use Snapshot to specify the Single Colour or Colour Range of the pixel to look for, or specify the List Colour used to create a Colour List containing the colours the pixel to look for can be.
6. Optionally specify how far in one or more directions the pixel to look for must move before it is considered detected.

All the above processes are completed in the Pixel Detection window (see Fig. below) which is opened by performing the following actions:

1. Click the Process setting list box of a Condition.
2. Click the Pixel Detection option.
3. Click the Settings button () to the right of the Process setting list box.

Fig. Pixel Detection window

NOTE: Although it is actually the colour of a pixel Chimpeon looks for in the game window, the term "pixel" instead of "pixel colour" is generally used throughout this section.

9.2. Configuration Settings and Components

The Pixel Detection window (see Fig. above) is split into the following four panels each of which contain related configuration settings and components:

• Game
• Position
• Colour
• Motion

In addition, the following configuration setting appears at the bottom of the Pixel Detection window.

9.2.1. Game

The Game panel of the Pixel Detection window has the following configuration settings and components:

9.2.2. Position

The Position panel of the Pixel Detection window has the following configuration settings and components:

9.2.3. Colour

The Colour panel of the Pixel Detection window has the following configuration settings and components:

9.2.4. Motion

The Motion panel of the Pixel Detection window has the following configuration settings and components:

9.3. Specifying a Live View of the Game Window

Before pixel detection can be configured, an area of the game window must be specified. This is displayed in a 114x114 pixel area of the Pixel Detection window called Live (see Fig. below). It is used to determine what appears in Snapshot and normally encompasses one or more of the following:

• The fixed pixel to look for.
• The pixel to determine the Single Colour.
• The pixel to determine the left extremity of the Colour Range.
• The pixel to determine the right extremity of the Colour Range.
• The pixel to determine the List Colour used for creating the Colour List.

Fig. Example of Live

The centre point of what appears in Live can be specified in the following ways:

• Game window
• Live X and Live Y Settings

NOTE: If the incorrect game window has been selected for the associated Profile's Send To setting, specifying Live will not work properly. Instead, Live will only be able to show a live image of what is contained within the selected window. To resolve this, the correct game window will need to be found and selected for the Send To setting.

NOTE: If the game specified for the associated Profile's Send To setting is not running, "Send To Not Found" appears in Live. Run the game to remove this notification.

MORE: For details about how the border of Live indicates whether the pixel to look for is detected or not detected (if the Not setting is selected), refer to Pixel Detection > Monitoring Detection

9.3.1. Using the Game Window

To use the game window to specify the centre of Live, perform the following actions:

1. Hold the Alt key.
2. Move the cursor in the game window until the required area appears in Live.
3. Release the Alt key.

Following this, the Live X and Live Y settings indicate the centre of Live.

9.3.2. Using Live X and Live Y Settings

To use the Live X and Live Y settings to specify the centre of Live, perform the following actions:

1. Click inside the Live X or Live Y setting edit box.
2. Delete the existing value.
3. Type a new value.

Alternatively, click the speed buttons of the Live X or Live Y settings to increase or decrease the associated values. The mouse wheel can also be moved up and down to increase or decrease a value after clicking inside the associated edit box.

NOTE: Only values that fall within the constraints of the game window can be specified for the Live X and Live Y settings. If the values are smaller or greater than these constraints then either the permitted minimum or maximum value is applied after taking focus away from the associated edit box.

9.4. Taking a Snapshot of Live

Snapshot (see Fig. below) is a static copy of Live at the point when the Snapshot was taken. It is used to select one or more of the following:

• The position of the fixed pixel to look for.
• The Single Colour.
• The left extremity of the Colour Range.
• The right extremity of the Colour Range.
• The List Colour used for creating the Colour List.

Snapshot can also be used to specify the top left and bottom right corners of the Scan Area although these are normally specified directly in the game window.

Fig. Example of Snapshot

To copy Live to Snapshot, click the Take Snapshot button () or press Shift-S.

NOTE: The image within Snapshot is saved with the configuration file so it can be used at any time.

9.5. Specifying How a Pixel is Positioned

The Position setting determines how the pixel to look for is in positioned within the game window, and enables the settings associated with the chosen option.

9.5.1. Position Setting Options

The Position setting has the following options:

9.5.2. Indicating a Fixed Position

A fixed position means the position of the pixel to look for remains constant within the game window.

EXAMPLE: A pixel in an MMORPG spell icon; a pixel in a notification button.

To indicate a fixed position and to enable the Fixed X and Fixed Y settings, click the Position setting list box then click the Fixed option.

MORE: For details about specifying the position of the fixed pixel to look for, refer to Pixel Detection > Specifying the Position of a Fixed Pixel.

9.5.3. Indicating a Variable Position

A variable position means the position of the pixel to look for does not remain constant within the game window.

EXAMPLE: A pixel in an MMORPG fishing bobber/float; a pixel in an FPS target.

To indicate a variable position and to enable the Scan Area and Motion settings, click the Position setting list box then click the Variable option.

MORE: For details about specifying the Scan Area, refer to Pixel Detection > Specifying the Scan Area Where a Variable Pixel Appears.

MORE: For details about dealing with moving pixels, refer to Pixel Detection > Dealing With Moving Pixels.

9.5.4. Indicating a Real-Time Position

A real-time position means the position of the pixel to look for is where the cursor is located within the game window.

EXAMPLE: A pixel below the cursor manually positioned by the user; a pixel below the cursor positioned by another Trigger.

To indicate a real-time position, click the Position setting list box then click the Real-time option. No further configuration settings are applicable or need to be considered.

HINT: The Real-time option can be used when configuring Chimpeon as an "aim bot". It would be used to look for a pixel (i.e. the colour of a target to shoot at) at the current cursor position (determined by another Trigger) and if detected, fire the weapon. It overcomes the issue where a Trigger configured to look for the target is unable to move the crosshairs (cursor) to the target in the first attempt (due to many reasons such as mouse sensitivity) and as a result, fire the weapon prematurely. Using a second Trigger that uses the Real-time option ensures the weapon is only fired when the crosshair is actually on the target.

9.6. Specifying the Position of a Fixed Pixel

The position of the fixed pixel to look for can be specified in the following ways:

• Snapshot
• Fixed X and Fixed Y Settings

NOTE: The Fixed option of the Position setting must be selected before the position of a fixed pixel can be specified.

9.6.1. Using Snapshot

To use Snapshot to specify the position in the game window of the fixed pixel to look for, move the cursor within Snapshot then press the Ctrl key when the cursor is on top of the pixel. Following this, a large crosshair appears in Snapshot and the Fixed X and Fixed Y setting values indicate the position of the pixel relative to the game window.

MORE: For details about taking a Snapshot of Live, refer to Pixel Detection > Taking a Snapshot of Live.

9.6.2. Using Fixed X and Fixed Y Settings

To use the Fixed X and Fixed Y settings to specify the position in the game window of the fixed pixel to look for, perform the following actions:

1. Click inside the Fixed X or Fixed Y setting edit box.
2. Delete the existing value.
3. Type a new value.

Alternatively, click the speed buttons of the Fixed X or Fixed Y settings to increase or decrease the associated values. The mouse wheel can also be moved up and down to increase or decrease a value after clicking inside the associated edit box.

As the Fixed X and Fixed Y setting values are changed, the large crosshair in Snapshot moves to reflect the change.

NOTE: Only values that fall within the constraints of Snapshot can be specified for the Fixed X and Fixed Y settings. If the values are smaller or greater than these constraints then either the permitted minimum or maximum value is applied after taking focus away from the associated edit box.

9.7. Specifying the Scan Area Where a Variable Pixel Appears

When a pixel appears in a variable position within the game window, an area known as the Scan Area (see Fig. below) must be specified. The Scan Area is continually scanned in a specified direction for the variable pixel.

Fig. Scan Area

The size of a Scan Area can range from a minimum of 1 x 1 pixels up to the maximum dimensions of the game window.

CAUTION It is advised Scan Areas are specified as small as possible due to the large overhead they put on the CPU - especially when multiple Scan Areas are being used. Combining a small Scan Area with an appropriate scan direction will improve pixel detection times and the performance of Chimpeon.

The Scan Area can be specified in the following ways:

• Game window or Snapshot
• Top, Left, Bottom and Right Settings

NOTE: The Variable option of the Position setting must be selected before a Scan Area can be specified.

9.7.1. Using the Game Window or Snapshot

To use the game window or Snapshot to specify the Scan Area, perform the following actions:

1. Position the cursor within the game window or Snapshot where the top left corner of the Scan Area needs to be.
2. Press and release Ctrl-T to specify the Top setting value and Left setting value.
3. Position the cursor within the game window or Snapshot where the bottom right corner of the scan area needs to be.
4. Press and release Ctrl-B to specify the Bottom setting value and Right setting value.

Following this, the border of the Scan Area appears in the game window and if applicable, Snapshot (unless the border is turned off using the Show Border setting).

9.7.2. Using Top, Left, Bottom and Right Settings

To use the Top, Left, Bottom and Right settings to specify the Scan Area, perform the following actions:

1. Click inside the Top, Left, Bottom or Right setting edit box.
2. Delete the existing value.
3. Type a new value.

Alternatively, click the speed buttons of the Top, Left, Bottom and Right settings to increase or decrease the associated values. The mouse wheel can also be moved up and down to increase or decrease a value after clicking inside the associated edit box.

As the Top, Left, Bottom and Right setting values are changed, the border of the Scan Area changes (unless the border is turned off using the Show Border setting).

NOTE: Only values that fall within the constraints of the game window can be specified for the Top, Left, Bottom and Right settings. If the values are smaller or greater than these constraints then either the permitted minimum or maximum value is applied after taking focus away from the associated edit box.

NOTE: If the incorrect game window has been selected for the associated Profile's Send To setting, specifying a scan area using Ctrl-T and Ctrl-B in the game window will not work properly. Instead, a scan area that is contained within the selected window can only be created. To resolve this, the correct game window will need to be found and selected for the Send To setting.

9.7.3. Showing and Hiding the Border

To show and hide the Scan Area border, click the Show Border setting checkbox to add or remove a tick. A tick indicates the border is shown. Blank indicates the border is hidden.

9.7.4. Changing the Colour of the Border

To change the colour of the Scan Area border, perform the following actions:

1. Click the Colour button to open the Colour window.
2. Specify or select a colour.
3. Click the OK button to close the Colour window and apply the colour to the Scan Area border.

MORE: For details about using the Colour window, refer to Pixel Detection > Using the Colour Window.

9.7.5. Specifying the Scan Direction

The Direction setting determines the direction in which the Scan Area is scanned for a variable pixel. Selecting the most suitable scan direction for how and where a variable pixel appears in the Scan Area can reduce detection time.

To select a scan direction, click the Direction setting list box then click the required option.

9.7.5.1. Direction Options

The Direction setting has the following options:

• Bottom Left to Top Right
• Bottom Right to Top Left
• Centre to Outside
• Left to Right
• Outside to Centre
• Right to Left
• Top Left to Bottom Right (default)
• Top Right to Bottom Left

9.7.6. Specifying Whether the Scan Starts Again or Continues

The Restart When Pixel Detected setting determines whether the scan restarts at the beginning or continues to the end of the Scan Area when a pixel is detected. This is useful if only the first pixel encountered in the direction of the scan needs to be detected, or all pixels within the entire Scan Area need to be detected.

To restart the scan or continue to the end of the Scan Area when a pixel is detected, click the Restart When Pixel Detected setting checkbox to add or remove a tick. A tick indicates the scan is restarted. Blank indicates the scan continues.

9.8. Specifying Whether the Colour of a Pixel is a Single Colour or any Colour Within a Range

The Colour setting determines whether the colour of the pixel to look for is a single colour or any colour within a range, and enables the settings associated with each option.

9.8.1. Colour Setting Options

The Colour setting has the following options:

9.8.2. Indicating a Single Colour

A single colour means the colour of the pixel to look for remains constant.

EXAMPLE: A pixel in an MMORPG spell icon; a pixel in a notification button.

To indicate the colour of the pixel to look for is a single colour and to enable the Single Colour settings, click the Colour setting list box then click the Single option.

MORE: For details about specifying the Single Colour, refer to Pixel Detection > Specifying the Single Colour.

9.8.3. Indicating a Colour Range

A colour range means the colour of the pixel to look for can be any colour within a range. Using a colour range is normally required when the colour of the pixel to look for changes due to lighting or because of streaming.

EXAMPLE: A pixel in an MMORPG fishing bobber/float; a pixel in an FPS target; a pixel in any object within a game being streamed.

To indicate the colour of the pixel to look for is anything within a range, and to enable the Colour Range settings, click the Colour setting list box then click the Range option.

MORE: For details about specifying the Colour Range, refer to Pixel Detection > Specifying the Colour Range.

9.9. Specifying the Single Colour

If the pixel to look for remains a constant colour, the Single Colour (see Fig. below) should be specified.

Fig. Single Colour

The Single Colour can be specified in the following ways:

• Snapshot
• Colour List
• Colour window

NOTE: To enable the Single Colour and use it when looking for a pixel, the Single option must be selected for the Colour setting.

9.9.1. Using Snapshot

To use Snapshot to specify the Single Colour, move the cursor within Snapshot then press the left mouse button when the cursor is on top of a suitable pixel. Following this, a small crosshair () appears in Snapshot to indicate the location of the pixel used.

9.9.2. Using the Colour List

Instead of creating multiple Conditions that each look for a different pixel colour that appears in the same fixed position or within the same Scan Area, multiple colours can instead be assigned to the Single Colour using the Colour List.

MORE: For details about using the Colour List to determine the Single Colour, refer to Pixel Detection > Using the Colour List.

9.9.3. Using the Colour Window

The Single Colour can be specified in the Colour window which is opened by clicking the Single Colour button (which is the colour block of the Single Colour).

MORE: For details about using the Colour window to specify the Single Colour, refer to Pixel Detection > Using the Colour Window.

9.9.4. Resetting

To reset the Single Colour to the colour of the pixel selected in Snapshot or black (R0 G0 B0) if a pixel is not selected or a Snapshot has not been taken, click the Reset button (). Following this, a Reset Single Colour window is opened. Click the Yes button to confirm the reset or the cancel button to cancel the reset.

9.10. Specifying the Colour Range

If the pixel to look for does not remain a constant colour, the Colour Range (see Fig. below) must be specified.

Fig. Colour Range

The Colour Range is determined by the left and right colour extremities. All colours including and between the left and right colour extremities are used when looking for a pixel.

The left and right colour extremities of the Colour Range can be specified in the following ways:

• Snapshot
• Colour List
• Colour window

NOTE: To enable the Colour Range and use it when looking for a pixel, the Range option must be selected for the Colour setting.

9.10.1. Using Snapshot

To use Snapshot to select the left extremity of the Colour Range, move the cursor within Snapshot then press the left mouse button when the cursor is on top of a suitable pixel. Following this, a small crosshair () appears in Snapshot to indicate the location of the pixel used.

To use Snapshot to select the right extremity of the Colour Range, move the cursor within Snapshot then press the right mouse button when the cursor is on top of a suitable pixel. Following this, a small crosshair () appears in Snapshot to indicate the location of the pixel used.

9.10.2. Using the Colour List

Normally, when a game is streamed, the colour of the pixel to look for in the game window changes due to inconsistencies in the quality of the stream. Similarly, the pixel to look for can be affected by lighting within the game. Both these circumstances can result in the colour of the pixel to look for changing in such a way that the Colour Range defined using the other methods is unsuitable. To overcome this, the Colour Range must be specified so it encompasses the entire range of colours the pixel can change to. The Colour List is a quick and easy way to accomplish this without having to laboriously note the many RGB colour variations of the pixel then manually calculate the left and right extremities of the Colour Range.

MORE: For details about using the Colour List to determine the left and right extremities of the Colour Range, refer to Pixel Detection > Using the Colour List.

9.10.3. Using the Colour Window

The left and right extremities of the Colour Range can be specified in the Colour window which is opened by clicking the associated colour extremity button (which is the colour block of the extremity).

MORE: For details about using the Colour window to specify the left and right colour extremities of the colour range, refer to Pixel Detection > Using the Colour Window.

9.10.4. Resetting

To reset the left and right extremities of the Colour Range to the colours of the pixels selected in Snapshot or black (R0 G0 B0) if the pixels are not selected or a Snapshot has not been taken, click the Reset button (). Following this, a Reset Colour Range window is opened. Click the Yes button to confirm the reset or the cancel button to cancel the reset.

9.11. Using the Colour List

If the pixel to look for can be more than one colour or the pixel to look for is in a game window that is being streamed, the Colour List (see fig. below) will normally need to be used.

Fig. Colour List

As the name suggests, the Colour List is a list of colours derived from a pixel in Snapshot or the live game window. The colours accumulated in the Colour List determine the Single Colour and the Colour Range (whichever is selected for the Colour setting).

How the colours in the Colour List are used differs for the Single Colour and the Colour Range.

9.11.1. How the Colour List Affects the Single Colour

The Single Colour uses all colours accumulated in the Colour List meaning the pixel to look for can be any one of the colours.

As colours are added to the Colour List, the Single Colour changes to reflect these colours (see Fig. below).

Fig. Single Colour showing the colours in the Colour List

9.11.2. How the Colour List Affects the Colour Range

The left extremity of the Colour Range uses the colour in the Colour List with the lowest RGB values minus the - Buffer setting value.

EXAMPLE: If the Colour List contained R92 G58 B29 and R201 G153 B104 and the - Buffer setting value was set to 5, the left extremity of the colour Range would be R87 G53 B24.

The right extremity of the Colour Range uses the colour in the Colour List with the highest RGB values plus the + Buffer setting value.

EXAMPLE: If the Colour List contained R92 G58 B29 and R201 G153 B104 and the + Buffer setting value was set to 5, the right extremity of the colour Range would be R206 G158 B109.

Fig. Colour Range derived from the lowest and highest RGB values in the Colour List

MORE: For further details about the - Buffer and + Buffer settings, refer to Pixel Detection > Using the Colour List > Changing the Buffer.

9.11.3. Enabling and Disabling

To enable and disable the Colour List, click the Use Colour List setting checkbox to add or remove a tick. A tick indicates the Colour List is enabled. Blank indicates the Colour List is disabled.

NOTE: When the Colour List is enabled, changing the Single Colour and the Colour Range in the normal way cannot be performed.

9.11.4. Specifying the List Colour

The List Colour (see Fig. below) indicates the colour that can be added to the Colour List.

Fig. List Colour

The RGB values of the List Colour are displayed alongside the List Colour to help determine whether the List Colour should be added to the Colour List.

The List Colour can be specified in the following ways:

• Snapshot (and the game window)
• Colour window

9.11.4.1. Using Snapshot (and the Game Window)

To use Snapshot to specify the List Colour, move the cursor within Snapshot then press the left mouse button when the cursor is on top of a suitable pixel. Following this, a small crosshair () appears in Snapshot to indicate the location of the pixel to use. Now click the Live setting checkbox to add or remove a tick. A tick indicates the List Colour is derived from the pixel shown in the game window at the position specified in Snapshot. Blank indicates the List Colour is derived from the pixel shown in Snapshot.

HINT: Enable (tick) the Live setting checkbox when creating a Colour Range for detecting a pixel within a game window that is streamed.

EXAMPLE: A pixel in a spell icon of an MMORPG that is being streamed.

9.11.4.2. Using the Colour Window

The List Colour can be specified in the Colour window which is opened by clicking the List Colour button (which is the colour block of the List Colour).

MORE: For details about using the Colour window to specify the List Colour, refer to Pixel Detection > Using the Colour Window.

9.11.3. Adding Colours

The List Colour can be added to the Colour List automatically or manually. To determine this, click the Auto Add setting checkbox to add or remove a tick. A tick indicates the List Colour is added automatically. Blank indicates the List Colour is added manually by clicking the Add button ().

NOTE: No matter what method is used, the List Colour can only be added if it does not already exist in the Colour List.

CAUTION: If the Live setting is enabled (ticked) and the Auto Add setting is enabled (ticked) large numbers of List Colours will be quickly added to the Colour List if the game window is constantly changing at the location of the List Colour pixel specified in Snapshot.

NOTE: When using the Colour List to determine the Colour Range, the more colours that are added the more likely the associated pixel will be detected.

9.11.3.1. Invoking a Colour Change When Streaming

Using the Colour List to determine the Colour Range is a useful way of dealing with the colour variations of a pixel in a game window that is streamed. In order to add as many colours to the Colour List as possible so all the colour variations are accumulated and an optimal Colour Range is generated, it will be necessary to invoke a colour change in the game window. This can normally be achieved in the following ways within the game window:

• Move the cursor over then off the item the pixel is contained in.
• Deselect then select the item the pixel is contained in.
• Change the game view.
• Move into a lighter or darker area.

9.11.4. Removing Colours

To remove an individual colour from the Colour List, click it then click the Delete button ().

To remove all colours from the Colour List, click the Clear button (). Following this a Clear Colour List window is opened. Click the Yes button to clear the Colour List or the No button to cancel the clear.

9.11.5. Changing the Buffer

The - Buffer and + Buffer settings are enabled when the Colour List is used to determine the Colour Range. Specifying one or both settings causes the Colour Range to become wider making it more likely the associated pixel will be detected. This is especially useful when looking for a pixel in a game window that is streamed where pixel colour variations often occur.

The - Buffer setting determines how much the RGB values of the left extremity of the Colour Range are reduced by.

EXAMPLE: If the RGB values for the left extremity of the Colour Range are R92 G58 B29, and the - Buffer setting value is 10, the left extremity of the Colour Range becomes R82 G48 B19.

The + Buffer setting determines how much the RGB values of the right extremity of the Colour Range are increased by.

EXAMPLE: If the RGB values for the right extremity of the Colour Range are R201 G153 B104, and the + Buffer setting value is 10, the right extremity of the Colour Range becomes R211 G163 B114.

9.12. Using the Colour Window

The Single Colour, the left and right extremities of the Colour Range, and the List Colour are all buttons that, when clicked, open the Colour window (see Fig. below).

Fig. Colour window

The Colour window is used to specify HSL or RGB colour values or select a colour for the colour associated with the colour button used to open the window.

9.12.1. Specifying HSL or RGB Colour Values

To specify HSL or RGB colour values, perform the following actions in the Colour window:

1. Click inside a HSL or RGB edit box.
2. Delete the existing value.
3. Type a new value.
4. Repeat steps 2 to 4 for each HSL or RGB value.
5. Click the OK button to close the Colour window and apply the colour.

9.12.2. Selecting a Colour

A colour can be selected from the Colour Picker and Luminosity Bar, the Basic Colours Palette, or the Custom Colours Palette.

To select a colour, click a colour in the Colour Picker, the Basic Colours Palette or the Custom Colours Palette then click the OK button to close the Colour window and apply the colour.

NOTE: When selecting a colour from the Colour Picker, the luminosity (brightness) of the colour may need to be specified using the Luminosity Bar. Click and hold the mouse button over the arrow to the right of the Luminosity Bar, move the arrow up and down to change the luminosity.

9.13. Dealing with Moving Pixels

If a Condition needs to be satisfied when the pixel to look for moves in a particular direction within the Scan Area, motion settings must be specified.

EXAMPLE: A fishing bobber moving down when a fish is hooked; An enemy moving towards your character.

NOTE: Motion settings are only available when the Variable option is selected for the Position setting.

9.13.1. Enabling and Disabling

To enable and disable the motion settings, click the Use Motion setting checkbox to add or remove a tick. A tick indicates the motion settings are enabled. Blank indicates the motion settings are disabled.

9.13.2. Specifying the Motion Range

The Up, Down, Left and Right settings determine the minimum distance in pixels the pixel to look for must move in the Up, Down, Left and Right direction from the last position it was detected within the Scan Area.

EXAMPLE: If a Condition needs to be satisfied when the pixel to look for moves at least 5 pixels down and at least 3 pixels right, the Down setting would be set to 5 and the Right setting would be set to 3.

To specify the minimum distance in pixels the pixel to look for must move, perform the following actions:

1. Click inside the Top, Bottom, Left or Right setting edit box.
2. Delete the existing value.
3. Type a new value.

Alternatively, click the speed buttons of the Top, Bottom, Left and Right settings to increase or decrease the associated values. The mouse wheel can also be moved up and down to increase or decrease a value after clicking inside the associated edit box.

MORE: For details about determining the value to specify for the Top, Bottom, Left and Right settings, refer to Pixel Detection > Monitoring the Motion Range.

9.13.3. Monitoring the Motion Range

Min and Max values appear above the Up, Down, Left and Right setting edit boxes. These indicate the minimum distance and maximum distance in pixels the pixel to look for has moved since it was first detected in the Scan Area to when it was last detected. These values are useful for determining the value to specify for the Top, Bottom, Left and Right settings.

EXAMPLE: The pixel in an MMORPG fishing bobber has a minimum down motion of 1 pixels and a maximum down motion of 3 pixels all the while it is just bobbing about. When a fish is hooked, the pixel moves down and the minimum down motion changes to 3 pixels and the maximum down motion changes to 9 pixels. In order for the pixel to be considered detected when a fish is hooked (and as a result click the bobber to catch the fish), the Down setting would be set to a value of 4 or more pixels.

9.14. Not Detecting or Detecting a Pixel

As the name suggests, the pixel detection functionality of Chimpeon is aimed at detecting a pixel in a fixed position, a variable position or at the current cursor position in the game window. However, being able to satisfy a Condition when a pixel is not detected can also be useful.

EXAMPLE: Satisfy a Condition when a pixel is not detected in the portrait of an enemy so a key can be pressed to target an enemy.

To detect or not detect a pixel, click the Not setting checkbox to add or remove a tick. A tick indicates the pixel to look for must not be detected to satisfy the associated Condition. Blank indicates the pixel to look for must be detected to satisfy the associated Condition.

9.15. Monitoring Detection

Configuring Chimpeon to look for a pixel in the game window can sometimes be difficult. Therefore, being able to monitor the results is paramount to creating a configuration that works as expected. The following functionality is provided to assist with this during configuration or after Chimpeon is started:

Pixel Detection

10. Keys and Mouse

In this section, the following information is provided:

• 10.1. Overview
• 10.2. Configuration Settings
• 10.3. Specifying How a Key Press or Mouse Action is Sent to a Game
• 10.4. Specifying How Long a Key Press or Mouse Action is Performed For
• 10.5. Selecting the Keys and Mouse Buttons to Use
• 10.6. Accessing the Mouse Settings
• 10.7. Specifying How a Mouse Button is Used
• 10.8. Specifying Whether the Mouse Moves the Cursor or the Game Window
• 10.9. Specifying the Position of the Cursor
• 10.10. Making the Cursor Position Random
• 10.11. Specifying a User Defined Cursor Position
• 10.12. Offsetting the Cursor
• 10.13. Returning the Cursor to the Start Position

10.1. Overview

Configuring what keys to use and what mouse actions to perform for an Action occurs in the Keys/Mouse window (see Fig. below) which is opened by performing the following actions:

1. Click the Perform setting list box of an Action.
2. Click the Keys/Mouse option.
3. Click the Settings button () to the right of the Perform setting list box.

Fig. Keys/Mouse window

10.2. Configuration Settings

The Keys/Mouse window (see Fig. above) is split into the following four panels each of which contain related configuration settings and components:

• Sending
• Available
• Selected
• Mouse

10.2.1. Sending

10.2.2. Available

10.2.3. Selected

10.2.4. Mouse

10.3. Specifying How a Key Press or Mouse Action is Sent to a Game

The Method setting determines the mechanism used to send a key press or mouse action to the game.

10.3.1. Method Setting Options

The Method setting has the following options:

10.3.2. Using Post

The Post option for the Method setting is suitable for some games but certain mouse actions may not work. If having the game window unfocussed is required (so you can perform other tasks in other applications), the Post option should be tried.

To use Post, click the Method setting then click the Post option.

10.3.3. Using Send

The Send option for the Method setting is suitable for some games but certain mouse actions may not work.

To use Send, click the Method setting then click the Send option.

10.3.3. Using SendInput

The SendInput option for the Method setting is suitable for almost all games and all mouse actions are likely to work. However, the game window must be focused (selected) to enable SendInput to send keystrokes and mouse actions to it.

To use SendInput, click the Method setting then click the SendInput option.

NOTE: To ensure keystrokes and mouse actions are successfully sent to the game when using the SendInput option, the Duration setting may need to have a positive value specified (e.g. 100).

10.4. Specifying How Long a Key Press or Mouse Action is Performed For

Certain games may require a key or mouse button to be pressed for a specific amount of time. This will be to either perform a specific task correctly or for the game to recognise whether a key or mouse button has been pressed.

The Duration setting determines the number of milliseconds the selected keys and mouse buttons are pressed for. It also determines how long the mouse cursor takes to move from the cursor start position to the cursor end position.

To specify how long the selected keys and mouse buttons are pressed for and how long mouse movement is performed for, perform the following actions:

1. Click inside the Duration setting edit box.
2. Delete the existing value.
3. Type a value in milliseconds.

NOTE: The associated Thread is delayed throughout the duration, meaning Triggers in the Thread are not checked until the duration expires.

10.4.1. Making the Duration Random

If key presses and mouse actions are continually performed for the same length of time, game developers may be able to determine Chimpeon is being used. Therefore, introducing a random element to their use will make in-game actions more human-like and less detectable.

The Duration setting has an associated Random setting. This determines the number of milliseconds either side of the Duration setting value a random duration is derived from.

EXAMPLE: If the Random setting value is 2000 milliseconds and the associated Duration setting value is 10000 milliseconds, the random duration is any value between 8000 and 12000 milliseconds.

NOTE: Specifying 0 as the value for the Random setting means the associated duration is not random.

To make the duration random (or not random if 0 is specified), perform the following actions:

1. Click inside the Random setting edit box.
2. Delete the existing value.
3. Type a value in milliseconds.

10.5. Selecting the Keys and Mouse Buttons to Use

All keys and mouse buttons that can be selected and used are listed in the Available panel. To use one or more of them they must be moved to the Selected panel.

To move a key or mouse button from the Available panel to the Selected panel, click the key or mouse button in the Available panel then click the Move to Selected button ().

NOTE: Only one mouse button can be moved to the Selected panel at any one time.

NOTE: If only mouse movement needs to be performed, select one of the mouse buttons.

10.5.1. Searching for a Key or Mouse Button

To quickly find a key or mouse button in the Available panel, click inside the Search edit box then type the value of the key or mouse button. Following this, and if the key or mouse button is found, it will be highlighted in the Available panel.

EXAMPLE: Type spacebar (or even sp) to highlight Spacebar in the Available panel.

10.5.2. Ordering

The order modifier keys (Alt, Ctrl and Shift) are pressed prior to other keys or a mouse button being simultaneously pressed is determined by the order they appear in the Selected panel.

EXAMPLE: If Alt then G are listed in the Selected panel, then Alt followed by G are pressed.

To change the order keys and mouse buttons appear in the Selected panel, perform the following actions:

1. Click the key or mouse button that needs to be moved.
2. Click the Up button () or Down button () to the right of the Selected panel until the key or mouse button is positioned as required.

10.5.3. Removing

To remove a key or mouse button from the Selected panel it must be moved back to the Available panel. To move a key or mouse button to the Available panel, click the key or mouse button in the Selected panel then click the Move to Available button ().

10.6. Accessing the Mouse Settings

To access the mouse settings in the Mouse panel, click a mouse button (e.g. Left mouse button) in the Selected panel.

10.7. Specifying How a Mouse Button is Used

Normally, when a mouse button is selected, an action such as clicking or double clicking will need to be specified so something within the game can be performed. The Button Action setting enables this.

10.7.1. Button Action Setting Options

The Button Action setting has the following options:

10.7.2. Performing a Single Click

If an item in the game window such as a button or an enemy needs to be clicked, the Click option for the Button Action setting must be selected.

To perform a single click of the mouse button, click the Click radio button for the Button Action setting.

NOTE: The Duration setting determines the time between the button down and button up action of the click.

10.7.3. Performing a Double Click

If an item in the game window such as a button needs to be double clicked, the Double Click option for the Button Action setting must be selected.

To perform a double click of the mouse button, click the Double Click radio button for the Button Action setting.

NOTE: The Duration setting determines the time between each button click.

NOTE: When the Double Click option for the Button Action is selected, the Cursor End settings are disabled because they become irrelevant.

10.7.4. Doing Nothing

If the cursor needs to be moved from its existing position to another position in the game window without the mouse button being pressed, the None option for the Button Action setting must be selected.

EXAMPLE So the cursor/crosshair tracks a target in an FPS without shooting it.

To not press the mouse button, click the None radio button for the Button Action setting.

NOTE: The Duration setting is still performed and determines how long it takes the mouse button to move from the start position to the end position (if specified).

10.8. Specifying Whether the Mouse Moves the Cursor or the Game View

Moving the mouse either moves the cursor within the game window or moves the view within the game window. The Cursor Coordinates setting enables one of these methods to be used.

10.8.1. Cursor Coordinates Setting Options

The Cursor Coordinates setting has the following options:

10.8.2. Moving the Cursor Within the Game Window

If the cursor needs to be moved to a position within the game window, the Absolute option for the Cursor Coordinates setting must be selected.

EXAMPLE: Moving the cursor to a button so it can be clicked.

To move the cursor within the game window, click the Absolute radio button for the Cursor Coordinates setting.

10.8.3. Moving the View Within the Game Window

If the view within the game window needs to be moved while the cursor remains in a fixed position (normally the centre), the Relative option for the Cursor Coordinates setting must be selected.

EXAMPLE: Moving the view in an FPS game to position an enemy within the crosshair.

To move the view within the game window and enable the Multiplier X and Multiplier Y settings, click the Relative radio button for the Cursor Coordinates setting.

10.8.3.1 Optimising the Movement of the View Within the Game Window

Due to many factors including mouse sensitivity and the distance from point A to point B in the game window, moving the view within the game window (like in an FPS game) may not be optimal with the default settings. As a result, the view may move too slowly (the "jumps" required to move from point A to point B in the game window are too small) or too fast (the "jumps" required to move from point A to point B in the game window are too large). To overcome this, the Multiplier X and Multiplier Y settings are provided.

If the view within the game window moves too slowly from point A to point B then increase the Multiplier X and/or Multiplier Y settings.

If the view within the game window moves too fast from point A to point B (and possibly even going past point B then back to point B) then decrease the Multiplier X and/or Multiplier Y settings.

The Multiplier X and Multiplier Y settings determine the efficiency of moving the view of the game window and therefore, if used for an FPS aim bot, how quickly a target ends up within the crosshair ready to be shot. It is therefore important to spend time finding the optimal values for these settings.

To change the Multiplier X and Multiplier Y setting values, perform the following actions:

1. Click inside the Multiplier X or Multiplier Y setting edit box.
2. Delete the existing value.
3. Type a new value.

NOTE: The Absolute option of the Cursor Coordinates setting must be selected before the Multiplier X and Multiplier Y settings are enabled.

NOTE: If the game allows, changing settings such as mouse sensitivity within the game will also have a similar result as changing the Multiplier X and Multiplier Y settings.

10.9. Specifying the Position of the Cursor

The start position of the cursor must be specified so Chimpeon knows where in the game window to initially move the cursor to after the associated Expression is satisfied.

EXAMPLE: Move the cursor to a target when a pixel within it is detected (e.g. to shoot an enemy in an FPS game); Remain in the current cursor position (e.g. to repeatedly click in a clicker game); Move the cursor over a button when a pixel within it is detected (e.g. to start a dungeon or raid in an MMORPG).

The end position of the cursor must be specified so Chimpeon knows where in the game window to move the cursor to after it has moved to the start position.

EXAMPLE: Move the cursor so a game item (that was picked up at the start position) is placed somewhere else.

The Cursor Start Position and Cursor End Position settings determine the start position and end position of the cursor respectively.

10.9.1. Cursor Start Position Setting and Cursor End Position Setting Options

The Cursor Start Position and Cursor End Position settings have the following options:

10.9.2. Using the Last Detected Pixel Position

If the Pixel Detection option for an associated Condition's Process setting is used, the last detected pixel position can be used to determine the start position and end position of the cursor.

EXAMPLE: When a pixel is detected in a target that needs to be shot; When a pixel is detected in a resource icon that needs to be collected; When a pixel is detected in a button that needs to be pressed.

To use the last detected pixel position as the start position or end position of the cursor, click the Cursor Start Position or Cursor End Position list box then click the Last Detected option.

10.9.3. Using the Real-Time (Current) Cursor Position

The real-time (current) cursor position in the game window can be used as the start position and end position of the cursor.

EXAMPLE: When the cursor has already been moved to a position in the game window (like a target) by another Trigger; when the cursor is anywhere in the game window and pressing a mouse button performs something (i.e. a clicker game); when the cursor has been manually moved.

To use the real-time cursor position as the start position or end position of the cursor, click the Cursor Start Position or Cursor End Position list box then click the Real-Time option.

HINT: The Real-time option can be used when configuring Chimpeon as an FPS "aim bot". It would be used to click the mouse button (which fires the weapon) at the current mouse cursor position if an associated Condition detected a pixel in the target. It overcomes the issue where a Trigger configured to look for the target is unable to move the crosshairs (mouse cursor) to the target in the first attempt (due to many reasons such as mouse sensitivity and the distance from the target to the crosshair) and as a result, fire the weapon prematurely and miss the target. Using a second Trigger that uses the Real-Time option for pixel detection and for pressing the mouse button, ensures the weapon is only fired when the crosshair is actually on the target.

If the cursor does not need to be moved to a different position after it has been moved to its start position (i.e. a different cursor end position to that of the cursor start position is not required) the Real-Time option should be selected for the Cursor End Position setting.

10.9.4. Using a User Defined Cursor Position

A user defined position can be used as the start position and end position of the cursor.

EXAMPLE: When any object that always appears in a fixed position in the game window needs to be selected or pressed.

To use a user defined position as the start position or end position of the cursor and to enable the User X and User Y settings, click the Cursor Start Position or Cursor End Position list box then click the User option.

MORE: For details about specifying the User X and User Y settings, refer to Keys and Mouse > Specifying a User Defined Cursor Position.

10.9.5. Using the Detected Pixel Position of a Condition

If a Trigger has more than one Condition that uses pixel detection, the last detected pixel (derived from the last Condition in the Conditions panel that uses pixel detection) would be used when the Last Detected option for the Cursor Start Position or Cursor End Position setting is specified. However, if a pixel that is not the last detected pixel needs to be the start position or end position of the cursor, the required Condition can be specified.

To use the detected pixel position of a Condition as the start position or end position of the cursor, click the Cursor Start Position or Cursor End Position list box then click the name of the Condition.

10.10. Making the Cursor Position Random

If the cursor is continually moved to the same position, game developers may be able to determine that an automated process is being used. Therefore, introducing a random element to the cursor position will make it more human-like and likely less detectable.

The Cursor Start Position setting and Cursor End Position setting each have an associated Random setting. Each determines whether the start position and end position of the cursor is random or not random by a specified number of pixels above or below and left or right from where the cursor would normally be positioned.

EXAMPLE: If the Random setting value is 5 pixels and the X coordinate of the cursor is 20 and the Y coordinate of the cursor is 30, the random position for the X coordinate is any value between 15 and 25 and the random position for the Y coordinate is any value between 25 and 35.

NOTE Specifying 0 as the value for the Random setting means the associated cursor position is not random.

To make the start position or end position of the cursor random (or not random if 0 is specified), perform the following actions:

1. Click inside the Random setting edit box.
2. Delete the existing value.
3. Type a new value in pixels.

10.11. Specifying a User Defined Cursor Position

When the cursor always needs to be in a specific start position or end position, a user defined cursor position can be specified.

EXAMPLE: To move the cursor to a button that always appears in the same position.

A user defined cursor position can be specified in the following ways:

• Game window
• User X and User Y Settings

NOTE: The User option for the Cursor Start Position or Cursor End Position setting must be selected before an associated user defined cursor position can be specified.

10.11.1. Using the Game Window

To specify a user defined start position or end position for the cursor using the game window, position the cursor in the required position within the game window then press the left CTRL key for the cursor start position or the right CTRL key for the cursor end position. Following this, the coordinates of the position appear in the associated User X and User Y setting edit boxes.

10.11.2. Using the User X and User Y Settings

To specify a user defined start position or end position for the cursor using the User X and User Y settings, perform the following actions:

1. Click inside the User X or User Y setting edit box.
2. Delete the existing value.
3. Type a new value in pixels.

10.12. Offsetting the Cursor

If the cursor start position or cursor end position is not actually the required cursor position, then the cursor position can be offset.

EXAMPLE: To move the crosshair in an FPS so it targets a specific yet undetectable part of the enemy; to move the crosshair in front of a moving target so the bullet hits it (i.e. leading the target).

The Offset X and Offset Y settings determine how far in pixels the start position and end position of the cursor are offset in the x-axis and y-axis from the start position and end position of the cursor respectively. A positive value offsets the cursor to the right in the x-axis and down in the y-axis. A negative value offsets the cursor left in the x-axis and up in the y-axis.

EXAMPLE: If the x-axis coordinate for the cursor start position is 20 pixels and the Offset X setting value is 5 pixels, the x-axis coordinate for the cursor start position becomes 25 pixels.

To specify an offset, perform the following actions:

1. Click inside the Offset X or Offset Y setting edit box.
2. Delete the existing value.
3. Type a new value in pixels.

10.13. Returning the Cursor to the Start Position

If the end position of the cursor needs to be different to the start position of the cursor and the cursor needs to return to the start position, the Return to Start setting can be enabled.

To keep the cursor at the end position or immediately make it return to the start position, click the Return to Start checkbox to add or remove a tick. A tick indicates the cursor returns to the start position. Blank indicates the cursor remains at the end position.

HINT: If immediately returning the cursor to the start position does not achieve its purpose, a second Action can be configured to move the cursor from the end position to the start position instead. Use the Real-time option for the Cursor Start Position setting (i.e. the other Action's end position) and the User Defined option for the Cursor End Position setting. Now set the User X and User Y settings to the values of the other Action's end position.

Keys and Mouse

11. Macro

In this section, the following information is provided:

• 11.1. Overview
• 11.2. Configuration Settings
• 11.3. Starting and Stopping Recording
• 11.3. Starting and Stopping Playback

11.1. Overview

A sequence of keystrokes and mouse actions performed in a game need to be performed by Chimpeon, they can be recorded as a macro. This macro can then be performed for an Action.

A macro is recorded in the Macro window (see Fig. below) which is opened by performing the following actions:

1. Click the Perform setting list box of an Action.
2. Click the Macro option.
3. Click the Settings button () to the right of the Perform setting list box.

Fig. Macro window

Keystrokes and mouse actions are recorded for the game specified for the Send To setting of the Profile.

11.2. Configuration Settings

The Macro window (see Fig. above) has the following configuration settings and components:

11.3. Starting and Stopping Recording

To start or stop the recording of a macro, perform one of the following actions:

• Click the Record Start/Stop button.*
• Press the Record Start/Stop Hot Key.

*NOTE: Using the Record Start/Stop button may not be preferable because the mouse cursor needs to be moved from and to it, the process of which is recorded. It is therefore recommended to use the Record Start/Stop Hot Key when (and if applicable) the position of the cursor is at the correct start location in the game.

11.3. Starting and Stopping Playback

Prior to using a recorded macro, it is advised it is tested.

To playback a macro, perform the following actions:

• Click the Playback Start/Stop button.*
• Press the Playback Start/Stop Hot Key.

*NOTE: Using the Playback Start/Stop button may not be preferable because the mouse cursor needs to be moved from it to the game, the process of which will be interupted by the keystrokes and mouse actions of the macro. It is therefore recommended to use the Playback Start/Stop Hot Key when (and if applicable) the position of the cursor is at the correct start location in the game.

Macro

12. Status Hot Keys

In this section, the following information is provided:

• 12.1. Overview
• 12.2. Configuration Settings
• 12.3. Managing
• 12.4. Specifying a Modifier Key
• 12.5. Specifying a Key
• 12.6. Configuring Status Hot Key Triggers

12.1. Overview

Status Hot Keys are used to turn on, turn off and execute one or more Triggers manually or automatically while Chimpeon is started.

EXAMPLE: Manually press a key to turn off single target spell Triggers and turn on multi-target spell Triggers.

EXAMPLE: Automatically turn off a Trigger when the Expression associated with another Trigger is satisfied.

Turning on sets the Status setting of the Trigger to On. Turning off sets the Status setting of the Trigger to Off. Executing checks to see if the Expression associated with the Trigger is satisfied and if it is the associated Action(s) are performed.

Status Hot Keys are displayed and managed in the Status Hot Keys window (see Fig. below) which is opened by clicking the Status Hot Keys button () (above the Triggers panel).

Fig. Status Hot Keys window

12.2. Configuration Settings

Each Status Hot Key has the following configuration settings:

12.3. Managing

Status Hot Keys can be selected, added, deleted, duplicated and moved.

MORE: For details about these processes, refer to Getting Started > Interface Overview > Using Panels and Managing Items.

12.4. Specifying a Modifier Key

The Shift, Ctrl and Alt settings determine whether a corresponding modifier key should be pressed at the same time as the key specified for the Hot Key setting.

Click the Shift, Ctrl or Alt setting checkbox then click it again to add or remove a tick. A tick indicates the associated key must be pressed. Blank indicates the associated key is not used.

12.5. Specifying a Hot Key

The Hot Key setting determines the key that must be pressed to turn on, turn off and/or execute specified Triggers manually.

NOTE: The Hot Key setting is not required (and can be left blank) if the associated Status Hot Key will be used automatically (i.e. by specifying it for an Action's Perform setting value.

To specify a key, perform the following actions:

1. Click the Hot Key setting edit list box.
2. If an existing key already exists, delete it then type a key, or
3. Click the arrow to the right of the Hot Key setting edit list box.
4. Click the name of the key in the list.

12.6. Configuring Status Hot Key Triggers

A Status Hot Key can perform one or more of the following actions when used:

• Turn on one or more Triggers
• Execute one or more Triggers if their associated Expression is satisfied
• Turn off one or more Triggers

One or more Triggers can be assigned to these actions in the Status Hot Key Triggers window (see Fig. below) which is opened by clicking the Triggers button (...) of a Status Hot Key in the Status Hot Keys window (see Fig. above).

Fig. Status Hot Key Triggers window

12.6.1. Turn On One or More Triggers

One or more Triggers can be turned on (i.e. the Status setting for the Trigger(s) changes to On) when the associated Status Hot Key is manually or automatically used. This is accomplished by moving the required Trigger(s) to the Turn On panel in the Status Hot Key Triggers window (see Fig. above).

MORE: For further details about moving Triggers to the Turn On panel, refer to Moving Triggers.

12.6.2. Execute One or More Triggers

One or more Triggers can be executed (if their associated Expression is satisfied) when the associated Status Hot Key is manually or automatically used. This is accomplished by moving the required Trigger(s) to the Execute panel in the Status Hot Key Triggers window (see Fig. above).

MORE: For further details about moving Triggers to the Execute panel, refer to Moving Triggers.

12.6.3. Turn Off One or More Triggers

One or more Triggers can be turned off (i.e. the Status setting for the Trigger(s) changes to Off) when the associated Status Hot Key is manually or automatically used. This is accomplished by moving the required Trigger(s) to the Turn Off panel in the Status Hot Key Triggers window (see Fig. above).

MORE: For further details about moving Triggers to the Turn Off panel, refer to Moving Triggers.

12.6.4. Toggle a Trigger Status Off and On

The Toggle Off/On setting determines whether a Status Hot Key operates like a toggle or not.

To enable or disable the toggle, click the Toggle Off/On setting checkbox to add or remove a tick. A tick enables the toggle and causes Triggers in the Turn On and Turn Off panels to be turned on or turned off respectively when the Status Hot Key is used for the first time then turned off or turned on respectively when the Status Hot Key is used for the second time. Blank disables the toggle.

EXAMPLE (if enabled): If a Status Hot Key is configured to turn off Trigger A and turn On Trigger B, the first use would turn off Trigger A and turn on Trigger B, and the second use would turn on Trigger A and turn off Trigger B.

MORE: For details about applying a sound to the Toggle Off/On setting, refer to Applying a Sound.

12.6.5. Applying a Sound

To receive an audible indication of when a Status Hot Key is pressed, a sound file (WAV) can be selected and applied to it. An additional sound file can also be applied to the Toggle Off/On setting if it is enabled.

To add a sound file, perform the following actions:

1. Click the File button () to the right of the applicable Sound edit box in the Status Hot Key Triggers window to open the Browse window.
2. Locate then select the required sound file (WAV files are supported).
3. Click the Open button to close the Browse window and apply the path and filename of the sound file to the Sound edit box.

12.6.6. Moving Triggers

Triggers can be moved from their Triggers panel to the associated Turn On, Execute or Turn Off panel and vice versa using the Move All and Move Selected buttons provided in the Status Hot Key Triggers window (see Fig. above).

• >> Move All right
• > Move Selected right
• << Move All left
• < Move Selected left

To move a single Trigger, click it then click the appropriate Move Selected button.

To move multiple Triggers in the same panel, hold the Ctrl key, click each Trigger in turn, release the Ctrl key then click the appropriate Move Selected button.

To move all Triggers in the same panel, click the appropriate Move All button.

12.6.7. Ordering Triggers

The order in which Triggers appear in the Turn On, Execute and Turn Off panels of the Status Hot Key Triggers window (see Fig. above), determines the order they are either turned on, executed or turned off.

To move a single Trigger, click it then click the associated Up button or Down button to move it up or down in the panel.

To move a multiple Triggers in the same panel, hold the CTRL key, click each Trigger in turn, release the Ctrl key then click the associated Up button or Down button to move them up or down in the panel.

Status Hot Keys

13. Preferences

In this section, the following information is provided:

• 13.1. Overview
• 13.2. General Settings
• 13.3. Proxy Settings

13.1. Overview

Preferences are configuration settings that control general aspects of Chimpeon or determine the default values of other configuration settings. All appear in the Preferences window (see Fig. below) which is opened by clicking the Options menu then clicking the Preferences option.

Fig. Preferences window

Click the OK button to close the Preferences window and apply the changes made to configuration settings.

Click the Cancel button to close the Preferences window and cancel the changes made to configuration settings.

The Preferences window has the following configuration settings:

• General Settings
• Proxy Settings

13.2. General Settings

The following general settings appear in the Preferences window:

• Check For Update On Launch
• Check For Notification On Launch

13.2.1. Check For Update on Launch

The Update window that opens by default when Chimpeon is launched and when an update is available, is enabled and disabled in the Preferences window using the Check For Update on Launch setting.

Click the Check For Update On Launch setting checkbox to add or remove a tick. A tick enables (opens) the Update window on launch if an update is available. Blank disables (does not open) the Update window on launch.

NOTE: If a critical update is available (i.e. an update that must be performed to continue using Chimpeon), the Critical Update window is opened on startup even if the Check For Update On Launch setting is disabled.

MORE: For further details about updating Chimpeon, refer to Getting Started > Updating.

MORE: For further details about the Update window, refer to Getting Started > Launching > Launch Windows > Update.

13.2.2. Check For Notification On Launch

The Notification window that opens by default when Chimpeon is launched and when a notification is available, is enabled and disabled in the Preferences window using the Check For Notification on Launch setting.

Click the Check For Notification On Launch setting checkbox to add or remove a tick. A tick enables (opens) the Notification window on startup if a notification is available. Blank disables (does not open) the Notification window on startup.

MORE: For further details about the Notification window, refer to Getting Started > Launching > Launch Windows > Notification.

13.3. Proxy Settings

If your PC connects to the Internet using a proxy it is likely proxy settings will need to be specified so Chimpeon can connect to the Chimpeon server.

MORE: For further details about proxy settings, refer to Getting Started > Proxy Settings.

Preferences

14. Log

In this section, the following information is provided:

• 14.1. Overview
• 14.2. Messages
• 14.3. Starting and Stopping
• 14.4. Showing and Not Showing When Started
• 14.5. Showing a Simple Log
• 14.6. Retaining
• 14.7. Copying to the Windows Clipboard

14.1. Overview

The Log shows useful information about what Chimpeon is doing when it is started. It is provided to troubleshoot issues, monitor performance or simply show that something is happening.

Log messages appear in the Log panel (see Fig. below) which is displayed by clicking the Log tab.

Fig. Log panel

CAUTION: When Chimpeon is started, messages already displayed in the Log panel are removed prior to new ones being added.

14.2. Messages

The Log panel displays the following messages all of which are prefixed with the time they occurred:

14.3. Starting and Stopping

The Log panel can display a huge number of messages when Chimpeon is started. As a result, the performance of Chimpeon can be reduced which can cause processes such as pixel detection to be less than optimal. Therefore, the Log can be turned off to prevent messages being displayed and maximise performance.

Click the Start Log button (see Fig. below) to show messages in the Log panel when Chimpeon is started.

Fig. Start Log button

Click the Stop Log button (see Fig. below) to prevent messages being shown in the Log panel when Chimpeon is started.

Fig. Stop Log button

14.4. Showing and Not Showing When Started

The Show Log When Started setting is used to automatically show or not show the Log panel when Chimpeon is started.

Click the Show Log When Started setting checkbox to add or remove a tick. A tick causes the Log panel to be shown when Chimpeon is started. Blank prevents the Log panel being shown when Chimpeon is started (unless it is already shown).

14.5. Copying to the Windows Clipboard

If you encounter a problem while using Chimpeon, it may be beneficial to copy the content of the log and send it to Fly Software so they can better ascertain what caused the issue.

To copy the content of the log to the Windows Clipboard, click the Copy Log button ().

Log

15. Troubleshooting

In this section, the following information is provided:

• 14.1. Overview
• 14.2. Resources

15.1. Overview

Chimpeon is a complex application as are the tasks it is developed to perform. It is therefore expected that automating a game will not work immediately after creating a configuration, and time and patience will be required to resolve issues and optimise what you want it to do. Remember, Chimpeon can't magically do everything in a game so it is important you know its limitations and take the time to learn what it can do using the resources provided.

15.2. Resources

The following resources will help you overcome problems encountered when using Chimpeon or give you a head start on configuring specific tasks:

Troubleshooting