AWZ PHONOGRAPH

AWZ Phonograph

AWZ Phonograph is a complete and immersive phonograph system for RedM VORP servers, designed to bring ambient music, roleplay interactions and collectible music cylinders into your game world.

The resource allows players to place phonographs, insert music cylinders, play 3D positional audio, change tracks, control volume, purchase cylinders from configurable shops and interact with both placed and static phonographs around the map.

It has been designed to be clean, optimized and suitable for professional roleplay servers.

Main Features

Placeable Phonographs

Players can use the configured item to place a phonograph in the world.
Placement is handled through VORP Lib Gizmo, including camera controls, movement, rotation, ground placement and fully localized control labels.

You can configure:

• phonograph item;

• prop model;

• placement distance;

• minimum distance between phonographs;

• max placed phonographs per character;

• recovery behavior;

• database persistence.

Music Cylinders with Metadata

Music cylinders are real inventory items with custom metadata.

Each cylinder can include:

• album name;

• track list;

• optional track durations;

• custom description;

• optional unique serial number;

• metadata image and formatting.

Cylinders can be created through commands, exports or purchased from configured shops.

3D Audio with xsound

The resource uses xsound as the main audio system.

Music is played in 3D space with configurable distance, rolloff and volume.
When players move away from a phonograph, the client-side audio handling is optimized to avoid unnecessary updates.

Supported features:

• 3D positional audio;

• configurable volume;

• track switching;

• pause/play;

• stop;

• optional antique phonograph sound layer;

• local player audio toggle through commands.

Static Phonographs and World Scan

Besides placeable phonographs, the resource supports static phonographs already placed in the world.

You can use:

• static phonographs configured by coordinates;

• existing map props;

• configurable world model scan;

• multiple models such as p_phonograph01x and p_gramophone01x.

Perfect for saloons, shops, hotels, theatres or any roleplay location.

Phonograph and Cylinder Shops

The resource includes a built-in shop system.

Shops support:

• configurable NPC;

• configurable blip;

• HOLD mode interaction prompt;

• VORP Menu interface;

• custom offers;

• phonograph sales;

• music cylinder sales;

• purchases only through the Buy button, not by double-clicking menu items.

Store NPCs, blips and prompts are handled through VORP Lib.

Optimized Prompt System

The phonograph prompt layout is clean and practical.

Available actions:

• play / pause;

• change track;

• volume + / - on the same prompt row;

• recover cylinder with HOLD mode;

• recover phonograph with HOLD mode.

When the player is not near a phonograph or a shop, the client threads sleep and the resource stays extremely light.

Persistent Database

Placed phonographs are saved in the database table:

phonographs

The resource saves:

• position;

• heading;

• owner;

• inserted cylinder;

• cylinder metadata;

• current track;

• volume;

• pause/play state.

After a server or resource restart, the phonograph remains in the world and the cylinder remains inserted, without automatically starting music playback.

Multi-Language Support

The resource includes separate locale files for:

IT
EN
FR
DE
ES

You can select the language directly from the config:

Config.Locale = 'EN'

Translated content includes:

• prompts;

• notifications;

• menus;

• shop labels;

• buttons;

• default metadata;

• VORP Lib Gizmo controls.

Clean Configuration

The configuration files are compact and easy to manage.

Main config files:

• config.lua

• config_audio.lua

• config_placement.lua

• config_metadata.lua

• config_albums.lua

• stores.lua

• locales

Advanced internal options are handled script-side to keep the public configuration clean and safe.

Performance

The resource has been optimized to keep resmon usage extremely low.

Included optimizations:

• dynamic thread sleeps;

• prompt checks only when nearby;

• audio updates only when needed;

• optimized store scans;

• server-side loops sleep when no active phonographs exist;

• no AWZ Libs dependency.

When the player is not near phonographs or shops, the resource is designed to stay around 0.00 / 0.01 ms.

Dependencies

Required resources:

vorp_core
vorp_inventory
vorp_lib
vorp_menu
xsound
oxmysql