BrownTurbo/BrownTurbo-ExtendedGame

BrownTurbo-ExtendedGame

BrownTurbo-ExtendedGame is designed as an extensible game expansion framework for SA-MP, bringing singleplayer gameplay mechanics, advanced character customization, and extended features into multiplayer.

Features

1. Full Singleplayer CJ Customization in SA-MP:

   • Customize all 18 texture slots and 10 3D model component slots.
   • Live Fat & Muscle body transformation (0.0 to 1000.0) with real-time composite mesh morphing.
   • Support for all clothing items, shoes, haircuts, tattoos, accessories, and special suits directly from player.img.

2. Fixes the Infamous SA-MP Model 0 Crash:

   • In vanilla SA-MP, setting remote players to Skin 0 crashes the game because Model 0 lacks a pre-built static DFF in gta3.img.
   • BrownTurbo-ExtendedGame hooks CPed::SetModelIndex (0x5E4880) to dynamically initialize CPlayerData and rebuild the composite clump with CClothesBuilder, preventing any crashes.

3. Remote & Local Player Synchronization:

   • Can target the local player (playerId = 0xFFFF) or any remote player (playerId = 0..1000).
   • Caches custom clothing state so that when players stream in or respawn, their custom outfit is preserved automatically.

4. Multi-Version SA-MP Compatibility:

   • Automatically adapts to SA-MP client versions: 0.3.7-R1, 0.3.7-R3-1, 0.3.7-R5-1, and 0.3.DL-1.
   • Safely preserves and restores SA-MP attached accessories (SetPlayerAttachedObject) across model rebuilds.

5. MTA-style Water Controls:

   • Set world sea and lake heights independently, optionally change outside-world sea height, and reset world water to its original levels.
   • Set water wave intensity from 0% to 100% of GTA:SA's normal waviness; -1.0 restores native weather-driven waves.
   • For setters that support playerid = -1, the change applies to all current players and is retained as the default for future players.

---

RakNet Packet ID 252 Specification

Communication uses RakNet Packet ID 252 (0xFC).

Packet Header

Action Sub-commands

1. CJ_ACTION_SET_CLOTHES (0x01)

Sets a clothes or tattoo item in a specific slot.

2. CJ_ACTION_REMOVE_CLOTHES (0x02)

Removes clothing/tattoo from a slot.

3. CJ_ACTION_SET_BODY_STATS (0x03)

Morphs CJ's body between skinny, fat, and muscular.

4. CJ_ACTION_RESET_CLOTHES (0x04)

Resets clothing.

5. CJ_ACTION_REBUILD (0x05)

Forces an immediate rebuild of the ped's composite mesh. (No extra payload).

6. CJ_ACTION_SET_FULL_OUTFIT (0x06)

Sets an entire outfit and body stats in a single network packet.

7. CJ_ACTION_SET_CLOTHES_HASH (0x07)

Sets clothes using CRC32 hash keys directly (bandwidth-optimized).

8. CJ_ACTION_SET_TATTOO (0x08)

Sets a tattoo in one of the 9 tattoo slots.

9. CJ_ACTION_CLEAR_CACHE (0x09)

Purges client-side cached outfit and body state for the target player ID.

10. CJ_ACTION_REQUEST_SYNC (0x0A)

Sent by client ASI to server when a remote ped spawns with Skin 0 but has no cached outfit.

11. CJ_ACTION_HANDSHAKE_PING (0x0B)

Server pings client to verify if the BrownTurbo-ExtendedGame ASI plugin is installed.

12. CJ_ACTION_HANDSHAKE_PONG (0x0C)

Client confirms ASI plugin presence and reports version.

20. EXTENDEDGAME_ACTION_SET_AIRCRAFT_HEIGHT_LIMIT (0x14)

Sets the aircraft ceiling height limit in meters (default: 800.0f).

21. EXTENDEDGAME_ACTION_SET_JETPACK_HEIGHT_LIMIT (0x15)

Sets the jetpack ceiling height limit in meters (default: 100.0f, <= 0.0f for unlimited).

22. EXTENDEDGAME_ACTION_SET_BIKE_KNOCK_OFF (0x16)

