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 name
• An image file
• A size (width × height in maps)

---

📂 Image Setup (Required)

1. Place your image inside:

/plugins/Billboards/images/

Example:

example.png

1. Open config.yml and define the image:

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:

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:

/billboard spawn <billboard-name>

Example:

/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
• [Open] – 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 asynchronously
• 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