Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.leaf7.fun/llms.txt

Use this file to discover all available pages before exploring further.

​
L7 Script Macros

Leaf7 injects runtime macros into your script environment so you can access user-specific data like Discord IDs, execution counts, and key expiry — all without any API calls from the client.
Macros are environment-scoped. They only exist during your script’s execution and are immediately wiped afterwards. Other scripts running in the same executor cannot read your macro values.

​
Available macros

Use these variables directly in your Lua source code — no setup required. Leaf7 detects which ones you reference and injects only those.
MacroTypeDescription
L7_LinkedDiscordIDStringDiscord ID of the user executing the script
L7_ScriptNameStringName of your project as set in the dashboard
L7_ScriptVersionStringCurrent version of your project (e.g. "1.2.3")
L7_TotalExecutionsNumberHow many times this user has executed the script
L7_SecondsLeftString / NumberSeconds until key expires, or "Lifetime" for non-expiring keys
L7_UserNoteStringCustom note set on the key (or "FFA" for free-for-all)

​
Usage example

Simply reference the macro names in your source code. No imports, no tables, no setup: 
print("Welcome!")
print("Your Discord ID: " .. L7_LinkedDiscordID)
print("Script: " .. L7_ScriptName .. " v" .. L7_ScriptVersion)
print("Total executions: " .. tostring(L7_TotalExecutions))
print("Time left: " .. tostring(L7_SecondsLeft))
print("Note: " .. L7_UserNote)
Output for a user with a 30-day key: 
Welcome!
Your Discord ID: 123456789012345678
Script: Premium Hub v1.2.3
Total executions: 47
Time left: 2592000
Note: VIP Customer
Output for a lifetime FFA user: 
Welcome!
Your Discord ID: 
Script: Premium Hub v1.2.3
Total executions: 1
Time left: Lifetime
Note: FFA

​
Practical examples

​
Welcome screen with key info

local Players = game:GetService("Players")
local player = Players.LocalPlayer

-- Build a personalized greeting
local timeLeft = L7_SecondsLeft
local timeStr

if timeLeft == "Lifetime" then
    timeStr = "♾️ Lifetime"
else
    local days = math.floor(timeLeft / 86400)
    local hours = math.floor((timeLeft % 86400) / 3600)
    timeStr = days .. "d " .. hours .. "h remaining"
end

-- Send to Roblox chat or UI
print("━━━━━━━━━━━━━━━━━━━━━━━━━━━")
print("🍃 " .. L7_ScriptName .. " v" .. L7_ScriptVersion)
print("👤 " .. player.Name)
print("⏰ " .. timeStr)
print("📊 Execution #" .. tostring(L7_TotalExecutions))
print("━━━━━━━━━━━━━━━━━━━━━━━━━━━")

​
Discord ID gate for premium features

local OWNER_IDS = {
    ["123456789012345678"] = true,
    ["987654321098765432"] = true,
}

if OWNER_IDS[L7_LinkedDiscordID] then
    print("🔓 Owner features unlocked!")
    -- Load owner-only modules
else
    print("🔒 Standard access")
end

​
Auto-expire warning

if L7_SecondsLeft ~= "Lifetime" then
    if L7_SecondsLeft < 86400 then  -- Less than 1 day
        warn("⚠️ Your key expires in less than 24 hours!")
    elseif L7_SecondsLeft < 259200 then  -- Less than 3 days
        warn("⏰ Your key expires in " .. math.floor(L7_SecondsLeft / 86400) .. " days")
    end
end

​
How it works (technical)

Detection: When you upload your source code, Leaf7 scans for any references to L7_ macro names. Only referenced macros are injected — zero overhead for unused ones.
Injection: On each execution, Leaf7 sets the macro values in getgenv() before your script runs, then immediately nils them out after your script completes. This happens inside a pcall wrapper, so cleanup runs even if your script errors.
Do not try to access macros from a different script or after your script has finished. They will always be nil. This is by design for security.

​
Important notes

  • Macros are read-only — modifying them has no effect on the server
  • Macros are per-execution — values are fresh on every run
  • If a user runs in FFA mode (no key), L7_LinkedDiscordID may be empty and L7_UserNote will be "FFA"
  • L7_SecondsLeft returns the string "Lifetime" for keys without an expiry date, and a number (seconds) for timed keys