Home/Products/VortixCarshopUI

VortixCarshopUI

An intuitive carshop UI for RP servers

VortixCarshopUI Preview 1
Click to Expand

VortixCarShopUI is a modern, feature-rich RocketMod plugin for Unturned that provides an interactive, UI-driven vehicle dealership. It integrates with Uconomy and the VortixUI masterbundle to allow players to inspect 3D vehicle models, cycle paint colors/variants, review stats, take vehicles on timed test drives, and make purchases.


Features

  • 3D Interactive Showroom: Displays 3D vehicle previews with interactive rotation and stat readouts (Speed, Health, Fuel, Price).
  • Multi-Color / Variant Cycling: Cycle through variant vehicle IDs defined in configuration using the in-game color button.
  • Uconomy Integration: Safe asynchronous balance verification and deduction to prevent server hitches or transaction loss.
  • Timed Test Drives: Players can test-drive vehicles for a configured duration. Test drives automatically end if the timer expires or if the player exits early.
  • Checkpoint Proximity Markers: Automatically triggers visual effects (CheckpointEffectId) when players approach a dealership location.
  • Spawn Protection & Collision Checks: Prevents double-purchases or spawning cars into blocked pads.
  • Per-Location Permissions: Restrict specific dealerships to VIPs or staff.
  • Single-Shopper Isolation: Restricts each dealership to one customer at a time to prevent preview overlap, vehicle theft, and visual bugs.
  • Custom & Default HUD Support: Cleanly hides vanilla or custom HUD elements while in the dealership, then reliably restores all widget flags upon exit without mouse lock or camera blur bugs.
  • Setup Helper Tools: Includes /coords to quickly configure shop coordinates and rotations.

Requirements

  • Unturned RocketMod
  • Uconomy
  • VortixUI Workshop (Workshop ID: 3814461260)

Commands & Permissions

CommandAllowed CallerPermissionDescription
/carshopPlayercarshopOpens the nearest car shop if within CheckpointRadius.
/coordsPlayercoordsPrints your current X, Y, Z coordinates and rotation yaw in chat.

Note: Individual dealership locations can also enforce their own permission node in the XML configuration (set to "none" to allow all players).


Configuration Reference

The configuration file is located at Plugins/VortixCarShopUI/VortixCarShopUI.configuration.xml.

Global Settings

SettingTypeDefaultDescription
EffectIdushort41092The Unturned Effect Asset ID for the main shop UI.
EffectUILayershort10035The unique UI instance key used to send text and visibility updates. Prevents conflicts with other UI plugins.
CheckpointEffectIdushort9518The visual particle effect ID triggered when a player walks within 15m of a shop checkpoint.
TimeInShopSecondsint300Maximum time (in seconds) a player can stay in the dealership before being automatically returned to the exit point.
TestDriveDurationSecondsint60Duration (in seconds) of a test drive before the vehicle is cleaned up and the player is teleported back.
RandomColorOnSelectboolfalseIf enabled, chooses a random color/ID variant when first opening a vehicle preview.
UseDefaultUnturnedHudbooltrueHides vanilla Unturned HUD elements (health, stamina, crosshair, etc.) during browsing and restores them upon closing.
CheckSpotIsBusybooltruePrevents vehicle purchases if another vehicle is obstructing the purchase pad.
SpotBusyRadiusfloat5.0Radius (in meters) around VehiclePurchasePosition to check for obstructions.
RotationValuefloat15.0Degrees to rotate the preview vehicle when clicking the rotate button.
FuelDividerfloat100.0Value used to divide raw vehicle fuel for display in the UI.
TeleportBackIfNearCarShopbooltrueTeleports players back to the exit point if they revive too close to a shop's preview stage.
ButtonCooldownMsint350Cooldown period between UI interactions.
CustomHudSupportboolfalseEnables execution of external console commands when entering and leaving the UI (useful for servers running third-party HUD plugins).
CustomHudSupportDisableCommandstringhud falseCommand executed on the player when opening the shop menu.
CustomHudSupportEnableCommandstringhud trueCommand executed on the player when closing the shop menu.

Dealership Locations (<Locations>)

Each <Location> block supports the following settings:

PropertyDescription
NameDisplay name of the shop shown on the UI banner.
PermissionPermission required to access this shop (none for public).
CheckpointPositionCoordinate where players must stand to use /carshop.
CheckpointRadiusMaximum distance (in meters) from CheckpointPosition to open the shop.
PlayerSpawnPosition / PlayerSpawnRotationWhere the player stands while looking at the vehicle preview.
VehicleSpawnPosition / VehicleSpawnRotationWhere the 3D preview model is placed.
PlayerExitPosition / PlayerExitRotationWhere the player is teleported when closing the menu.
VehiclePurchasePosition / VehiclePurchaseRotationSpawn location for purchased vehicles.
VehicleTestDrivePosition / VehicleTestDriveRotationSpawn location for test-drive vehicles.
TestDriveReturnPosition / TestDriveReturnRotationWhere the player is placed when their test drive finishes.

