# XRISMA MACHINE CREATOR

### Advanced Vending Machine & Player Business System for FiveM

**Take your FiveM server to the next level with XRISMA MACHINE CREATOR!**

Bring your server to life with 4 premium custom 3D vending machines, a powerful in-game administration creator, and a complete player-owned business system.

Players can purchase products, manage their own vending machine businesses, control stock, set selling prices, collect earnings, and pay taxes — creating a more immersive and dynamic economy.

Fully compatible with **Qbox, QBCore, ESX, and Standalone**.

## KEY FEATURES

- 4 Premium Custom 3D Vending Machines.

- Fully Interactive & Realistic Machine Interfaces.

- In-Game Admin Creator (`/machines`).

- Complete Player Ownership System (`/mymachines`).

- Custom Product Management & Pricing.

- Stock Management & Restocking System.

- Machine Earnings & Cash Collection.

- Configurable Business Taxes.

- Realistic Player Animations & Cinematic Camera.

- Discord Logging System.

- Multiple Frameworks & Inventory Support.

- English & Greek Translations.

- Optimised Performance.

## 4 CUSTOM 3D VENDING MACHINES

Includes four unique, optimised 3D vending machines, each with its own design, products, and interactive interface.

**Coffee Machine**

- Custom 3D coffee machine.

- Interactive touchscreen interface.

- Small, Medium & Large sizes.

- Customisable sugar and milk.

- Realistic coffee preparation animation.

- Payment unit and illuminated cup bay.

**Food Machine**

- 20 fully modelled 3D food products.

- Burgers, toasts, hot dogs, pies, croissants and more.

- 5 × 4 product layout.

- Detailed 3D vending coils.

**Snacks Machine**

- 24 fully modelled 3D snack products.

- Chips, chocolate, candy, cookies, popcorn and more.

- 4 × 6 product layout.

- Detailed 3D vending coils.

**Drinks Machine**

- 72 fully modelled 3D cans and bottles.

- Lore-friendly GTA brands.

- eCola, Sprunk, Orang-O-Tang, Raine, Junk and more.

**Every product is a real 3D model**, featuring readable labels, vibrant colours, and optimised low-poly geometry.

All props are streamed directly with the resource and can also be replaced with GTA's original vending machine models or your own custom models.

## REALISTIC INTERACTIVE MACHINE MENUS

Each machine features a unique interface matching its design and colour scheme.

- Realistic UI for Coffee, Food, Snacks and Drinks machines.

- Select products using their individual codes (A1, B2, etc.).

- Enter product codes using the in-game keypad or keyboard.

- Cash or bank payment options.

- Quantity selection and live balance display.

- Automatic display of inventory item images.

- Optional item metadata support (OX / QB / QS).

**Advanced Purchase Protection:**

Payment is only collected when the player actually takes the purchased product from the vending tray.

The interface remains open until the product is collected, preventing unwanted charges and improving the overall experience.

Additional server-side protection includes:

- Distance validation.

- Purchase cooldowns.

- One-player-per-machine locking.

## IN-GAME ADMIN CREATOR

### `/machines`

Create, configure, and manage every vending machine directly in-game.

**Machine Placement**

- Live placement preview.

- Rotation and height adjustment.

- Fast placement mode.

- Change the model of existing machines.

**Product Editor**

- Browse all available inventory items.

- Automatic item image display.

- Product search.

- Custom prices and display order.

- Stock configuration.

- Item blacklist and validation.

**Machine Management**

- Sales and revenue statistics.

- Search and filtering.

- Teleport to any machine.

- Move existing machines.

- Enable / Disable machines.

- Delete machines.

- Restock products.

- Configure payment methods.

- Individual map blips.

**Advanced Permissions**

Four configurable staff roles:

- Owner

- Admin

- Developer

- Moderator

Permissions can be detected through ACE, framework groups, or player identifiers.

**Discord Integration**

Detailed Discord logs for:

- Purchases.

- Machine edits.

- Ownership changes.

- Price modifications.

- Money collection.

- Tax payments.

## PLAYER-OWNED BUSINESS SYSTEM

