📖Luarmor User Manual & F.A.Q

✅Quickstart Guide✅

If you just started using Luarmor, you should read this quick start guide. It will take you only 10 minutes to understand how Luarmor works.

1️⃣ Create an account:

• In order to use Luarmor, you need to create an account. And for that, you need an "invite code". Invite codes can be purchased here --> https://luarmor.net#prices

• Alternatively, you can use an invite code to extend your membership for +30 extra days here --> https://luarmor.net/profile

2️⃣ Upload your script:

3️⃣ Whitelist users:

If you are migrating from another whitelist service, or your own, you can easily import your users with 2 clicks. Skip to this part for mass whitelisting details.

Once the user is whitelisted, they can execute the script by adding script_key = "KEY HERE"; on top of the script. Note that keys are linked to user's HWID and sharing the key with someone else won't work because they will have a different HWID.

4️⃣ Reset HWID:

In some cases, user's HWID might change on its own, when that happens, they must run /resethwid via discord bot and re-execute the script. It will automatically assign the new HWID upon execution.

If you think someone might be sharing their key and using /resethwid for others, simply compare action fingerprint in the resethwid notification

⚡Runtime Variables⚡

Luarmor has runtime variables that allows you to access to user details such as discord id, total executions, script name, premium, user note etc..

They can be used for a lot of things. Check out this example:

⚙️ Discord Bot Configuration ⚙️

You can automate everything using this discord bot. Or you can write your own bot using our API documentation.

If you're a Luarmor buyer, discord bot invite will be sent to you via DM. After inviting the bot, run /login command and link the server.

👑 Mass Whitelist - Import Users 👑

If you already have users with a specific role, you can easily mass whitelist every single one of them with one command.

Alternatively, you can import them as a JSON file.

🔑 Key Check Library

Ideally, you would want to run this library before the obfuscated code (luarmor loadstring) runs. So you can implement your custom logic to handle invalid / expired keys by displaying the error message to the user without kicking or crashing the client.

Here's how to import it:

local api = loadstring(game:HttpGet("https://sdkapi-public.luarmor.net/library.lua"))()
--> Returns a table with methods that you can use.
-- You must initialize it with the script ID first.

-- Put your own script ID Below:
-- You can find it in your loadstring URL or projects tab.
api.script_id = "f42f3746fb3eb60f837d3673581c14a6"

-- make the API request:
local status = api.check_key(script_key or textLabel1.Text); -- pass 32-char user key here
print(status) --> table {code:<string>, message:<string>, data?:<table>}

-- custom logic below:
if (status.code == "KEY_VALID") then

    -- fetch basic info about the key (only if KEY_VALID)
    ui:SetBanner("Welcome. Seconds left: " .. (status.data.auth_expire - os.time()))
    ui:UpdateTitle("Total executions: ", status.data.total_executions)
    
    print("Is key from ad system? " .. status.data.note == "Ad Reward" and "YES" or "NO")
    
    script_key = script_key or textLabel1.Text; -- SET THE KEY BEFORE LOADSTRINGING.
    
    api.load_script(); -- Executes the script, based on the script_id you put above.
    -- Alternatively, you can just put the loadstring you got from luarmor website.
    -- You must specify the script_key global either way.
    return
    
elseif (status.code == "KEY_HWID_LOCKED") then
    ui:Notify("Key linked to a different HWID. Please reset it using our bot")
    return
    
elseif (status.code == "KEY_INCORRECT") then
    ui:Notify("Key is wrong or deleted!")
    return    
else
    -- fallback to anything else e.g blacklisted, key empty/too short:
    player:Kick("Key check failed:" .. status.message .. " Code: " .. status.code)
end

-- You can see a full list of possible status codes and status messages below.

Possible status codes:

Response body will always be a JSON. In case of KEY_VALID, an additional "data" field will be included in the table, with these fields:

KEY_VALID "data" fields:

Library Methods

You can see a full list of functions that are provided by the library.

🎁 Ad System (Rewards)

Refer to "Ad System (Rewards)" page.