Community Scripts

For players

1. Put .lua files in your executor's workspace/KronHub/Community folder, or paste a raw link into Raw URL and press Import from URL.

2. Open the Community tab and press Load next to the script under Installed.

3. Its controls appear under Running. Click a card's header to collapse it. Press Unload to stop the script and remove its controls.

Scripts stay in the folder, so they're still listed the next time you open KronHub. Press Load to start one again.

Writing a script

Press Create Template in the Community tab. It writes workspace/KronHub/Community/Template.lua, which you can edit in any text editor. To reload after editing, press Unload and then Load.

--@name My Script
--@author YourName
--@version 1.0
--@description What your script does

local Tab, Hub = ...

Tab:NewSection("Main")

Tab:NewButton("Say hi", function()
    Hub:Notify("My Script", "Hello!", 3)
end)

Tab:NewToggle("Example toggle", false, function(state)
    print("Example toggle:", state)
end)

Tab is your card: everything you add shows up inside it, in the order you add it. Hub holds helpers like notifications. The method names and arguments are the same as KronHub's own tabs.

Header tags

The first lines of the file describe the script. KronHub reads them to fill the Installed list without running your code.

--@name Wire Art
--@author YourName
--@version 1.0
--@description Draws pictures with wires
--@url https://raw.githubusercontent.com/you/repo/main/WireArt.lua

Elements

Tab:NewSection("Main")

Tab:NewLabel("Some text")

local button = Tab:NewButton("Start", function()
    print("clicked")
end)

button.Text = "Stop"

local toggle = Tab:NewToggle("Auto chop", false, function(state)
    print("on?", state)
end)

toggle:Set(true)

Tab:NewSlider("Speed", 16, 16, 100, false, function(value)
    print(value)
end)

local trees = Tab:NewDropDown("Tree:", {"Oak", "Birch"}, function(choice)
    print(choice)
end)

trees:Update("Walnut")        -- add an option
trees:UpdateRemove("Birch")   -- remove an option
trees:SetList({"Oak", "Koa"}) -- replace every option
trees:SetName("Tree: Oak")    -- change the text on the box

Tab:NewKeyBind("Toggle fly", Enum.KeyCode.F, function(key)
    print(key, "pressed") -- "F"
end)

Tab:NewBox("Webhook", "", function(text)
    print(text)
end)

Cleaning up

When a player presses Unload, KronHub automatically:

• removes your card and all its elements
• stops every element callback, so buttons, toggles and keybinds do nothing after unload
• disconnects everything you connected with Tab:Connect
• runs your Tab:OnUnload functions

Anything else you start has to stop itself:

Tab:Connect(game:GetService("RunService").Heartbeat, function(dt)
    -- disconnected automatically on unload
end)

Tab:OnUnload(function()
    workspace.CurrentCamera.FieldOfView = 70 -- undo your changes here
end)

task.spawn(function()
    while Tab:IsAlive() do -- stops when unloaded
        task.wait(1)
    end
end)

Don't use while true do loops or plain :Connect calls. They keep running after unload, and run twice if the script is loaded again.

Hub helpers

Hub:Notify("My Script", "Done!", 3)

local progress = Hub:Progress("Moving:", 25) -- shows "Moving: 0/25"
for i = 1, 25 do
    progress:Update()                        -- 1/25, 2/25 … closes itself at 25/25
end
progress:Del()                               -- close it early

Errors

Your script and every callback run in protected mode, so an error doesn't break KronHub. It's printed in the F9 console as:

[KronHub Community] <script name>: <error>

If the script errors while loading, its card is removed and a notification says it crashed. Syntax errors are reported the same way.

Publishing

1. Upload the file somewhere with a raw link, such as GitHub raw or Pastebin raw.

2. Add --@url <that link> to the header. KronHub also adds it automatically on import.

3. Share the link. Players paste it into Raw URL and press Import from URL.

4. To ship an update, change the file at the same link. Players get it the next time they press Load.