🖼️[FREE] Adaptive Cards Boilerplate

A lightweight Lua boilerplate for integrating Adaptive Cards into your FiveM connection process using deferrals. Built by the PyroByte team.

📦 Overview

This boilerplate demonstrates how to display interactive Adaptive Cards to players when they connect to your FiveM server. It's designed to improve the user experience during the connection phase.

Cards can range from basic buttons to styled forms and complex layouts.

✨ Features

  • 🟦 Simple Cards – Title, message & single action

  • 📋 Form Cards – Input fields with multiple actions

  • 🔁 Card Switching – Easily change views in real-time

  • ⏳ Timeout Handling – Auto-failure or countdown after inactivity

  • 🎨 Styled Cards – Use consistent styles via Config.Styles

📁 File Structure

pyro-adaptivecards-boilerplate/
├── fxmanifest.lua
├── sv_main.lua         # Sample connection handler with card flow
└── functions.lua       # Card creation helpers

🧪 Examples Included

Each scenario is covered in the sample server script:

  1. ✅ Main Menu Card

  2. 🔑 Recovery Form

  3. ✔️ Success Message

  4. ⏱️ Timeout Countdown

  5. 📜 Welcome Card with rules

  6. 🎨 Styled Card using Config.Styles

🛠 Card Creation Functions

CreateSimpleCard(title, message, buttonText, buttonId)

Creates a basic card with a heading, message, and one button.

CreateMultiActionCard(title, message, actions)

Accepts a list of buttons with labels and styles. Good for menus.

actions = {
  { title = "Login", id = "submit_login", style = "positive", color = "light" },
  { title = "Cancel", id = "submit_cancel", style = "default", color = "light" }
}

CreateFormCard(title, message, inputFields, submitText, submitId, backText?, backId?)

Builds a card with text input fields.

inputFields = {
  { id = "email", placeholder = "Enter your email", style = "email" }
}

CreateComplexCard(title, message, backgroundImage)

A styled layout with optional top-right nav (Back/Exit), centered message, and multiple buttons.

CreateStyledCard(title, message, styleName, buttonText, buttonId, backgroundImage?)

Uses styles from your Config.Styles object for consistent theming.

🔄 Deferral Flow

Outlined in sv_main.lua:

  1. Player connects

  2. Main menu displayed

  3. Form submitted or canceled

  4. Timeout or success triggers

  5. Deferral ends with done() or rejection

⚙️ Installation

  1. Clone or download the repository

  2. Place it in your server's resources folder

  3. Add this to your server.cfg:

    ensure pyro-adaptivecards-boilerplate

🎨 Customization Tips

  • Replace image URLs with your own CDN or Imgur links

  • Add or modify styles in Config.Styles

  • Update logic in sv_main.lua to match your server's workflow

📋 Requirements

  • A FiveM server

  • Basic Lua knowledge

📥 Link

📞 Support

Need help or have questions? → Join the PyroByte Discord

PreviousFood Delivery

Last updated