Floating Clock

Show the in-game world time as floating hologram-style clocks anywhere in your Minecraft world. Personal clocks visible only to you, or world clocks visible to everyone. Move them, resize them, color them — all from commands or a 3×3 GUI.

# Requirements
- Java 17+
- Spigot 1.20.4+

# Installation

- Drop FloatingClock.jar into your server's plugins/ folder
- Start the server — the plugin generates config.yml and data.yml automatically
- Grant permissions (see below) or set use-permissions: false in config.yml for testing
- Run /fc help in-game to open the wiki book

# Clock Types
## Personal clocks
visible only to the owner. Despawn when the owner logs out, respawn on join. Other players never see them.

## World clocks
visible to everyone. Always display the live time when at least one player is online. Show XX:XX when the server is empty.

# Per-Clock Customization
- Text label : a custom name shown above the time display
- Color: Background color (17 Bukkit colors)
- Size (Text scale): small, medium, big, verybig, huge — configurable in config.yml
- Time offset: ±hours shift applied to the displayed world time

# Edit GUI
- /fc edit <idx> opens a 3×3 dispenser GUI:
Movement is relative to the player's facing direction.

# Performance

- Personal clocks despawn on quit, respawn on join
- Data saves asynchronously with coalescing
- Entity reconnection via UUID + name fallback scan
- Ghost entity cleanup on chunk load
- Late-loading worlds handled via WorldLoadEvent

# Commands

permission floatingclock.player or .world
- /fc help: Opens 9-page colored wiki book
- /fc list: Lists your clocks with [P]/[W] tags
- /fc edit <idx>: Opens the 3×3 movement GUI
- /fc offset <idx> <±hours>: Shifts displayed time forward (+) or back (-)
- /fc color <idx> <color>
- /fc size <idx> <size>
- /fc delete <idx>: Deletes one clock by ID
- /fc reset: Deletes ALL your clocks

permission floatingclock.player
- /fc add player <clock-name>

permission floatingclock.world
- /fc add world <clock-name>

.world or .admin
- /fc worldlist: Lists world clocks in current dimension

floatingclock.admin
- /fc admin list: Lists every clock on the server
- /fc admin reset: Removes every clock on the server

Alias: /floatingclock = /fc

Tab completion: All subcommands and arguments are tab-completable. Clock IDs in uppercase. Admins see all IDs; players see only their own.

Admin override: Players with floatingclock.admin can edit, delete, color, resize, and offset ANY clock. Owner name is shown when editing another player's clock.


# Permissions
- floatingclock.player: Create and manage personal clocks
- floatingclock.world: Create and manage world clocks
- floatingclock.admin: Manage any clock + admin commands


# Server Restart

- World clocks: re-spawned automatically, settings restored
- Personal clocks: re-spawned when owner logs in
- Ghost entities from crashes: auto-cleaned on chunk load

# Backup

- Copy plugins/FloatingClock/data.yml — human-readable YAML, editable while server is offline.