KeyLibrary

Better Way To Create Key Binds / Key Handlers With Integrated Support For (KeyHolding, Key Toggling and etc.)

-- Chad Way
local Key = loadstring(game:HttpGet('https://raw.githubusercontent.com/Perthys/KeyLibrary/main/main.lua'))()
local UserInputService = game:GetService("UserInputService")

local Test = Key.new({Enum.KeyCode.A, Enum.KeyCode.B, Enum.KeyCode.C}, function(self, Input)
    print(self.Key)
end) 

-- Virgin Way
UserInputService.InputEnded:Connect(function(Input, GameProcessedEvent)
    if Input.KeyCode == Enum.KeyCode.A then
        print("a")
    elseif Input.KeyCode == Enum.KeyCode.B then
        print("b")
    elseif Input.KeyCode == Enum.KeyCode.C then
        print("b")
    end
end)

-- Semi Better But Still bad
local KeyBindHandler = {
    [Enum.KeyCode.A] = {
        [1] = function()

        end,
    }
}

UserInputService.InputBegan:Connect(function(Input, GameProcessedEvent)
	if not GameProcessedEvent then
		if Input.UserInputType == Enum.UserInputType.Keyboard and KeyBindHandler[Input.KeyCode] then
			for _, func in ipairs(KeyBindHandler[Input.KeyCode]) do
				func()
			end
		elseif KeyBindHandler[Input.UserInputType] then
			for _, func in ipairs(KeyBindHandler[Input.UserInputType]) do
				func()
			end
		end
	end
end)


Test:Unbind()

Key.new Variant 1

Name	Type	Description
Key(s) {required}	EnumItem (UserInputType, KeyCode) / Table	This Argument is used for registering KeyBinds you may pass a table or a single enum item
Name {optional}	String {Default: Auto-Increment Integer}	This Argument is used to denominate the Key Bind, Using a name multiple times will auto-increment it. If you do not pass any value it will give a auto incrementing integer value.
Handler {required}	Function	This Function is called when the KeyBind is activated.
Type {optional	String {Default: Tap}	This Argument is used for determining the KeyBind type, there are 3 types {Tap, Toggle, Hold}

Example:

local Example1 = Key.new(Enum.KeyCode.X, function(self, Input)
    print(self.Key, self.Type)
end)

-- Remove KeyBind
Example1:Unbind()

Key.new Variant 2

Name	Type	Description
Key(s) {required}	EnumItem / Table	This Argument is used for registering KeyBinds you may pass a table or a single enum item
Data {required} => Name {optional} => Handler {required} => Type {optional}	Table	This Table is used for Passing Data with a different syntax.

Example:

-- Supports Different Syntax
local A =  Key.new(Enum.KeyCode.A, {
    Name = "Test";
    Handler = function(self, Input)
        print(self.Key, self.Type, self.Name) 
    end,
})


local Mouse1 =  Key.new(Enum.UserInputType.MouseButton1, { 
    Name = "Test";
    Handler = function(self, Input)
        print(self.Key, self.Type)  
    end,
    Type = "Hold"
})
-- Remove KeyBinds
A:Unbind()
Mouse1:Unbind()

Key.AsyncNew

Exact Same Syntax As Previously but it returns a promise

Example

Key.AsyncNew({Enum.KeyCode.A, Enum.KeyCode.B, Enum.KeyCode.C}, function(self, Input) print(self.Key) end, "Hold"):andThen(function(Obj)
    Obj:Unbind():andThen(function()
        
    end)
end)

Key.NewCombination