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)

1. Download: Grab the latest .mcaddon file from the GitHub Releases.
2. 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.
3. Apply to Your World:
   • Open Minecraft and go to your world's settings.
   • Apply both AddonExeBP and AddonExeRP to your world.
4. 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.
5. 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:

1. Place the Pack Folders:
   • Move the extracted AddonExeBP and AddonExeRP folders into your BDS's behavior_packs and resource_packs folders.
2. 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).
3. 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.

1. Navigate to behavior_packs/AddonExeBP/scripts/ and open config.js in a text editor.
2. Find the ownerPlayerNames setting.
3. Add your exact in-game name (case-sensitive) to the array. javascript // Example in AddonExeBP/scripts/config.js ownerPlayerNames: ['YourNameHere', 'AnotherOwnerName'],
4. 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.