Recent posts

[What is Fluxer?]

#11

Community Plugins / Fluxer Plugin

Last post by Necroso - Aug 07, 2026, 09:50 PM

What is Fluxer?

Fluxer is a communication platform where communities organize themselves through servers, channels and real-time messaging. It was created by Swedish developer Hampus Kraft and released in January 2026, gaining traction as an alternative to Discord after Discord's mandatory ID/age verification rollout. Fluxer's biggest differentiators are that it's open source (AGPLv3, code publicly available on GitHub), it's built to be self-hosted (still being actively developed, with federation planned down the line), it does not sell user data or use it to train AI per its terms, and it's free to use with no paywalls on core features - the optional Plutonium subscription only raises limits on the official hosted instance.

For VC:MP scripters, Fluxer can also be used as an external communication layer for a game server. A bot can receive events from your VC:MP server, send messages to channels and react to messages or other events coming from Fluxer.

This makes integrations such as these possible:

• Send player chat to a Fluxer channel.
• Send server startup/shutdown notifications.
• Create administration or staff channels connected to the server.
• Report joins, leaves, kicks, bans or other server events.
• Receive commands from Fluxer.
• Create server-status messages.
• Send embeds and custom message payloads.
• Edit or delete messages.
• Upload files.
• Listen for reactions, member events, channel events and other Gateway events.
• Build custom REST API integrations directly from Squirrel.

The Fluxer Connector plugin provides the bridge between VC:MP's Squirrel environment and Fluxer's REST API and Gateway.

Instead of implementing HTTP requests, WebSockets, Gateway heartbeats, reconnection and rate-limit handling yourself, your Squirrel script can communicate with Fluxer through a simple API exposed by the plugin.


How the plugin works

The plugin provides a global Fluxer object to your Squirrel scripts.

There are essentially two sides to the integration:

VC:MP -> Fluxer

Your script calls functions such as:

Code Select Expand

Fluxer.SendMessage(...)
Fluxer.SendPayload(...)
Fluxer.EditMessage(...)
Fluxer.DeleteMessage(...)
Fluxer.Get(...)
Fluxer.Post(...)
Fluxer -> VC:MP

The plugin receives Gateway events and forwards them to Squirrel callbacks such as:

Code Select Expand

onFluxerReady(bot)
onFluxerMessage(message)
onFluxerEvent(eventName, jsonData)
onFluxerDispatch(event)
onFluxerResponse(response)
onFluxerError(message)
Gateway callbacks are executed on the VC:MP main thread, so they can be integrated naturally with your existing server script.

Creating your Fluxer application

Before connecting your VC:MP server, you will need a Fluxer application/bot and its token.

If you are not sure how to create or configure an application, follow this guide:

Bot / Application Setup Guide

Once you have the bot token, you can connect it from Squirrel.

Important: Treat your bot token like a password. Do not publish it or include it in scripts that you distribute publicly.


Basic connection

A simple connection can be created when your script loads:

Code Select Expand

const FLUXER_TOKEN = "YOUR_BOT_TOKEN";

function onScriptLoad() {
    Fluxer.ConfigureGateway(0, 1);

    if (!Fluxer.Connect(FLUXER_TOKEN))
        print("Could not start the Fluxer connector.");
}

Code Select Expand

Fluxer.Connect() starts the connector, but that does not necessarily mean Gateway authentication has already completed.

Use onFluxerReady when you need to know that the bot is actually ready:

Code Select Expand

function onFluxerReady(bot) {
    print(format("Fluxer authenticated as %s (%s)", bot.Username, bot.UserID));
}
You can also check the current state manually:

Code Select Expand

if (Fluxer.IsRunning()) print("Fluxer connector is running.");

if (Fluxer.IsReady()) print("Fluxer Gateway is ready.");
When unloading your script, disconnect the connector:

Code Select Expand

function onScriptUnload() {
    Fluxer.Disconnect();
}

Sending messages from VC:MP

The most common operation is sending a message to a Fluxer channel:

Code Select Expand

const FLUXER_CHANNEL_ID = "YOUR_CHANNEL_ID";

Fluxer.SendMessage(FLUXER_CHANNEL_ID, "Hello from VC:MP!");

