> For the complete documentation index, see [llms.txt](https://goonsquad.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://goonsquad.gitbook.io/docs/getting-started/changelog.md).

# Changelog

All notable changes to Goonsquad Studios resources will be documented here.

## GS Boombox + CarPlay 1.0.0

* Added portable custom speakers, fitted car screens, shared queues, radio, linked playback and phone controls.
* Added dashboard maps, vehicle features, real-phone pairing and guest queue QR codes.
* Prepared production UI and optional NPWD app packages, seven explicit Lua escrow exceptions and clean default configuration.
* Removed the public screen-test command, isolated saved simulator fixtures and corrected failed inventory transaction/refund handling.

See [GS Boombox + CarPlay](/docs/gs-boombox-+-carplay/overview.md).

## GS Minimap Designer 1.0.1

* Updated the resource and UI package version to 1.0.1 and rebuilt the production interface.
* Retained confirmed save/publish results, destination protection, empty-table migration and path/polygon/heal-only baking.
* Corrected the map-renderer diagnostic to refer to the bundled renderer and streamed-asset conflicts.
* Refreshed the runtime-only main/AI packages, six explicit Lua escrow exceptions, update guide and versioned marketing artwork.

See [Minimap Designer updating](/docs/gs-minimap-designer/updating.md).

## GS ScaleMenu 1.0.0 — Free Release

* Added height/body-shape controls, live/manual preview, comparison ghost, orbit camera, ruler, presets, profiles and six languages.
* Supports standalone, Qbox, QBCore and ESX, JSON persistence and optional SQL storage.
* Prepared two Lua escrow exceptions, removed the public debug command and excluded saved test characters.
* Tightened finite values, profile access, lifecycle hooks, same-bucket hit validation and failed storage retries.

See [GS ScaleMenu](/docs/gs-scalemenu-free/overview.md).

## ClothDesigner 1.5.0 and Minimap Designer 0.2.0 — Update Packages

* Kept the existing version numbers and refreshed production UI/server bundles and runtime-only packages.
* Verified ClothDesigner access, apparel allocation, equipping/rollback, transfer handling, inventory metadata, image caching, runtime binding and localization.
* Fixed Minimap save/publish acknowledgements, protected rename/duplicate destinations, storage failure handling and path/polygon/heal-only baking.
* Removed Minimap browser samples, narrowed its escrow exceptions to six explicit Lua files and blanked release access lists/credentials.
* Added a Minimap update guide preserving sheets, the active pointer, custom maps, completed exports and integrations; refreshed ClothDesigner runtime confirmation docs.

See [ClothDesigner updating](/docs/clothdesigner/updating.md) and [Minimap Designer updating](/docs/gs-minimap-designer/updating.md).

## GS Nails 1.0.0

* Refreshed the release with automatic/explicit Qbox, QBCore and ESX Legacy selection, framework-specific job/duty/boss integration and per-character legacy metadata storage.
* Added the shared editable bridge, skin reload support and update instructions; checked failed metadata clearing and character lifecycle handling.
* Added five paired manicure stations, six nail shapes, 18 presets per gender and a layered custom nail studio.
* Added personal/salon design libraries, paid technician sessions, optional self-application, image-host integrations and inspect/show gestures.
* Prepared prebuilt female/male packs, five explicit Lua escrow exceptions and a production UI/server bundle.
* Removed development commands and browser mocks, disabled debug defaults and blanked release credentials.
* Tightened charge/token/distance validation, slot checks, failed-payment rollback, layer JSON and public-image downloads; handled empty new-install libraries.

See [GS Nails](/docs/gs-nails/overview.md) for installation, configuration, usage and integrations.

## GS La Flavia 1.0.0

* Added hands-on 3D drink preparation, twelve recipes, quality metadata, bottle-volume consumption and an animated ice-machine workflow.
* Added four customer tablets, paid orders/trays, staff order monitor, public TV, 25 supply-shop entries, pickup/courier delivery and shared storage.
* Added four job grades, hiring/grade management, a SQL society account and lift floor access integration.
* Prepared 27 explicit Lua escrow exceptions, removed seven development commands and browser previews, and built production UI assets.
* Tightened finite quantities, overlapping transactions, pickup hooks, metadata capability and failed reward/payout rollback; preserved offline refunds and corrected Qbox staff membership handling.
* Disabled automatic legacy balance import for the new release.

See [GS La Flavia](/docs/gs-la-flavia/overview.md) for installation, configuration, usage and integrations.

## GS Cloth Designer 1.5.0

* Updated installation, configuration, usage, Tebex, exports and troubleshooting documentation for the current runtime.
* Documented public access, five prints per six-hour character window, default approval and nine editable languages.
* Added an update guide that preserves existing designs, entitlements, generated apparel and private integration settings.
* Required server authorization for limited-pass grants so clients cannot create or reset allowances.
* Removed development commands, disabled debug mode, rebuilt the UI and bundled/minified the server pipeline for the runtime-only package.
* Narrowed Lua escrow exceptions and retained the raw YDD template exception required by runtime generation.

See [GS Cloth Designer](/docs/clothdesigner/overview.md) and [Updating to 1.5.0](/docs/clothdesigner/updating.md).

## GS Baddie Hub 1.0.0

* Added the members lounge, profiles, friendships, persistent chat and private messages.
* Added starter pack/vehicle claims, ten season rewards, daily/chat XP and two usable items.
* Added character and Discord-role gates, moderation, blocking, directories, themes and five languages.
* Prepared nine explicit Lua escrow exceptions and server-only private integration settings.
* Tightened database startup, reward failure handling, claim locks, vehicle identity/position checks and item consumption.

See [GS Baddie Hub](/docs/gs-baddie-hub/overview.md) for installation, configuration, usage and integrations.

## GS BellaBody 1.0.0

* Added a cosmetic clinic career with a supply cart, portable shot crafting and a deployable animated stretcher.
* Added five walk-in customer variants, Small/Big BBL requests, upgrades, synchronized patient/surgeon scenes and cinematic treatment cameras.
* Added ten ranks, daily/weekly goals, six achievements, statistics and an earnings leaderboard.
* Added framework/inventory bridges, an internal bag, SQL/JSON persistence and five languages.
* Prepared twelve explicit Lua escrow exceptions and private server-only webhook configuration.
* Set the new standalone wallet to $35,000 so the initial clinic setup is affordable, corrected configurable brand text and tightened patient/proximity validation.

See [GS BellaBody](/docs/gs-bellabody/overview.md) for installation, configuration, gameplay and integration documentation.

## GS GlowUp 1.0.0

* Added the makeup studio career with a supplier cart, nineteen materials, two deployable custom machines and eleven cosmetic recipes.
* Added folding workbench placement, mixer snapping, camera-led START interaction, animated dispensing and batches of one to five.
* Added NPC sales and a pop-up stand with refusal, theft, recovery, rank payouts and tips.
* Added ten ranks, rotating daily/weekly goals, six achievements, personal statistics and an earnings leaderboard.
* Added optional cosmetic application with temporary freemode makeup overlays, animation sequences and configurable consumption.
* Added Qbox, QBCore, ESX and standalone bridges, external inventories, a built-in bag, SQL/JSON persistence and five languages.
* Prepared Lua-only escrow exceptions for configuration and integration files, moved webhook settings to server-only configuration and disabled legacy import by default.
* Set the new standalone wallet to $25,000 so players can afford the initial studio setup; corrected configurable interface branding and blocked recovery before a theft sale resolves.

See [GS GlowUp](/docs/gs-glowup/overview.md) for installation, configuration, gameplay and integration documentation.

## GS OnlyShots 1.0.0

* Added the creator career with an orbiting selfie/POV camera, five shot presets, twelve poses, captions and a searchable content gallery.
* Added photo collections with rank-based size limits and bonuses for collection size, creator rank and capture hotspots.
* Added NPC sales with rejection, theft chases, recovery, tips, viral payouts and follower changes.
* Added player purchase offers with server-calculated prices and collector metadata that preserves original authorship.
* Added ten ranks, five hotspots, daily and weekly challenges, ten achievements, lifetime stats and an earnings leaderboard.
* Added Qbox, QBCore, ESX and standalone bridges, supported external inventories and an internal metadata inventory.
* Added SQL or JSON persistence, SQL/hosted image storage, optional role access and activity feeds, and five languages.
* Prepared the release with Lua configuration and integration adapters open under Asset Escrow; removed the temporary forced-theft recording command, its unused outcome override and obsolete command-suggestion cleanup.

See [GS OnlyShots](/docs/gs-onlyshots/overview.md) for installation, configuration, gameplay and integration documentation.

## GS DJ Studio 1.0.0

* Added DJ stations with one server-owned queue per station, played in sync for every listener in range, with periodic drift correction.
* Added YouTube links played as video, direct `.mp3` / `.ogg` / `.wav` links, uploads from the DJ's PC, and a server music library indexed from `data/media/` with `/gsdj scan`.
* Added optional YouTube search by name with exact track lengths through a YouTube Data API v3 key, and automatic title lookup for pasted links without a key.
* Added positional audio from real speakers with coverage radius, directionality, vertical fade, linear, quadratic, or exponential falloff, HRTF panning, and a low-pass filter outside the club.
* Added the light show: lights, spotlights, lasers, fog, fire jets, and sparklers with six animation presets, beam, wash, and bulb shapes, coloured haze, and a live light board in the DJ panel.
* Added screens that show the station's live picture, in drawn mode for any flat prop or texture mode for known render targets.
* Added the in-game venue creator with a freecam, a 3D move and aim gizmo, box select, grab, duplicate, snapping, and nine one-click stage templates.
* Added personal playlists, "Recently played here" and "Top songs on this server" recommendations, and a ten-clip original soundboard.
* Added per-station DJ access by ace, job and grade, identifier, or Discord role, a single DJ lock per booth with take-over, and station ownership.
* Added station export and import, config-station overlays with `/gsdj reset`, and automatic model fallbacks for older game builds.
* Added personal volume and streamer mode, `/gsdj diag` diagnostics, client and server exports, and a per-station state bag.
* Added Qbox, QBCore, ESX, and standalone support, JSON or oxmysql storage, four interaction styles including ox\_target, qb-target, and qtarget, and six interface languages.

## GS Map Studio 1.0.0

* Added the in-game map editor with a noclip freecam, FLY and EDIT camera modes, ped walk mode, focus-on-selection, and go-to-coordinates.
* Added ghost placement with surface alignment, a 3-axis Move / Rotate / Scale gizmo with world and local space, grid, angle, and scale snapping, and arrow-key nudging.
* Added the Array tool (line, grid, circle, path, stairs), the Scatter brush with weighted models, Polygon fill, Area select, Eyedropper, and World erase.
* Added World Edit: select, move, and delete GTA's own map props at runtime using engine model hides, including static geometry by typed model or hash, with per-map restore.
* Added dynamic point and spot lights with color, range, brightness, cone controls, pulse, flicker, and strobe animation, optional shadow, and attachment to props.
* Added layers, groups, server-shared prefabs, copy and paste, align and distribute, and unlimited undo and redo with a browsable history page.
* Added the prop library with categories, search, favorites, recently used, collections, direct spawn by model name, and `Config.CustomProps` for add-on packs.
* Added server-side JSON file storage with rolling autosave, crash recovery, and Locked, Public, and Autoload flags per map.
* Added live co-editing with validated, rate-limited operation batches and automatic resync on rejection.
* Added export to YMAP XML, JSON, Lua, and CSV, and one-click publish of a standalone streaming resource.
* Added Qbox, QBCore, ESX, and standalone support with ace, identifier, and job-based permissions, six interface languages, dark and light themes, and rebindable keys.

## GS Appearance 2.0.0

* Added the cinematic appearance editor: arc category rails, a curved item carousel with real preview renders, a drag dial for mixes and sliders, a 64-swatch hair palette, and a scripted camera with face, shirt, pants, and shoes focus presets.
* Added the full freemode pipeline: ped models, clothing components, props, head blend, 20 face-feature sliders, 12 head overlays, hair with tint, eye color, makeup, and tattoos by body zone.
* Added four store types — clothing, barber, tattoo, and surgeon — with database-backed zones, per-type blips and prompts, job and gang locks, and server-side distance and cost enforcement.
* Added `Config.StoreMenus`, so each shop type's customization sections are configurable and a single section skips the menu entirely.
* Added the in-game admin dashboard: an interactive store map with create, move, toggle, and delete, a live server-wide accent color, and item rules with blacklist, job lock, and player whitelist types enforced on the server.
* Added named outfits with in-place updates and verified writes, shareable outfit codes, and job and gang uniforms filtered by job, grade, and gender.
* Added drop-in compatibility with `illenium-appearance`, `qb-clothing`, `skinchanger`, `esx_skin`, and `fivem-appearance`, including their exports, events, and callbacks.
* Added an ox\_lib-free callback bridge that reimplements ox\_lib's wire protocol, so third-party scripts keep working on servers that do not run ox\_lib.
* Added automatic migration of `qb-clothing` and `esx_skin` / `skinchanger` skin formats, so existing characters keep their look and are never sent back through the character creator.
* Added Qbox, QBCore, ESX, ox, and standalone detection with late-start recovery, plus character-creation hand-off for `qb-multicharacter`, `qbx_properties`, `esx_multicharacter`, and `esx_identity`.
* Added automatic schema creation and self-healing migrations, including widening `player_outfits.citizenid` for ESX Legacy identifiers and adding the unique key non-destructively.
* Added CDN preview hosting, removing the \~7,900-file registration that made `ensure gs_appearance` hang. `Config.CaptureBaseUrl` repoints every preview at another account or host in one line, with a per-file url map as a fallback for hosts that do not mirror the folder layout.
* Added `server/credentials.lua`, a server-only file holding the Fivemanage upload key and endpoint, and a resumable upload tool that reads them and prints the base url to paste into the config.
* Added `Config.IconOverrides`, which swaps any individual UI icon for a resource file or a hosted image without rebuilding the NUI, falling back to the shipped icon if an override fails to load.
* Added startup conflict detection for competing appearance resources, the `/gsdiag` install diagnostic with a real database write round-trip, and `/gsrelease` as an emergency NUI and ped release.

## GS Weapon Designer 0.2.0

* Added the in-game weapon skin studio with a layer-based canvas, UV wireframe guides, live 3D preview, and per-part editing for bodies, magazines, suppressors, scopes, grips, and flashlights.
* Added the slot system: every published design occupies a pre-built addon weapon slot, with per-weapon counts and a server-wide ceiling controlled by `data/weapon_slots.json`.
* Added runtime skin rendering visible to nearby players, with persistence across disconnects and server restarts.
* Added 29 vanilla weapon templates covering rifles, pistols, SMGs, shotguns, and melee weapons.
* Added the armory with design history, restore, equip, and delete, plus an optional staff approval queue with audit logging.
* Added ox\_inventory integration with real weapon items and working attachments via the bundled bridge module, plus support for QBCore, Qbox, ESX, Jaksam, CodeM, Quasar, and AK47 inventories through a ticket item.
* Added Tebex designer passes with weapon and AI-generation allowances, offline claiming, and persistent entitlements.
* Added the studio tool API for external addons, including the optional `gswd-ai` generation companion.
* Added Qbox, QBCore, and ESX detection with a standalone fallback, and automatic database migration on first start.

## GS Garages 1.0.0

* Initial release with public, house, job, gang, and impound garages, all defined as data in `config/garages.lua`.
* Added the showroom interface with a live 3D turntable preview, composed camera presets, cinematic mode, and real handling-data performance bars.
* Added in-world DUI surfaces: the nameplate behind the previewed vehicle, the `E — PARK` prompt at garage bays, and the `E — OPEN GARAGE` prompt on foot.
* Added Qbox, QBCore, ESX, and standalone support with automatic framework detection and no framework file edits.
* Added auto-detected fuel, vehicle key, and target adapters, each with a config override hook.
* Added automatic house garages for ps-housing, qbx\_properties, qs-housing, qb-houses, loaf\_housing, esx\_property, and rtx\_housing, plus a custom provider hook.
* Added favorites, nicknames, transfers, give-keys with persistent shared access, "find my car" waypoints, and odometer mileage.
* Added impound lots with job-gated release, depot pricing, and police/tow exports.
* Added the in-game admin suite: world-placed garage creation and live, database-persisted config editing.
* Added additive idempotent schema migrations, a native import for incomplete dealership rows, and cross-script importers for qb-garages, jg-advancedgarages, cd\_garage, and loaf\_garage.
* Added server-side ownership, fee, rate-limit, and duplicate-spawn protection, plus batched Discord webhook logging.

## GS Announcements 1.0.0

* Added the full announcement Builder with seven layouts, animated backgrounds, media, lightshows, sizing, sounds, GPS actions, and scheduling.
* Added limited player publishing with job locking and an administrator approval queue.
* Added MySQL-backed access control for jobs, players, one-time passes, super admins, minimum grades, and content restrictions.
* Added an approved asset-library workflow for announcement backgrounds, logos, and artwork.
* Opened Asset Library submissions to whitelisted players; media stays pending until an approver signs it off.
* Added `Config.PlayerMode.RequireApproval` to switch player publishing between the admin approval queue and direct broadcasting.
* Added profiles, broadcast history, recurring schedules, business statuses, CSV history export, and live engagement analytics.
* Added Qbox, QBCore, and ESX job detection with standalone administrator operation.

## Zombies V3 3.1.0

* Added named zombie profiles with weighted models and per-profile stats, combat, movement speed, and locomotion.
* Added profile zones with weighted links and deterministic overlap priority.
* Added ox\_lib-compatible sphere, box, and polygon/prism zones with a built-in fallback when ox\_lib is unavailable.
* Added server exports for runtime profile, profile-zone, profile-link, and safe-zone management.
* Added client exports for managed-zombie detection and profile inspection.
* Extended client and server spawn hooks with backward-compatible profile context.

## ClothDesigner 1.3.0 RC

* Added limited designer client and server exports with separate clothing and AI allowances.
* Added persistent Tebex package entitlements with configurable package limits, online auto-open, offline claiming, transaction de-duplication, and usage rules.
* Added a player wardrobe for previewing, wearing, and removing created clothing.
* Added optional admin approval and rejection before a print is published and granted.
* Added synchronized equip and unequip state across inventory items and the wardrobe.
* Made printed inventory items toggle their design on first use and off on second use.
* Added persistent previous-appearance restoration for clothing components and props, including footwear.
* Improved reconnect rehydration so equipped runtime textures return after supported framework load events.
* Added FiveManage media hosting alongside Discord and database storage.
* Added pre-`FileReader` client upload-size validation with player-facing errors.
* Added a bounded media queue for uploads, imports, design previews, AI references, and generated-media hosting.
* Added AK47 Inventory support and expanded inventory documentation for Jaksam, CodeM, Quasar Advanced Inventory, and ox\_inventory.
* Added a persistent black or light-gray 3D preview background switch.
* Added lazy loading and unloading for off-screen library previews.
* Reworked WebGL renderer lifecycle to reuse and dispose contexts correctly.
* Improved generated pack diagnostics with exact source YDD, companion YTD, and generated YDD names for invalid references.
* Added stale retry invalidation to prevent removed clothing from immediately reappearing.
* Reduced pants flicker with prebinding and a targeted component-cache fallback.

## \[Unreleased]

### ClothDesigner

* Documentation and release-candidate validation

### DarkMet

* Initial release

### Zombies V3

* Initial release

### Paintball

* Initial release

### Fueling System

* Initial release

### Arenas

* Initial release

### Multicharacter (QBCore)

* Initial release

### Characters (ESX)

* Initial release

### Leveling System

* Initial release

### Zombies/Cannibals

* Initial release