Controls whether the rider gets knocked off motorbikes / bicycles on crash.

23. EXTENDEDGAME_ACTION_SET_FIRE_PROOF (0x17)

Toggles complete immunity to fire and burning.

24. EXTENDEDGAME_ACTION_SET_INFINITE_SPRINT (0x18)

Toggles infinite sprint capability (player never runs out of stamina).

25. EXTENDEDGAME_ACTION_SET_SUN (0x19)

Toggles the rendering of the sun corona and sky glare.

Actions 26 and 27 are reserved.

35. EXTENDEDGAME_ACTION_SET_WATER_LEVEL (0x23)

Sets the world water vertex heights, independently selecting non-sea world water, sea-level world water, and outside-world water.

36. EXTENDEDGAME_ACTION_SET_WATER_WAVE_HEIGHT (0x24)

Sets water wave intensity as a percentage of GTA:SA's normal waviness. The input is mapped from 0..100 to a game multiplier of 0..1; -1 restores native weather-driven waves.

37. EXTENDEDGAME_ACTION_RESET_WATER_LEVEL (0x25)

Restores captured GTA:SA world-water vertex heights and resets outside-world water to its default height. (No additional payload.)

38. EXTENDEDGAME_ACTION_SET_TEXTDRAW_ROTATION (0x26)

Sets the rotation angle, pivot point, and continuous spin speed for a global TextDraw or Player TextDraw.

39. EXTENDEDGAME_ACTION_RESET_TEXTDRAW_ROTATION (0x27)

Resets rotation and spin animation for a global TextDraw or Player TextDraw.

40. EXTENDEDGAME_ACTION_CREATE_WATER_ZONE (0x28)

Creates a swimmable, buoyant, rendered water zone at custom world coordinates.

41. EXTENDEDGAME_ACTION_SET_WATER_ZONE_LEVEL (0x29)

Changes the surface level of an existing custom water zone.

42. EXTENDEDGAME_ACTION_SET_WATER_ZONE_COORDS (0x2A)

Updates the bounds and levels of an existing custom water zone.

43. EXTENDEDGAME_ACTION_DESTROY_WATER_ZONE (0x2B)

Destroys an active custom water zone and frees its slot.

44. EXTENDEDGAME_ACTION_SET_JETPACK_OFFSET (0x2C)

Sets the 3D attachment translation offsets and rotation for the player's jetpack.

45. EXTENDEDGAME_ACTION_RESET_JETPACK_OFFSET (0x2D)

Resets jetpack placement and orientation to default GTA:SA coordinates. (No payload)

46. EXTENDEDGAME_ACTION_TOGGLE_NIGHT_VISION (0x2E)

Toggles green night vision post-processing filter.

47. EXTENDEDGAME_ACTION_TOGGLE_THERMAL_VISION (0x2F)

Toggles infrared/heat-seeking thermal vision filter.

48. EXTENDEDGAME_ACTION_SET_NO_RELOAD (0x30)

Disables ammo decrement on weapon firing (infinite clip / no reload required).

49. EXTENDEDGAME_ACTION_TOGGLE_SWITCH_RELOAD (0x31)

Enables or disables auto-reloading when quickly switching away and back to a weapon.

50. EXTENDEDGAME_ACTION_TOGGLE_QUICK_RELOAD (0x32)

Instantly finishes weapon reload animation so the weapon is ready to fire immediately.

51. EXTENDEDGAME_ACTION_TOGGLE_INFINITE_OXYGEN (0x33)

Grants infinite lung capacity while swimming underwater.

52. EXTENDEDGAME_ACTION_SET_PLAYER_PED_ANIMS (0x34)

Switches CJ ped movement animations: CJ walk/run vs standard ped locomotion for Model 0.

53. EXTENDEDGAME_ACTION_TOGGLE_CURSOR (0x35)

Toggles the client mouse cursor.

54. EXTENDEDGAME_ACTION_SET_PLANE_RADAR_COLOR (0x36)

Sets custom color tint for the plane radar altimeter artificial horizon line using a 32-bit hexadecimal color (0xRRGGBBAA).