A practical example is announcing when a player joins:

Code Select Expand

function onPlayerJoin(player) {
    Fluxer.SendMessage(FLUXER_CHANNEL_ID, format("%s joined the VC:MP server.", player.Name));
}

Or when a player leaves:

Code Select Expand

function onPlayerPart(player, reason) {
    Fluxer.SendMessage(FLUXER_CHANNEL_ID, format("%s left the server.", player.Name));
}


Creating a VC:MP <-> Fluxer chat bridge

One of the simplest uses of the plugin is connecting your in-game chat with a Fluxer channel.

VC:MP -> Fluxer

Code Select Expand

function onPlayerChat(player, message) {
    Fluxer.SendMessage(FLUXER_CHANNEL_ID, format("**%s:** %s", player.Name, message));

    return 1;
}
Fluxer -> VC:MP

Code Select Expand

function onFluxerMessage(message) {
    if (message.ChannelID != FLUXER_CHANNEL_ID) return;
    if (message.AuthorBot) return;

    Message(format("[#7C3AED][Fluxer][#FFFFFF] %s: %s", message.AuthorName, message.Content));
}
The AuthorBot check is particularly important for bridges. It prevents messages produced by bots from being processed again and potentially creating message loops.


Using custom message payloads

For more advanced messages, use Fluxer.SendPayload(channelId, payloadJson)

Unlike SendMessage, this accepts a complete JSON message payload.

For example:

Code Select Expand

local payload = "{\"content\":\"Server status\",\"embeds\":[{\"title\":\"VC:MP\",\"description\":\"The server is online\",\"color\":8134381}]}";

Fluxer.SendPayload(FLUXER_CHANNEL_ID, payload);

This can be useful for status systems, administration notifications, embeds, replies, components, allowed mentions and other message fields supported by Fluxer.

Note: The payload must be valid JSON. Squirrel tables are not automatically converted to JSON by the plugin.


Editing and deleting messages

Existing messages can be edited:

Code Select Expand

Fluxer.EditMessage("CHANNEL_ID", "MESSAGE_ID", "{\"content\":\"Updated VC:MP server status\"}");
They can also be deleted:

Code Select Expand

Fluxer.DeleteMessage("CHANNEL_ID", "MESSAGE_ID");
This makes it possible to create persistent server-status messages instead of posting a new message every time something changes.

For example, your script could maintain a single message containing:

• Current player count.
• Maximum slots.
• Current game mode.
• Server uptime.
• Current map/location.
• Staff online.

The same Fluxer message can then be updated whenever your server state changes.


Using the REST API

The plugin is not limited to its message helper functions.

You can send authenticated requests to bot-accessible Fluxer REST routes using:

Code Select Expand

Fluxer.Request(method, path[, jsonBody])
There are also convenient aliases:

Code Select Expand

Fluxer.Get(path[, jsonBody])
Fluxer.Post(path[, jsonBody])
Fluxer.Put(path[, jsonBody])
Fluxer.Patch(path[, jsonBody])
Fluxer.Delete(path[, jsonBody])
For example:

Code Select Expand

Fluxer.Get("/users/@me");
Or:

Code Select Expand

Fluxer.Get(
    "/channels/CHANNEL_ID/messages?limit=25"
);
A POST request can be made directly:

Code Select Expand

Fluxer.Post("/channels/CHANNEL_ID/messages", "{\"content\":\"Hello from the REST API\"}");
This generic API is useful when you want to access a Fluxer endpoint that does not have a dedicated Squirrel helper.


Understanding asynchronous requests

REST operations are asynchronous.

For example:

Code Select Expand

local requestId = Fluxer.SendMessage(
    FLUXER_CHANNEL_ID,
    "Hello!"
);
A positive request ID means that the request was accepted into the connector's local queue.

It does not mean Fluxer has already accepted the HTTP request.

The final result is delivered through:

Code Select Expand

function onFluxerResponse(response) {
    print(format("Request %d returned HTTP %d", response.RequestID, response.StatusCode));
}
The response contains useful fields including:

• RequestID - ID originally returned to Squirrel.
• StatusCode - HTTP status code.
• Route - requested API route.
• Body - raw response body.
• Data - parsed JSON data when available.

For example:

