TipSign

Place supporter links and long-form text directly in your Minecraft world.

TipSign adds a craftable sign-post block that lets server operators, map makers, and content creators embed multi-page text with one-click Ko-fi and Patreon buttons — bridging in-game exploration with real-world community support.

Features

Tip Sign Block

Custom sign-post model with vertical post, mounted board, and decorative cap
Place on the ground (standing) or on walls (flush-mounted)
8 background color themes: Oak, Dark Oak, Spruce, Birch, Crimson, Warped, Stone, Obsidian
Title renders directly on the block face in the world
Animated "Right-click me!" indicator appears when players look at the sign

Long-Form Text

Write up to 50 pages of content per sign (configurable)
Full Minecraft formatting code support (colors, bold, italic, underline, strikethrough)
Book-style page navigation in a weathered-plank UI

Supporter Links

Ko-fi and Patreon buttons with brand colors, displayed on every page
One click opens the creator's support page in the player's browser
Confirmation dialog before opening external links (configurable)

Inline Hyperlinks

Embed [link text](url) in body text for clickable links
Server-configurable domain whitelist for security
Can be disabled server-wide via config

Permissions & Data Safety

Only the sign owner (or server ops) can edit content
Configurable break protection — non-owners can't destroy placed signs
Breaking a sign preserves all data in the dropped item — place it again with everything intact
Explicit "Delete All Content" action with two-step confirmation is the only way to erase data

Discovery API

Automatic JSON snapshot of all signs written to config/tipsign/tipsigns.json
Optional webhook push to an external URL (for website integration)
HMAC-SHA256 request signing for secure webhook endpoints
5-second debounce for rapid edits, configurable background interval

Crafting Recipe

[Gold Nugget] [Any Plank] [Gold Nugget]
[           ] [  Stick  ] [           ]
[           ] [  Stick  ] [           ]

Accepts any plank type (oak, birch, spruce, etc.). Recipe can be disabled via config.

Configuration

Server-side config at config/tipsign.toml:

Option	Default	Description
`ownerOnlyBreak`	`true`	Only owner/ops can break a placed sign
`maxPages`	`10`	Maximum pages per sign (1–50)
`craftingEnabled`	`true`	Enable/disable crafting recipe
`allowInlineLinks`	`true`	Allow clickable hyperlinks in body text
`allowedLinkDomains`	`ko-fi.com, patreon.com`	Domain whitelist for all links
`discoveryEnabled`	`true`	Enable JSON snapshot + webhook output
`webhookUrl`	(empty)	Webhook endpoint for push notifications
`webhookSecret`	(empty)	HMAC-SHA256 secret for webhook signing

Version Support

TipSign supports 18 Minecraft versions across 7 compatibility bands:

Versions	Java
1.20.1–1.20.4	17
1.20.5–1.20.6	21
1.21–1.21.1	21
1.21.2–1.21.3	21
1.21.4–1.21.5	21
1.21.6–1.21.8	21
1.21.9–1.21.11	21

Requires: Fabric Loader 0.18.4+, Fabric API