KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

PoEController

★ 31 Open GitHub ↗

Use a joystick to play Path of Exile in the most natural way possible.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# READ THIS FIRST !

This project is a blast from the past. It was created prior to the introduction of console versions of Path of Exile, when they officially developed a client with the capability of using gamepads. Please refrain from using this program and wait [until Path of Exile 2](https://old.reddit.com/r/Games/comments/im2x1i/ama_im_chris_wilson_from_grinding_gear_games_we/g3wpzjg/) as it will probably have official gamepad support on PC.

However, due to a request from an user, who did not wish to use similar fan-made softwares for playing PoE with a gamepad on PC, I decided to port the entire project to ElectronJS, instead of NWJS. This new version has a [Developer's Guide](developers.md), since the goal is that it implements many types of gamepads for use within this application (Although I hope to just implement the ones I have).

Other software that does the same stuff as this and is better maintained: [Zhadok's poe-controller project](https://github.com/Zhadok/poe-controller)

# OLD README

# PoEController

An easy way to play [Path of Exile](http://www.pathofexile.com/) with a gamepad.

## Goals

The main problem with using a gamepad in Path of Exile is that the game is in no way designed to be friendly to few key bindings. It heavily focuses use of the mouse cursor and several key bindings for optimal gameplay.

Many people provided solutions to play Path of Exile with a gamepad before. However, the main focus of this solution is to reduce the need of using a gamepad input as a mouse cursor to a minimum.

# Solution

After some players' feedback, I decided to remove support for auto detection of game input method using pixels. It was just a very slow method for doing this and it was hard to maintain, as the game keeps being developed and many things change.

In the future, I want to try to scan the game's memory and change the input method based on that. However, it might not be allowed by their EULA terms.

# Old Solution below (1.0)

## Solution

The provided solution focus on mimicking the input methods of another similar game on game consoles, [Diablo 3](http://us.battle.net/d3).

So the focus is to give the players one thumbstick for character movement, some keys bound to access menus and freedom to bind the other keys to his character's abilities.

(Notice that you can hide the help overlay text in the main menu!)
<img src="screenshots/arpg-mode.png" alt="Main menu" width="100%" />

## How it works

The application detects what I called "pixel signatures" from the screen in an attempt to adjust the input methods accordingly to whats needed to be done by the player.

As you can see here, when a player opens his stash, and the application detects it, the input methods change drastically compared to the previous screenshot:
<img src="screenshots/stash-mode.png" alt="Main menu" width="100%" />

This solution has several drawbacks. It costs a lot, in terms of performance, and this asynchronous type of state detection creates an error prone environment, which leads to being an application hard to work in. My hopes lies with [GGG](http://www.grindinggear.com/) and the player community seeing this as a viable option to play the game and providing the necessary support to make this in the best possible way (APIs, add-on support, etc).

## General tips

- The application works better with the Steam's Path of Exile client version, since it tries to open it via steam link.
- Path of Exile's configuration file is rewritten on opening the application and restored when exiting it. There are some expected configurations for this to work properly. One of them is that the game will run in windowed fullscreen.
- While playing the game in ARPG mode, notice a red circle in the middle of the screen. Holding the "select" key will bring the mouse there while holding the game highlight key. Use the right trigger on the gamepad to loot and item there. This tries to mimic a common behaviour in old beat'em up games, where you had to position your character above an item on the ground and press a button to "loot" it.
- There will be times where you will be stuck (maybe between two hideout's masters or in a zone entrance) and will need to use the right thumbstick as mouse. It is minimal, but it happens.
- Sometimes you will also need to use the right thumbstick to loot. My advice is to position the red circle as close as possible to the item. This position paired with the "loot key" will provide minimal mouse movement to loot.
- This mod is better enjoyed for players who just like to chill on the couch.

## Mapped modes

- Stash
- Inventory
- World map (Waypoint)
- Passive skill tree
- Craft benches
- Game default mode (named as ARPG mode)
- Quest rewards

## Requirements

### In-game

- Left mouse click needs to be set to "move"

### Supported resolutions

- 1360x768
- 1366x768
- 1600x900
- 1920x1080

### Gamepad

The application fallbacks to the XBOX 360 controller driver. All gamepads that can work as such will work with the application. That is one of the reasons that the PS3 game overlay was implemented (eg: PS3 gamepad can work as XBOX 360 gamepad with [ScpToolkit](https://github.com/nefarius/ScpToolkit)).

## Known issues

- Don't try to make an action too quickly after accessing the options menu ("start" key on ARPG mode). It can bug and the application can think that you are in a mode (eg: inventory) but there isnt any related UI being displayed. If this happens, press the "start" key to go back to ARPG mode. This bug only happens if you are really quick on accessing a mode after opening the menu (aka: almost simultaneously).

PoEController

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README