Перейти к содержимому
Mineforgian

WaxShelf

WaxShelf is a lightweight Paper/Spigot plugin that lets players wax Shelves(from 1.21.11) and Item Frames using Honeycomb, locking them against interaction.

Загрузки
70
Подписчики
2
Обновлён
28 апреля 2026 г.
Лицензия
MIT

Опубликован 6 февраля 2026 г.

Исходный кодСообщить об ошибке

bstats

WaxShelf 🕯️

A lightweight and powerful Minecraft plugin that allows players to "wax" item frames and shelves to prevent unwanted interactions. Perfect for decorators, shop owners, and builders!

Modrinth License

✨ Features

  • Waxing Mechanics: Use Honeycombs to wax item frames and bookshelves. Once waxed, they cannot be rotated, changed, or broken by regular means.
  • Unwaxing: Use an Axe to remove the wax.
  • Invisible Item Frames: Sneak-right-click an item frame with Shears to make it invisible. Use Leather to make it visible again.
  • Chiseled Bookshelf Support: Fully compatible with Minecraft 1.20+ Chiseled Bookshelves (can be toggled in config).
  • Cross-Platform: One JAR for Spigot, Paper, and Folia.
  • Hex Colors: Use modern HEX colors (#RRGGBB) in all messages.
  • Action Bar Feedback: Clean notifications that don't spam the chat.
  • Config Migration: Automatic configuration updates.

🛠 Commands & Permissions

Command Description Permission
/waxshelf reload Reloads the configuration waxshelf.admin
Permission Description Default
waxshelf.wax Apply wax to items true
waxshelf.unwax Remove wax from items true
waxshelf.invisible Toggle frame invisibility true
waxshelf.bypass Interact with waxed items op
waxshelf.admin Use reload command op

⚙️ Configuration

The plugin generates a config.yml with the following options:

# Enable or disable waxing mechanics
waxing:
  shelves: true
  chiseled-bookshelves: true
  frames: true

# Enable or disable specific mechanics
mechanics:
  shears-invisible-frames: true
  leather-visible-frames: true

# Check for updates on startup (Modrinth API)
update-checker: true

🚀 Installation

  1. Download the latest JAR from Modrinth.
  2. Drop it into your plugins folder.
  3. Restart your server.
  4. Enjoy your protected decorations!

Developed by dscss2 with ❤️

Ченджлог

1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 28 апреля 2026 г.

🔄 WaxShelf v1.1.0 — The "Universal Compatibility" Update

This major update completely refactors the plugin's core to provide a seamless experience across all modern Minecraft platforms, including Spigot, Paper, and Folia, while adding advanced features for administrators and players.

🌟 New Features

  • Action Bar Notifications: Interaction messages (e.g., "Item is waxed") are now displayed in the Action Bar to avoid chat clutter.
  • Hex Color Support: Full support for HEX colors (#RRGGBB) in all configuration messages.
  • Configurable Chiseled Bookshelves: Added an option to enable/disable waxing specifically for Chiseled Bookshelves.
  • Advanced Tab-Completion: Intelligent command suggestions that respect player permissions.
  • Automatic Config Migration: The plugin now automatically updates your config.yml when new options are added, preserving your existing settings.
  • Modrinth Update Checker: Stay notified about new releases directly via the Modrinth API.

🛠 Technical Improvements

  • Cross-Platform Core: A new unified scheduler system allows the same JAR file to work on Spigot, Paper, and Folia.
  • Adventure API & LegacyComponent: Integration with the Adventure API for high-quality text processing on Paper-based servers, with a graceful fallback for Spigot.
  • Folia Support: Implemented RegionScheduler and EntityScheduler to ensure thread safety on multi-threaded server cores.
  • Complete Refactoring: Codebase organized into specialized packages (commands, listeners, utils) for better performance and maintainability.
  • bStats Integration: Added anonymous metrics to help track global plugin usage.

🔑 New Permissions

  • waxshelf.admin — Access to /waxshelf reload.
  • waxshelf.wax / waxshelf.unwax — Permission to apply or remove wax.
  • waxshelf.invisible — Permission to create/toggle invisible item frames.
  • waxshelf.bypass — Allows interacting with or breaking waxed items.
  • waxshelf.update — (Internal) Permission to receive update notifications.

📄 Configuration Changes A new config-version field has been added. The plugin will now automatically detect and add missing keys to your configuration.

   1 # New waxing options
   2 waxing:
   3   chiseled-bookshelves: true
   4
   5 # New system settings
   6 update-checker: true
   7 config-version: 1.1

Note: If you are upgrading from 1.0.x, your configuration will be migrated automatically upon the first start. Enjoy the new universal WaxShelf!

1.0.2Релиз1.21.10, 1.21.11 · 20 февраля 2026 г.

Fixed

  • Waxing with honeycomb now only works while sneaking
  • Axe interactions now require sneaking
1.0.1Релиз1.21.10, 1.21.11 · 7 февраля 2026 г.

1.0.1

  • Fixed Durability of items
  • Fixed FrameDamageEvent when is waxed
1.0Релиз1.21.10, 1.21.11 · 6 февраля 2026 г.

v1.0.0

  • Initial release 🎉
  • Added waxing support for Shelves (from 1.21.11) using Honeycomb
    • Locks book insertion and removal
    • Wax can be removed with an Axe
  • Added waxing support for Item Frames
    • Prevents rotation and item adding/removing
    • Wax can be removed with an Axe
  • Added Invisible Item Frame mechanics
    • Shears on visible frame → makes it invisible (drops Leather)
    • Leather on invisible frame → makes it visible again
    • Disabled when the frame is waxed
  • Fully configurable via config.yml
  • No permissions required
  • Paper / Spigot compatible, vanilla-friendly behavior

Комментарии

Загружаем…