AddonExe for Minecraft BE

The ultimate scripting-based solution for your Minecraft Bedrock Edition world! Designed to be robust, highly configurable, and packed with features to ensure fair and fun gameplay.

✨ Why Choose AddonExe?

Scripting Power: Built entirely with the Minecraft Scripting API, offering flexibility and complex logic not always possible with traditional methods.
Comprehensive Detection (Under Redevelopment): While currently a powerful moderation tool, a full suite of cheat detections is being redesigned and will be re-introduced in a future update.
User-Friendly Tools: Manage your server with ease using an intuitive in-game UI (/panel) and extensive slash commands, which can be used in-game, from the server console, or via a chat-based fallback (e.g., !panel).
Highly Customizable: Fine-tune almost every aspect, from feature toggles to command permissions, to perfectly suit your server's needs.
Active Development: Continuously updated with new features, improvements, and compatibility for the latest Minecraft versions.
Open & Documented: With clear documentation and an open codebase, understand how it works and even contribute!
Enhanced Stability: Includes robust error handling and a watchdog to prevent script-related server crashes, ensuring a more stable experience.

🌟 Core Features

🛠️ Powerful Admin & Moderation Tools:
- A universal, dynamic in-game UI panel (/panel) that shows each player only the buttons they are permitted to see.
- Perform a wide range of actions: Kick, Ban/Unban, Mute/Unmute, Freeze, View/Clear Inventory, Teleport.
- Extensive slash commands for all administrative functions, which can also be run directly from the server console.
💾 Persistent Player Data Management:
- Mutes and bans are saved across player sessions using dynamic properties.
⚙️ Highly Configurable System:
- Toggle major features, customize messages, and define all permissions and ranks in easy-to-edit configuration files.
🏅 Flexible Rank System:
- Define Owner, Admin, Member, and custom roles with specific permissions and visual chat/nametag prefixes.
📞 Teleport Request System (TPA/TPAHere):
- Allows players to request teleports to others or summon others, with configurable cooldowns and warmup periods.
✨ Player & Server Utilities:
- Economy & Bounties: A simple economy system with player balances, payment commands, and a full bounty system.
- In-Game Shop: A complete GUI-based shop where players can buy and sell items.
- Homes: Allows players to set and teleport to their own personal "homes".
- Kits: A system for players to claim predefined kits of items with cooldowns.
- Random Teleport (RTP): A command for players to teleport to a random, safe location.

[!NOTE] Cheat Detection Suite (Under Redevelopment) A comprehensive suite of cheat detections is being redesigned and will be re-introduced in a future update. The old system has been removed to ensure stability.

➡️ For a full list and details of all features, check out our Features Overview!

🚀 Installation & Setup

We recommend the following manual installation method, as it makes future configuration much easier.

For All Platforms (Windows, iOS, Android)

Download: Grab the latest .mcaddon file from the GitHub Releases.
Extract the Packs:
- Do not open the .mcaddon file directly. Instead, rename it to end in .zip (e.g., AddonExe.mcaddon -> AddonExe.zip).
- Unzip the file. Inside, you will find two folders: AddonExeBP (the Behavior Pack) and AddonExeRP (the Resource Pack).
- Move these two folders into your Minecraft's behavior_packs and resource_packs folders, respectively. > Why this method? Installing the folders directly makes it simple to find and edit the config.js file later.
Apply to Your World:
- Open Minecraft and go to your world's settings.
- Apply both AddonExeBP and AddonExeRP to your world.
Enable World Settings (CRITICAL!):
- In your world settings, go to the "Game" section and enable "Activate Cheats".
- Next, go to the "Experiments" section and enable the "Beta APIs" toggle. The addon will not function without this setting.
Prioritize: Ensure AddonExeBP is at the TOP of your behavior pack list in the world settings.

For Bedrock Dedicated Server (BDS)

Follow steps 1 & 2 above, then:

Place the Pack Folders:
- Move the extracted AddonExeBP and AddonExeRP folders into your BDS's behavior_packs and resource_packs folders.
Activate the Packs:
- Download the following two files from the root of the repository:
  - world_behavior_packs.json
  - world_resource_packs.json
- Place both of these files into the root folder of your world (the same folder that contains your level.dat).
Enable Beta APIs:
- The easiest method is to download your world, open it in a local version of Minecraft, enable the "Beta APIs" experiment, and then re-upload the world to your server.

👑 Initial Configuration (CRUCIAL!)

After installing, you must set yourself as the owner to access admin commands.

Navigate to behavior_packs/AddonExeBP/scripts/ and open config.js in a text editor.
Find the ownerPlayerNames setting.
Add your exact in-game name (case-sensitive) to the array. javascript // Example in AddonExeBP/scripts/config.js ownerPlayerNames: ['YourNameHere', 'AnotherOwnerName'],
Save the file. If your server is live, run Minecraft's vanilla /reload command to apply the changes.

➡️ For a detailed guide on all settings, see our Configuration Guide.

📖 Full Documentation & Support

📜 Commands List - Every command for players and admins.
🏅 Rank System - How to configure and use ranks.
❓ F.A.Q. - Answers to common questions.
🛠️ Troubleshooting Guide - Solutions for common problems.

Need Help?

Join our Discord Server for community support.
Report Bugs on our GitHub Issues Page.

⚖️ License

This project is licensed under the MIT License. See the LICENSE file for details.