# EssentialZ<\/p>\n
— <\/p>\n
\n
\n
\n
\n
\n
\n
\n<\/p>\n
EssentialZ is a powerful and versatile plugin, designed to enhance gameplay and provide server administrators with a wide range of tools and features. It is inspired by the popular EssentialsX plugin but has been rebuilt from the ground up specifically for modern Paper servers.<\/p>\n
EssentialsZ gives you the option to fully customize your experience without any bloat. You don’t like a command? Disable it. You don’t want to use the custom chat? Disable it. You want other chat colors? Change them with one line in the config. EssentialsZ strives to be highly configurable without overwhelming you with options.<\/p>\n
**Important!**<\/p>\n
EssentialZ is still in an alpha stage. While many features are already implemented and functional, some commands and tools are still under development.<\/p>\n
## Features<\/p>\n
– **Core Commands**: Provides essential commands for player management, teleportation, home setting, warps, and more.
\n– **Chat Management**: Customizable chat formats, prefixes, suffixes, and channels to enhance communication on your server.
\n– **Economy Integration**: Seamless integration with popular economy plugins to manage player balances, transactions, and shops.
\n– **Permissions Support**: Compatible with major permissions plugins, allowing for granular control over command access and features.
\n– **Moderation Tools**: Includes tools for muting, banning, kicking players, and managing player behavior. (*Coming Soon*)
\n– **Customizable Configuration**: Easy-to-edit configuration files that allow server admins to tailor the plugin to their specific needs.
\n– **Fully customizable Messages and Branding**: Change every message the plugin sends to players to fit your server’s theme.
\n– **Disabling Commands\/Features**: Disable any command or feature you don’t want to use, keeping your server clean and efficient.<\/p>\n
## Installation<\/p>\n
1. Download the latest version of EssentialZ from Modrinth or Hangar.
\n2. Place the downloaded JAR file into your server’s `plugins` directory.
\n3. Restart your server to generate the configuration files.
\n4. Customize the configuration files located in the `plugins\/EssentialZ` directory to suit your server’s needs.<\/p>\n
## Configuration<\/p>\n
You can configure EssentialZ by editing the `.yml` files located in the `plugins\/EssentialZ` directory. The main configuration file is `config.yml`.<\/p>\n
If you want to customize messages, you can either change the colors and prefixes for message types in `config.yml`, or edit the individual messages for your language in the `lang` directory.<\/p>\n “`yml # The max amount of lines a lore can have. Set to -1 to disable. (128 is the max amount of lines an item can have in Minecraft) # Set the message styles for each message type. “`yml # Format for regular chat messages # Maximum length for nicknames # Format for broadcast messages # Wether to enable or disable joing and leaving messages # Wether to show a special message for first time joiners “`yml pay: true “`yml # Enable or disable the economy module # Starting balance for new users currencyFormat: “`yml # The type of storage to use. You have the following options: # This section is only relevant if you use a MySQL database ## Placeholders<\/p>\n To use PlaceholderAPI with EssentialZ, you only need to have both plugins installed on your server. EssentialZ will automatically register its placeholders with PlaceholderAPI.<\/p>\n You can use the following placeholders:<\/p>\n – `%essentialz_balance%` – The player’s current balance. ## Languages<\/p>\n EssentialZ supports multiple languages. You can find the language files in the `plugins\/EssentialZ\/lang` directory. To change the language, simply edit the `language` option in the `config.yml` file to match the desired language file name (without the `.yml` extension).<\/p>\n ### Currently supported languages: ## Support<\/p>\n If you need help with the setup of the plugin, or found a bug, you can join our discord here.<\/p>\n <\/p>\n —<\/p>\n <\/p>\n","protected":false},"excerpt":{"rendered":" A modern and highly configurable Essentials plugin similar to EssentialsX<\/p>\n","protected":false},"featured_media":65409,"template":"","meta":{"_minecraft_slug":"essential_z","_minecraft_project_id":"FTVoyulY","_minecraft_author":"KartoffelChipss","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":1409,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"essential_z.zip","_minecraft_size_bytes":18821197,"_minecraft_version_count":14,"_minecraft_updated_at":"2026-05-16T07:29:42.491491Z","_minecraft_date_created":"2025-12-12T20:31:55.459171Z","_minecraft_date_modified":"2026-05-03T09:17:51.132585Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/essential_z","_minecraft_icon_attachment_id":65409,"_minecraft_imported_at":"2026-06-03T18:16:45+00:00","_minecraft_import_hash":"d495108db962dbacfdf21106bea1a1bf","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,126,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-65408","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\nconfig.yml<\/summary>\n
\n# The max length an item name can be. Set to -1 to disable.
\nmaxItemNameLength: 100<\/p>\n
\nmaxLoreLines: 10<\/p>\n
\nstyles:
\n default:
\n accentColor: “#ba7cf8”
\n prefix: “&8[
\n error:
\n accentColor: “#FF1744”
\n prefix: “&8[<#FF1744>\u26a0&8] ”
\n warning:
\n accentColor: “#E9D502”
\n prefix: “&8[<#E9D502>\u26a0&8] ”
\n success:
\n accentColor: “#4CAF50”
\n prefix: “&8[<#4CAF50>\u2714&8] ”
\n movement:
\n accentColor: “#6EC6FF”
\n prefix: “&8[<#6EC6FF>\u2601&8] ”
\n combat:
\n accentColor: “#FF1A1A”
\n prefix: “&8[<#FF1A1A>\u2694&8] ”
\n moderation:
\n accentColor: “#8F9BFF”
\n prefix: “&8[<#8F9BFF>\u262f&8] ”
\n items:
\n accentColor: “#FFD54F”
\n prefix: “&8[<#FFD54F>\ud83c\udf92&8] ”
\n stats:
\n accentColor: “#4CAF50”
\n prefix: “&8[<#4CAF50>\u2605&8] ”
\n communication:
\n accentColor: “#81C784”
\n prefix: “&8[<#81C784>\u2709&8] ”
\n teamchat:
\n accentColor: “#FF8A65”
\n prefix: “&8[<#FF8A65>\ud83d\udc65&8] ”
\n worldcontrol:
\n accentColor: “#BA68C8”
\n prefix: “&8[<#BA68C8>\ud83c\udf10&8] ”
\n economy:
\n accentColor: “#FFD700”
\n prefix: “&8[<#FFD700>\ud83d\udcb0&8] ”
\n“`<\/p>\n<\/details>\nchat.yml<\/summary>\n
\n# Wether or not to enable custom chat formatting
\nenableCustomChat: true<\/p>\n
\n# Placeholders:
\n# {player_displayname} – The display name of the player
\n# {player_name} – The name of the player
\n# {message} – The message sent by the player
\nchatFormat: “&7{player_displayname} &8\u00bb &f{message}”<\/p>\n
\nmaxNicknameLength: 16<\/p>\n
\nbroadcastFormat: “&8[<#F06292>Broadcast&8] &7{message}”<\/p>\n
\n# You can configure the messages in the lang files (“joinMessage” and “quitMessage”)
\nenableJoinMessages: true
\nenableLeaveMessages: true<\/p>\n
\n# You can configure the message in the lang files (“welcomeMessage”)
\nspecialWelcomeJoinMessage: true
\n“`<\/p>\n<\/details>\ncommands.yml<\/summary>\n
\n# Here you can enable or disable specific commands.
\n# After editing this file, be sure to reload or restart your server for changes to take effect. \/esz reload will NOT apply changes made to this file.<\/p>\n
\nbalance: true
\nhat: true
\nfeed: false
\n…
\n“`<\/p>\n<\/details>\neconomy.yml<\/summary>\n
\n# Configuration file for the economy module<\/p>\n
\n# When disabled, all economy-related features will be turned off and the economy commands won’t be available.
\nenabled: true<\/p>\n
\nstartingBalance: 0.0<\/p>\n
\n # Currency symbol
\n symbol: “$”
\n # Number of decimal places
\n decimalPlaces: 2
\n # Thousand separator
\n thousandSeparator: “,”
\n # Decimal separator
\n decimalSeparator: “.”
\n # Position of the currency symbol (before\/after)
\n symbolPosition: “before”
\n“`<\/p>\n<\/details>\nstorage.yml<\/summary>\n
\n# === Storage ===<\/p>\n
\n# “SQLite”, “MySQL”, “MariaDB”
\ntype: “SQLite”<\/p>\n
\nhost: “localhost”
\nport: 3306
\ndatabase: “essentialz”
\nusername: “root”
\npassword: “password”
\n“`<\/p>\n<\/details>\n
\n– `%essentialz_balance_raw%` – The player’s current balance as a raw number (without formatting).
\n– `%essentialz_baltop_{rank}_balance%` – The balance of the player at the specified rank in the baltop (e.g., `%essentialz_baltop_1_balance%` for the richest player).
\n– `%essentialz_baltop_{rank}_balance_raw%` – The raw balance of the player at the specified rank in the baltop.
\n– `%essentialz_baltop_{rank}_player%` – The name of the player at the specified rank in the baltop.
\n– `%essentialz_baltop_godmode%` – Whether the player is in godmode (true\/false).
\n– `%essentialz_fly%` – Whether the player is allowed to fly (true\/false).<\/p>\n
\n– English (`en-US`)<\/p>\n