Billboards

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： bukkit paper spigot

标签： game-mechanics technology utility

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

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:

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