VortixCarshopUI
An intuitive carshop UI for RP servers

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
/coordsto quickly configure shop coordinates and rotations.
Requirements
- Unturned RocketMod
- Uconomy
- VortixUI Workshop (Workshop ID:
3814461260)
Commands & Permissions
| Command | Allowed Caller | Permission | Description |
|---|---|---|---|
/carshop | Player | carshop | Opens the nearest car shop if within CheckpointRadius. |
/coords | Player | coords | Prints 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
| Setting | Type | Default | Description |
|---|---|---|---|
EffectId | ushort | 41092 | The Unturned Effect Asset ID for the main shop UI. |
EffectUILayer | short | 10035 | The unique UI instance key used to send text and visibility updates. Prevents conflicts with other UI plugins. |
CheckpointEffectId | ushort | 9518 | The visual particle effect ID triggered when a player walks within 15m of a shop checkpoint. |
TimeInShopSeconds | int | 300 | Maximum time (in seconds) a player can stay in the dealership before being automatically returned to the exit point. |
TestDriveDurationSeconds | int | 60 | Duration (in seconds) of a test drive before the vehicle is cleaned up and the player is teleported back. |
RandomColorOnSelect | bool | false | If enabled, chooses a random color/ID variant when first opening a vehicle preview. |
UseDefaultUnturnedHud | bool | true | Hides vanilla Unturned HUD elements (health, stamina, crosshair, etc.) during browsing and restores them upon closing. |
CheckSpotIsBusy | bool | true | Prevents vehicle purchases if another vehicle is obstructing the purchase pad. |
SpotBusyRadius | float | 5.0 | Radius (in meters) around VehiclePurchasePosition to check for obstructions. |
RotationValue | float | 15.0 | Degrees to rotate the preview vehicle when clicking the rotate button. |
FuelDivider | float | 100.0 | Value used to divide raw vehicle fuel for display in the UI. |
TeleportBackIfNearCarShop | bool | true | Teleports players back to the exit point if they revive too close to a shop's preview stage. |
ButtonCooldownMs | int | 350 | Cooldown period between UI interactions. |
CustomHudSupport | bool | false | Enables execution of external console commands when entering and leaving the UI (useful for servers running third-party HUD plugins). |
CustomHudSupportDisableCommand | string | hud false | Command executed on the player when opening the shop menu. |
CustomHudSupportEnableCommand | string | hud true | Command executed on the player when closing the shop menu. |
Dealership Locations (<Locations>)
Each <Location> block supports the following settings:
| Property | Description |
|---|---|
Name | Display name of the shop shown on the UI banner. |
Permission | Permission required to access this shop (none for public). |
CheckpointPosition | Coordinate where players must stand to use /carshop. |
CheckpointRadius | Maximum distance (in meters) from CheckpointPosition to open the shop. |
PlayerSpawnPosition / PlayerSpawnRotation | Where the player stands while looking at the vehicle preview. |
VehicleSpawnPosition / VehicleSpawnRotation | Where the 3D preview model is placed. |
PlayerExitPosition / PlayerExitRotation | Where the player is teleported when closing the menu. |
VehiclePurchasePosition / VehiclePurchaseRotation | Spawn location for purchased vehicles. |
VehicleTestDrivePosition / VehicleTestDriveRotation | Spawn location for test-drive vehicles. |
TestDriveReturnPosition / TestDriveReturnRotation | Where 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:
| Key | Default Text |
|---|---|
someoneAlreadyInCarShop | Someone is already in the car shop, please wait! |
noNearestCarshop | No car shop nearby! Move closer to a checkpoint. |
purchaseSuccess | You have successfully purchased {0}! |
NotEnoughMoneyTranslation | Insufficient funds! |
SpotBusyTranslation | Spot is occupied! |
Known Bugs
- Test Drive doesn't work working as intended
Roleplay Essentials
Essential roleplay plugins for the ideal RP experience.
Bundle Price:
VortixCarshopUI
Required Workshop
Latest Changes
v1.0.0