Wireless Redstone Plugin

Wirelessly link copper bulbs, redstone lamps, and container blocks.
State and inventory synchronization across any distance with GUI management.

            

Wireless Redstone is an open-source Minecraft plugin that allows players to create named groups of wirelessly linked blocks that synchronize their states or inventories across any distance. Link copper bulbs and redstone lamps into groups that toggle together, or link chests, shulker boxes, and copper chests into shared inventory groups that update in real time. All group data is saved persistently and survives server restarts, with full GUI-based management, a unified circuit tool for rapid assignment and inspection, and hopper-compatible container support.

Core Features

• Wireless Bulbs and Lamps: Create linked groups of copper bulbs or redstone lamps that synchronize state across any distance (2-26 blocks per group)
• Wireless Containers: Create linked groups of chests, barrels, shulker boxes, or copper chests that share inventory in real time
• Management GUI: Visual interface for managing all wireless groups with category organization, category descriptions, custom naming, icon assignment, and quick tool buttons
• Circuit Tool: Management and diagnostic tool for adding/removing blocks, inspecting wireless groups, and showing color-coded glowing outlines per group
• Block Recovery: Recover lost or accidentally broken wireless blocks that still belong to an existing group
• All Copper Variants: Full support for normal, exposed, weathered, and oxidized copper bulbs and chests - including all waxed variants
• All Shulker Colors: Support for all 17 shulker box colors as wireless container variants
• Hopper Compatible: Wireless containers work seamlessly with hoppers for automated item transfer and sorting systems
• Persistent Data: All group data is saved automatically and survives server restarts

Supported Platforms

• Server Software: Spigot, Paper, Purpur, CraftBukkit
• Minecraft Versions: 1.21 and higher
• Java Requirements: Java 21+
• Dependencies: None - fully self-contained, no external plugins required

Table of Contents

1. Getting Started
   • Prerequisites
   • Installation Steps
   • First Launch & Configuration
   • Verifying Installation
2. Configuration
   • Data Files
3. How It Works
   • Wireless Bulbs and Lamps
   • Wireless Containers
   • Circuit Tool
4. Player Commands
   • Command Reference
5. Permissions
6. Building from Source
7. License
8. Screenshots

Getting Started

Prerequisites

Before installing Wireless Redstone, confirm the following requirements are met:

• A Minecraft server running Spigot, Paper, Purpur, or any compatible fork
• Server version 1.21 or higher (api-version: 1.21 is the minimum)
• Java 21 or newer installed on the machine running the server
• Operator or console access to install plugin files

No additional plugins or libraries are needed. Wireless Redstone has zero external dependencies.

Installation Steps

1. Download the latest WirelessRedstone-x.x.x.jar from the Releases page
2. Stop your server completely before placing any files
3. Copy the .jar into your server's plugins/ directory
4. Start the server - Wireless Redstone generates its configuration folder automatically on first boot

First Launch & Configuration

On the first server start after installation, Wireless Redstone creates the following structure:

plugins/
└── WirelessRedstone/
    ├── config.yml       - Plugin settings, including visual effect durations
    ├── bulbs.yml        - All bulb and lamp group data
    ├── chests.yml       - All container group data and shared inventories
    └── categories.yml   - Category definitions and icons

All data files are managed automatically by the plugin. Do not edit them manually while the server is running - all management is done in-game using the /wireless command and GUI. If you make manual edits while the server is stopped, run /wireless reload after restarting.

Verifying Installation

• Run /plugins in-game - WirelessRedstone should appear green in the list
• Run /version WirelessRedstone to confirm the installed version matches the release you downloaded
• Run /wireless to open the management GUI - a chest inventory should open
• If the plugin fails to load, check the server console for WirelessRedstone error messages (common causes: wrong Java version, corrupt JAR, or unsupported API version)

Configuration

Data Files

Wireless Redstone persists all runtime data to YAML files under plugins/WirelessRedstone/. These files are written automatically on every change and on server shutdown.

