# VebaStickers v1.9.2 Release Notes

VebaStickers v1.9.2 Release Notes

Version: 1.9.2
Target Platform: Paper / Purpur 1.21.4+ (Java 21) & Geyser / Floodgate (Bedrock)
Release Focus: Container Isolation, Admin Dashboard Redesign, Dynamic Onboarding Cache Purge & UI Polish

---

Highlights

• Pure Vanilla Container Isolation: Completely separated normal Minecraft chests from custom menus. Survival and creative chests now retain 100% authentic vanilla textures, while the custom Mega Vitrin UI renders seamlessly via modern font overlay glyphs and OptiGUI hooks.
• Dynamic Onboarding and Cache Reset: Running /vebasticker remove-cache now purges previous texture choices (FULL_GUI vs STICKERS_ONLY), clears client cache, and immediately presents the interactive setup menu for on-the-spot reselection.
• Admin Dashboard Overhaul (/vsa): Fully redesigned all 14 administrative views with symmetrical glass framing, balanced 3-row layout grids, and persistent pagination controls with disabled-state indicators.
• Minimalist Iconography and Clean Titles: Removed cluttered header text suffixes (such as " (Mega 3x3)") and unified all GUI vector badges with clean, two-tone minimalist designs.

---

What's New and Improvements

1. Interactive Onboarding and Cache Management

• Automatic Preference Reset:
  • Running /vebasticker remove-cache or /vsa remove-cache now clears the player's saved pack_decision and has_prompted_pack flags from active memory and userdata/<uuid>.yml.
  • Instantly unloads the cached client pack and opens the aesthetic 27-slot Pack Prompt Setup Menu (PackPromptMenu), allowing players to choose between:
    • Full HD + Modern GUI: HD animated stickers, neon GUI frames, and custom vector icons.
    • Stickers Only (Vanilla GUI): HD stickers in chat and inventory, keeping 100% classic vanilla Minecraft chests.
    • Skip / Text Mode: Plain-text chat emojis with zero download overhead.
    • Remember Preference: One-click toggle for login prompt persistence.
• Targeted and Offline Player Support:
  • Added support for targeting specific players: /vsa remove-cache <player> or /vsa remove-cache all.
  • Supports offline player profiles by resetting their stored decision file, ensuring they receive the onboarding menu immediately upon their next login.
  • Added rich tab-completion for all and all currently connected players.

2. Container Isolation and Minimalist Titles

• Authentic Vanilla Containers:
  • Restored clean vanilla textures for generic_54.png in the pack template.
  • Survival chests, double chests, Creative inventories, and Gallery views are completely isolated from custom texture overrides.
  • Mega Vitrin container visuals strictly rely on invisible negative-space glyph overlays (\uF808\uEE01\uF8F0) and chest.properties regex matching (\uEE01).
• Clean Inventory Header Text:
  • Stripped redundant sub-labels (such as " (Mega 3x3)") from the inventory title bar, presenting a sleek and modern look (e.g., Stickers » Catalog).

3. Complete Overhaul of Admin Dashboard (/vsa)

• Symmetrical 6-Row Layouts:
  • Header (Row 0): Interactive identity badge, view breadcrumb navigation, and quick refresh button.
  • Footer (Row 5): Persistent pagination arrows with dark gray disabled-state placeholders (◀ First Page, Last Page ▶), back button, and context actions.
  • Content Matrix (Rows 1-3): Framed with slate gray stained glass panes (GRAY_STAINED_GLASS_PANE) to eliminate asymmetric slot gaps across all 14 admin views.
• Minimalist Vector Styling:
  • Streamlined modern SVG icons into clean, high-contrast single and two-tone vector graphics.
  • Added proper handling for admin web server status and documentation click actions.

4. Internationalization and Localization (i18n)

• Added full multi-language translations for onboarding dialogs, buttons, and notifications in both languages/en.yml and languages/tr.yml.
• Dynamic fallback handling ensures missing localization keys smoothly fall back to English defaults without throwing runtime exceptions.

---

Bug Fixes and Technical Refactors

• Disk Cache Race Condition: Resolved an issue where resetting player pack preferences could accidentally reload stale cache from disk before asynchronous writes finished, through the use of a sentinel state.
• OptiGUI Compatibility: Updated assets/minecraft/optifine/gui/container/chest.properties regex to accurately detect the Mega Vitrin container character (\uEE01).
• Thread Safety: Enforced main-thread synchronization via Bukkit Scheduler when opening the setup menu during command dispatch.
• Client Unload Signal: Integrated native Player.removeResourcePacks() and Player.removeResourcePack(PACK_UUID) invocations when clearing packs.

---

Updated Commands

Command	Permission	Description
/vebasticker remove-cache	sticker.admin	Clears your pack cache, resets your display choice, and re-prompts the setup menu.
/vsa remove-cache [all|player]	sticker.admin	Resets cached choices and opens the onboarding menu for you, a specific player, or all players.
/sticker pack	sticker.use	Re-opens the interactive setup menu anytime to switch between Modern GUI and Vanilla mode.
/vsa	sticker.admin	Opens the newly restructured and polished admin management panel.

