Yessentials: The Ultimate Addon for Bedrock Servers and Realms

Yessentials is much more than just a simple addon; it's a complete ecosystem designed to take your server's (Realm or BDS) administration and survival experience to the next level. Forget about complicated commands: almost everything is managed through beautiful and intuitive UI menus.

🛡️ Advanced 3D Land Claim System

Protect your home and builds from intruders and griefers in the most secure way possible.

• 3D Volumetric Protection: Your land boundaries aren't infinitely tall; they adapt into a configurable 3D cube. This means players can freely mine in the caves below your house, but your house will remain untouchable.
• Particle Border Vision: With the click of a button, visually draw a 3D particle skeleton around your land to know exactly how far your protection reaches.
• Absolute Anti-Griefing: Explosions (Creepers/TNT) respect the 3D protection, and pistons placed outside won't be able to alter the interior of your land.
• Upkeep System: Optionally, require players to "feed" their protection blocks with ores to keep the protection active, preventing the map from filling up with abandoned claims.

⚔️ Smart Guards (Custom AI)

Your land isn't just protected by magic, but by a fierce personal security Guard!

• Impartial Justice: The Guard is peaceful by nature. They will only draw their weapon and attack those intruders who attempt to break a block, open a chest without permission, or attack another entity within your borders.
• "Wanted" System: If a criminal flees and cowardly disconnects from the server, the Guard will remember them. Upon rejoining, they will remain an enemy until they pay for their crimes with their life!
• Healing & Upgrades: Owners can heal their guard with Golden Apples or buy permanent Max Health upgrades using diamonds or netherite.

🏰 Complete Factions (Clans) System

Create and manage your own clan with an integrated, highly advanced Factions system!

• Custom Faction Tags: Players can found factions with their own custom names and a short unique Tag (e.g., [LOB]). This tag integrates seamlessly into the Chat, Floating NameTags, and the Scoreboard.
• Faction UI & Economy: Everything is managed through a beautiful UI (!f or !faction). Server owners can configure the cost to create a faction using the in-game economy.
• Faction Bases (Nexus): Leaders can set a specific location as the Faction Base. Members can then fast-travel directly to their base from anywhere in the world!
• Friendly Fire & Allies: Prevents members of the same faction from hurting each other (configurable). Even the Smart Guards will recognize your faction members as allies and won't attack them on your land!
• Top Factions Leaderboard: A global UI leaderboard displays the most powerful factions on the server sorted by member count.

💬 Chat Formatting, Ranks & Custom NameTags

Say goodbye to the boring Vanilla chat and default floating names.

• Custom Ranks: Create your own ranks (VIP, Mod, Admin) linked to tags, which will appear beautifully next to the player's name in the chat.
• Dynamic NameTags: Replaces the default floating names with a highly customizable system. Display real-time Health and Money directly above players' heads (e.g., [Admin] Player \n [ $1000 | 20 HP ]).
• Server Messages: Replace the boring gray messages. Now, when someone joins, leaves, dies, or kills another player, the server will announce it with dynamic colors and exciting texts.

✨ Floating Texts & Dynamic Leaderboards

Decorate your server's Spawn with vital and eye-catching information completely in-game.

• Live Variable Texts: Create spectacular holograms directly from the Admin menu. Customize them using dynamic variables like {online} (online players), {tps} (server performance), {time}, and {date}.
• Smart Leaderboards: Create leaderboards linked to any in-game Scoreboard objective (like kills, money, etc.). The system magically reads the scores, auto-sorts them from highest to lowest, and remembers players even if they are offline!

📊 Sidebar Scoreboard (Fully Configurable)

Display vital information to your players at all times.

• Elegant Panel: A sleek Sidebar displays key real-time data such as money balance, rank, and other player details.
• 100% Customizable: Change colors, add frame-by-frame animations, and design a unique scoreboard for your community.

💰 Dynamic Economy and UI Menus

Keep your players motivated with a seamless, integrated economic system.

• UI Transfers: Say goodbye to memorizing chat commands or players making typing mistakes. You can transfer money to other players quickly, safely, and elegantly using a visual interactive menu (UI form).

🏠 Player Utilities (Homes, TPA & Back)

Make life easier for your players in their survival adventure.

