Odyssey NPCs — The Ultimate NPC & Server Framework

Tired of broken NPC add-ons that require unstable Beta APIs, endless command lines, or crash your world upon every game update?

Welcome to Odyssey NPCs — a revolutionary, standalone NPC framework built from scratch for Minecraft Bedrock Edition. It requires ZERO Beta APIs and ZERO commands. Everything is managed through beautiful, performance-optimized, and intuitive UI menus. Whether you are creating an immersive RPG adventure map, managing a massive multiplayer server, or looking for loyal companions in your survival world, Odyssey NPCs provides absolute control.

🛠️ Core Features

🧠 Advanced AI & Behaviors

Follow, Wait, & Roam: Command your NPCs to act as your shadow, stand guard at a fixed location, or freely explore the environment.
Smart Teleportation: If an NPC in follow mode falls too far behind, it will automatically teleport to your position—no more lost companions.

⚔️ Quick-Guard Combat System

Reflexive Defense: Toggle combat mode instantly by Sneaking + Right-Clicking your NPC (restricted to Owners and Whitelisted players).
Smart Target Filtering: NPCs will fiercely defend you against hostile threats (Zombies, Skeletons, Spiders, Witches, etc.) but will strategically ignore world-destructive entities like Creepers, Wardens, and the Wither to protect your builds.
Aggressive Mode (Attack Players): Turn your NPCs into ruthless arena combatants or base guardians that target survival players on sight.

🏹 Advanced Ranged Combat (Bow Mode)

Equip your NPC with a bow and load their custom inventory with arrows. They will automatically act as snipers, picking off targets from towers.
If an enemy breaches their perimeter and gets too close, the AI dynamically switches from ranged to melee combat instantly.

🛡️ Deep Equipment & Durability

Full Gear Customization: Equip your NPCs with armor sets and items in both main and off-hands. In Survival, items are deducted from your inventory; in Creative, they are mirrored.
Functional Mechanics: Equipped enchantments are fully functional, and item durability is active—weapons will realistically degrade and break over time.
Quick Equip: Simply right-click an NPC while holding a gear set to instantly dress them without opening a menu.

📦 Walking Chests & Inventory

NPCs feature a secure, custom inventory slot system to carry your loot.
Includes a toggleable safety feature: choose whether the NPC drops its inventory upon death or retains it securely.

🧭 Navigation, Patrols, & Armies

Go-To Command: Order an NPC to travel to a precise coordinate within a 14-block radius.
Cyclic Patrols: Program complex patrol routes by setting multiple coordinates. NPCs will continuously loop through the path.
NPC Linking (Army Framework): Link multiple NPCs to a single leader. Move the leader, and your entire battalion follows in formation.

💬 Storytelling & Dialogues

An easy-to-use dialogue editor allows you to write custom greeting messages, quest prompts, or lore snippets. Any regular player interacting with the NPC will see your text in a clean chat layout.

🎨 Visual Customization

Comes packed with 10 unique built-in skins and dynamic nametag editors.
Custom Skin Support: Fully compatible with custom resource packs, allowing you to easily inject your own 64x64 .png skins.

🏬 Server Utility & Advanced Systems

🛒 Dynamic Shop System

Build bustling RPG markets easily. The fully UI-driven trade creator allows admins to establish custom economic exchanges (e.g., Trade 5 Gold Ingots for 1 Milk Bucket) using strict Item IDs or categorized item lists.

📜 Robust Quest Framework

Two Operational Modes: Choose between Free Mode (players complete quests in any order) and Sequential Mode (quests must be cleared in a strict, story-driven order).
Three Core Quest Types:
1. Collect: Gather and deliver specific item quantities.
2. Kill: Hunt down designated mobs.
3. Go To: Travel to a specific location (features adjustable proximity radius detection).

🚩 Faction Gangs & PvP Sagas

Assign NPCs to Group Kırmızı (Red) or Group Mavi (Blue).
Blow the War Horn item to trigger massive, automated army battles, and right-click again to cease fire.
Toggle player-damage protection and realistic knockback vectors for customized cinematic battle scenes.

👥 Instant Mass Cloning

Need to populate a city or server spawn? Duplicate any complex NPC up to 20 times instantly. Your custom outfits, dialogues, trades, whitelist records, and quest structures are completely cloned to the new entities with a single click.

🕹️ Dual Ecosystem: Server vs. Survival

Odyssey NPCs adapts to your playstyle using the Admin Wand configuration interface:

SERVER MODE: Total creative freedom. All administrative features (cloning, shop setup, quest lines, player-attack modes) are unlocked for Whitelisted Admins. Regular players cannot spawn or alter NPCs.
SURVIVAL MODE: Tailored for fair, vanilla-plus gameplay. Creative exploits are automatically locked out. Players can naturally hire a companion by creating an NPC Contract—simply hold Paper, Sneak, and Right-Click (requires 1 Emerald, 1 Paper, and 1 Ink Sac).

🔒 Permissions & Safety

Sovereign ownership rules apply. Regular players can only read dialogues, accept/turn in quests, and buy from shops.
They cannot access configuration matrices, steal gear, or order your personal guards around.
Lost ownership due to unexpected world anomalies? Simply right-click the NPC with an Admin Wand to reclaim your creator status instantly.

📢 Technical Credits & Author Note
Engine Developer: RomanCraft (Murad Umarov) Version: 1.0.0 (Official Release) All Rights Reserved. Unauthorized redistribution, cloning of the source codebase, or claiming authorship of this framework is strictly prohibited under digital property protections.