Multy Admin Setup Guide

What You Need

• FiveM server
• MySQL database
• Discord server (for webhook logs)

Step 1: Install Resource

1. Put multy-admin folder in your server's resources folder
2. Add this line to your server.cfg:

ensure multy-admin

Step 2: Set Permissions

IMPORTANT: First add the permission groups to QB-Core config

1. Open qb-core/config.lua
2. Find the line QBConfig.Server.Permissions = {'god', 'admin'}
3. Change it to: QBConfig.Server.Permissions = {'god', 'admin', 'mod'}

Note: These are the default groups. If you want additional custom groups, add them here and in multy-admin config.

Then add these lines to your server.cfg:

# Give god permissions (highest level)
add_principal identifier.fivem:YOUR_FIVEM_ID qbcore.god
add_principal identifier.discord:YOUR_DISCORD_ID qbcore.god

# Give admin permissions  
add_principal identifier.fivem:ADMIN_FIVEM_ID qbcore.admin
add_principal identifier.discord:ADMIN_DISCORD_ID qbcore.admin

# Give mod permissions (lowest level)
add_principal identifier.fivem:MOD_FIVEM_ID qbcore.mod
add_principal identifier.discord:MOD_DISCORD_ID qbcore.mod

Example:

add_principal identifier.fivem:7220920 qbcore.god #Blaxe
add_principal identifier.discord:493865592323833861 qbcore.god #Blaxe

Step 3: Configure Discord Webhooks

1. Go to your Discord server
2. Right-click on the channel you want logs in
3. Click "Edit Channel" > "Integrations" > "Webhooks" > "Create Webhook"
4. Copy the webhook URL
5. Open server/webhooks.lua
6. Replace YOUR_MAIN_WEBHOOK_URL_HERE with your webhook URL
7. Replace YOUR_SCREENSHOT_WEBHOOK_URL_HERE with your webhook URL (can be same)

Step 4: Test Setup

1. Start your server
2. Join the server
3. Type /madmin or press F9
4. If menu opens, setup is complete

Commands

• /madmin - Open admin menu
• /report - Open report system (for players)

Keybinds

• F9 - Open admin menu (configurable in config.lua)
• F2 - Toggle noclip (when enabled in menu)

Permission Levels

• god (Level 3) - Full access to everything
• admin (Level 2) - Most features except god-only functions
• mod (Level 1) - Basic moderation and player management (lowest level)

Adding Custom Permission Groups

The default groups (god, admin, mod) are already included. Only follow these steps if you want ADDITIONAL custom groups:

1. First, add to QB-Core config:

   • Open qb-core/config.lua
   • Add your custom group to: QBConfig.Server.Permissions = {'god', 'admin', 'mod', 'yourgroup'}

2. Then add to Multy Admin config:

   • Open multy-admin/config.lua
   • Add to qbGroups array:

   qbGroups = {
       'mod', 
       'admin',
       'god',
       'yourgroup'  -- Add your custom group here
   },
   

   • Add to groups section:

   ['yourgroup'] = {
       level = 4,              -- Higher number = more permissions
       label = "Your Group",   -- Display name
       color = "#ff0000",      -- Color for admin chat
       description = "Custom admin group"
   }
   

3. Add permissions in server.cfg:

   add_principal identifier.fivem:123456 qbcore.yourgroup
   

Important: The group name must be EXACTLY the same in all three places:

• QB-Core config
• Multy Admin qbGroups
• Multy Admin groups section

Configuration

Edit config.lua to change:

• Menu keybind
• Permission requirements for features
• Vehicle spawn settings
• Teleport locations
• Feature toggles

Database

The resource creates its own database tables automatically. No manual database setup needed.

Troubleshooting

Menu won't open:

• Check you have correct permissions in server.cfg
• Restart server after adding permissions
• Check F8 console for errors

No webhook logs:

• Check webhook URLs are correct in server/webhooks.lua
• Test webhook URL in browser
• Check Discord channel permissions

Permission errors:

• Restart server after changing server.cfg permissions
• Check Steam hex is correct (use steam: prefix)
• Enable debug mode in config.lua to see permission checks

Support

Make sure you have:

1. QB-Core framework installed
2. oxmysql resource running
3. Correct permissions in server.cfg
4. Valid Discord webhook URLs

That's it! The admin menu should now work on your server.