### `/mymachines`

Turn vending machines into fully functional player-owned businesses!

Administrators can assign vending machines to players using their server ID, with configurable ownership limits.

**Business Management**

- Own and manage multiple vending machines.

- Collect earnings from individual machine cash boxes.

- Set custom selling prices within configurable minimum and maximum markup limits.

- Manage product stock.

- Receive low-stock warnings.

- View and manage owned machines from one interface.

- GPS navigation to every owned machine.

**Smart Restocking System**

Owners can purchase new stock at cost price using:

- Machine cash box.

- Bank account.

- Cash.

A convenient restock cart makes managing multiple products simple and efficient.

**Public Machines**

Administrators can also configure public vending machines with fixed prices and unlimited stock, or enable stock management if preferred.

## BUSINESS TAX SYSTEM

A complete configurable taxation system for player-owned vending machines.

- Automatic tax receipts every X days.

- Decimal intervals supported.

- Configurable tax amounts per machine type.

- Tax payments through the machine management interface.

- Payment using machine cash box, bank, or cash.

- Automatic payment warnings for machine owners.

**Unpaid Taxes:**

After a configurable number of unpaid tax receipts, the machine can automatically:

- Be deleted.

- Become public again.

The behaviour is fully configurable.

## FRAMEWORK & RESOURCE COMPATIBILITY

**Frameworks**

- Qbox

- QBCore

- ESX

- Standalone

**Inventories**

- ox_inventory

- qb-inventory

- ps-inventory

- lj-inventory

- qs-inventory

- ESX

- Custom inventories

**Interaction Systems**

- ox_target

- qb-target

- Built-in TextUI

**TextUI**

- Built-in TextUI (8 positions).

- ox_lib.

- QB.

- Custom.

**Notifications**

- Built-in.

- ox_lib.

- QB.

- ESX.

- okokNotify.

- Native.

- Custom.

**Database & Storage**

- oxmysql.

- JSON storage (no database dependency).

**Languages**

- English.

- Greek.

All text is fully translated through editable locale files.

**Important:** ox_lib is NOT required.

## IMMERSIVE PLAYER EXPERIENCE

Make every interaction feel natural and realistic.

- Player walks towards the vending machine.

- Realistic button-pressing animation.

- Product collection animation with individual item props for each machine type.

- Smooth cinematic camera while interacting.

- Configurable interface sound effects and volume.

## OPTIMISED PERFORMANCE

Built with performance in mind.

- Vending machine props spawn only within the configured player streaming distance.

- Lightweight client-side processing.

- Nearest machine checks run 4 times per second.

- Batched data storage to reduce unnecessary database operations.

- Optimised custom 3D models.

**Enjoy detailed visuals without unnecessary performance overhead.**

## CONFIGURATION & OPEN FILES

Extensive configuration options and editable source files.

**Included Open Files (Escrow Ignored):**

- `config.lua`

- `server/sv_config.lua`

- `locales/`

- `bridge/` (Framework / Inventory / Notify / TextUI)

- `install.sql`

Configure:

- Machine types and slots.

- Models and product prices.

- Stock and ownership.

- Business taxes.

- Permissions and staff roles.

- Interaction keys and commands.

- Animations and cinematic camera.

- Placement settings.

- Currency and sounds.

**Custom Server Hooks**

Includes server-side hooks such as `CanPurchase`, allowing you to integrate your own economy rules and custom server logic.

## INSTALLATION

1. Place `xrisma_machine_creator` inside your server's `resources` folder.

2. If using oxmysql, execute `install.sql` (or configure `Config.Storage = 'json'`).

3. Add the following line to your `server.cfg`:

`ensure xrisma_machine_creator`

4. Give your staff the required ACE permission:

`add_ace group.admin xrisma.machines.admin allow`

5. Start your server and use:

- `/machines` – Create and manage vending machines.

- `/mymachines` – Manage player-owned vending machine businesses.

## XRISMA MACHINE CREATOR

**More than just vending machines. A complete business experience for your FiveM server!**

Designed for immersive roleplay, advanced server economies, and endless customisation possibilities.