File	Purpose
config.yml	Plugin settings
bulbs.yml	Bulb/lamp groups, ownership, names, category links, variant material, locations
chests.yml	Container groups, shared inventories, ownership, names, category links, locations
categories.yml	Category definitions, owners, descriptions, icons

Note: Do not edit these files manually while the server is running. Use /wireless reload after any manual edits made while the server is stopped.

How It Works

Wireless Bulbs and Lamps

Each wireless group is a named set of copper bulbs or redstone lamps linked by a shared group ID stored in each block's persistent data. When one block in the group is toggled (powered by redstone, clicked, etc.), BulbSyncTask propagates the new state to every other block in the same group within the same tick. Groups support 2 to 26 blocks, support all copper weathering/waxing variants and redstone lamps, and can span across any distance - including across dimensions if the chunks are loaded.

The BulbPlaceListener captures block placements of custom wireless bulb items, reads their group metadata, and registers the new location. BulbBreakListener removes the location from the group when a wireless block is broken. BulbInteractionListener handles player interactions and fires the sync.

Wireless Containers

Wireless container groups link chest-type blocks into a shared inventory that all members access simultaneously. When a player opens a wireless chest, barrel, shulker box, or copper chest, the plugin intercepts the ChestInventoryListener and presents the group's shared Inventory object to the player. Any changes made by any player to any container in the group are reflected in real time across all linked containers.

Hoppers connected to wireless containers interact with the shared inventory directly - items deposited or extracted by hoppers update the shared inventory and are reflected in all linked blocks.

Circuit Tool

The Circuit Tool is a special shears item given by /wireless create. In existing-group mode, right-clicking a compatible block adds it to the currently edited group; left-clicking any wireless block removes it from whichever group it belongs to. In creation mode (for new groups), the first right-click registers the first block; subsequent right-clicks add more. While held, the tool renders color-coded glowing outlines around every wireless group so overlapping groups can be distinguished visually.

Player Commands

All commands require the wirelessredstone.use permission (operator by default). Admin-specific operations additionally require wirelessredstone.admin.

Aliases: /wr

Command Reference

Command	Description
/wireless	Open management GUI (same as /wireless gui)
/wireless help	Show command help
/wireless create	Ask for a new group name and give a creation-mode Circuit Tool
/wireless create <groupName>	Give a Circuit Tool for an existing group, or creation-mode tool for a named new group. Use category/groupName to categorize it
/wireless modify name <groupName> <newName>	Rename a group
/wireless recover <groupName>	Restore saved group blocks destroyed by the environment
/wireless gui [--all]	Open management GUI
/wireless reload	Reload configuration files (admin only)

Permissions

Permission	Description	Default
wirelessredstone.use	Allows using wireless redstone commands	op
wirelessredstone.teleport	Allows teleporting to bulb locations via GUI	op
wirelessredstone.remove	Allows removing bulb groups via GUI	op
wirelessredstone.admin	Allows viewing/managing all players' groups and using admin actions	op

Building from Source

Wireless Redstone uses Apache Maven as its build system. The plugin is packaged as a standard JAR with no external runtime dependencies.

Requirements:

• Java 21 or newer
• Apache Maven 3.6 or newer

Steps:

# Clone the repository
git clone https://github.com/Cobbleworks/Wireless-Redstone-Plugin.git
cd Wireless-Redstone-Plugin

# Compile and package
mvn clean package

The output JAR is written to target/WirelessRedstone-x.x.x.jar. Copy it into your server's plugins/ folder as described in the Installation Steps section.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Screenshots

The screenshots below demonstrate Wireless Redstone Plugin in action, showcasing wireless activation of factory buttons, disco floor lighting, fence illumination, room machines, bulb command setup, and a lever activating a lamp without any physical connection.

Wireless Redstone - Factory Button	Wireless Redstone - Disco Ground Lightning
Wireless Redstone - Factory Fence Lighting	Wireless Redstone - Room Machines
Wireless Redstone - Bulb Command	Wireless Redstone - Lever Activating Lamp