FreeScriptsDocsSupport

Browse

  • Documentation
    • FAQ
  • 📱 Phone
    • 🧠 Installation
    • 🦄 Unique phones
    • 💿 Configure
      • 💄 Additional Features
      • 📸 Camera
      • 📹 Video Calls
      • 🍏 Apps
      • 🪵 Logs
      • 🔋 Battery System
      • 🖼️ Media Customization
      • 🗣️ Multi-Language Support
      • 🗃️ SIM Cards
      • 🚗 Valet System
      • 🖼️ Wallpapers App
      • ⛅ Weather Widget
    • ⏭️ Exports
      • Client side
        • 👁️‍🗨️ General
        • 📞 Calls
        • ☀️ Groups
        • 🏢 Companies
        • 🔧 Misc
        • 🗼 Signal Towers
      • Server side
        • 🆔 Identify Player
        • ☎️ Sim Cards
        • 📞 Calls
        • 💬 Messages
        • ☀️ Groups
        • 🌐 Cell Broadcast
        • 💸 YPay
        • 📧 Mail
        • 📪 Notifications
        • 📵 Screen Damage
        • 🗯️ Dark Chat
        • 🔧 Misc
    • 🪛 Commands
    • 📡 Events
      • Server side
        • 📨 Messages
        • 📱 Social Media
        • ☎️ Calls
    • 🍎 Custom apps
    • 🏦 Banking App
    • 📈 Markets App
    • 👜 State bags
  • ☎️ Boomer Phone
    • 🧠 Installation
    • 🦄 Unique phones
    • ⏯️ Exports
      • Client side
  • 🏠 Properties
    • 🧠 Installation
    • 💿 Configure
    • 🔗 Compatibility
      • Phones
        • YSeries
        • LB Phone
    • 📖 Guides
      • 🛏️ Starter Apartments
      • 🐚 Add More Shells
      • 🔑 Physical Keys
      • 🪑 Furniture As Items
      • 🛠️ Fix Interactable Points
      • 📋 Discord Logs Setup
    • ⏭️ Exports
      • Client side
        • GetCurrentPropertyId
        • GetCurrentProperty
        • IsPointInsideProperty
        • OpenPropertyMenu
        • AddKey
        • RemoveKey
        • SetWaypointToProperty
        • GetAllProperties
        • GetKeyHolders
        • PoliceRaidDoor
        • WrapIntoProperty
        • GetClosestDoor
        • GetEntryCoordinates
        • UseLockpick
        • PoliceRaidDoor
      • Server side
        • GetAllProperties
        • GetPropertyData
        • AddKey
        • RemoveKey
        • ToggleDoorlock
        • GetPlayersInProperty
        • GetKeyHolders
        • DeleteProperty
        • AddStarterApartment
        • SellProperty
        • TransferProperty
    • 🪝 Hooks System
      • buyProperty
      • rentProperty
      • sellProperty
      • deleteProperty
      • createDoor
      • saveSettings
      • setInteractablePoint
      • canEnter
      • canExit
    • 👜 State bags
  • 🏦 Banking
    • 🧠 Installation
    • 🪛 Commands
    • ⏯️ Exports
      • Client side
      • Server side
    • 🪵 Logs
    • 🪝 Hooks
    • 🏦 Banking App
  • 💸 Billing
    • 🧠 Installation
    • ⏭️ Exports
      • Client side
      • Server side
  • 📊 Hud
    • 🧠 Installation
    • ⏭️ Exports
      • Client side
  • 📦 Storage Units
    • 🧠 Installation
  • 🎰 Slots
    • 🧠 Installation
    • 📱 Phone app
  • 🎃 Minigames
    • 🎯 Exports and Usage
    • 🔧 Commands

📵 Screen Damage

Break screen

Example of a broken phone - Preview

lua
-- phoneImei - string, The target phone's IMEI.
-- level - number(optional), The level of damage. *default(1-9)
-- breackTouchscreen - boolean(optional), Whether the phone screen should work.
-- The function will randomize the values if the optional properties aren't passed.
exports.yseries:BreakScreen(phoneImei, level, breakTouchscreen)

Fix screen

lua
-- phoneImei - string, The target phone's IMEI.
exports.yseries:FixScreen(phoneImei)

Get screen damage

Retrieves the current screen damage status for a phone.

lua
---@param phoneImei string The phone IMEI to get screen damage for
---@return table|nil Returns table with screen damage level and touchscreen status, or nil if no damage or invalid IMEI
local damage = exports.yseries:GetScreenDamage(phoneImei)

if damage then
    print("Screen damage level: " .. damage.level)
    print("Touchscreen broken: " .. tostring(damage.breakTouchscreen))
else
    print("No screen damage or invalid IMEI")
end

Returns:

  • nil - If the IMEI is invalid, or if no screen damage exists
  • table - If screen damage exists, containing:
    • level (number) - The screen damage level (1-9 based on config)
    • breakTouchscreen (boolean) - Whether the touchscreen is broken

Example:

lua
local phoneImei = "1234567890"
local damage = exports.yseries:GetScreenDamage(phoneImei)

if damage then
    if damage.breakTouchscreen then
        print("Phone screen is broken and touchscreen is not working")
    else
        print("Phone screen is damaged (level " .. damage.level .. ") but touchscreen works")
    end
else
    print("Phone has no screen damage")
end

On this page

  • Break screen 
  • Fix screen
  • Get screen damage

All Rights Reserved

TeamsGG © 2026

Pages

FreeScriptsDocsSupport

Legal

Terms of ServiceRefunds

Tebex

Tebex ImpressumTebex TermsTebex Privacy

Socials

DiscordYouTube