CAD Display

​

Activation Guide

​

1. Download and Install the Resource

​

2. Adjust the Configuration

​

ACE Permissions

• sonoran.caddisplay allows a player to open the menu and use or attach a CAD display.
• sonoran.caddisplay.admin allows menu access and saving or deleting vehicle-model placements.
• sonoran.caddisplay.world allows saving and deleting station-display placements. If this value is blank, the current resource falls back to aceObjectAdminUseMenu.

add_ace group.sonoran_cad_display sonoran.caddisplay allow
add_ace group.sonoran_cad_display_admin sonoran.caddisplay.admin allow
add_ace group.sonoran_cad_display_admin sonoran.caddisplay.world allow

​

Commands

• /caddisplay opens the vehicle display menu when seated in a supported vehicle, or the station display menu when on foot.
• /caddisplay calibrate opens screen alignment for display administrators. This is only needed for custom or misaligned screens.

​

Keybind

​

Usage

​

a. Prop Spawning

1. Stop the vehicle and stay seated. Run /caddisplay, choose Spawn CAD Display, and select the laptop.
2. Drag the colored arrows to move the laptop, or the colored squares to move it along two directions at once. Select Rotate to use the rotation rings. Snap helps make small, even adjustments.
3. Choose Apply to this vehicle to use the placement on your current vehicle. Administrators can choose Save for this vehicle model to reuse it for future vehicles with the same spawn code.

​

b. Using Built-in Laptops

b. Continued

1. This option requires additional configuration and third-party software. To begin, navigate to the caddisplay_config.lua file located in the /sonorancad/configuration folder. The builtinScreens section of this configuration file is where you define vehicles equipped with built-in laptops.
2. To obtain the texture name you will need to use a third-party software such as OpenIV.
3. Within OpenIV, click File in the top-right corner, then select Open Folder and navigate to the folder containing your vehicle files

OpenIV - Open Folder ButtonOpenIV - File Explorer

4. Once OpenIV opens your selected folder, you will see your vehicle files. From here, open the SPAWNCODE.ytd file. A .ytd file is a texture dictionary that contains the textures used by the vehicle, such as screens, decals, and interior displays. For this tutorial, the spawn code used is b3.

OpenIV - YTD Viewer

5. Within the OpenIV Texture Viewer, scroll through the textures and locate the laptop screen texture. In the case of b3, the texture name is laptop_screen. Some vehicles may include multiple screen textures; ensure you select the one used for the in-vehicle laptop display.

OpenIV - YTD Viewer - Laptop Screen Texture

6. Now that all required information has been gathered, you can begin adding it to the configuration. Be sure to note the texture’s dimensions as shown in OpenIV, as this information is required for proper display. Important: The texture dimensions must match exactly, or the display may not render correctly. For the tutorial vehicle, the configuration should appear as follows:

builtinScreens = {
    {
        vehicle = "b3",                 -- Vehicle spawn code
        screenTexture = "laptop_screen",-- Texture name from the .ytd file
        textureWidth = 256,             -- Texture width (must match OpenIV)
        textureHeight = 256             -- Texture height (must match OpenIV)
    }
},

​

c. Using the Screen

1. Close the handheld tablet if it is open. Sit in a vehicle with a configured display, or stand close to a station laptop.
2. Press G. If another player controls the display, they must approve your request first.
3. Once you have control, the camera moves toward the screen. Click, scroll, and type in CAD as you would in the tablet. Your CAD login and current page stay loaded when switching between the tablet and laptop.
4. Click Exit computer below the screen to return to the game. If Escape does not close the view while you are typing inside CAD, use Exit computer.

​

d. Passing Laptop Control

​

Station CAD Display Props

1. With station administration permission, run /caddisplay while on foot to open Station CAD Displays. You do not need to be in a vehicle.
2. Choose Place Station Display, or select an existing display and choose Edit Selected Display.
3. Use the same colored arrows and rotation rings as vehicle placement. Right-drag to orbit the laptop, middle-drag to pan, and use the mouse wheel to move closer or farther away. Frame object brings the laptop into view; Original view restores the starting camera.
4. Click Save station display to keep your placement, or Cancel to discard your changes.

​

Screen Alignment for Server Owners

1. Close the tablet and other menus. Stand within 3 meters of the station display, or sit in the stopped vehicle containing the screen.
2. Run /caddisplay calibrate. You need menu access and administration permission for the vehicle or station display you are adjusting.
3. Place the four numbered markers on the visible screen corners, viewed from the front: top-left, top-right, bottom-right, bottom-left. Aim and click to place a marker; press Tab to select the next one.
4. Use the arrow keys and Page Up/Page Down to fine-tune the markers, including their depth. Hold Shift for smaller movements or Ctrl to move all four together. If clicking does not land on the screen, use these keys instead.
5. Press Enter to apply the alignment locally, then G to test it. R resets the corners, F flattens the fourth corner if needed, and Backspace cancels.
6. To keep the alignment for everyone, copy the block printed in the F8 console into your active caddisplay_config.lua. For a separate laptop prop, place it inside interaction.models. For a built-in screen, place it inside that vehicle’s builtinScreens entry. Replace any existing profile for the same model, then restart sonorancad.

​

Troubleshooting Laptop Interaction

• G does not open the laptop: close the handheld tablet and other menus, move closer, and check the on-screen notification. Server owners should confirm both sonorancad and tablet are running.
• Missing screen profile or an incorrectly aligned screen: use the screen alignment steps above. Built-in screens need their own profile even if their texture already shows CAD.
• Laptop interaction is disabled: the server owner can enable interaction.enabled. Players can use /tablet open in the meantime.
• Placement will not start: stop the vehicle and close any other camera or placement mode before trying again.