Setup New MLO

Getting Started

1. Open the Position Configurator

/position-config

This opens the web-based UI for configuring positions.

2. Select an Item to Position

Choose from the available restaurant elements in the UI:

  • Click on any item type to start positioning

  • The system will automatically determine if it needs a gizmo or marker

3. Position Your Element

For Physical Objects (Gizmo Mode)

  1. The object appears at your current position

  2. Use object_gizmo controls to move and rotate

  3. Position is automatically saved when you finish

  4. UI reopens automatically for continued configuration

For Interaction Points (Marker Mode)

  1. A visual marker appears at your position

  2. Walk to the desired location

  3. Type /save-pos to save the position

  4. Continue with next position

4. Save and Continue

  • Positions are automatically saved

  • Use /position-config to continue configuring

  • Preview all positions with the toggle in the UI

Commands

Main Commands

Command
Description

/position-config

Open the position configurator UI

/stop-position-config

Close the configurator and cleanup

/save-pos

Save current position (marker mode)

/cancel-pos

Cancel current positioning

UI Features

Position Management

  • Visual Grid: See all configured positions at once

  • Item Categories: Organized by restaurant element type

  • Index Management: Multiple instances of same item type

  • Real-time Updates: Changes reflect immediately

Preview System

  • Toggle Preview: Show/hide all configured positions

  • Semi-transparent Objects: Easy to see through preview objects

  • Position Validation: Visual confirmation of placements

Configuration Data

  • Automatic Saving: No manual save required

  • Export Ready: Data formatted for external use

  • Backup System: Local storage of all positions

Technical Details

Object Models

Each item type uses specific preview models:

PREVIEW_MODELS = {
    coords = 'prop_mp_cone_02',
    cookingStations = 'prop_mp_cone_02',
    fridges = 'prop_mp_cone_02',
    speakers = 'prop_mp_cone_02',
    trashCans = 'prop_bin_07d',
    spatulas = 'sn_spatula',
    fryers = 'sn_fryer',
    dumpsters = 'prop_mp_cone_02',
    grills = 'prop_bbq_3',
    friesPlates = 'prop_food_tray_01',
    npcWaiting = 'prop_mp_cone_02',
    npcRoutes = 'prop_mp_cone_02'
}

Position Data Format

{
    x = 123.45,        -- X coordinate
    y = 678.90,        -- Y coordinate
    z = 12.34,         -- Z coordinate
    heading = 180.0,   -- Rotation (degrees)
    rotation = {       -- 3D rotation (for gizmo objects)
        x = 0.0,
        y = 0.0,
        z = 180.0
    }
}

Grill Component System

Grill items use meat-specific models:

  • Raw Meat Patties: sn_burgerpattyraw

  • Cooked Meat: sn_burgerpatty

  • Burnt Meat: sn_burgerpattyburnt

  • Custom Meat Types: Configurable via Config.MeatModels

Best Practices

Positioning Tips

  1. Start with Layout: Position major elements first (grills, fryers)

  2. Work in Sections: Configure one area at a time

  3. Use Preview: Regularly toggle preview to see overall layout

  4. Test Interactions: Ensure player access to all interaction points

Performance Considerations

  • Cleanup: System automatically cleans up preview objects

  • Model Loading: Large models may take time to load

  • Memory Management: Objects are deleted when not needed

Troubleshooting

  • Gizmo Not Working: Ensure object_gizmo resource is started

Error Messages

  • Failed to load model: Model file missing or corrupted

  • No active positioning session: Use /position-config first

  • Position already exists: Overwrites existing position at index

This documentation covers the complete position configurator system. For additional support, check the main nn_restaurants documentation or contact the development team.

PreviousInstallationNextConfiguration

Last updated