VebaStickers is an enterprise-grade, high-performance Minecraft plugin engineered to deliver a modern visual messaging experience across Java Edition and Bedrock Edition. Featuring a zero-redundancy texture linking pipeline, pure vanilla container isolation, an interactive player onboarding wizard (PackPromptMenu), dynamic cache purging with instant preference reset, a 4-tier network delivery architecture, real-time 3x3 mega vitrin showcase with a 9-slot interactive hitbox, Shift-Click Burst Send, 3D floating holograms, and 16-language auto-detection, VebaStickers delivers the ultimate chat graphics framework without sacrificing server TPS, player freedom, or network bandwidth.

Key Highlights & Architectural Overview (v1.9.2)

• Pure Vanilla Container Isolation (100% Unmodified Chests): Unlike other plugins that brutally overwrite the global generic_54.png container texture and alter every double chest on your server, VebaStickers isolates its custom GUI backgrounds completely. Normal survival and creative chests, Ender chests, and /vsa admin views retain 100% authentic vanilla textures. The custom Mega Vitrin backdrop is rendered strictly for the sticker showcase using negative-space font glyph overlays (\uF808\uEE01\uF8F0) and OptiGUI hooks.
• Interactive Onboarding Setup Wizard (PackPromptMenu): Empowers every player with personal freedom. Upon initial login (or anytime via /sticker pack), players are greeted with an aesthetic 27-slot setup wizard where they can choose between Full HD + Modern GUI, Stickers Only (Classic Vanilla Chests), or Skip (Text Mode), complete with a one-click preference remember toggle.
• Dynamic Cache Purge & Choice Reset (/vebasticker remove-cache / /vsa remove-cache): Server administrators and players can instantly purge the server pack cache, regenerate fresh SHA-1 hashes, unbind old client packs, wipe player onboarding decisions, and immediately re-open the setup wizard on-the-spot for seamless preference reselection.
• Overhauled Administrative Dashboard (/vsa): Symmetrical 6-row layouts with zero missing slots, slate gray glass framing, persistent pagination controls with disabled-state indicators (◀ First Page, Last Page ▶), real-time system health telemetry, and web server diagnostics.
• Clean Minimalist Titles & Icons: All GUI title bars have been cleaned of cluttered suffixes (e.g., " (Mega 3x3)" has been removed in favor of clean breadcrumbs like Stickers » Catalog), paired with modern single/two-tone vector iconography.
• Zero Client Mods (100% Vanilla Compatible): Works natively on default Vanilla Minecraft Java Edition clients (1.12.x through 26.x+ Game Drops) and Bedrock Edition (iOS, Android, Xbox, PlayStation, Switch, Windows 10/11) via GeyserMC & Floodgate.
• Universal Multi-Era Compatibility (1.12.x – 26.x+): A single unified plugin and resource pack bridges legacy 1.12.x (via 2048x2048 HD Unicode sheets and OptiFine CIT), modern 1.14–1.20.4 (CustomModelData), 1.20.5+ (Item Components), and 1.21.4+ (items/*.json model definitions).
• Zero-Redundancy Texture Linking (95% Pack Size Reduction): Slices 50 MB pack bloat down to ~2.5 MB. Each sticker is stored as a single 128x128 Retina master PNG referenced dynamically across GUI models, font glyphs, and CIT properties without file duplication.
• 3x3 Mega Showcase with 9-Slot Interactive Hitbox: Players can choose between a 28-slot WhatsApp-style gallery and an enlarged 2.6x Mega Showcase. The surrounding 8 slots act as empty border-free canvases while mapping to the center sticker—clicking anywhere in the 3x3 grid sends the sticker instantly.
• Shift + Left Click: "Burst Send": Players can send multiple stickers in rapid succession without the menu closing, mimicking mobile messaging apps (Discord/WhatsApp/Telegram).
• 4-Tier Resilient Pack Delivery: Embedded micro HTTP Server (ports 8085-8095), SSL/TLS reverse proxy (public-url for Nginx/Caddy/Cloudflare), native server.properties fallback, and external CDN routing.
• Cross-Platform Crossplay (GeyserMC Native): Automatic .mcpack generation and distribution to Geyser's packs directory, touch-friendly Cumulus Form UIs, and Bedrock Emote button shortcut triggers.
• Dynamic In-Game Administration: Add new stickers live via URL (/stickeradmin add <id> <url>) or bulk-import ZIP packs (/stickeradmin import <pack>) with instant hot-reloading and zero server downtime.
• 3D Floating Holograms (Java Edition): Spawns temporary, billboarded 3D TextDisplay holograms above player heads with smooth bobbing animations, automatically hidden from Bedrock players to prevent entity scaling glitches.
• Economy & Monetization: Full integration with LuckPerms (rank-based packs), Vault economy (per-sticker/category purchasing), and PlayerPoints.

Technical Feature Matrix

Interactive Setup & Onboarding Wizard (PackPromptMenu)

VebaStickers respects your players' visual preferences. Instead of forcing heavy GUI modifications onto players who prefer classic Minecraft aesthetics, VebaStickers introduces the interactive Pack Prompt Onboarding Wizard:

1. Full HD + Modern GUI	2. Stickers Only (Vanilla Chests)
3. Skip Download (Text Mode)	4. Remember My Preference

The Four Setup Options Explained:

1. Full HD + Modern GUI (Slot 11):
   • Downloads the complete resource pack.
   • Enables HD chat stickers, modern neon inventory window frames, and custom vector icons.
   • Recommended for players who want the ultimate, cutting-edge visual overhaul.
2. Stickers Only - Vanilla GUI (Slot 13):
   • Downloads the sticker resource pack for chat and item slots.
   • Preserves 100% classic vanilla Minecraft chests: All GUI menus remain standard vanilla double chests with classic icons (Nether Star, Emerald, Clock, Arrow), while the stickers inside remain full HD emojis!
3. Skip Download - Text Mode (Slot 15):
   • Declines the resource pack download.
   • Stickers display as clean fallback text codes (e.g. :pepe:) in chat with interactive hover badges. Zero download overhead or network lag.
4. Remember My Preference Toggle (Slot 22):
   • Allows players to toggle whether the server should remember their decision permanently or re-prompt them upon each login.
   • Players can re-open this menu at any time by running /sticker pack!

Dynamic Cache Purge & Preference Reset (/vebasticker remove-cache):

• When an administrator runs /vsa remove-cache or /vebasticker remove-cache, the plugin:
  1. Purges cached SHA-1 checksums and regenerates fresh assets.
  2. Sends an unbind packet to the client (Player.removeResourcePacks()) to unload the old pack.
  3. Completely wipes the player's stored decision (pack_decision and has_prompted_pack).
  4. Immediately opens the Pack Prompt Onboarding Wizard so the player can choose their preferred mode again on-the-spot!
  5. Supports /vsa remove-cache all (prompts all online players) or /vsa remove-cache <player> (supports online and offline player profiles).

Dual Display Modes: 28-Slot WhatsApp Grid & 3x3 Mega Vitrin & Bedrock Gui

Players can effortlessly switch between two distinct browsing experiences using the in-game display mode toggle:

WhatsApp Gallery Mode (28-Slot Grid)	Mega Vitrin Mode (Enlarged 3x3 Stage)

Bedrock Edition UI Showcase

1. WhatsApp-Style 28-Slot Gallery Grid (/sticker)

• A dense, multi-sticker layout optimized for rapid chatting and extensive sticker collections.
• Displays 28 stickers per page with category navigation tabs, favorites filter, recents list, sound toggles, and live search.
• When Stickers Only mode is selected, this menu renders inside a 100% authentic vanilla Minecraft chest!

2. 3x3 Mega Vitrin Showcase

• Enlarges the selected sticker to 2.6x scale, commanding center stage.
• Continuous 9-Slot Clickable Hitbox: The surrounding 8 slots act as empty canvas slots while mapping directly to the center sticker. Clicking anywhere within the 3x3 area sends the sticker immediately!
• Pure Container Isolation: Uses zero-width negative-space font glyphs (\uF808\uEE01\uF8F0) to render the isolated neon frame, leaving normal survival chests completely untouched.
• Clean Title Bar: Clean breadcrumb header (e.g. Stickers » Catalog) without unsightly text suffixes.

Architecture & Technical Pipeline Roadmap

1. Zero-Redundancy Texture Linking & Universal Pack

• Single Source of Truth: All stickers are compiled into standard 128x128 Retina PNGs at assets/minecraft/textures/item/stickers/<id>.png.
• Deduplicated Linking:
  • models/item/stickers/<id>.json references "minecraft:item/stickers/<id>"
  • models/item/stickers/<id>_mega.json (2.6x scale) references "minecraft:item/stickers/<id>"
  • font/default.json references "minecraft:item/stickers/<id>.png"
  • items/paper.json (1.21.4+ range_dispatch) references "minecraft:item/stickers/<id>"
  • mcpatcher/cit/stickers/<id>.properties (OptiFine CIT) references "minecraft:item/stickers/<id>"
• Virtual Zip Entry Streaming: To support 1.12.x clients searching for the pre-flattening plural textures/items/ path, ZipOutputStream streams a virtual entry on the fly—costing 0 bytes of extra disk space.
• Universal Metadata (pack.mcmeta):

  {
    "pack": {
      "pack_format": 3,
      "supported_formats": {
        "min_inclusive": 3,
        "max_inclusive": 99
      },
      "description": "§d§lVebaStickers §7- Universal HD Pack (1.12.x - 26.x+)"
    }
  }

  • 1.12.x clients see native pack_format: 3 and load without warnings.
  • 1.20.2 through 26.x+ Game Drops clients recognize supported_formats and load seamlessly with zero red incompatibility screens.

2. Dual-Font Bridge for 1.12.x Clients

Minecraft 1.12.x lacks JSON bitmap font providers (font/default.json). VebaStickers overcomes this with an algorithmic HD Unicode Sheet Generator:

• Compiles active stickers into a crystal-clear 2048x2048 ARGB sheet (unicode_page_e1.png, unicode_page_f0.png).
• Maps each character (e.g. \uE101) to a 128x128 cell in a 16x16 grid.
• Zero-Message Conversion: Both modern and 1.12 clients receive the same unicode in chat, rendering identical HD graphics natively.

3. Dual-Engine Chat Interception

• Paper / Purpur / Folia Engine (AsyncChatEvent): Asynchronous, non-blocking chat pipeline using Adventure Component and custom ChatRenderer implementations. Zero main-thread lag even under high player traffic.
• Spigot Engine (AsyncPlayerChatEvent): High-compatibility thread-safe fallback pipeline for vanilla Spigot and CraftBukkit servers.

4. 4-Tier Resilient Pack Delivery Pipeline

• HTTP Range Requests (HTTP 206): Allows resumption of interrupted downloads.
• ETag & 304 Not Modified Caching: Eliminates redundant network transfers when pack content hasn't changed.
• ViaVersion Protocol Detection: Dynamically appends client protocol diagnostics (?proto=340&target=legacy or ?proto=769&target=modern).

In-Game Player Experience

Chat Graphics & Inline Codes

Java Edition Chat	Bedrock Edition Chat

• Full-Scale HD Stickers: Send standalone stickers or insert :sticker_code: inline anywhere within standard sentences.
• Smart Emoticon Conversion: Automatically converts standard smileys (:), <3, :fire:, ;)) into vibrant custom stickers.
• Rich Hover Tooltips: Displays interactive hover cards showing sticker title, category, required permissions, and author.
• Click Actions: Configure stickers to suggest or run commands when clicked in chat.
• Sticker Mute/Toggle (/sticker toggle): Players can individually toggle sticker visibility without affecting others.

GUI Catalogs & Burst Send

• Shift + Left Click ("Burst Send"): Send stickers repeatedly without closing the menu.
• Normal Left Click: Sends sticker to chat and closes menu.
• Right Click: Adds or removes sticker from personal favorites (/sticker favorites).
• Interactive Book Catalog (/sbook): Browse stickers in an interactive book interface.
• Double-Tap 'F' Shortcut: Double-tapping the offhand swap key ('F') with empty hands opens the sticker catalog instantly.
• Real-Time Search (/sticker search <query>): Instant search filtering by name, ID, or chat code.

3D Floating Holograms (Java Edition)

3D Billboard Hologram

• Spawns a floating 3D TextDisplay entity above the player's head upon sending a sticker.
• Billboard Orientation: Always faces nearby viewers automatically.
• Smooth Bobbing Animation: Gentle vertical motion without jerky teleportation.
• Sender Hiding (hide-from-sender: true): Keeps the sender's own vision clear.
• Ghost Entity Prevention: Clean entity removal on chunk unload, player disconnect, or server reload.

Multi-Language Localization (16 Languages)

Supported Languages Catalog

Built-in support for 16 languages with automatic client locale detection (per-player-language: true):
en (English), tr (Turkish), de (German), es (Spanish), fr (French), pt (Portuguese), ru (Russian), zh (Chinese), ja (Japanese), ko (Korean), it (Italian), nl (Dutch), pl (Polish), ar (Arabic), hi (Hindi), uk (Ukrainian).

Administrative Operations & Overhauled Dashboard (/vsa)

Admin Control Panel	Integrity Status Panel

• Symmetrical 6-Row Layouts: Redesigned all 14 administrative views with slate gray glass borders, dedicated header breadcrumbs (Row 0), and persistent footer navigation controls (Row 5).
• Persistent Pagination Arrows: Eliminates asymmetric holes on first/last pages with disabled-state indicators (◀ First Page, Last Page ▶).
• Live Cache Purge (/vsa remove-cache [all|<player>]): Purges pack cache, forces SHA-1 regeneration, clears stored player choices, and immediately opens the setup onboarding wizard.
• Live URL Sticker Ingestion (/stickeradmin add <id> <url>): Downloads PNG, converts to 128x128 Retina, updates unicode allocations, compiles models, and regenerates the pack live in the background.
• Instant Sticker Removal (/stickeradmin remove <id>): Cleans up assets, models, and font bindings on the fly.
• Bulk ZIP Import (/stickeradmin import <pack>): Bulk-imports complete sticker folders into categories without manual file edits.
• Bedrock Pack Sync (/stickeradmin exportbedrock): Pushes updated .mcpack archives directly to Geyser.
• Live System Status (/stickeradmin status): Reports active server version, chat engine, TextDisplay status, HTTP port, bandwidth, and download metrics.
• 6-Point Integrity Audit (/stickeradmin verify): Validates textures, models, font providers, ZIP integrity, and SHA-1 checksums automatically.

Commands & Permissions Reference

Player Commands

Administrative Commands

Permission Hierarchy

Frequently Asked Questions (FAQ)

1. Does VebaStickers require client-side mods or custom launchers?
No. VebaStickers runs 100% server-side. Vanilla Java Edition and Bedrock Edition clients receive the lightweight resource pack automatically upon joining.

2. How does VebaStickers prevent overwriting standard Minecraft chests?
In v1.9.2, VebaStickers guarantees Pure Vanilla Container Isolation. Normal survival/creative double chests, single chests, Ender chests, and admin menus use the standard vanilla Minecraft texture. Only the custom Mega Vitrin inventory renders custom backgrounds by utilizing invisible negative-space font glyphs (\uF808\uEE01\uF8F0) and OptiGUI title matching (\uEE01), preventing any global texture leaks.

3. What is the difference between "Full HD + Modern GUI" and "Stickers Only"?

• Full HD + Modern GUI: Displays both HD chat stickers and custom modern GUI window borders with custom icons.
• Stickers Only: Downloads the stickers so emojis display in HD in chat and in GUI slots, but keeps the inventory window 100% classic vanilla Minecraft chest style.

4. How can players switch between display modes or reset their choices?
Players can type /sticker pack at any time to open the 27-slot setup wizard and re-select their preference. Administrators can also run /vsa remove-cache [all|<player>] to reset choices and re-prompt the setup wizard.

5. How does VebaStickers support both 1.12.2 and modern 1.21.4 / 26.x+ Game Drops in one pack?
Through our Dual-Font Bridge and Universal metadata architecture:

• Modern clients (1.13+) parse font/default.json and model definitions.
• Legacy 1.12.x clients read the auto-generated 2048x2048 unicode_page_e1.png font sheet and OptiFine CIT definitions.
• The pack.mcmeta specifies pack_format: 3 with supported_formats: [3, 99], satisfying both old and new client parsers with zero warnings.

6. What happens if port 8085 is blocked by my server host?
VebaStickers' 4-tier network delivery automatically scans ports 8085-8095. If all HTTP ports are restricted, it seamlessly falls back to updating server.properties native pack delivery or routes through an SSL reverse proxy (http-server.public-url) or external CDN.

7. How does the 3x3 Mega Vitrin showcase work?
Instead of cutting stickers into 9 separate physical files, VebaStickers renders a single 2.6x scaled mega model in the center slot while clearing adjacent slots to AIR. All 9 slots register in the click listener, providing a massive, seamless hitbox.

8. How does Shift + Left Click "Burst Send" work?
Normal Left-Click sends the sticker and closes the inventory. Shift + Left-Click sends the sticker to chat with full sound effects and cooldown validation while keeping the menu open, allowing rapid sticker combos.

9. Are Bedrock Edition players supported?
Yes. With GeyserMC and Floodgate, VebaStickers generates a native .mcpack, delivers touch-friendly Bedrock Form GUIs, and maps the Bedrock Emote button directly to the sticker menu.

License & Telemetry

Copyright (c) Veba. All Rights Reserved.
Provided as an optimized, production-ready plugin binary. Telemetry metrics are gathered anonymously via bStats to monitor version adoption and delivery resilience.