Skip to content

v1.0.0

Choose a tag to compare

@Github-Samuel Github-Samuel released this 29 Aug 18:34
· 3 commits to main since this release

3D channel-letter signs for FiveM. Type text into a panel, watch the real sign float in front of you as you tune it, then drag it into place. It stays there, for everyone, across restarts.

The letters are streamed props — one game object per character — so they catch light, cast shadows, have real extruded depth and a dark return down the sides, and you can walk around them.

What's in it

  • 129 glyphs — A–Z, a–z, 0–9 and 67 symbols: punctuation, brackets, currency, arrows, fractions and maths
  • 10 colours, matte or neon, and up to 3 rows per sign
  • Per-letter colour — click any letter in the preview and recolour just that one
  • 5 colour effects — gradient, cycle, wave, chase, pulse — plus spin
  • Size from 0.2 m to 10 m, or up to 120 m with the Ultra toggle
  • Per-sign visibility, up to roughly two miles
  • Walk around the preview — pin the sign, drop the panel and inspect it on foot from any angle
  • Two placement modes — camera aim, or drag handles via the optional object_gizmo
  • Admin overview — every placed sign, with preview, highlight, teleport, edit, delete and delete-all
  • Persists to MySQL with a self-migrating schema. No SQL file to import.

Colour is a tint, not geometry

Both finishes use a GTA tint shader carrying a small palette texture, and the game picks the row per entity:

SetObjectTextureVariation(entity, 7)   -- blue, on any glyph

So "red A" and "blue A" are the same streamed model. The whole palette ships in 258 models and about 5 MB, where baking colour into each model would have meant 2580 and ~44 MB — and an animated sign costs no more entities than a static one, because animating is writing an integer rather than swapping objects.

Installation

  1. Download sd-signs.zip below and drop sd-signs into your resources folder.
  2. ensure sd-signs in server.cfg, after ox_lib and oxmysql.
  3. add_ace group.admin sd-signs.build allow
  4. Restart. The table is created on first start.

Use the zip rather than a source download — the NUI is built by CI and packaged into it, so a clone of main has no web/build.

Requires ox_lib and oxmysql. No framework needed.

Letters built from Montserrat Bold under the SIL Open Font License 1.1.