Skip to content

Corn-Can/TransformableShulker

Repository files navigation

TransformableShulker

A Minecraft Bukkit/Spigot plugin that lets players transform Chests into Shulker Boxes in-place, and recolor Shulker Boxes using Dyes or Water Buckets — all without breaking the container.

Requirements

  • Spigot / Paper 1.21+
  • Java 21+
  • FairyProject framework (bundled via Shadow JAR)

Features

Feature Default Config key
Convert Chest → Shulker Box (costs 2 Shulker Shells) ✅ Enabled isAllowChestToShulker
Convert Double Chest → Shulker Box ❌ Disabled isAllowDoubleChestToShulker
Recolor Shulker Box with a Dye (consumes 1 Dye) ✅ Enabled isAllowColoringShulkerByDyes
Reset Shulker Box color with a Water Bucket ✅ Enabled isAllowResetShulkerColor

How to Use

All interactions are performed by sneaking + right-clicking:

  • Chest + Shulker Shell (×2 in hand) → converts the Chest into a Shulker Box, keeping its contents.
  • Shulker Box + any Dye in hand → recolors the Shulker Box, consuming one Dye.
  • Shulker Box + Water Bucket in hand → resets the Shulker Box to the default (purple) color and returns an empty Bucket.

Converting a Chest that contains a Shulker Box inside is blocked to prevent nesting issues.

Commands

Command Permission Description
/ts reload ts.admin Reloads the plugin config
/transformableshulker reload ts.admin Same as above (full alias)

Permissions

Permission Default Description
ts.admin op Access to /ts reload

Configuration (plugins/transformable_shulker/config.yml)

# Function Switches
isAllowChestToShulker: true
isAllowDoubleChestToShulker: false
isAllowColoringShulkerByDyes: true
isAllowResetShulkerColor: true

# Notification Settings (supports '&' color codes)
prefix: "&a[Transformable Shulker] "
notAllowed: "&cThe action is Forbidden by the server."
shellNotEnough: "&cYou need at least 2 ShulkerShells to perform the conversion."
isNotChest: "&cSpecifies that the convertible block is not a Chest."
isDoubleChest: "&cDouble-Chest not allowed to be converted. You can change the setting in config."
containShulker: "&cConverting a chest that contains a Shulker Box is not allowed."
transformToShulker: "&aTwo ShulkerShells have been used to convert the Chest into a ShulkerBox."
restoreShelkerColor: "&aRestored the color of the ShulkerBox."
reColorShelker: "&aRecolored the ShulkerBox."

Building

./gradlew shadowJar

The compiled JAR will be in build/libs/.

Tech Stack

  • FairyProject — IoC container, commands, config management
  • bStats — anonymous usage metrics (Plugin page)
  • Gradle + Shadow — dependency shading

About

Transform Chests into Shulker Boxes — right where they stand, without losing a single item.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages