BLN Studio Docs - RedM Scripts

🌀 BLN Teleporter ​

bln teleporter

📺 Preview ​

Video Preview

🔽 Get it Now ​

Download

Create seamless teleportation points across your RedM server! Build hidden hideouts, secret passages, job-restricted areas, and fast-travel networks with beautiful visual markers and smooth transitions.

✨ Features ​

🎯 Core Features ​

  • 🚪 Dual-Point System: Enter and exit locations with independent settings
  • 🎨 Visual Markers: Multiple marker types including particles and static markers
  • 🔒 Job Restrictions: Limit teleporters to specific jobs or make them public
  • 🗺️ Smart Blips: Distance-based blip visibility with custom names
  • 🎬 Smooth Transitions: Cinematic fade effects during teleportation
  • 🚫 Mount/Vehicle Detection: Prevents teleporting while mounted or in vehicles
  • 📍 Independent Configuration: Each enter/exit has its own marker, blip, and prompt settings

🎨 Marker Types ​

bln teleporter
  • none - Invisible teleporter (no visual indicator)
  • default - Cylinder marker
  • halo - Halo ring marker
  • haloRotate - Rotating halo ring
  • cube - Cube marker
  • arrow - Rotating arrow particle effect
  • fireCircle - Horizontal fire circle particle
  • fireCircleRotate - Vertical fire circle particle

🔧 Advanced Features ​

  • ⚡ Distance-Based Rendering: Optimized performance with configurable render distances
  • 🎨 Custom Colors: RGB color control for all markers and particles
  • 🔔 Smart Notifications: Customizable notifications for permissions and restrictions
  • 🧹 Auto Cleanup: Automatic cleanup of particles, blips, and prompts on resource stop
  • 🎮 Framework Integration: Built with bln_lib for multi-framework support

📦 Dependencies ​

🛠️ Configuration ​

Basic Teleporter Setup ​

lua
{
    id = "hideout",                    -- Unique identifier
    name = "Secret Hideout",           -- Display name
    jobs = { "outlaw", "gang" },       -- Jobs allowed (false for public)
    
    enter = {
        coords = vector4(x, y, z, heading),
        
        marker = {
            type = "fireCircle",       -- Marker type
            color = { r = 255, g = 100, b = 0, a = 255 },
            distance = 15.0            -- Visibility distance
        },
        
        blip = {
            enabled = true,
            sprite = "blip_region_hideout",
            color = "BLIP_MODIFIER_MP_COLOR_27",
            showDistance = 150.0       -- Blip visibility range
        },
        
        prompt = {
            name = "Enter",            -- Prompt action text
            key = 0xCEFD9220,          -- E key
            distance = 2.5             -- Interaction distance
        },
    },
    
    exit = {
        coords = vector4(x, y, z, heading),
        
        marker = {
            type = "fireCircle",
            color = { r = 255, g = 0, b = 0, a = 255 },
            distance = 15.0
        },
        
        blip = {
            enabled = true,
            sprite = "blip_region_hideout",
            color = "BLIP_MODIFIER_MP_COLOR_27",
            showDistance = 150.0
        },
        
        prompt = {
            name = "Exit",
            key = 0xCEFD9220,
            distance = 2.5
        },
    }
}

Notification Configuration ​

lua
Config.notify = {
    placement = "top-left",
    notifications = {
        ["permission"] = {
            ["title"] = "Permission Denied",
            ["desc"] = "You don't have permission to use this teleporter.",
            ["placement"] = "top-left",
            ["icon"] = "lock",
        },
        ["mount_vehicle"] = {
            ["title"] = "Cannot Teleport",
            ["desc"] = "You cannot teleport while on a mount or in a vehicle.",
            ["placement"] = "top-left",
            ["icon"] = "warning",
        },
    }
}

Callback Functions ​

lua
Config.callbacks = {
    -- Called before teleportation
    beforeTeleport = function(id)
        print("Teleporting via: " .. id)
        -- Add custom logic (freeze player, play animation, etc.)
    end,
    
    -- Called after teleportation
    onTeleport = function(id)
        print("Arrived at: " .. id)
        -- Add custom logic (effects, logs, etc.)
    end
}

📋 Configuration Options ​

Distance Settings ​

Each teleporter has three types of distances:

SettingLocationPurpose
marker.distanceEnter/Exit marker configHow far the marker/particle is visible
prompt.distanceEnter/Exit prompt configHow close to interact with teleporter
blip.showDistanceEnter/Exit blip configHow far the blip appears (false = always visible)

Marker Colors ​

Colors use RGBA format (0-255):

lua
color = {
    r = 255,  -- Red (0-255)
    g = 100,  -- Green (0-255)
    b = 0,    -- Blue (0-255)
    a = 255   -- Alpha/Transparency (0-255)
}

Job Restrictions ​

lua
-- Public teleporter (everyone can use)
jobs = false

-- Single job requirement
jobs = { "sheriff" }

-- Multiple jobs allowed
jobs = { "sheriff", "deputy", "marshal" }

🤝 Support ​

Need help? Have questions? Join our Discord server for support and updates!

  • 💬 Discord: Join Our Community
  • 🎮 Live support and community help
  • 🔄 Regular updates and improvements
  • 💡 Feature requests and suggestions

Built with ❤️ by BLN Studio