Essentials Plus

The first version of Essentials Plus!

EssentialsPlus

An all-in-one essentials plugin for Minecraft Paper servers (1.21+).

Features

Teleportation Commands

- /spawn - Teleport to spawn point - /setspawn - Set the spawn point (admin) - /tpa <player> - Request to teleport to a player - /tpahere <player> - Request a player to teleport to you - /tpaccept - Accept a teleport request - /tpdeny - Deny a teleport request - /tpatoggle - Toggle teleport requests on/off - /home [name] - Teleport to your home - /sethome [name] - Set your home location - /delhome <name> - Delete a home - /homes - List your homes - /warp <name> - Teleport to a warp point - /setwarp <name> - Set a warp point (admin) - /delwarp <name> - Delete a warp point (admin) - /warps - List all warp points - /rtp - Teleport to a random location

Utility Commands

- /workbench - Open a crafting table - /anvil - Open an anvil - /enderchest - Open your ender chest - /stonecutter - Open a stonecutter - /grindstone - Open a grindstone - /wastebin - Open a wastebin (trash can)

Status Commands

- /afk - Toggle AFK status - /gametime - Show server time

Permissions

| Permission | Description | Default | |------------|-------------|---------| | essentialsplus.spawn | Use /spawn | true | | essentialsplus.setspawn | Set spawn | op | | essentialsplus.tpa | Use /tpa | true | | essentialsplus.tpahere | Use /tpahere | true | | essentialsplus.tpaccept | Use /tpaccept | true | | essentialsplus.tpdeny | Use /tpdeny | true | | essentialsplus.tpatoggle | Toggle TPA | true | | essentialsplus.home | Use /home | true | | essentialsplus.sethome | Use /sethome | true | | essentialsplus.delhome | Use /delhome | true | | essentialsplus.homes | Use /homes | true | | essentialsplus.warp | Use /warp | true | | essentialsplus.setwarp | Set warps | op | | essentialsplus.delwarp | Delete warps | op | | essentialsplus.warps | List warps | true | | essentialsplus.rtp | Use /rtp | true | | essentialsplus.workbench | Use /workbench | true | | essentialsplus.anvil | Use /anvil | true | | essentialsplus.enderchest | Use /enderchest | true | | essentialsplus.stonecutter | Use /stonecutter | true | | essentialsplus.grindstone | Use /grindstone | true | | essentialsplus.wastebin | Use /wastebin | true | | essentialsplus.afk | Use /afk | true | | essentialsplus.gametime | Use /gametime | true |

Building

Prerequisites

- Java 17 or higher - Gradle 7.0+ (or use the Gradle Wrapper)

Build Steps

cd EssentialsPlus
gradle build

Or if you don't have Gradle installed, use the Gradle Wrapper (recommended):

cd EssentialsPlus
gradlew build

The compiled JAR will be in build/libs/EssentialsPlus-1.0.0.jar.

Installation

1. Copy build/libs/EssentialsPlus-1.0.0.jar to your server's plugins folder 2. Start/restart your server 3. Configure the plugin in plugins/EssentialsPlus/config.yml

Configuration

TPA Settings

- tpa.timeout - Time in seconds before a TPA request expires (default: 60) - tpa.cooldown - Cooldown in seconds between TPA requests (default: 5)

Home Settings

- homes.max-homes - Maximum number of homes a player can set (0 = unlimited, default: 3)

RTP Settings

- rtp.radius - Radius from player's current position (default: 5000) - rtp.max-attempts - Maximum attempts to find a safe location (default: 10) - rtp.avoid-water - Whether to avoid teleporting into water (default: true)

AFK Settings

- afk.broadcast - Whether to broadcast AFK status changes (default: true) - afk.auto-afk-timeout - Auto-AFK timeout in seconds, 0 = disabled (default: 0)

Database

The plugin uses SQLite for data storage. Data is stored in plugins/EssentialsPlus/data.db.

License

MIT License