One toolkit for Story Mode and multiplayer
Story Mode modders get access to scripting and publishing tools once reserved for multiplayer platforms. Build on the same foundation for solo play, community servers, or both.
One platform. Your worlds.Create Story Mode mods and custom multiplayer worlds for GTA V Enhanced.
-- One mod, solo and online.
if lsmp.gameType() == "MP" then
lsmp.onServer("welcome", function(name)
lsmp.log("Welcome to Los Santos, " .. name)
end)
lsmp.emitServer("ready")
else
lsmp.log("Welcome to Los Santos!")
endLS:MP is as much a Story Mode platform as a multiplayer one. A mod is made once and distributed where it belongs: to the servers that run it, or straight to solo players. Either way, its assets get the strongest protection we can give them.
Install mods for Story Mode from the platform and play them solo, kept up to date for you. Creators publish to single players as easily as to a server, with the same protection.
Join custom servers in one click. Everything a server needs reaches you by itself when you connect, already up to date, and nothing you did not ask for stays behind.
The same scripts run in Story Mode and in multiplayer. Write your mod once, ask it where it runs, and let it adapt.
The platform keeps mods compatible with one another, intelligently and under control: they work side by side without stepping on each other.
LS:MP runs your scripts on Luax, its own engine, optimized specifically for running gamescripts. On average, it runs them 7× faster than the standard Lua engine.
-- Type "screen" in F8 to toggle a web page in the world. local screen lsmp.registerCommand("screen", function() if screen then screen:destroy() screen = nil return end local browser = lsmp.createBrowser3D( "rsc://my-mod/screen.html", { fps = 15 }) if not browser then return end screen = browser browser:on("load", function() local texture = browser:getTexture() if not texture then return end lsmp.replaceTexture(texture, { type = "txd", container = "cs4_02_build_1", name = "cs4_02_rsl_mr_bb", }) end) end)
-- Reply when the client is ready. lsmp.onClient("ready", function(src) local name = lsmp.getPlayerName(src) if name then lsmp.emitClient(src, "welcome", name) end end) -- Give each player a car on their first spawn. lsmp.on("playerSpawn", function(src, pos, _, _, first) if not first then return end lsmp.createEntity("vehicle", "blista", { x = pos.x + 3, y = pos.y, z = pos.z }, { owner = src }) end)
-- Type "outline-nearby" in F8 to outline nearby networked entities. lsmp.registerCommand("outline-nearby", function() local ped = playerPedId() if ped == 0 then return end local pos = getEntityCoords(ped, true) for _, netId in ipairs(lsmp.getEntitiesInRadius(pos, 50)) do local handle = lsmp.getEntityFromNetId(netId) if handle then lsmp.outline.showEntity(handle, { color = "#40beff", width = 2.5, mode = "dashed", }) end end end)
// Send the server's greeting to a web HUD and the game feed. const ui = lsmp.createBrowser('rsc://my-mod/hud.html'); lsmp.onServer('welcome', (name) => { ui?.emit('welcome', name); beginTextCommandThefeedPost('STRING'); addTextComponentSubstringPlayerName(`Welcome to Los Santos, ${name}`); endTextCommandThefeedPostTicker(false, true); }); if (lsmp.gameType() === 'MP') lsmp.emitServer('ready');
Made to run every frame without weighing on the game, even with many mods loaded at once.
Every native of the game, the full LS:MP API and built-in JSON, ready from the first line.
Wait for a server reply in a Lua coroutine or with JavaScript async/await while the game keeps running.
Each mod in its own context, its scripts shipped protected, the server side kept in a sandbox.
JavaScript too. The same API answers in JavaScript, with Node.js and npm on the server. Pick per mod, or mix both.
Lua in the SDK referenceConnect players, shape your world and bring the web into the game. Explore the Lua and JavaScript API and Vinewood+.
Exchange events between client and server, or call external HTTP APIs asynchronously while the game keeps running.
Spawn shared entities, choose who simulates them, and give them goals they keep when control changes hands.
A key/value store kept in sync for you with every player who needs it, plus storage that lasts.
Show a web page over the game or use it to replace a texture in the world, such as a billboard or a TV screen.
Take parts of the base map away, stream your own in, switch whole areas while the game runs.
Voice channels your scripts create, radio-style or in 3D with distance. The server decides who hears whom.
Stage characters, vehicles and props in a private studio. Set the camera and lighting, then capture a still or render a live texture with the scene API.
Edit and arrange scenes, refine your shots, and choose the codec for your export.
Every native of the game, documented, searchable, and callable as plain functions.
We built LS:MP to make it easy for modders to share their work with the GTA V community, whether they want to release it for free or make a living from what they create.
my_mod.Story Mode modders get access to scripting and publishing tools once reserved for multiplayer platforms. Build on the same foundation for solo play, community servers, or both.
Only authorized players can run your protected packages. LS:MP safeguards the assets you spend hours making against extraction and unauthorized resale.
Give players a chance to try your creations before they buy. LS:MP grants access for the length of the trial while keeping your files protected.
Through our partner Summum, you can sell your creations and manage subscriptions. Server owners can also offer in-game perks to their communities.
Fair play is protected on every server. Hardened checks in the game and on the platform, backed by AI analysis that spots what does not look like a real player.
Two settings few platforms give you, and that change how a full server feels. Try them below.
Nearby players sync directly within each local group. Distant players and unavailable peer links fall back to the server.
Fine-tune traffic and pedestrians. Keep streets alive and crowded areas smooth.
From your first session to your own server, here’s what you need to know about LS:MP.
Still have a question?
Ask the communityLS:MP is an independent modding platform for GTA V Enhanced. It brings Story Mode mods and community-hosted multiplayer together, with tools to build your own mods and servers.
Yes. You can play Story Mode and multiplayer, create mods, and run a server with the Free tier. Paid memberships are optional.
You need Windows and a legitimate copy of GTA V Enhanced. Get the client from the download page.
Install LS:MP and choose a world from the server browser. The client downloads the resources that server needs when you join. You can also browse servers on the web.
No. The Free tier includes one server with up to 32 simultaneous players, a public listing and access to LSAdmin. You provide the hosting. Check the server downloads for package availability and compare tiers for higher limits.
Each server is run by its own operator, who chooses its resources, rules and moderation. Check a server’s rules before joining and contact its team for help with that world.
Use Lua or JavaScript to build resources. The SDK reference explains how resources are structured and includes examples for both client and server scripts.
Every paid tier raises the player limit, the number of servers per account and the boosts that come with the plan. Bronze adds supporter status and a private forum category. Silver adds more profile and server media options. Gold adds features such as a custom join link. See the full comparison for the details.
Boosts help a server rank higher in the public list. See how many boosts come with each plan and manage yours under My boosts.
Choose a tier on Patreon, then link your Patreon account under Billing in your LS:MP account. Your eligible tier is synchronised with your profile.
Patreon handles payments and membership changes. Use Billing in your profile to check which Patreon account is linked.