Install gg_lib

gg_lib is the shared library every new GG Studio script runs on. Install it once and start it before your GG scripts. It connects them to your framework, inventory, target, and dispatch on its own, and gives you Script Studio, the in-game menu where you change every script's settings. There is no config file to edit.

1. Download

You need these three resources. Each button downloads the latest release straight from GitHub:

Extract each one into your server's resources folder and keep the folder names gg_lib, oxmysql, and ox_lib. If you already run oxmysql or ox_lib, skip those.

2. Start them first

Add this to server.cfg, above every GG Studio script:

ensure oxmysql
ensure ox_lib
ensure gg_lib

Database tables are created automatically. There is no SQL to import.

3. Add yourself as an admin

Script Studio is admin-only, so nobody can open it until you add yourself.

1. Join your server and read your license2 identifier off the server console.
2. Open gg_lib/server_config.lua and put it in the admins list:

--------------------------------------------------
-- MARK: gg_lib Server Configuration
--------------------------------------------------
-- Put your license below and restart. That is the whole setup.
-- Keep a copy before you update -- an update replaces this file.

return {
    -- You. Join your server and read your license2 off the console.
    -- Nothing in game can remove anyone listed here, so it is the way back
    -- in if you ever lock yourself out. Everyone else is added in /ggsettings.
    admins = {
        "license2:put_your_own_license_here",
    },

    -- Anyone who is already an admin on your server gets in too, without
    -- being listed above. They get Admin, never Owner.
    -- Set false if you want only the list above.
    auto_admin = true,
}

3. Restart gg_lib and type /ggsettings in game.

Keep a copy of this file before you update, because an update replaces it. Add other admins from /ggsettings → Admins instead of editing the file.

4. Change settings

Type /ggsettings in game and pick a script. Changes apply when you press Save, and anything that needs a restart is labelled. Settings are stored in your database, so updating a script never wipes them.

Common questions

The menu will not open. You are not an admin yet. Finish step 3, restart gg_lib, and try again.

Where did utility.lua go? Scripts on gg_lib have no config file. Everything is in /ggsettings.

A script picked the wrong framework or inventory. Open Bridges in /ggsettings to see what was detected. To force a choice, see Bridges.

How do I update? Copy your server_config.lua somewhere safe, replace the gg_lib folder with the new release, put the file back, and restart. Your settings live in your database, so nothing else is lost.

More guides

Source and issues: github.com/GGStudioCFX/gg_lib. Ask in the Discord if you get stuck.