Code Select Expand

local myRequest = Fluxer.Get("/users/@me");
function onFluxerResponse(response) {
    if (response.RequestID != myRequest) return;

    if (response.StatusCode >= 200 && response.StatusCode < 300) {
        print("Authenticated user: " + response.Data.username);
    }
    else {
        print(format("HTTP %d: %s", response.StatusCode, response.Body));
    }
}
Request IDs are especially useful when your script has multiple API requests running and needs to identify which operation produced each response.


Receiving Fluxer messages

For normal message handling, the easiest callback is onFluxerMessage(message)

The object provides:

• ID
• ChannelID
• GuildID
• AuthorID
• AuthorName
• AuthorBot
• Content
• Raw

Example:

Code Select Expand

function onFluxerMessage(message) {
    if (message.AuthorBot) return;

    print(format("[Fluxer] %s: %s", message.AuthorName, message.Content));
}
This callback is ideal for chat bridges and simple bot commands.


Creating Fluxer commands

Because incoming messages are available directly from Squirrel, you can implement commands using your normal scripting logic.

For example:

Code Select Expand

function onFluxerMessage(message) {
    if (message.AuthorBot) return;

    if (message.Content == "!players") {
        Fluxer.SendMessage(message.ChannelID, format("There are currently %d players online.", GetPlayers()));
    }
}
More advanced systems can check:

• Channel IDs.
• Guild IDs.
• User IDs.
• Roles obtained through API/Gateway data.
• Custom command prefixes.
• Arguments supplied after commands.

This allows Fluxer to become an external administration or monitoring interface for your VC:MP server.


Listening to Gateway events

The plugin is not restricted to messages.

Every Gateway dispatch can be observed using:

Code Select Expand

function onFluxerEvent(eventName, jsonData) {
    print("Gateway event: " + eventName);
}
For structured data, use:

Code Select Expand

function onFluxerDispatch(event) {
    print(format("Dispatch %s, sequence %d", event.Name, event.Sequence));
    // event.Data contains the parsed data.
}
The plugin also automatically converts Gateway event names into Squirrel callback names.

Examples:

Code Select Expand

MESSAGE_CREATE        -> onFluxerMessageCreate(data)
MESSAGE_UPDATE        -> onFluxerMessageUpdate(data)
MESSAGE_DELETE        -> onFluxerMessageDelete(data)
MESSAGE_REACTION_ADD  -> onFluxerMessageReactionAdd(data)

GUILD_MEMBER_ADD      -> onFluxerGuildMemberAdd(data)
GUILD_MEMBER_REMOVE   -> onFluxerGuildMemberRemove(data)

CHANNEL_CREATE        -> onFluxerChannelCreate(data)
CHANNEL_UPDATE        -> onFluxerChannelUpdate(data)

TYPING_START          -> onFluxerTypingStart(data)
VOICE_STATE_UPDATE    -> onFluxerVoiceStateUpdate(data)
For example:

Code Select Expand

function onFluxerGuildMemberAdd(data) {
    print("A member joined guild " + data.guild_id);
}

function onFluxerMessageReactionAdd(data) {
    print("Reaction added to message " + data.message_id);
}
This makes Gateway events feel similar to normal VC:MP callbacks: implement only the callbacks your script actually needs.


Raw vs parsed Gateway data

When using onFluxerDispatch, you have access to both raw and parsed information:

Code Select Expand

function onFluxerDispatch(event) {
    print(event.Name);

    // Original JSON:
    print(event.Raw);

    // Parsed Squirrel value:
    local data = event.Data;
}
event.Data recursively converts JSON into normal Squirrel values such as tables, arrays, strings, integers, floats, booleans and null values.

This is useful when implementing more complex integrations because you usually do not need to manually parse Gateway JSON.


Bot presence

Your bot's Gateway presence can be changed with:

Code Select Expand

Fluxer.SetPresence("{\"since\":null,\"activities\":[{\"name\":\"VC:MP\",\"type\":0}],\"status\":\"online\",\"afk\":false}");

For example, a server could periodically update its bot presence to reflect the state of the VC:MP server.

Possible ideas include:

Code Select Expand

VC:MP | 12 players
Vice City Multiplayer
Server Online
Waiting for players...

