/qb-scenes

Primary LanguageLuaGNU General Public License v3.0GPL-3.0

QBCore Scenes

Original ui, util code, and inspiration from loljoshie's nui_drawtext.

I really liked LJ's scenes implementation, but I wanted to do a lot of refactor on it, as well as add some custom work from myself, so I did!

Scenes lets you place drawtext anywhere in the world, through the NUI menu, and laser pointers. This drawtext can include emojis, be multiple lines, and supports markdown! If you don't like the way a scene looks before you place it, you can easily edit it!

Setup

  1. Import scenes.sql into your database
  2. Adjust values in the shared/config.lua file to your likings.

Features

  • Create 3Ddrawtext from an NUI interface and laser pointer system (defaults to 'K')
  • Delete scenes with a laser pointer system (defaults to 'DELETE')
  • Customize text, color, view distance, expiration time, font size, font style
  • Ability to preview a scene before finalizing it
  • All scenes are saved in the database
  • Scenes are automatically deleted when they expire
  • Markdown, emojis, and multiple lines supported
  • Configurable logo

Example Usage

Interface Examples

Interface

Creation Laser

Creation Laser

Deletion Laser

Deletion Laser

Video Example

Video Example

Change Log

1.07

  • Accepted PR from loljoshie. Which changed around the color scheme of the ui, logo to svg, added sounds, and locale support.
  • Changed close button to a reset button
  • Moved around order of items in the ui to make more sense
  • Updated README

1.0

  • Initial release

Future ToDos

  • Refactor VUE code to allow for resetting values after placement
  • Add config option to only allow posting scenes if you have an item (Poster?)
  • Add more scene settings (maybe an advanced tab?) (text outline)
  • Add background settings (Type, height/width, color, opacity, x/y location, rotation)
  • Add interaction function when E is pressed nearby. This will let users bind any command on press.
  • Be able to preview your changes live on the screen instead of having to submit and check

Other Creations

License

QB Racing
Copyright (C) 2022

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>