ControllerIconMapping | custom controller icons made easy for roblox

i stole this from resurface

introduction

what is ControllerIconMapping?

ControllerIconMapping is a module i originally built for r6 emote haven for its custom proximity prompt’s console support.

go play it!

it helps developers add their own custom gamepad icons for their experiences, and supports all of the current buttons that controllers have.

why should i use ControllerIconMapping?

ControllerIconMapping helps reduce the time you need on making your own icon mapping system, as this system allows you to customize all the controller icons for xbox, ps4 and ps5, using some techniques to differentiate the three controller types.

or just use it if you want idk


features

  • custom gamepad icons
  • ability to check what console/controller type is the player on

installation

  1. get the model

  2. place the module anywhere you like (i recommend ReplicatedStorage)
  3. change the attributes in the 5 different configurations to your asset id’s
  4. require the module in your script
  5. use the functions from the api and you’re good to go!

video showcase of the module


api

ControllerIconMapping:GetControllerType()
returns the current console/controller type

ControllerIconMapping:GetIcon(keyCode: Enum.Keycode)
returns the asset id associated with the given Enum.Keycode


known bugs

  • unable to differentiate ButtonShare and ButtonTouchpad (roblox side issue)

support

if you would like to support development of this resource, you may… do nothing! making this resource to help everyone is already great enough for me, if you would still like to support this resource you may share it with others to use if you like it.

made with :heart: by 1mangotable


4 Likes

small update

  • changed the format of the IconsConfig folder, instead of going into a configuration and editing all the stringvalue’s they are all in the configuration itself now
  • changed how playstation icons are implemented for easier editing (icons that are different between ps4 and ps5 are put in a PlaystationExclusive folder while normal playstation icons are put in the PlayStation config)

get the model now