Underground Beacon

The Underground Beacon

Allows a beacon to be (and stay) active even if there is no clear path to the sky.
No more digging holes to make a beacon work underground.

Creating an Underground Beacon

To use a beacon underground/indoors without access to the sky, the player must place an Underground Beacon Block above it. The mod configures the _Tinted Glass block_ by default (see Underground Beacon Blocks).

This block can be placed directly on top of the Beacon or higher, as long as there are no other blocks between them.

The exceptions are blocks that do not deactivate the beacon (e.g., stained glass blocks, used to change the beam color).

If the Underground Beacon Block is removed, the Beacon reverts to its normal behavior and will be deactivated if there is no clear path to the sky.

Beacon Beam on Underground Beacons

When a beacon is turned into an underground beacon, the mod changes how its beam is rendered for the players.

The beam renders only up to the tinted glass block, instead of all the way up to the max height (2048 in Vanilla).

Environment

The Underground Beacon mod can be installed in single-player or server (optional on client).

Single-Player

• Can be activated without a clear path to the sky by using a tinted glass block.
• The beam will be visible.

Server (Client is optional)

• Can be activated without a clear path to the sky by using a tinted glass block. The effect does not require the mod on the client.

For players with the mod on their client:

• The beam will be visible.

For players without the mod on their client:

• The beam will not be visible.

Client (not in the Server)

When the mod is present on a client but not on the server, using the tinted glass block will not activate the effect. The beacon still needs a clear path to the sky, as the effect is always managed by the server.

But the rendering changes will be applied.
This means the beam will become visible and will be rendered as if the beacon was activated.

Underground Beacon Blocks

The Tinted Glass Block is the default Underground Beacon block, but you can add more blocks or change the default using a Data Pack.

Any block listed under the tag _underground_beacon_ is a valid block for the mod.

You can replace the default block or add more blocks using a data pack.

    {
      "pack": {
        "description": "Add (or replace) Underground Beacon Blocks",
        "min_format": 107.1,
        "max_format": 107.1
      }
    }

    {
        "replace": false,
        "values": [
            "minecraft:glowstone",
            "minecraft:sea_lantern"
        ]
    }

Complementary Shaders Community Server

This mod was made for the Complementary SMP, a server run by the Complementary Shaders Discord Community.
Join the community in the Complementary Shaders Discord and play Minecraft on our server. 🙂

Incompatibilities

Currently, no incompatibilities are known.

But any mod that changes the Beacon behavior may be incompatible.
If you encounter any problems when using Underground Beacon with other mods, open an issue or leave me a message on my Discord (links on the side bar).

Dependencies

• Fabric API

License

This project uses different licenses for its source code and visual/audio/design assets.
The source code is available under the MIT license.
Visual, audio, and other assets are all rights reserved.