---

Upgrade Instructions

1. Stop your server safely with /stop.
2. Replace your previous VebaStickers.jar in your plugins/ directory with VebaStickers-1.9.2.jar.
3. Start your server. Existing configuration and player data files will be upgraded automatically.
4. (Optional) Run /vsa remove-cache all to give all active players the option to choose their preferred GUI experience.

v1.9.1

VebaStickers v1.9.1 - Release Notes

What's New & Improvements

• Official bStats Integration:

  • Upgraded the bStats metrics library to the latest stable release (3.2.1).
  • Configured the official bStats Plugin ID (34438).
  • Added custom telemetry charts for total loaded stickers, resource pack delivery method, chat engine type (Paper vs. Spigot), and economy integration status.
  • Relocated all bStats classes under com.veba.sticker.lib.bstats to ensure complete classpath isolation and prevent conflicts with other plugins.

• Configuration & Control:

  • Added the metrics.enabled toggle in config.yml, allowing server administrators to easily opt in or opt out of anonymous telemetry collection.

• Compatibility & Stability:

  • Refined Gradle shadow packaging and dependency minimization rules.
  • Synchronized Modrinth metadata, build manifests, and project documentation for the v1.9.1 release.

VebaStickers v1.9.0 Release Changelog

Overview

VebaStickers v1.9.0 is our most ambitious update to date. This release completely refactors the asset pipeline into a Zero-Redundancy Linking Engine (reducing pack size by 95%), introduces a Dual-Font Bridge providing native support from Minecraft 1.12.x all the way through 26.x+ Game Drops, and adds an interactive 3x3 Mega Vitrin Hitbox and Burst Send mechanics.

---

[Added]

• Universal Multi-Era Support (1.12.x – 26.x+ Game Drops):
  • Dual-Font Bridge: Implemented an algorithmic 2048x2048 HD Unicode Font Sheet generator (unicode_page_e1.png). Legacy 1.12.x clients now render crystal-clear HD stickers natively in chat without requiring client mods.
  • OptiFine CIT Integration: Automatically generates .properties rules linking directly to master item textures. Legacy 1.12.x players now view custom sticker models inside GUI menus instead of blank paper items.
  • Universal Metadata: Updated pack.mcmeta to root format 3 with supported_formats: [3, 99], eliminating "Incompatible Resource Pack" warnings across 9 years of Minecraft versions.
  • ViaVersion Dynamic Protocol Detection: Detects client protocol version upon connection and appends routing diagnostics (?proto=340&target=legacy or ?proto=769&target=modern).
• Shift + Left Click: "Burst Send":
  • Added instant sticker sending without closing the inventory menu. Players can now trigger rapid sticker combos similar to mobile messaging platforms (Discord/WhatsApp).
  • Normal Left-Click sends and closes; Right-Click toggles personal favorites.
• 3x3 Mega Vitrin Showcase & 9-Slot Hitbox:
  • Replaced the legacy 9-piece sliced grid with a unified 2.6x scaled mega model in the center slot.
  • Adjacent 8 slots are kept empty (AIR) to prevent borders from obstructing the graphic, while all 9 slots register in the click listener to provide a seamless continuous hitbox.

[Optimized]

• Zero-Redundancy Texture Linking (95% Pack Size Reduction):
  • Completely abolished physical 3x3 tile slicing (_tile_0..8 PNGs and JSONs deleted, eliminating ~900 redundant files per 100 stickers).
  • Unified textures/font/ and textures/item/ into a single 128x128 Retina master PNG. GUI models, font glyphs, and CIT properties all reference this single file.
  • Pack size slashed from ~26 MB down to ~2.5 MB on production servers.
  • Shaded JAR binary size optimized from 18 MB down to 1.2 MB.
• Virtual ZIP Entry Streaming:
  • Legacy 1.12.x plural texture paths (textures/items/) are dynamically streamed directly into the ZIP archive in memory, requiring 0 bytes of physical disk duplication.
• HTTP Delivery Engine:
  • Added X-Pack-Universal headers and enhanced ETag caching (HTTP 304 Not Modified) to eliminate redundant client re-downloads.

[Fixed & Hardened]

• Inventory Exploit Guarding: Verified strict boundary validation (slot < 0 || slot >= 54) and immediate event cancellation, preventing any item dragging or injection.
• Bedrock TextDisplay Isolation: Hologram entities are explicitly masked from Bedrock clients (setVisibleByDefault=false), preventing Geyser from miscalculating entity scale matrices on mobile devices.
• Memory & Entity Cleanup: Implemented strict task cancellation and entity removal upon plugin shutdown or reload, preventing floating ghost displays.

VebaStickers v1.8.0

VebaStickers v1.8.0 — Release Notes & Infrastructure Update

We are excited to announce VebaStickers v1.8.0! This major update brings 100% transparent unobfuscated builds for Modrinth compliance, a 4-tier resilient resource pack delivery manager (with Nginx reverse proxy and server.properties portless fallback), in-game system integrity diagnostics, and automated Modrinth update checking.

---

What's New in v1.8.0

