whiteboard

Whiteboard (Paper plugin)

> Render text from a writable book onto an Item-Frame whiteboard. > Supports grid boards, lock, background fill, fonts, undo/redo—server-side only.

Full docs & screenshots: GitHub README

Summary

Whiteboard lets players place a board on item frames and push book text onto it with a right-click. Multiple maps can be merged into a large grid board—handy for PDCA-style planning with kids, without client mods.

Images

Requirements

• Server: Paper 1.21.9 (or compatible)
• Java: 21
• Client: Vanilla (no mods needed)

Install

1. Download the JAR from Releases (or Hangar).
2. Drop it into plugins/ and start the server.

Usage

1. Place an Item Frame (map inside is recommended).
2. (Optional) Create a grid board:

   /wb grid 3x2

1. Write in a writable book, hold it, and right-click the board to render.

• Book directives let you control setup without commands:

| Directive | Effect | |---------------------|---------------------------------------------------------------------| | [boardsize WxH] | Create/reset a board using the clicked frame as the top-left tile. | | [lock on/off] | Lock (default) or unlock the board after creation/updates. | | [size N] | Override text size (8–64). | | [line N] | Set line height when rendering wrapped/global text. | | [pos X Y] | Offset drawing position. [xy …] / [offset …] also work. | | [color #RRGGBB] | Change text colour (CSS names or hex). | | [clear] | Clear existing text before applying the book. | | [pass secret] | Provide the current password so a locked board accepts the book. | | [password new] | Set or change the board password; use off / clear / none. |

Example first page:

     [boardsize 7x4] [password classroom123] [lock on]
     [size 18] [color #ffaa00] Welcome to class!

Password Protection

• Combine [password <value>] with [lock on] to require that password for future edits.
• When a board is locked with a password, draw/clear commands are blocked until a book supplies [pass <currentPassword>].
• To change or remove the password, include both [pass <current>] and either [password <new>] or [password off] in the same book.
• Server operators (or players with whiteboard.admin) can force-remove a board with /wb gdestroy while looking at it—handy if the password is lost.

Commands

/wb grid <COLS>x<ROWS>     # e.g., /wb grid 3x2
/wb text [<text>]          # no arg: use held book; with arg: draw the text
/wb font size=<n> color=#RRGGBB
/wb bg <#RRGGBB>
/wb lock on|off
/wb clear
/wb undo
/wb redo
/wb gdestroy              # OP only: delete the board you are looking at

Build (dev)

./gradlew clean build
# JAR: build/libs/Whiteboard-<version>.jar

Localization(i18n)

Language files live in src/main/resources/lang/. If your language isn’t available, please add a new file (e.g. de_de.yml) and open a PR.

Troubleshooting

• Nothing renders: check permissions and console; ensure you’re right-clicking while holding a written book.
• Hangar publish 400 (noColor): create the channel (e.g., Snapshot) on Hangar UI and assign a color, then publish again.

License

MIT (see LICENSE).

Credit

• 納戸工房 / Closet Workshop