# Mebahel\u2019s API \u2014 Core Library for Mebahel Mods<\/p>\n
**Mebahel\u2019s API** is a core dependency mod that provides shared systems, utilities, and gameplay frameworks used across the Mebahel mod ecosystem.<\/p>\n
It is designed for **mod developers** who want production-ready building blocks for complex mechanics without rewriting the same infrastructure in every project.<\/p>\n
> \u26a0\ufe0f This mod is a library. It does not add standalone gameplay content by itself.<\/p>\n
***<\/p>\n
## Supported Versions<\/p>\n
* Minecraft **1.20.1 \u2014 Fabric**
\n* Minecraft **1.21.1 \u2014 Fabric**<\/p>\n
***<\/p>\n
## \u2b50 For Players & Modpack Users<\/p>\n
This mod is a **technical dependency** used by other Mebahel mods.<\/p>\n
### What it does in a game<\/p>\n
You normally won\u2019t interact with this mod directly.
\nIt runs in the background to make other mods work correctly and efficiently.<\/p>\n
Depending on the mod that uses it, it may provide:<\/p>\n
#### \ud83c\udf0a Dry Structure Generation<\/p>\n
Structures can generate without being flooded, even underwater or inside wet terrain.<\/p>\n
#### \ud83d\udce6 Advanced Custom Chests<\/p>\n
Some Mebahel mods use special chests powered by this API:<\/p>\n
* Animated opening and closing
\n* Multiplayer-safe inventories
\n* Optional per-player rewards (each player gets their own loot)
\n* Custom sounds and GUI<\/p>\n
#### \u2694\ufe0f Improved Mob Behavior<\/p>\n
Certain creatures may use advanced movement such as:<\/p>\n
* Strafing during combat
\n* Tactical retreat when too close
\n* More natural positioning
\n* Reduced \u201cstuck\u201d behavior <\/p>\n
—<\/p>\n
### Do I need this mod?<\/p>\n
\u2714 Required if another mod lists it as a dependency
\n\u2714 Safe for singleplayer and multiplayer
\n\u2714 Must be installed on both client and server <\/p>\n
\u274c Removing it will break mods that depend on it<\/p>\n
—<\/p>\n
## \u2b50 For Mod Developers<\/p>\n
Mebahel\u2019s API provides reusable systems intended to simplify the development of complex Fabric mods.<\/p>\n
### Main Systems Provided<\/p>\n
#### \ud83c\udf0a Structure Water Removal System<\/p>\n
Prevents structures from spawning flooded in oceans, rivers, or aquifers.<\/p>\n
**Capabilities**<\/p>\n
* Removes waterlogged states after generation
\n* Clears surrounding water blocks inside structure bounds
\n* Works with template-based structures
\n* Tick-budget safe (no lag spikes)
\n* Fully automated once configured<\/p>\n
—<\/p>\n
#### \ud83d\udce6 Advanced Animated Chest Framework<\/p>\n
A complete foundation for creating custom containers with multiplayer-safe logic.<\/p>\n
**Includes**<\/p>\n
* GeckoLib animated open\/close\/spawn sequences
\n* Built-in sound synchronization
\n* Custom GUI support
\n* Server-authoritative behavior
\n* Multiplayer compatibility<\/p>\n
##### Personal Loot Mode<\/p>\n
When using a loot table:<\/p>\n
* Each player receives individual rewards
\n* Loot is generated once per player
\n* Prevents duplication exploits
\n* Ideal for dungeon or boss chests<\/p>\n
##### Shared Inventory Mode<\/p>\n
Without a loot table:<\/p>\n
* Functions as a normal container
\n* Inventory shared between players<\/p>\n
—<\/p>\n
#### \ud83d\udda5\ufe0f Ready-to-Use GUI & Screen Handler<\/p>\n
Speeds up development of container blocks:<\/p>\n
* Preconfigured ScreenHandler
\n* Player inventory integration
\n* Client GUI implementation
\n* Minimal boilerplate required<\/p>\n
—<\/p>\n
#### \u2694\ufe0f Entity Movement Utilities<\/p>\n
Utility methods for advanced combat AI and movement behavior.<\/p>\n
Supports:<\/p>\n
* Strafing around targets
\n* Tactical retreat movement
\n* Target-facing rotation
\n* Jump assistance
\n* Anti-stuck handling<\/p>\n
Ideal for bosses, ranged mobs, constructs, or mechanical entities.<\/p>\n
—<\/p>\n
## \ud83e\udde0 Why Use Mebahel\u2019s API?<\/p>\n
\u2714 Reduces duplicated code across multiple mods
\n\u2714 Optimized for server performance
\n\u2714 Multiplayer-safe systems
\n\u2714 Production-ready implementations
\n\u2714 Actively used in real released mods <\/p>\n
—<\/p>\n
## \ud83d\udd27 Installation (Developers)<\/p>\n
Add the API as a dependency in your Fabric mod project.<\/p>\n
### Maven Repository<\/p>\n
repositories {
\n maven {
\n name = “GitLab-Mebahel”
\n url = uri(“https:\/\/gitlab.com\/api\/v4\/projects\/77311613\/packages\/maven”)
\n }
\n }<\/p>\n
### Dependency<\/p>\n
dependencies { ### fabric.mod.json<\/p>\n { —<\/p>\n ## \u2699\ufe0f Required Dependencies<\/p>\n * **Fabric Loader** Ensure versions match your Minecraft version.<\/p>\n —<\/p>\n ## \ud83d\udce6 Used By<\/p>\n All **Mebahel ecosystem mods** depend on this API as their shared core library.<\/p>\n —<\/p>\n ## \ud83d\udc68\u200d\ud83d\udcbb Developer Guide \u2014 Integration<\/p>\n ### \ud83c\udf0a Water Removal Processor (Structures)<\/p>\n Automatically removes water and waterlogged states after structure generation.<\/p>\n **Use cases**<\/p>\n * Ocean structures **How to enable**<\/p>\n Add the processor to your structure configuration:<\/p>\n “processors”: “mebahelsapi:water_removal_processor”<\/p>\n The cleanup runs automatically after placement. —<\/p>\n ### \ud83d\udce6 BaseChest Framework \u2014 Custom Animated Containers<\/p>\n Provides a ready-to-extend system for animated, synchronized chests.<\/p>\n #### Creating a Custom Chest<\/p>\n 1. Extend the base chest block Example \u2014 ChestBlockEntity:<\/p>\n public class DwemerChestBlockEntity extends BaseChestBlockEntity { @Override @Override @Override @Override @Override Example \u2014 ChestBlock:<\/p>\n public class DwemerChestBlock extends BaseChestBlock { @Override —<\/p>\n ### \ud83c\udff9 MovementUtil \u2014 Advanced AI Positioning<\/p>\n MovementUtil provides reusable helpers for combat movement, especially for ranged entities.<\/p>\n Typical responsibilities:<\/p>\n * Keep the entity facing its target Recommended usage pattern inside a Goal:<\/p>\n 1) Validate target Example \u2014 Shooting Goal (Draugr Archer):<\/p>\n public class DraugrArcherShootingGoal extends Goal { public DraugrArcherShootingGoal(DraugrArcherEntity actor) { @Override LivingEntity target = this.actor.getTarget(); double distanceToTarget = this.actor.distanceTo(target);<\/p>\n movementUtil.lookAtTarget(target, actor); if (distanceToTarget <= STRAFE_DISTANCE) {\n movementUtil.moveBackward(target, actor);\n } else {\n movementUtil.strafeAroundTarget(target, actor);\n }\n\n \/\/ Shooting logic handled separately\n }\n }\n\nThis separation keeps movement smooth while allowing precise control over attack timing and animations.\n\n---\n\n## \ud83d\udcdc Notes\n\n* This mod is a **core library** required by several Mebahel projects.\n* Removing it will cause dependent mods to fail to load or function incorrectly.\n* Safe for both singleplayer and dedicated server environments.\n* Does not add standalone gameplay content by itself.\n* Join the community on Discord: https:\/\/discord.com\/invite\/y8uC2NepkB\n\n<\/p>\n","protected":false},"excerpt":{"rendered":" Mebahel\u2019s API is a core dependency mod that provides shared systems, utilities, and gameplay frameworks used across the Mebahel mod ecosystem.<\/p>\n","protected":false},"featured_media":99825,"template":"","meta":{"_minecraft_slug":"mebahels-api","_minecraft_project_id":"7PmL8Hql","_minecraft_author":"Mebahel","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":12457,"_minecraft_follows":7,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mebahels-api.zip","_minecraft_size_bytes":328281,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T02:01:29.990816Z","_minecraft_date_created":"2026-02-17T05:27:43.520057Z","_minecraft_date_modified":"2026-04-14T20:19:27.164853Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mebahels-api","_minecraft_icon_attachment_id":99825,"_minecraft_imported_at":"2026-06-05T17:41:20+00:00","_minecraft_import_hash":"547bf3bd58f61120c7631d926f71dead","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,873,158,98],"mod_loader":[99,106,160,100],"minecraft_version":[59,36,62,37],"class_list":["post-99824","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-library","mod_category-neoforge","mod_category-quilt","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","mod_loader-quilt","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\n
\n modImplementation “net.mebahelsapi:mebahels-api:
\n }<\/p>\n
\n “depends”: {
\n “mebahels-api”: “*”
\n }
\n }<\/p>\n
\n* **Fabric API**
\n* **GeckoLib** (for animated blocks and entities)<\/p>\n
\n* Underground builds intersecting fluids
\n* Ruins or dungeons that must remain dry <\/p>\n
\nServer-side only.<\/p>\n
\n2. Extend the base chest block entity
\n3. Register them normally
\n4. Configure title, sounds, and multiplayer behavior <\/p>\n
\n public DwemerChestBlockEntity(BlockPos pos, BlockState state) {
\n super(ModBlockEntities.DWEMER_CHEST_ENTITY, pos, state, 36);
\n }<\/p>\n
\n protected Text getChestTitle() {
\n return Text.translatable(“block.mebahelcreaturesdwarven.dwemer_chest”);
\n }<\/p>\n
\n protected String getLogPrefix() {
\n return “[DwemerChest]”;
\n }<\/p>\n
\n @Environment(EnvType.CLIENT)
\n public void playOpenSound() {
\n playChestSound(ModSounds.DWARVEN_CHEST_OPEN);
\n }<\/p>\n
\n @Environment(EnvType.CLIENT)
\n public void playCloseSound() {
\n playChestSound(ModSounds.DWARVEN_CHEST_CLOSE);
\n }<\/p>\n
\n protected boolean isMultiplayerEnabled() {
\n return ModMultiplayerChest.turnOnMultiplayerDraugrChest;
\n }
\n }<\/p>\n
\n public DwemerChestBlock(AbstractBlock.Settings settings) {
\n super(
\n settings,
\n () -> ModBlockEntities.DWEMER_CHEST_ENTITY,
\n DwemerChestBlockEntity::new
\n );
\n }<\/p>\n
\n protected boolean isMultiplayerEnabled() {
\n return ModMultiplayerChest.turnOnMultiplayerDraugrChest;
\n }
\n }<\/p>\n
\n* Prevent pathfinding stalls
\n* Maintain optimal distance
\n* Control strafe and retreat behavior <\/p>\n
\n2) Face the target
\n3) Run anti-stuck logic
\n4) Choose movement based on distance
\n5) Handle attack timing separately <\/p>\n
\n private final DraugrArcherEntity actor;
\n private final MovementUtil movementUtil;
\n private final double STRAFE_DISTANCE = 8;<\/p>\n
\n this.actor = actor;
\n this.movementUtil = new MovementUtil(this.actor);
\n }<\/p>\n
\n public void tick() {
\n if (actor.isUsingPotion() || actor.getHealTicks() > 0) {
\n actor.setShooting(false);
\n actor.getNavigation().stop();
\n return;
\n }<\/p>\n
\n if (target == null || !target.isAlive()) {
\n this.stop();
\n return;
\n }<\/p>\n
\n movementUtil.checkIfStuck(target, actor);<\/p>\n