Spittoon - A Bukkit Plugin for Minecraft

Spittoon

a receptacle for spit, usually in a public place

A veritable spit bucket of ideas and utilities for Bukkit servers (should also work on derivatives like Spigot MC and Paper MC).

Requires Java 9+

Features

Light Level

Ever have the need to light up caves and other areas in order to prevent mobs from spawning? This feature allows you to see which blocks are not "lit up enough" to prevent mob spawning. This helps tremendously with efficient placement of light sources.

To activate the visual, the player needs to be sneaking and holding a torch in either hand.

[ADD SCREENSHOT]

Find Things

Ever been really frustrated by bad luck mining for diamonds? While exploration is a key part of the game, no one wants to waste days looking for something specific. If you want to find something fast, this is the feature for you!

The current list of things you can find with this feature includes:

Biomes - The search range is limited because this can be very expensive for rare biomes. Be kind to your server.
Entities - Specifically living entities (excluding players).
Blocks - Find the nearest blocks of a certain type, or all mineral veins nearby.
Slime Chunks - Find slime chunks near the player.

Commands

/spit light-level on - Turns on the light-level feature.
/spit light-level off - Turns the light-level feature off.
/spit light-level apothem <int> - Sets the apothem¹ used by the light level effect.
/spit find biome <biome-type> - Searches nearby chunks for the given biome.
/spit find block <block-type> [apothem]¹ - Searches for nearby veins of the given block type.
/spit find blocks [apothem]¹ - Searches for nearby veins of a configured set of block types.
/spit find entities - Finds the nearest entity of each type for all living entities currently spawned.
/spit find entity <entity-type> [apothem]¹ - Searches for nearby entities of the given type.
/spit find slime [apothem]¹ - Finds nearby slime chunks.

¹: Apothem - The perpendicular line or distance from the center of a regular polygon (square) to any of its sides. You might think of this as the radius, but technically that is the distance from the center to any of the corners.

Setup

Install a Bukkit server. I recommend Paper MC.
Grab the plugin JAR from [insert URL here later].
Place the JAR file in the plugins directory of your server.

License

Distributed under the Apache License 2.0.