Sending files

The connector also supports multipart REST requests with a file.

Example:

Code Select Expand

local payload = "{\"content\":\"Latest server screenshot\",\"attachments\":[{\"id\":\"0\",\"filename\":\"server.png\"}]}";

Fluxer.Multipart("POST", "/channels/CHANNEL_ID/messages", payload, "screenshots/server.png", "server.png");

The file must be readable by the VC:MP server process.

This can be useful for sending generated reports, screenshots, logs or other files produced by your server scripts or related systems.


Error handling

Connector-level errors are delivered through:

Code Select Expand

function onFluxerError(message) {
    print("Fluxer error: " + message);
}
REST failures should normally be inspected through onFluxerResponse:

Code Select Expand

function onFluxerResponse(response) {
    if (response.StatusCode < 200 || response.StatusCode >= 300) {
        print(format("Fluxer request %d failed: HTTP %d: %s", response.RequestID, response.StatusCode, response.Body));
    }
}
Gateway disconnections can also be observed:

Code Select Expand

function onFluxerDisconnect(reason) {
    print("Fluxer Gateway disconnected.");
}
Temporary network failures may be followed by automatic reconnection and session resume.


Example: simple server integration

The following example combines the basic pieces into a small VC:MP/Fluxer integration:

Code Select Expand

const FLUXER_TOKEN      = "YOUR_BOT_TOKEN";
const FLUXER_CHANNEL_ID = "YOUR_CHANNEL_ID";

function onScriptLoad() {
    Fluxer.ConfigureGateway(0, 1);

    if (!Fluxer.Connect(FLUXER_TOKEN)) throw "Could not start Fluxer";
}

function onFluxerReady(bot) {
    print(format("Fluxer authenticated as %s (%s)", bot.Username, bot.UserID));

    Fluxer.SendMessage(FLUXER_CHANNEL_ID, "VC:MP server is online.");
}

function onPlayerJoin(player) {
    Fluxer.SendMessage(FLUXER_CHANNEL_ID, format("%s joined the server.", player.Name));
}

function onPlayerChat(player, message) {
    Fluxer.SendMessage(FLUXER_CHANNEL_ID, format("**%s:** %s", player.Name, message));

    return 1;
}

function onFluxerMessage(message) {
    if (message.ChannelID != FLUXER_CHANNEL_ID) return;

    if (message.AuthorBot) return;

    Message(format("[#7C3AED][Fluxer][#FFFFFF] %s: %s", message.AuthorName, message.Content));
}

function onFluxerResponse(response) {
    if (response.StatusCode < 200 || response.StatusCode >= 300) {
        print(format("Fluxer HTTP error %d: %s", response.StatusCode, response.Body));
    }
}

function onFluxerError(message) {
    print("Fluxer error: " + message);
}

function onScriptUnload() {
    Fluxer.Disconnect();
}
This is only a starting point. Since the connector exposes both the REST API and Gateway to Squirrel, the integration can be expanded according to the needs of your server.


Ideas for VC:MP scripters

The plugin can be used for much more than a simple chat bridge.

Some possible projects:

• Administration bridge - Send reports, bans, kicks and administrative actions to staff channels.
  
• Remote commands - Allow authorized Fluxer users to request server information or execute carefully controlled administrative commands.
  
• Live player list - Maintain a Fluxer message containing the current players.
  
• Server status - Keep a persistent status message updated with player count, uptime and other information.
  
• Player reports - Forward in-game reports directly to a staff channel.
  
• Join/leave logging - Maintain external logs of player activity.
  
• Account integration - Connect Fluxer identities with your own VC:MP account system.
  
• Event notifications - Announce races, minigames, rounds or other server events.
  
• Reaction-based actions - React to Gateway events such as message reactions.
  
• Custom bot systems - Use the generic REST and Gateway interfaces to build functionality beyond the provided helpers.
  

Important notes

• REST calls are asynchronous. A request ID means the operation was queued, not that the HTTP request succeeded.
• Use onFluxerResponse when the result of an API request matters.
  
• Wait for onFluxerReady before treating the Gateway session as authenticated.
  
