Overview#
Ma Essentials is a versatile utility mod designed for Minecraft Forge (versions 1.18.1, 1.17.1, and others). It serves as a lightweight yet powerful alternative to server-side plugins like EssentialsX, bringing essential quality-of-life features directly to the Forge platform. The mod is highly customizable, allowing server administrators and players to toggle specific commands, set teleportation delays, and manage player kits.
Key features include:
- Teleportation Suite: Comprehensive home, warp, and spawn systems.
- Player Utilities: Tools for healing, feeding, flight, and inventory management.
- Server Administration: Advanced moderation tools including mutes, jails, and temporary bans.
- Kits System: Configurable item sets for new and existing players.
- World Management: Simplified commands for controlling time and weather.
Teleportation Commands#
The teleportation system is the core of Ma Essentials, providing players with the ability to navigate the world efficiently. Most teleportation commands can be configured with a delay (default 3 seconds) during which the player must remain still.
Home Management
Players can set multiple homes to mark important locations. The limit of homes per player is configurable.
| Command | Arguments | Description |
|---|---|---|
/sethome |
[name] |
Sets a home at your current location. |
/home |
[name] |
Teleports you to a saved home. |
/delhome |
<name> |
Deletes a specific home. |
/homes |
- | Lists all your saved homes. |
Warps and Spawn
Warps are public teleportation points set by administrators for all players to use.
| Command | Arguments | Description |
|---|---|---|
/setwarp |
<name> |
Sets a public warp point (Operator only). |
/warp |
<name> |
Teleports you to a public warp. |
/delwarp |
<name> |
Deletes a public warp (Operator only). |
/warps |
- | Lists all available public warps. |
/spawn |
- | Teleports the player to the world spawn point. |
Player-to-Player Teleportation
Teleportation requests allow players to move to each other's locations with consent.
| Command | Arguments | Description |
|---|---|---|
/tpa |
<player> |
Sends a request to teleport to another player. |
/tpahere |
<player> |
Requests another player to teleport to you. |
/tpaccept |
[player] |
Accepts a pending teleport request. |
/tpdeny |
[player] |
Denies a pending teleport request. |
/tpall |
- | Teleports all online players to your location (Operator only). |
Utility Teleportation
| Command | Arguments | Description |
|---|---|---|
/back |
- | Teleports you to your previous location or death point. |
/rtp / /rndtp |
- | Teleports you to a random location within a configured range. |
/top |
- | Teleports you to the highest block at your current X/Z coordinates. |
/up |
<blocks> |
Teleports you a specific number of blocks upward. |
Player Utilities#
Ma Essentials adds numerous commands to enhance the survival and creative experience for players.
Survival Tools
/heal [player]: Restores health and hunger to maximum./feed [player]: Fully restores the hunger bar./god [player]: Toggles invincibility mode./fly [player]: Toggles the ability to fly in survival mode./repair: Repairs the item currently held in the player's hand./suicide: Allows a player to instantly kill themselves (useful if stuck).
Inventory & Equipment
/hat: Places the item currently in your hand onto your head slot./invsee <player>: Opens a view of another player's inventory (Operator only)./ci//clearinventory: Clears your inventory or a target player's inventory./cleararmour: Removes all equipped armor from the player./trash: Opens a temporary inventory; any items left inside when closed are deleted.
Information
/afk: Marks the player as Away From Keyboard, notifying others in chat./coords//pos: Displays the player's current X, Y, and Z coordinates./speed <1-10>: Adjusts the player's walking or flying speed.
Kits System#
The Kits system allows players to claim predefined sets of items. Administrators can create kits in the configuration file, specifying items, amounts, and cooldowns.
| Command | Arguments | Description |
|---|---|---|
/kit |
<name> |
Claims a specific kit. |
/kits |
- | Lists all kits available to the player. |
Default Kits:
- Tools: Typically includes basic stone or iron tools and torches.
- Ender Chest: Provides an Ender Chest for portable storage.
Kits are often used for "Starter Kits" given to new players upon their first join, which can be automated via the mod's configuration.
Server Administration#
Ma Essentials provides robust tools for server owners to moderate their community and manage server-wide settings.
Moderation Commands
| Command | Arguments | Description |
|---|---|---|
/tempban |
<player> <time> <reason> |
Bans a player for a specified duration. |
/unban |
<player> |
Removes a player from the ban list. |
/mute |
<player> <time> <reason> |
Prevents a player from speaking in chat. |
/unmute |
<player> |
Restores a player's ability to chat. |
/jail |
<player> |
Teleports a player to a designated jail area. |
/kickall |
[reason] |
Kicks all players from the server. |
/vanish |
- | Makes the administrator invisible to other players. |
World & Chat Control
/day//night: Sets the world time to 1000 or 13000 respectively./sun//rain//thunder: Changes the current weather state./broadcast <message>: Sends a bold, colored message to all players on the server./motd: Displays the server's Message of the Day./rules: Displays the server rules as defined in the config./maereload: Reloads the mod's configuration and data files without restarting the server.
Mechanics & Configuration#
Ma Essentials is driven by a configuration file (usually found in the config folder as maessentials.json or maessentials-common.toml).
Configurable Options
Administrators can modify the following mechanics:
- Command Toggles: Every command added by the mod can be individually disabled.
- Teleportation Settings: Set the delay (seconds before teleporting) and cooldown (seconds between teleports).
- Home Limits: Define the maximum number of homes a player can set.
- RTP Range: Set the minimum and maximum distance for the Random Teleport command.
- AFK Timer: Set the time in seconds before a player is automatically marked as AFK (default 600s) and whether they should be kicked after further inactivity.
- MOTD & Rules: Customize the text displayed when players join or use the
/rulescommand.
Fun Commands
Ma Essentials includes several "fun" commands for community interaction:
/slap <player>: Sends a message that you slapped the target player./joker <player>: Causes the target player to type random nonsense in chat./head <player>: Gives the executor the player head of the specified user.
