solarlune/egpbc

egpbc is a gamepad constant library for Ebitengine games.

egpbc 🎮

egpbc is named constants for Nintendo, Sony, and Xbox game console controllers for Ebitengine.

(And so, egpbc stands for Ebitengine GamePad Button Constants.)

Why?

Because this is easier to visualize and use in development than using ebitengine's built-in gamepad constants, and it should be consistent regardless of what brand of controller you or your players use, as long as they're capable of being internally mapped to a standard gamepad device. In other words, this should mean that you can use Xbox constants while developing and the player should be able to use a PS5 controller without issue.

How to install

go get github.com/solarlune/egpbc

How to use

Each brand is contained within its own struct.

import "github.com/solarlune/egpbc"

func main() {

    // Each brand has its own constants struct that contains its button and axis 
    // constants and directions; this is done to make things easy to manage.
    xbox := egpbc.MicrosoftConstants

    if ebiten.IsStandardGamepadButtonPressed(0, xbox.A) {
        fmt.Println("The A Button was pressed.")
    }

    lsX := ebiten.StandardGamepadAxisValue(0, xbox.LeftStickX)
	lsY := ebiten.StandardGamepadAxisValue(0, xbox.LeftStickY)

    isLeftPressed := egpbc.AxisIsLeft(lsX)
    fmt.Println("left is pressed: ", isLeftPressed)

}

That's it.