Sable: Sublevel Detection

Dead Man's Switch

Sable 2.0.0+ Required (Tested 2.0.5)

This mod adds a new redstone component called the "Occupancy Sensor." This sensor, when placed on a Sable sublevel, provides Redstone signal if any player is occupying that sublevel. The sensor can also be inverted with an empty-handed right-click, to provide a redstone signal when a sublevel is unoccupied.

This mod was developed around the concept of a Dead Man's Switch. Simply place the Occupancy Sensor next to a clutch, providing rotational power to your mode of propulsion, and set it to inverted mode. Now when you leave the vessel, it will register as unoccupied and the redstone signal from the sensor will shut off power from your engine.

While this may seem simple, the possibility for usage goes deeper than it seems, especially when augmented with the optional CC: Tweaked support. If CC: Tweaked is installed, you can wrap the occupancy sensor through the Peripheral API and gain access to 5 new functions in CraftOS.

• getOccupancyCount() - Returns an integer of how many players are currently occupying the sublevel.
• getOccupantsNames() - Returns a table containing every occupant's in-game name.
• getOccupantsUUIDs() - Returns a table containing every occupant's UUID.
• getInversionState() - Returns a boolean denoting whether the sensor is currently inverted.
• setInversionState(boolean) - Alters the inversion state of the sensor.

Using these functions, this sensor transcends simple redstone logic and allows you to use sublevels as a way to query regional game state, automating logistics based on if someone is present and who.

A few examples of this could be:

• A Create: Coasters Simulated rollercoaster that automatically starts a countdown once a specified amount of passengers have boarded

• A cafe that keeps track of new customers waiting to be tended to.

• A parkour course with platforms that start to move as a player lands on them.

• A cockpit whose door only opens once the Captain's UUID is present on board.

• A home where every room's floor is a unique sublevel, allowing a security system to tell you exactly what room an intruder is in.

There are plenty of vessel protocols, minigames, home automations, and roleplay applications that are opened up by this little block.

This is my first mod ever, and as such, there may be some unforeseen bugs. Please provide any relevant details, screenshots, videos, or steps to reproduce it in a GitHub ticket should you stumble across one.