CC:Gamepad

CC: Gamepads adds a CC:Tweaked peripheral block which lets ComputerCraft computers read real gamepad/controller input from players.

The controller is read on the player client, sent to the server, and exposed to Lua through a bound Gamepad Peripheral. This works in singleplayer, LAN, and dedicated multiplayer servers.
Requirements

Minecraft 1.21.1
NeoForge 21.1.x
CC:Tweaked 1.117.1

How To Use

Place a Gamepad Peripheral block next to, or connected by modem to, a CC:Tweaked computer.
Hold a Gamepad item.
Sneak-right-click the Gamepad Peripheral with the Gamepad item to bind it.
Keep the bound Gamepad item in your main hand or off hand.
Plug in/connect with bluetooth your/a controller and run Lua code on the computer.

Up to 4 players can send input to the same Gamepad Peripheral at once. Each player gets a slot from 1 to 4.
Lua Peripheral

Wrap the peripheral like any other CC:Tweaked peripheral:

local pad = peripheral.find("gamepad")

Functions
getPlayers()

Returns a list of connected controller states.

Each entry includes:

slot: player slot, 1 to 4
player: player name
playerId: player UUID
controllerId: client controller id
controllerName: controller name
guid: controller GUID
buttons: numbered button table
buttonNames: named button table
axes: numbered axis table
axisNames: named axis table
updatedAt: server timestamp

getState(slot)

Returns the full state table for one slot.

Throws an error if no controller is bound to that slot.
isDown(slot, button)

Returns true if a numbered button is held.

Buttons:

A
B
X
Y
Left bumper
Right bumper
Back/select
Start
Guide/home
Left stick
Right stick
D-pad up
D-pad right
D-pad down
D-pad left

isButtonDown(slot, name)

Returns true if a named button is held.

Names:

a b x y
leftBumper rightBumper
back select start guide home
leftStick rightStick
dpadUp dpadRight dpadDown dpadLeft

getAxis(slot, axis)

Returns a numbered axis value.

Axes:

Left X, -1 to 1
Left Y, -1 to 1
Right X, -1 to 1
Right Y, -1 to 1
Left trigger, 0 to 1
Right trigger, 0 to 1

getAxisValue(slot, name)

Returns a named axis value.

Names:

leftX leftY rightX rightY leftTrigger rightTrigger

getMaxPlayers()

Returns 4.
getButtonCount()

Returns 15.
getAxisCount()

Returns 6.
Events

When controller state changes, attached computers receive:

cc_events, "gamepad", slot, playerName, controllerId

Example:

local event, kind, slot, player, controllerId = os.pullEvent("cc_events")
if kind == "gamepad" then
print(player .. " updated slot " .. slot)
end

Example Lua Program

This prints basic state for slot 1 and exits when Start is pressed.

local pad = peripheral.find("gamepad")
if not pad then
error("No gamepad peripheral found")
end

print("Waiting for gamepad input...")

while true do
local event, kind, slot, player = os.pullEvent("cc_events")
if kind == "gamepad" and slot == 1 then
local lx = pad.getAxisValue(1, "leftX")
local ly = pad.getAxisValue(1, "leftY")
local a = pad.isButtonDown(1, "a")
local b = pad.isButtonDown(1, "b")

term.clear()
term.setCursorPos(1, 1)
print("Player: " .. player)
print(("Left stick: %.2f %.2f"):format(lx, ly))
print("A: " .. tostring(a))
print("B: " .. tostring(b))
print("Start exits")

if pad.isButtonDown(1, "start") then
  break
end

end
end

Multiplayer Notes

Controller input is only accepted from the player who sent it.
The player must be holding a Gamepad item bound to the target peripheral.
Controller IDs and GUIDs are verified server-side.
Packet sizes, string lengths, button counts, axis counts, and axis values are validated before the state is accepted.
Player state is cleared when they disconnect or when their controller list changes.