Essentials Fabric

Essentials (Fabric) (WIP)

Essentials is an SMP toolkit that, in my opinion, provides the essential admin and quality of life improvements for a survival server.

Commands & Features

Available Commands

- `/repair [target]` – Repairs the main-hand item if it is damageable. Op-level permission by default. - `/heal [target]` – Restores health, hunger, and saturation to full. Op-level permission by default. - `/feed [target]` – Tops off hunger and saturation. Op-level permission by default. - `/flight [target]` – Toggles creative-style flight for survival players. Op-level permission by default. - `/disposal`, `/trash`, `/trashcan` – Opens a temporary 9x3 inventory for throwing items away. Available to all players by default. The contents are deleted when the screen closes, and the player gets a reminder in chat. - `/tpa <player>` – Send a teleport request to another player. Available to all players by default. - `/tpahere <player>` – Send a request for another player to teleport to you. Available to all players by default. - `/tpahere` – Send TPAHere requests to all online players. Available to all players by default. - `/tpaccept <player>` – Accept a teleport request. Available to all players by default. - `/tpdeny <player>` – Deny a teleport request. Available to all players by default. - `/tpacancel` – Cancel your outgoing teleport request. Available to all players by default. - `/back` – Teleport back to your previous position (works after TPA teleports). Available to all players by default.

`[target]` is optional. Defaults to executor.

Features

- Back Command: Commands can be restricted to operators only or made available to all players via configuration - Back Command: All messages include a configurable tag with custom text, colors, and styling - Back Command: All targeted commands send feedback to both the executor and the affected player, so nobody is surprised by a sudden heal or flight toggle - Back Command: YAML-based configuration system allows server administrators to customize command availability and access levels - Back Command: Full teleport request system with configurable timeouts, cooldowns, and smart request management - Back Command: Return to your previous position after TPA teleports with a configurable time window

Installation (Fabric)

Dedicated server

1. Install Fabric Loader for your server's Minecraft version. 2. Download and place the built JAR of this mod into the `mods/` folder along with Fabric API. 3. If you used a previous Version `> v2.0.0` clear the config in `config/essentials.yaml`. 4. Start the server. Vanilla clients can connect. The mod will automatically generate a default configuration file at `config/essentials.yaml`.

Singleplayer

1. Install Fabric Loader and Fabric API on your client. 2. Place the mod JAR into your client `mods/` folder. 3. Launch the game. The behavior applies in singleplayer because it runs an integrated server. The mod will automatically generate a default configuration file at `.minecraft/config/essentials.yaml`.

Configuration

Essentials uses a YAML configuration file located at `.minecraft/config/essentials.yaml` (or in your server's config directory). If no configuration file exists, default settings will be used.

TPA Configuration

The TPA system includes the following configurable options:

- `timeout_seconds` (default: 60) - How long teleport requests last before expiring - `cooldown_seconds` (default: 10) - How long to wait after cancelling a request before sending another - `window_seconds` for back command (default: 120) - Time window during which `/back` can be used after a TPA teleport

All TPA commands can be enabled/disabled and have their access level configured (op/all) in the `commands` section.

Build from source

```bash ./gradlew build ```

The remapped JAR will be in `build/libs/`.

License

- MIT (see LICENSE)