Billboards

BILLBOARDS

Create high-quality in-game billboards from images using maps. Built for performance, large images, and smooth rendering.

---

✨ Features

- Create in-game billboards from image files - Fast rendering with image caching - Async image loading to reduce lag - Supports large images with safe scaling

---

How It Works

Billboards are created from image files placed in the plugin’s `images/` folder and defined in `config.yml`.

Each billboard has: - A size - An size - A size (width × height in maps)

---

📂 Image Setup (Required)

1. Place your image inside: ```

/plugins/Billboards/images/

```

Example: ```

example.png

````

2. Open `config.yml` and define the image: ```yml image: "%example%.png" ````

* `example` is the billboard name * You can name it anything you want

---

📐 Billboard Size

Define the size (in maps) in `config.yml`:

```yml size: width: 4 height: 3 ```

* `width` → number of maps horizontally * `height` → number of maps vertically

---

🚀 Spawning a Billboard

Once the image and size are defined:

```bash /billboard spawn <billboard-name> ```

Example:

```bash /billboard spawn example ```

This will:

* Load the image * Slice it into maps * Spawn the billboard in front of you

---

📜 Commands

`/billboard spawn <name>`

Spawns a billboard using the image and size defined in the config.

`/billboard list`

Lists all spawned billboards.

Each entry includes:

* Billboard name * [Copy] – Teleport to the billboard * [Copy] – Copy the billboard name / ID

`/billboard reload`

Reloads the config and images without restarting the server.

`/billboard remove <name>`

Removes a specific billboard.

`/billboard wipeall`

⚠️ Removes all billboards from the world.

---

📸 Screenshot Utilities

Some list entries may include:

* `screenshot:list` * `screenshot:reload` * `screenshot:spawn`

These are internal tools used for previewing and refreshing billboard renders.

---

⚡ Performance

* Images are loaded cached * Rendered maps are cached * Large images are scaled safely to prevent memory spikes

---

⚠️ Beta Notes

This is a Beta release.

If you report issues, please include:

* Server version * Java version * Plugin version * Full console logs

---

🔗 Links

* GitHub: https://github.com/revqz1/Billboards

```