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
- Type a Title and the Text, for example
Opening hours|Mon-Fri 9-17. - Pick the size, colors and frame. Check the preview.
- Aim at a wall and left-click. You get "Billboard placed (n / 10 on this map)."
Put up a standing board
- Tick Posts under standing billboards if you want posts.
- Aim at the floor where it should stand and left-click. The board stands up and faces you.
Change an existing billboard
- Change the settings in the panel.
- 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
- As a superadmin, tick Every player can use the Billboard tool (off = admin only).
- Set Billboards per player and press Apply.
- 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>.jsonand 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_playersoff again does not remove players' billboards. Remove them from the list if needed. - Placing, changing and removing billboards is written to the Action Log.