CozyDisplays

CozyDisplays is a lightweight Paper plugin for creating and managing vanilla TextDisplay-based displays. It is intended for floating text, wall signage, spawn notes, and simple hologram-style server displays without the weight of a larger hologram suite.

Features

• Create multi-line vanilla TextDisplay signage in-game.
• Move, nudge, hide, show, scale, and delete displays with admin commands.
• Snap displays to vertical wall faces for clean signage.
• Tune per-display render/view range.
• Persist displays in plugins/CozyDisplays/displays.yml.
• Optional PlaceholderAPI support for global placeholders.
• Legacy & color code support for display text.

Compatibility

• Server software: Paper
• Target Minecraft version: 1.21.11
• Java: 21
• Optional dependency: PlaceholderAPI

CozyDisplays uses Paper API and vanilla TextDisplay entities. It is not intended for Bukkit/Spigot-only servers.

Installation

1. Download the CozyDisplays jar.
2. Stop your Paper server.
3. Place the jar in your server's plugins/ folder.
4. Install PlaceholderAPI only if you want placeholder support.
5. Start the server.
6. Edit plugins/CozyDisplays/config.yml if needed, then run /display reload.

Existing config files are not overwritten on startup.

Quick Start

Create a display at your location:

/display create welcome &6Welcome to spawn

Add another line:

/display addline welcome &fRead the rules before building.

Move it to the wall you are looking at:

/display snapwall welcome

Fine tune its position:

/display up welcome 0.05
/display left welcome 0.05

Commands

Command	Description
/display create <id> <text...>	Create a display at your location.
/display addline <id> <text...>	Add a line to a display.
/display setline <id> <lineNumber> <text...>	Replace one line.
/display removeline <id> <lineNumber>	Remove one line.
/display movehere <id>	Move a display to your location.
/display snapwall <id>	Center a display on the targeted vertical block face.
/display nudge <id> <up|down|left|right|forward|back> [amount]	Move a display by a small amount.
/display up|down|left|right|forward|back <id> [amount]	Shortcut nudge commands.
/display scale <id> <scale>	Set text scale.
/display viewrange <id> <range>	Set render range in blocks.
/display viewrangeall <range>	Set render range for every display.
/display enabled <id> <true|false>	Show or hide a display.
/display hide <id>	Hide a display while keeping it saved.
/display show <id>	Respawn a hidden display.
/display info <id>	Show saved display settings.
/display stats	Show display and entity counts.
/display list	List saved displays.
/display delete <id>	Delete a display and remove its entities.
/display reload	Reload config and saved displays.

Permissions

Permission	Default	Description
cozydisplays.admin	op	Allows all CozyDisplays admin commands.

PlaceholderAPI

PlaceholderAPI is optional. If it is installed and enabled, CozyDisplays resolves placeholders in display lines on spawn and on the configured refresh interval. If PlaceholderAPI is missing, the plugin still starts normally and leaves placeholder text unchanged.

Displays are world-bound and not rendered per player by CozyDisplays, so player-specific placeholders may resolve to PlaceholderAPI's global, default, or empty value.

Configuration

config.yml includes:

Key	Description
placeholder-refresh-seconds	Refresh interval for PlaceholderAPI text. Set to 0 to disable automatic refresh.
wall-offset	Distance pushed out from a wall by /display snapwall.
default-view-range	Default render range in blocks for new or older saved displays.
display-entity-warning-threshold	Logs a warning when spawned TextDisplay entities exceed this count.
default-nudge-amount	Default movement amount for nudge commands.
debug-view-range	Logs view-range details while spawning displays.
debug-placeholder-refresh	Logs placeholder refresh checks.

Unsafe numeric values are clamped to safe ranges and logged.

Examples

Spawn rules sign:

/display create rules &cRules
/display addline rules &f1. Be kind
/display addline rules &f2. No griefing

Create a lightweight status display with PlaceholderAPI:

/display create online &aOnline: &f%server_online%

Limit render range for dense signage:

/display viewrange rules 8

Troubleshooting

Problem	Check
Commands do not work	Confirm you have cozydisplays.admin or operator status.
Placeholders show literally	Install PlaceholderAPI and the needed expansions, then run /display reload.
Display is missing after restart	Confirm the saved world is loaded and check the server log for skipped display warnings.
Text is hard to position	Use /display snapwall, then the nudge shortcuts with small amounts such as 0.03 or 0.05.
Dense areas cause client lag	Lower viewrange, remove unneeded lines, or split signage across fewer visible displays.

Support / Issues

Please report bugs and documentation problems on the GitHub issue tracker:

https://github.com/Cheddah01/CozyDisplays/issues

When reporting bugs, include your server software/version, CozyDisplays version, Java version, relevant config snippets, and any console errors.

Building From Source

Requirements:

• Java 21
• Maven 3.9 or newer

Build:

mvn clean package

The jar is written to target/CozyDisplays-<version>.jar.

License

CozyDisplays is released under the MIT License. See LICENSE.