Better Slabs

A Paper/Folia vertical slab plugin, theoretically supporting 1.19.4+, providing a complete vertical slab placement, breaking, and collision system.

Features

• ✅ Vertical Slab System - Place slabs in any direction (North, South, East, West)
• ✅ Smart Collision - Uses BlockDisplay + Interaction to achieve precise collision
• ✅ Folia Support - Fully compatible with Folia multi-threaded servers
• ✅ Configurable - Language configuration, exclude specific slab types
• ✅ H2 Database - High-performance persistent storage
• ✅ Chunk Optimization - Smart chunk indexing, efficient loading and unloading

Version Requirements

Component	Minimum Version	Description
Plugin	1.19.4	Version where BlockDisplay API is available
Server	Paper/Folia	Requires Adventure API support

Installation

1. Download the latest version of BetterSlab-1.0.0.jar
2. Place it into the server's plugins directory
3. Restart the server

Usage

Basic Operations

• Get vertical slabs: /betterslabs give <material> [amount]
• Switch mode: While holding a slab, Shift + Right-click air to toggle between normal/vertical slab mode
• Place: Right-click to place a vertical slab
• Break:
• Creative Mode: Left-click to break instantly
• Survival Mode: Hold left-click to mine (displays progress bar)

Commands

Command	Permission	Description
/betterslabs reload	betterslabs.admin	Reload configuration
/betterslabs info	betterslabs.admin	View plugin info
/betterslabs give <material> [amount]	betterslabs.admin	Give vertical slab item

Configuration Files

config.yml

# Exclude specific slabs (for use when officially supported in the future)
# Example:
#   - STONE_SLAB
#   - OAK_SLAB
ignore-slabs:

lang.yml

Complete language configuration file, supports customizing all texts:

# Inventory vertical slab Lore
item:
  vertical-slab-lore:
    - "§7Status: Vertical Slab"
    - "§8Shift+Right-click air to toggle"

# Mining progress display
dig:
  title: "§6Mining"
  subtitle: "§7{bar} {current}/{total}s ({percent}%)"
  actionbar: "§6Mining {percent}%"

# Command feedback
command:
  no-permission: "§cNo permission."
  reload-success: "§aBetter Slabs reloaded."
  # ... more configurations

Building

Prerequisites

• Java 17+
• Gradle 8.0+

Build Steps

# Windows
gradlew.bat shadowJar

# Linux/Mac
./gradlew shadowJar

Build output: build/libs/BetterSlab-1.0.0.jar

Technical Details

Architecture

• SlabStorage - H2 database persistence, supports chunk indexing
• DisplayManager - BlockDisplay rendering management
• CollisionManager - Interaction collider management
• SlabManager - Core logic: placement, breaking, merging
• SlabRegistry - Registration of supported slab types

Performance Optimization

• ✅ Chunk indexing to accelerate queries
• ✅ ConcurrentHashMap concurrency safety
• ✅ Database connection health checks
• ✅ Folia regional scheduling support

Compatibility

• ✅ Paper 1.19.4+
• ✅ Folia multi-threaded servers
• ✅ Multi-world support
• ✅ Compatible with protection plugins like WorldGuard/Residence

License

GPLv3 License

Author

Little_100

Website: www.little100.cn

Contributing

Issues and Pull Requests are welcome!