Skip to content
This repository was archived by the owner on May 22, 2026. It is now read-only.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

History

6 Commits

Repository files navigation

🧭 TP Menu

A modern, category-based teleport menu for FiveM servers.

Built for performance, clean UI, and full framework compatibility through motion_bridge.

⚠️motion_bridge must start beforemotion_tpmenu.

Support: https://discord.gg/jAbJ8rVUqw


✨ Features

  • 🔌 Auto Framework Detection (QBX → QB → ESX → OX → Standalone)
  • 🔐 Framework & ACE Permissions
  • 🗂 Category Sidebar System
  • 🖼 Location Image Preview Support
  • ⭐ Recent Teleport System
  • 🎨 Fully Customizable Theme
  • 🚗 Optional Vehicle Handling
  • 🔔 Advanced Notification Support
  • 🖥 Grid & List View Modes
  • ⚡ Teleport Fade Effect

📦 Requirements

Ensure the following resources are started:

ensure motion_bridge
ensure motion_notify (not required but reccomended)

⚙️ Configuration

All configuration is handled inside:

config.lua

🧠 Framework

Config.Framework="auto"

Available Options

  • "auto" (Recommended)
  • "esx"
  • "qb"
  • "qbx"
  • "ox"
  • "standalone"

"auto" will detect in this order:

QBX → QB-Core → ESX → OX → Standalone

🔐 Permissions

Config.Permissions="framework"Config.AdminGroups= { "admin", "superadmin", "god", "mod" }

Permission Modes

ModeDescription
"framework"Uses framework player groups
"ace"Uses FiveM ACE permission (tpmenu.admin)
"none"Everyone can access all locations

ACE Example

add_ace group.admin tpmenu.admin allow

⌨ Command & Keybind

Config.EnableCommand=trueConfig.EnableKeybind=trueConfig.Command="tp"Config.Keybind="F5"

Set to false to disable either option.


🔔 Notifications (Recommended: motion_notify)

Config.Notify="motion_notify"

⭐ Why motion_notify?

  • ✅ Clean & modern design
  • ✅ Fully integrated with motion_bridge
  • ✅ Consistent styling across Motion resources
  • ✅ Optimized performance
  • ✅ Framework-independent

Make sure it is started:

ensure motion_notify

Other Supported Notify Options

OptionDescription
"motion_notify"Direct Motion Notify (Recommended)
"bridge"Uses motion_bridge auto-detection
"ox_lib"Uses ox_lib notifications
"qb"Uses QB-Core notify
"esx"Uses ESX showNotification
"custom"Fully custom notify system

Custom Notify Setup

If using "custom":

Config.Notify="custom"

Add inside client.lua:

_G.CustomNotify=function(ntype, title, message, duration)
-- ntype = "success", "error", "info"end

🖥 Menu Settings

Config.ConfirmTP=trueConfig.ShowRecent=trueConfig.MaxRecent=5Config.ShowCoords=falseConfig.DefaultView="grid"Config.TeleportEffect="fade"Config.LeaveVehicle=false

Options Explained

  • ConfirmTP — Show confirmation dialog before teleport
  • ShowRecent — Show recent locations at top
  • MaxRecent — Maximum saved recent locations
  • ShowCoords — Display XYZ in list view
  • DefaultView"grid" or "list"
  • TeleportEffect"fade" or "none"
  • LeaveVehicle — Eject player before teleporting

🎨 Theme Customization

Config.Theme= {
accentColor="#60a5fa",
accentGlow="rgba(96,165,250,0.15)",
menuWidth="860px",
menuHeight="580px",
}

You can customize:

  • Accent color
  • Glow effect
  • Menu width & height

🗂 Categories

Config.LocationCategories= {
{ id="city", label="City", icon="building" },
{ id="airport", label="Airport", icon="plane" },
{ id="gang", label="Gang Zones", icon="crosshair" },
{ id="police", label="Police", icon="shield" },
{ id="medical", label="Medical", icon="heart" },
{ id="leisure", label="Leisure", icon="star" },
}

Supported Icons

building, plane, shield, heart, star,
crosshair, car, tree, dollar,
music, zap, map, anchor,
home, flag

📍 Locations

Example location format:

{
id="lsc",
name="Los Santos Customs",
category="city",
desc="Vehicle mods & paint",
coords=vector4(-349.7, -137.3, 39.0, 60.0),
badge=nil,
image="https://example.com/image.jpeg"
}

Location Fields

FieldDescription
idUnique identifier
nameDisplay name
categoryMust match category id
descLocation description
coordsvector4(x, y, z, heading)
badgenil or "admin"
imageURL or nil

🛡 Admin-Only Locations

To restrict a location to admins:

badge="admin"

This respects your selected permission mode.


🚀 Adding New Locations

  1. Choose a valid category id
  2. Add a new entry inside Config.Locations
  3. Restart tp_menu

🛠 Troubleshooting

Menu not opening?

  • Ensure motion_bridge starts before tp_menu
  • Check Config.Framework
  • Verify permission setup

Notifications not showing?

  • Set:
Config.Notify="motion_notify"
  • Ensure:
ensure motion_notify

📄 License

Free to use and modify.
Do not resell without permission.


Made for modern FiveM servers.

About

Free FiveM TP Menu

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages