StoneHaven Essentials

StoneHaven Essentials is a custom utility mod developed by SwornHero(opens in a new tab) for StoneHavenSMP. It puts useful server information and community links directly into Minecraft, alongside a permission-controlled staff-alert command that reaches online staff in-game and offline staff on Discord through Milo.

The mod focuses on everyday communication: finding the rules, opening the live map, locating the modpack, joining Discord, and bringing an issue to staff attention.

Browse all Custom Mods.

Features at a glance

Getting started

Run these commands in Minecraft chat while connected to a server running StoneHaven Essentials:

The informational commands do not have explicit permission gates in the reviewed implementation. The staff-alert command has separate access requirements.

Command reference

Quick aliases

Link messages use aqua, underlined text with a “Click to open” hover hint. Clicking opens the configured URL through Minecraft's link-handling interface, subject to your client settings.

The rules command is a convenient in-game summary. Consult the community rules and Discord for the full current policies.

Sending a staff alert

Players with the required permission can use:

Give a clear description of the issue and include a location when relevant. The command accepts the remaining text as the alert message.

When executed, the mod:

1. Writes the sender and message to the server log.
2. Sends a formatted alert to online players who have receive permission.
3. Replies to the sender with the number of in-game recipients.
4. Allows Milo to pick up the log entry and notify staff in Discord, so offline staff can respond quickly.

In Minecraft, eligible staff see a red [Staff Alert] prefix with the sender’s name and message. The sender also receives a green confirmation with the in-game recipient count:

Milo posts the same alert to the Discord staff-alert channel and mentions the Staff role, so team members who are not in-game can still see and act on it:

Alerts are not confidential messages: they are written to server logs and forwarded to Discord for staff. Avoid including private information. If you need a documented support conversation, Submit a Ticket(opens in a new tab).

How Essentials works with Milo

StoneHaven Essentials supplies the in-game command. Milo supplies the Discord-side log monitoring and notification routing so staff can respond efficiently even when they are offline.

An alert produces a line with this payload:

[STAFF_ALERT] sender="PlayerName" message="I need assistance near the Market District."

Milo’s parser recognizes this format for Minecraft player names. When its log source and destination channel are configured, it turns the entry into a Discord staff-alert embed and can mention the configured staff role.

The mod does not connect directly to Discord or require a Discord token. The connection between the two projects is the server log. Essentials still delivers in-game alerts without Milo; Discord forwarding requires the bot to be running and receiving the log stream.

Permissions

The mod uses Fabric Permissions API for staff-alert access checks.

Both checks use PermissionLevel.OWNERS as their fallback when permission resolution falls back to vanilla levels. Server operators can use a compatible permissions provider, such as LuckPerms, to grant sending and receiving independently.

Receiving alerts does not automatically grant permission to send them, and sending does not automatically grant receiving. A sender who also has receive permission can be included in the in-game recipient count.

Technical design

StoneHaven Essentials is written in Java for Fabric. Its initializer registers a command tree through Fabric API's command-registration callback, using Minecraft's Brigadier command system.

The implementation is intentionally small:

• Initializer: registers the commands and writes a startup message.
• Command class: defines commands, link destinations, formatted messages, and staff-alert behavior.
• Minecraft text components: provide colors, hover hints, and clickable URLs using the game's existing chat interface.
• Fabric Permissions API: separates staff-alert sending and receiving permissions.
• SLF4J logging: emits a consistent staff-alert payload for external processing.

The reviewed source includes template mixin classes with empty callbacks. The documented utility features come from command registration and message handling, rather than gameplay changes implemented by those mixins.

Configuration and stored data

Discord, map, and modpack links are defined in Java constants. Rules, descriptive messages, and the displayed mod version are also compiled into the code. The reviewed implementation does not expose a configuration file or reload command for these values; changing them requires editing the source and building a replacement JAR.

There is no application database or stored ticket system in the mod. Staff alerts are sent immediately to eligible online players and written to the server's existing logging system. No alert cooldown or Discord delivery acknowledgment is implemented in the reviewed command.

Platform and dependencies

The following describes the reviewed source version, not an independently verified inventory of the live server:

Fabric API and Fabric Permissions API are declared runtime dependencies. Server operators should install compatible versions alongside the mod.

The features are implemented through server commands and ordinary Minecraft messages, with no custom client networking shown in the reviewed implementation. A separate client installation is not needed for these command features. The manifest nevertheless declares compatibility with both environments using environment: "*"; it does not declare the package exclusively server-side. Follow StoneHaven's normal modpack instructions for the rest of the server's requirements.

Building and deployment

The project uses Gradle and Fabric Loom. With an appropriate Java 25 development environment and portable local Gradle settings, the build commands are:

./gradlew build

On Windows:

.\gradlew.bat build

Build outputs are written to build/libs/. Operators deploy the runtime mod JAR, rather than a sources JAR, to the compatible Fabric server's mods directory alongside its required dependencies, then restart the server.

After deployment, verify /stonehaven, the link commands, and the staff-alert permission checks. Where Milo is configured, verify both the server log entry and the Discord notification separately; the in-game confirmation alone cannot validate that integration.

Keep the source version, displayed information, and deployed JAR aligned when updating the mod. The version displayed by /stonehaven info is a Java constant, while the packaged metadata version is expanded from Gradle's version property.

Build workflow

The repository includes a GitHub Actions workflow for pushes and pull requests. It configures Java 25 on Ubuntu, validates the Gradle wrapper, runs ./gradlew build, and defines an artifact-upload step for build/libs/.

This is a build workflow, not automatic deployment to StoneHavenSMP. The reviewed repository does not contain a dedicated automated test suite, and the presence of the workflow does not by itself establish a successful build.

Troubleshooting

For player support, Submit a Ticket(opens in a new tab) with the command used, approximate time, and any visible error.

About the project

StoneHaven Essentials is developed by SwornHero for StoneHavenSMP. It is part of the community's custom tooling, combining in-game convenience with a small integration point that connects Minecraft staff alerts to Milo.

Return to Custom Mods to explore other StoneHaven-developed and maintained projects.