55. EXTENDEDGAME_ACTION_PAUSE_MENU_EVENT (0x37)

Sent by client ASI to server when the player opens, closes, or navigates submenus in the pause menu.

56. EXTENDEDGAME_ACTION_SET_SUN_COLOR (0x38)

Overrides the game timecycle sun core and corona RGB colors.

57. EXTENDEDGAME_ACTION_RESET_SUN_COLOR (0x39)

Restores native weather timecycle sun coloring. (No payload)

58. EXTENDEDGAME_ACTION_SET_MOON_COLOR (0x3A)

Overrides the moon texture and corona sprite colors.

59. EXTENDEDGAME_ACTION_RESET_MOON_COLOR (0x3B)

Restores native moon coloring. (No payload)

60. EXTENDEDGAME_ACTION_TOGGLE_VEHICLE_BLUR (0x3C)

Toggles high-speed motion blur for vehicles (which was disabled in SA-MP) and sets its intensity.

---

Clothes Slot Reference

---

Server-Side (Pawn) Usage & Authoritative Synchronization

BrownTurbo-ExtendedGame includes a comprehensive server-side synchronization engine in pawn/extendedgame.inc.

Key Server-Side Features:

• Authoritative In-Memory Storage: The server stores each player's active CJ outfit slots (cj_szTexture, cj_szModel) and body stats (cj_fFat, cj_fMuscle).
• Automatic ALS Hooking:
  • OnPlayerConnect(playerid): Automatically initiates the ASI plugin presence verification handshake.
  • OnPlayerStreamIn(playerid, forplayerid): Whenever playerid enters forplayerid's streaming radius, the server automatically transmits playerid's outfit, bike knock-off state, and fire-proof state.
  • OnPlayerSpawn(playerid): Replays the player's bike and fire-proof states to the player and current stream viewers, and synchronizes CJ appearance.
  • OnPlayerDisconnect(playerid): Automatically clears server-side state and broadcasts a cache purge.
  • OnIncomingPacket(playerid, packetid, bs): Handles client sync requests and plugin handshakes. On handshake, the server replays all stored settings for that player's client and resends actor state for that player's currently streamed players.
• Plugin Presence Verification & Crash Protection:
  • HasPlayerExtendedGame(playerid): Returns true if the client has verified the ASI plugin.
  • GetPlayerExtendedGameVersion(playerid): Returns the client plugin version.
  • SetPlayerSkinSafe(playerid, skinid, fallback_skinid): Prevents setting Model 0 if the player doesn't have the plugin installed, averting client crashes.
  • OnPlayerExtendedGameCheck(playerid, bool:installed, version): Callback triggered once client handshake completes or times out.
• Synchronization Scope: Player-attached state (CJ appearance, bike knock-off, and fire-proof state, including default/disabled values) is sent to the player and viewers streaming them on stream-in and spawn. Client-wide environment and HUD settings remain scoped to the selected recipient; use playerid = -1 for supported global setters to apply them to all current players and retain the value for future connections. Every stored client setting is replayed after the plugin handshake, and currently streamed actor state is replayed to late-handshaking clients.
• Network Bandwidth Optimization: Player-attached state is routed to the target and players currently streaming them (IsPlayerStreamedIn / Virtual World), rather than wasteful global broadcasts.

1. Copy pawn/extendedgame.inc into your server's pawno/include/ directory.
2. In your gamemode or filterscript:

#include <a_samp>
#include <Pawn.RakNet>
#include <extendedgame>

// Callback triggered when plugin presence is resolved for a player
public OnPlayerExtendedGameCheck(playerid, bool:installed, version) {
    if (installed) {
        printf("[Plugin] Player %d has BrownTurbo-ExtendedGame ASI installed (v%d.%d)!", playerid, (version >> 8) & 0xFF, version & 0xFF);
    } else {
        printf("[Plugin] Player %d does NOT have BrownTurbo-ExtendedGame ASI installed.", playerid);
    }
    return 1;
}

// Example: Safely assign skin 0 only if player has the plugin installed
SetPlayerSkinSafe(playerid, 0, 299); // sets 299 if player doesn't have ASI installed!