• Do not expose your bot token.
• Ignore bot-authored messages when building chat bridges unless you specifically need them.
• JSON payload arguments must contain valid JSON strings.
• Use the dedicated helpers when possible and Fluxer.Request / HTTP aliases for custom API routes.
  
• Gateway event callbacks are optional. You only need to implement the events your script uses.

Getting Started

Create your account and explore Fluxer:

https://fluxer.app/

Need help creating the application/bot?

Read the Bot Setup Guide

Once you have your bot token and channel ID, connect the plugin from Squirrel and start building your VC:MP integration.

Binaries & Source Code

Windows
fluxer04rel32.dll
fluxer04rel64.dll

Linux
fluxer04rel32.so
fluxer04rel64.so

Source code and release page: https://github.com/Necroso/0.4-fluxer-connector/

#12

Script Showroom / [SERVER SIDE] Basic Speedomete...

Last post by LamFloGaming - Aug 06, 2026, 12:56 PM

Here is the full code:

Code Select Expand

SpeedTimer <- array(100, null);
function onPlayerEnterVehicle( player, vehicle, door )
{
SpeedTimer[ player.ID ] = NewTimer( "UpdateSpeedometer", 1, 0, player.ID );
}
function onPlayerExitVehicle( player, vehicle )
{
if ( SpeedTimer[ player.ID ] != null )
    {
        SpeedTimer[ player.ID ].Delete();
        SpeedTimer[ player.ID ] = null;
    }
}
function UpdateSpeedometer( playerID )
{
    local player = FindPlayer( playerID );
    if ( player && player.Vehicle )
    {
local vehicle = player.Vehicle;
        local kmh = GetVehicleKMH( player.Vehicle );
        local hp = GetVehicleHealthPercent( vehicle );
       
        Announce( "~w~Speed: ~g~" + kmh + " ~w~KM/H. ~r~HP: "+ hp + " percent", player, 1 );
    }
}
function GetVehicleKMH( vehicle )
{
    if ( vehicle )
    {
        local speed = vehicle.Speed;
        local velocity = sqrt( (speed.x * speed.x) + (speed.y * speed.y) + (speed.z * speed.z) );
        return ( velocity * 180 ).tointeger();
    }
    return 0;
}
function GetVehicleHealthPercent( vehicle )
{
    if ( vehicle )
    {
        local hp = vehicle.Health;
       
        // Máu dư?i 250 là xe n?/cháy, coi như 0%
        if ( hp < 250 ) return 0;
       
        // Quy đ?i t? kho?ng [250 -> 1000] v? [0% -> 100%]
        local percent = ( (hp - 250) / 7.5 ).tointeger();
        return percent;
    }
    return 0;
}(Some line have Vietnamese text, sorry)
Have fun!!!

#13