• 100% Unobfuscated & Clean Build (Modrinth Compliance)

  • Completely removed ProGuard obfuscation to adhere strictly to Modrinth project transparency requirements.
  • Upgraded Gradle Shadow plugin to v9.0.0-beta13 for Java 26 bytecode and Gradle 9.5 compatibility.
  • Generates a clean, transparent, high-performance VebaStickers-1.8.0.jar.

• 4-Tier Resilient Resource Pack Delivery Manager (PackDeliveryManager)

  • Tier 1 (Micro HTTP Server): Embedded web server with auto-failover port scanning (ports 8085-8095), HTTP 206 Range requests, HTTP 304 ETag caching, and DDoS rate protection.
  • Tier 2 (Nginx / SSL Reverse Proxy): Full reverse proxy domain support via http-server.public-url (e.g., https://pack.yourdomain.com).
  • Tier 3 (server.properties Native Handshake): Automatic fallback writing native resource-pack= and resource-pack-sha1= settings for shared hosting environments with restricted ports.
  • Tier 4 (External CDN): Direct Cloudflare R2 / GitHub / external URL fallback (pack-delivery.fallback-url).

• Admin System Diagnostics & Integrity Audit

  • /stickeradmin status: Displays web server health, uptime, active delivery method, bandwidth, total download counts, and player pack load stats.
  • /stickeradmin verify: Executes a 6-point automated integrity audit on textures, tile models, ZIP archives, SHA-1 checksums, and HTTP web server binding.

• Modrinth API Update Checker & bStats Telemetry

  • Integrated Modrinth REST API update checker with admin join notifications.
  • Added bStats custom chart telemetry for active delivery strategies, chat engines, and GeyserMC crossplay metrics.

• GitHub Actions CI/CD Pipeline

  • Added .github/workflows/build.yml for automated Shadow JAR compilation, JVM test execution, and GitHub Releases distribution on version tags.

---

Installation & Upgrade Guide

1. Download VebaStickers-1.8.0.jar and place it into your server's plugins/ directory.
2. Restart your server or run /stickeradmin reload.
3. Verify your delivery status anytime in-game using /stickeradmin status or /stickeradmin verify!

VebaStickers v1.7.4 - Bug Fix

VebaStickers v1.7.4 - Release Notes & Stability Update

We are excited to release VebaStickers v1.7.4, bringing core architecture hardening, 100% soft-dependency classloader isolation for Geyser/Floodgate, and improved cross-platform compatibility!

---

What's New & Fixed in v1.7.4

• GeyserMC & Floodgate Classloader Safety Fix:

  • Resolved NoClassDefFoundError: org/geysermc/geyser/api/event/EventRegistrar on servers running pure Paper/Spigot without Geyser.
  • Isolated Geyser event listeners into inner static delegates (GeyserEventListener) to guarantee zero startup crashes when Geyser is absent.
  • Added defensive Class.forName(...) runtime reflection checks and isolated helper calls for Floodgate and Geyser APIs.

• Automated Unit & Compatibility Tests:

  • Added automated JVM classloading safety tests (GeyserHookTest) to ensure VebaStickers initializes flawlessly across all server environments.

• ProGuard Obfuscation & Performance Hardening:

  • Built and obfuscated with ProGuard for optimal security and minimal JAR size (~1.1 MB).

---

Installation & Upgrade Guide

1. Place VebaStickers-1.7.4-obfuscated.jar (or VebaStickers-1.7.4.jar) into your server's plugins/ directory.
2. Restart your server or run /stickeradmin reload.
3. Geyser/Bedrock integration will activate automatically if Geyser is present, or safely bypass if running Java-only!

VebaStickers v1.7.3 - Lightweight Distribution Build

VebaStickers v1.7.3 - Release Notes

We are excited to announce VebaStickers v1.7.3, featuring a lightweight distribution build, optimized asset management, and complete English localization for global Minecraft communities!

---

What's New in v1.7.3

• Ultra-Lightweight Distribution JAR:

  • Optimized build size down to ~1.1 MB.
  • Bundles a clean 6-sticker sample set across 3 categories (cats, dogs, special_characters).
  • Custom server stickers are dynamically processed on boot without bloating the core jar.

• Global English Localization:

  • Standardized default stickers.yml keys, codes, hover tooltips, and categories into English (:happy_cat:, :angry_cat:, :staring_dog:, :biting_dog:, :patrick:, :flirty_bee:).

• Seamless Bedrock (Geyser) Cross-Play:

  • Automatic dual-message chat rendering for mobile and Bedrock clients.
  • Auto-compiling .mcpack generator with SHA-1 hash verification.

• Remote ZIP & Google Drive Importer:

  • Add sticker packs dynamically using /stickeradmin import .
  • Asynchronous ZIP extraction with automatic CustomModelData and Unicode codepoint allocation.

---

Installation & Upgrade Guide

1. Drop VebaStickers-1.7.3.jar into your server's plugins/ directory.
2. Restart your server or run /stickeradmin reload.
3. Add custom PNG stickers to plugins/VebaStickers/Stickerlar/ or import via /stickeradmin import!