Skip to main content
A prop placement system that allows players to place persistent, client-only props using inventory items. Features include preview placement with gizmos, owner-only removal, and efficient streaming based on player distance.
This script provides prop placement with persistent storage, client-side streaming for performance, and integration with popular placement gizmos.

Features

Persistent props

Props are saved to MySQL and automatically restored on resource start, so placements persist across server restarts.

Client-side streaming

Non-networked entities spawn and despawn per player within a configurable radius for optimal performance.

Owner-only removal

Toggleable system where only prop owners can remove their placements and receive the item back.

Placement limits

Configurable limits per item and a global maximum per player to prevent abuse and maintain server performance.

Advanced placement UX

Uses gs_gizmo for intuitive placement or falls back to a translucent ghost preview with rotation controls.

Framework integration

Compatible with VORP Core and RSG Core frameworks with modular framework bridge support.

Usage

Placing props

1

Use item

Use the configured inventory item from your inventory
2

Placement mode

Inventory closes and the placement gizmo opens (or a translucent ghost appears)
3

Position prop

Move and rotate the prop to the desired position using the controls
4

Confirm placement

Confirm placement to save and spawn the prop client-side

Removing props

1

Approach prop

Stand near the prop you want to remove (within the configured radius)
2

Use command

Run /pickupprop (or your configured removal command)
3

Receive item

The prop is removed and the original item is returned to your inventory

Placement controls

When using gs_gizmo, follow the on-screen prompts for intuitive placement controls.
  • Move: Aim the camera to move the ghost prop
  • Rotate: Use Q/E keys to rotate the prop
  • Confirm: Left mouse button to place
  • Cancel: Right mouse button to cancel placement

Credits

  • Placement gizmo integration: gs_gizmo by GlitchOo
  • Framework bridge: Modular design for easy framework integration
  • Performance optimization: Client-side streaming and efficient entity management

Next steps

Setup

Installation, dependencies, streaming, limits, and the database schema.

Docs home

Installation basics and links to every script.