Tutorial / Tools > Building

Billboard

Big boards with a title and text, saved for this map (at most 10).

What it does

Billboard places large signs with a title and up to 8 lines of text. Long lines wrap at the width you set. Billboards are saved for the map and shown to every player. A map holds at most 10 billboards.

Aim at a wall and the board hangs on it, facing out. Aim at the floor and the board stands up facing you, optionally on two posts.

Colors, frame, size and color effects are set in the tool panel. A live preview at the top of the panel shows the board as you change it.

Where to find it

Q menu > KGX's Admin Toolbox > Building > Billboard.

By default only admins can use it, and players who are given it in Settings > Player Access. A superadmin can open it to every player with kgxat_billboard_players (see below).

Given to a player (v3.6.11.3): Their own billboards (limit).

Controls

Key What it does
Left click Place a billboard (on a wall, or standing on the floor facing you)
Right click Remove the billboard nearest to where you aim
Reload Update the nearest billboard with the current settings

Right click and reload act on the nearest billboard within 400 units of where you aim.

Options

Option What it does Default Range
Title (empty = none) Title line at the top. BILLBOARD Up to 48 characters
Text (| = new line, max 8 lines) Body text. Use | to start a new line. Your text here|Use | for a new line Up to 400 characters, 8 lines
Size (1 - 10) Overall scale. 3 1-10
Width (where lines wrap) Width at which long lines wrap. 1400 600-2400
Title color Color of the title. 255, 210, 60
Text color Color of the text. 255, 255, 255
Title color effect Effect on the title (list below). Plain
Text color effect Effect on the text (list below). Plain
Second color (gradient) Second color used by the gradient effect. 255, 120, 0
Background (alpha = see-through) Board color. Lower alpha makes it see-through. 16, 20, 34, alpha 240
Frame Draw a frame around the board. On
Frame color Color of the frame. 255, 210, 60
Posts under standing billboards Floor billboards stand on two posts. On
Center the text Center the lines. Off = left aligned. On
Reset to defaults Puts every option above back to its default.

The color effects are Plain, Rainbow, Pulse, Gradient (two colors), Blink, Fire and Police lights (red / blue).

Who may place billboards (superadmins)
Option What it does Default Range
Every player can use the Billboard tool (off = admin only) Same as kgxat_billboard_players. Applies as soon as you tick it. Off
Billboards per player Same as kgxat_billboard_max. Press Apply to save it. 2 1-10

Only superadmins can change these two. Others see them greyed out.

Billboard list

Admins (and players given the Billboard in Player Access) see a list of all billboards on the map. The columns are #, Billboard (title, who placed it, size) and Distance.

  • Double-click a row to go there.
  • Right-click a row for Go there, Rename..., Copy position and Remove.
  • Refresh reloads the list. Remove all billboards on this map... asks first and cannot be undone.

How to use it

Put up a wall sign
  1. Type a Title and the Text, for example Opening hours|Mon-Fri 9-17.
  2. Pick the size, colors and frame. Check the preview.
  3. Aim at a wall and left-click. You get "Billboard placed (n / 10 on this map)."
Put up a standing board
  1. Tick Posts under standing billboards if you want posts.
  2. Aim at the floor where it should stand and left-click. The board stands up and faces you.
Change an existing billboard
  1. Change the settings in the panel.
  2. Aim at the billboard and press reload. It takes the new title, text, size and colors. Its place stays the same.
Let every player place billboards
  1. As a superadmin, tick Every player can use the Billboard tool (off = admin only).
  2. Set Billboards per player and press Apply.
  3. Players can now place up to that many. They can change and remove only their own.

Settings and commands

Setting What it does Default Range
kgxat_billboard_players 1 = every player can use the Billboard tool; 0 = admins and Player Access only. 0 0-1
kgxat_billboard_max Most billboards one player can have on a map when kgxat_billboard_players is on. 2 1-10

Tips and limits

  • The 10 per map limit counts everyone's billboards. The 11th is refused until one is removed.
  • A billboard needs a title or some text. Both empty is refused.
  • Billboards are saved in data/kgx_admin_toolbox/billboards_<map>.json and come back after cleanups and restarts.
  • Text from non-admins goes through the chat filter (Utilities > Chat Filter). Blocked words are starred out.
  • Players with only the open setting cannot change or remove other players' billboards ("That billboard is not yours."). Admins can change or remove any.
  • Turning kgxat_billboard_players off again does not remove players' billboards. Remove them from the list if needed.
  • Placing, changing and removing billboards is written to the Action Log.

Back to Tools

Type to search every tool, panel, setting, FAQ answer and release.