• /home System: Allows players to set checkpoints in their houses to quickly return at any time. Limit the maximum amount of homes based on their Rank.
• TPA System: Send teleport requests. Includes anti-cheat checks (won't teleport you into lava or walls) and you can optionally charge money/items for using it.
• !back Command: With a simple !back chat command, players can instantly return to the exact spot where they died to recover their items.

⚔️ Anti-Coward Combat System (Combat Log)

• Combat Timer: Hitting someone puts you "In Combat".
• Punishments: If someone leaves the server while in combat, Yessentials will automatically drop their entire inventory on the ground as a punishment, or kill them instantly.
• Blockers: Prevents the use of Ender Pearls or teleport commands while the combat timer is active.

🛠️ Supreme Admin Tools

Yessentials includes an Exclusive Admin Item that opens up a world of power:

• Global Management: View, edit, or delete any land protection on the map from anywhere (or teleport to them).
• Safezones: Draw invisible 3D cubes (e.g. at Spawn) where PvP, explosions, and griefing are completely disabled.
• Quick Moderation: Ban, Mute, or Freeze troublesome players with two clicks. (You can even set custom ban expiration times!)
• Vanish (Invisibility): Keep an eye on suspicious players without being detected.

☁️ Yessentials Cloud (Sincronización Mágica)

¿Miedo a perder tus mundos o configuraciones? Yessentials incluye de regalo un revolucionario Addon en la Nube (Cloud Addon). Este sistema funciona como un puente mágico que exporta e importa absolutamente toda tu base de datos (Zonas Seguras, Terrenos, Facciones, Ranks, Dinero) hacia un servidor web encriptado en tiempo real. ¡Puedes clonar todo tu servidor en segundos a un nuevo mapa!

🚀 Tutorial Paso a Paso: Cómo usar la Nube

1. Instalación: Activa tanto el Yessentials Core (Addon principal) como el Yessentials Cloud BP en tu mundo.
2. Requisito Crítico: Ve a las opciones de tu mundo y activa los experimentos "APIs Beta". (Si usas BDS, añade "@minecraft/server-net" al archivo permissions.json).
3. Exportar (Guardar): Entra al juego con rango de Admin y usa el comando !cloud. Selecciona "Exportar a la nube". El sistema empaquetará tus datos (verás el progreso en la consola) y te dará un Código PIN de 5 letras (ej: VOMIV).
4. Importar (Restaurar): En tu nuevo mundo (con los addons activados), usa !cloud, selecciona "Descargar desde la nube" e ingresa tu PIN de 5 letras.
5. Magia Pura: El sistema descargará tus datos. Los terrenos protegidos utilizarán el sistema Auto-Restore, que reconstruirá físicamente los bloques y hologramas de las bases de tus jugadores a medida que exploren el nuevo mundo. ¡No perderás ni una sola facción ni bloque!

📜 Complete Commands Guide

Almost all systems in Yessentials can be accessed via UI, but here is the complete list of available chat commands (you can change the prefix ! in the config file):

Player Utilities (No special requirements):

• !help - Displays the command list in the game chat.
• !hat - Places the item you are currently holding in your main hand directly on your head!
• !testtag - Summons a "mirror" Armor Stand to preview your own custom NameTag.
• !f or !faction - Opens the main Factions (Clans) Menu.

Economy Commands:

• !bal or !money - Check your current balance.
• !pay - Opens the UI to securely transfer money to another player.
• !top or !baltop - Displays the richest players on the server.

Teleportation Commands: (Note: Server owners can configure these commands to cost Money or specific Items in config.js)

• !tpa - Opens the TPA menu to send teleport requests to other players.
• !home - Opens the Homes menu to travel to your saved locations.
• !sethome - Sets a new home checkpoint where you are standing. (Max homes depend on the player's Rank).
• !delhome - Deletes a saved home.
• !back - Teleports you back to your last death location.

Admin Commands: (Require the Admin tag configured in config.js)

• !admin - Opens the Supreme Admin Panel (Manage players, Safezones, Protections, etc.).

⚙️ Robust Configuration Guide

The biggest advantage of Yessentials compared to other Addons is that ALL the configuration is centralized in code files (config.js and messages.js).

You won't have to navigate through thousands of in-game menus or risk losing your settings if a world gets corrupted. The system is purposely designed so that server owners can copy their configuration files and paste them into any other world or new update, saving months of work.

To configure the addon, go to your Yessentials Behavior Pack folder (behavior_packs/Yessentials_BP/scripts/) and open the files with any text editor (like Notepad, VSCode, or from your phone).

Below is a summary of everything you can modify there:

1. The Core: config.js

Here you control the mechanics and behavior of the server.

• General, Ranks, and Chat: Create infinite ranks (e.g., §a[VIP]), change the command symbol (e.g., !), and design how the public chat looks.
• Homes and TPA: Define how many homes each rank can have, teleport cooldowns, and the prices (in money or items) for each travel.
• Safezones & Admin: Create indestructible 3D "boxes" to protect your Spawn by turning off PvP or explosions inside them.
• 3D Protections & Guards: Define how much radius each protector block covers (e.g., Diamond = 51 blocks), how much lifetime coal or iron gives them, and how much health the Boss Guards have at each level.
• Economy & Custom Scoreboard: Connect the addon to your money Scoreboard (ECO_OBJECTIVE), and draw your own side panel on the screen by adding frame-by-frame animations and using variables like {tps} or {online}.

2. Absolute Translation: modules/messages.js

Make the addon speak your own language and with your own tone!

• Inside the modules/ subfolder, you will find the messages.js file.
• This file contains 100% of the texts and messages that Yessentials sends to players. From the "You don't have enough money" message to the "The Guard has detected you" warning.
• You can translate everything to English, Spanish, Portuguese, French, or simply change the texts to fit your server's roleplay theme (e.g., changing "Protection" to "Magic Kingdom").

⭐ Credits and Inspiration

Yessentials is deeply inspired by the golden era of the legendary Java Edition Server Plugins (Spigot / Bukkit / Paper) such as EssentialsX, GriefPrevention, and CombatLogX.

The idea of configuring everything from robust files instead of cumbersome in-game menus was born directly from how servers are professionally managed in Java, providing the highest stability, speed, and control to true Bedrock administrators.

Yessentials is highly optimized and jealously respects Minecraft Bedrock's vanilla mechanics, achieving complex systems while consuming minimum resources.

💬 Join our Community

Do you have questions, need help configuring the Addon, found a bug, or want to suggest new features? Join our official Discord server!

👉 Click here to join the Y_MC Community 👈