Server & Plugin Updates / Server Update Released (2026-0...

Last post by AdTec_224 - Aug 04, 2026, 03:15 PM

• Fixed potential crash in 3rd party library

Server downloads:
Windows Server (x64)
Linux Server (x64)

#14

Support / Re: Index missing

Last post by LamFloGaming - Jul 31, 2026, 12:15 PM

Hello, I have a big problem: I copy a code in here: https://forum.vc-mp.org/?topic=4353.0, but I launched my server, server console is warning me: The Index 'GUI' does not exist.
I need solution to solve this error

Version of my server: 0.4.7.1

That's because the second part is a client-side script. You need to place it in store/script/somescript.nut

but I moved to client side folder

#15

Support / Re: Index missing

Last post by Necroso - Jul 31, 2026, 03:02 AM

Hello, I have a big problem: I copy a code in here: https://forum.vc-mp.org/?topic=4353.0, but I launched my server, server console is warning me: The Index 'GUI' does not exist.
I need solution to solve this error

Version of my server: 0.4.7.1

That's because the second part is a client-side script. You need to place it in store/script/somescript.nut

[In GTA SA skin sites,there are a lot of skins and i love these skins.How can I convert them to GTA VC.Only .dff and .txd files,should I edit the XML file or what should I do ?]

#16

Support / Re: How can I convert GTA SA p...

Last post by LamFloGaming - Jul 29, 2026, 07:24 AM

In GTA SA skin sites,there are a lot of skins and i love these skins.How can I convert them to GTA VC.Only .dff and .txd files,should I edit the XML file or what should I do ?

Hello
This convert is doesnt basic is import directly to VC gta3.img (VCMP is the same), The SA skin engine is different of VC, you should find the 3DS Max and a script can inport and export GTA model.
Here is step by step to import SA skin to VC:
1. Download and install 3DS Max.
2. Download the script (Link here: https://www.gtagarage.com/mods/show.php?id=9172), and follow the strcture in readme to install the script.
3. Open 3DS Max, use the script to import SA skin into 3DS Max.
4. Use the script again to import the base skin from VC.
5. Copy the bone of VC Skin to SA skin.
6. Rerigging for correct moving ingame.
7. Export to VC format.
8. Use Magic.TXD open the .txd, and change the version to VC.
Done!!!
(Attention: These instructions may contain errors; please consider them as a reference only.)

[English:]

#17

Servers / [DM] SpeedUp Community

Last post by LamFloGaming - Jul 28, 2026, 07:45 AM

SpeedUp Community

English: (Sorry, my English is bad)
Discord: discord.gg/YtqQwxK2eR
IP Address: 5.39.63.207:5937 (Can connect directly in browser)
What is SpeedUp Community???
SpeedUp Community is a public server by VIetnamese people make (btw, the maker of this server is me) by creating a Deathmatch server for fun.
You can connect to immerse yourself in a world filled with gunfire and tension!
The server is currently in the Open Beta phase—come join us and contribute to building a powerful server!
If you is a one of player join my server in this phase of server, you will give free Beta Tester Discord role and VIP Free!!!

Join now!!!

Vietnamese:
Tham gia Discord!: discord.gg/YtqQwxK2eR
Địa chỉ IP: 5.39.63.207:5937 (có thể tham gia trực tiếp qua brower)
SpeedUp Community là gì???
SpeedUp Community là một máy chủ do người Việt tạo ra (nhận tiện thì người tạo ra đó là tôi), nhằm tạo ra một sân chơi Deathmatch vui vẻ.
Hãy gia nhập máy chủ để đắm chìm vào một thế giới toàn là tiếng súng và sự căng thẳng!!!
Máy chủ hiện tại đang trong giai đoạn OpenBeta, hãy gia nhập và đóng góp để tạo ra một máy chủ hùng mạnh!!!
Nếu bạn là một trong những người chơi trong giai đoạn này, bạn sẽ được nhận role Beta Tester trên Discord và VIP miến phí!!!

Tham gia ngay!!!

#18

Support / Re: Index missing

Last post by LamFloGaming - Jul 26, 2026, 11:02 AM

Hello, I have a big problem: I copy a code in here: https://forum.vc-mp.org/?topic=4353.0, but I launched my server, server console is warning me: The Index 'GUI' does not exist.
I need solution to solve this error

Version of my server: 0.4.7.1

Are you sure that you copied and pasted it correctly?

Correct 100%!

#19

Support / Re: Announce server to browser

Last post by LamFloGaming - Jul 26, 2026, 11:02 AM

Hello, after many day developing my server. I bringing my server to a free hosting, but I want to more players find to my server by browser, but I have put

Code Select Expand

announce 1 in server.cfg, but in Master list doesnt have my server. How to bring my server to Master List??? Thank for all helping!

Did you get the latest announce plugin?

How to get it?

#20

Off-Topic General / GTA 6 Artists Wanted! Show You...

Last post by DNeep - Jul 26, 2026, 07:49 AM

Hey everyone,

If you're into digital art, concept art, AI artwork, or GTA-style illustrations, we're currently hosting a free GTA 6 Fan Art Giveaway over on our community.

🏆 What you can do:
• Create your own GTA 6-inspired artwork.
• Submit it in our Drawings section.
• Compete with other artists.
• Win cash prizes and community recognition.

🎁 Prizes:
🥇 1st Place – $XX
🥈 2nd Place – $XX
🥉 3rd Place – $XX

✅ Everyone is welcome.
✅ AI art (if allowed by the rules).
✅ Digital & hand-drawn artwork accepted.
✅ Completely free to enter.

If you're interested, check it out here:

https://community.vicewire6.com/drawings

We'd love to see what this community can create. Good luck to everyone! 🎨🔥