Vehicle Definitions (<Vehicles>)

Each vehicle in a location contains:

  • Name: Vehicle title displayed in the shop list and specs panel.
  • Price: Uconomy cost.
  • TestDriveEnabled: Whether the "Test Drive" button is enabled for this vehicle.
  • Ids: List of <Id> entries representing paint colors or variant vehicle IDs. Clicking the "Change Color" button cycles through these IDs.

Example XML Configuration

<?xml version="1.0" encoding="utf-8"?>
<VortixCarShopUIConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <EffectId>15010</EffectId>
  <EffectUILayer>10035</EffectUILayer>
  <CheckpointEffectId>9518</CheckpointEffectId>
  <TimeInShopSeconds>300</TimeInShopSeconds>
  <RandomColorOnSelect>false</RandomColorOnSelect>
  <UseDefaultUnturnedHud>true</UseDefaultUnturnedHud>
  <CheckSpotIsBusy>true</CheckSpotIsBusy>
  <SpotBusyRadius>5</SpotBusyRadius>
  <RotationValue>15</RotationValue>
  <FuelDivider>100</FuelDivider>
  <TeleportBackIfNearCarShop>true</TeleportBackIfNearCarShop>
  <TestDriveDurationSeconds>60</TestDriveDurationSeconds>
  <ButtonCooldownMs>350</ButtonCooldownMs>
  <CustomHudSupport>false</CustomHudSupport>
  <CustomHudSupportDisableCommand>hud false</CustomHudSupportDisableCommand>
  <CustomHudSupportEnableCommand>hud true</CustomHudSupportEnableCommand>
  <Locations>
    <Location>
      <Name>REGULAR CAR SHOP</Name>
      <Permission>none</Permission>
      <VehicleSpawnPosition x="210.1032" y="59.72854" z="807.2935" />
      <VehicleSpawnRotation>29</VehicleSpawnRotation>
      <PlayerSpawnPosition x="216.9545" y="57.72854" z="796.7792" />
      <PlayerSpawnRotation>326</PlayerSpawnRotation>
      <PlayerExitPosition x="202" y="57.75923" z="818.4061" />
      <PlayerExitRotation>292</PlayerExitRotation>
      <VehiclePurchasePosition x="191.4235" y="59" z="800.8179" />
      <VehiclePurchaseRotation>230</VehiclePurchaseRotation>
      <VehicleTestDrivePosition x="191.4235" y="59" z="800.8179" />
      <VehicleTestDriveRotation>230</VehicleTestDriveRotation>
      <TestDriveReturnPosition x="202" y="57.75923" z="818.4061" />
      <TestDriveReturnRotation>292</TestDriveReturnRotation>
      <CheckpointPosition x="202" y="57.75923" z="818.4061" />
      <CheckpointRadius>3</CheckpointRadius>
      <Vehicles>
        <Vehicle>
          <Name>Charger</Name>
          <Price>40000</Price>
          <TestDriveEnabled>true</TestDriveEnabled>
          <Ids>
            <Id>140</Id>
            <Id>43</Id>
          </Ids>
        </Vehicle>
      </Vehicles>
    </Location>
  </Locations>
</VortixCarShopUIConfiguration>

Translations

All chat feedback strings can be localized in Plugins/VortixCarShopUI/VortixCarShopUI.en.translation.xml:

KeyDefault Text
someoneAlreadyInCarShopSomeone is already in the car shop, please wait!
noNearestCarshopNo car shop nearby! Move closer to a checkpoint.
purchaseSuccessYou have successfully purchased {0}!
NotEnoughMoneyTranslationInsufficient funds!
SpotBusyTranslationSpot is occupied!

Known Bugs

  • Test Drive doesn't work working as intended
BUNDLE & SAVE 20%Save $14.10

Roleplay Essentials

Essential roleplay plugins for the ideal RP experience.

Bundle Price:

$70.50$56.40
VortixCarshopUI

VortixCarshopUI

roleplayvehiclesgeneral (misc)economyui
★New(0 ratings)
$15.00Save up to 20% in a Bundle↓
Current Versionv1.0.0
Last Updated10/12/2026

Required Workshop

Unique Visitors31
Subscribers15
Favorites0
Workshop IDs
3814461260

Developer Support

Need help setting up this plugin? Reach out to the developer directly.

Get Support

Latest Changes

v1.0.0

Initial Release