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 standalone NPC framework built from scratch for Minecraft Bedrock Edition. It requires ZERO Beta APIs and ZERO commands. Everything is managed through intuitive, performance-optimized UI menus.

Whether you are creating an immersive RPG adventure map, managing a multiplayer server, building cinematic scenes, or looking for loyal companions in your survival world, Odyssey NPCs gives you complete control over your NPCs.

🆕 What's New in v1.2.0

This update focuses on making NPCs look and feel more natural with improved combat animations, realistic item-holding poses, and dynamic head movement.

⚔️ Melee Swing Animation

NPCs now perform a visible arm-swing animation when attacking in supported combat modes.

• NPCs visibly swing their arms when performing scripted melee attacks.
• Combat looks more dynamic and natural instead of NPCs simply dealing damage without a visible attack motion.
• Works with supported combat behaviors, including Guard, Attack Player, and Group/Faction combat.

🛡️ Improved Item-Holding Poses

NPCs now have more natural arm positions when holding items.

• Main-Hand Pose: The NPC's right arm moves into a more natural holding position when equipped with an item.
• Off-Hand Pose: The NPC's left arm adjusts when holding a supported off-hand item.
• These poses make equipped NPCs look more natural during gameplay and roleplay scenes.

🖐️ Improved Off-Hand Compatibility

Off-hand equipment handling has been improved to prevent visual conflicts.

• Supports compatible vanilla items and recognized third-party items, including supported shields.
• Unsupported items are rejected when they would cause incorrect or duplicated off-hand rendering.
• Clear feedback is displayed when an item is not supported.
• Off-hand compatibility remains subject to Minecraft Bedrock's rendering and item implementation limitations.

👀 Dynamic Head Tracking

NPCs can now tilt their heads up or down toward their current target.

• More natural head movement when looking toward players at different heights.
• Particularly useful when interacting with NPCs of different sizes.
• Adds more life and personality to NPC interactions and cinematic scenes.

🛠️ Core Features

🧠 Advanced AI & Behaviors

• Follow, Wait, & Roam: Command your NPCs to follow you, remain at a location, or freely explore the environment.
• Smart Teleportation: If an NPC in follow mode falls too far behind, it can automatically teleport to your position.

⚔️ 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 can defend you against hostile threats while strategically ignoring world-destructive entities such as Creepers, Wardens, and the Wither.
• Aggressive Mode: Turn NPCs into combatants or base guardians that can target survival players.
• Visible Combat Animations: NPCs perform melee swing animations during supported scripted attacks.

🏹 Advanced Ranged Combat

• Equip an NPC with a bow and arrows through its inventory.
• NPCs can use ranged combat while in supported combat modes.
• When enemies get too close, the AI can dynamically switch between ranged and melee combat.

🛡️ Deep Equipment & Durability

• Full Gear Customization: Equip helmets, chestplates, leggings, boots, main-hand items, and off-hand items.
• Give Held Item: Transfer the item you are currently holding directly into a selected equipment slot.
• Natural Holding Poses: NPCs adjust their arm positions when holding supported main-hand and off-hand items.
• Functional Mechanics: Supported enchantments, damage values, armor values, and durability can function normally.
• Quick Equip: Vanilla armor can also be equipped directly by interacting with the NPC while holding compatible gear.
• Third-Party Compatibility: Compatible equipment from other add-ons can be used, subject to each item's implementation and Bedrock's rendering limitations.

📦 Walking Chests & Inventory

• NPCs feature a custom inventory system for carrying items.
• Players can add or retrieve items through the NPC interface.
• Includes a toggleable safety feature allowing NPC inventory to be dropped upon death.

🧭 Navigation, Patrols, & NPC Groups

• Go-To System: Order NPCs to travel to selected coordinates.
• Cyclic Patrols: Create multi-point patrol routes that continuously loop between locations.
• NPC Linking: Link NPCs together so multiple NPCs can follow a designated leader.

🎨 Visual Customization

• 10 Built-in Skins: Choose from the included NPC skins.
• Custom Skin Support: Add your own 64×64 PNG skins through a compatible resource pack.
• Dynamic Names: Customize NPC nametags directly through the UI.
• NPC Size System: Change NPC scale between Baby, Medium, and Normal.
• Dynamic Head Tracking: NPCs can tilt their heads toward targets at different vertical positions.
• Improved Animations: More natural melee attacks and item-holding poses.

🏬 Server Utility & Advanced Systems

🛒 Dynamic Shop System

Create RPG-style shops with a fully UI-driven trading system.

• Create and manage custom trades.
• Use categorized vanilla items or Item IDs.
• Add multiple trades to a single NPC.
• Delete individual trades or clear the entire shop.

📜 Robust Quest Framework

• Free Mode: Players can complete available quests in any order.
• Sequential Mode: Quests must be completed in a defined order.
• Collect: Gather and deliver required items.
• Kill: Defeat designated entities.
• Go To: Travel to a specific location with configurable proximity detection.

🚩 Faction Gangs & PvP Battles

• Assign NPCs to Group Red or Group Blue.
• NPCs from opposing groups can fight each other.
• Use the War Horn system to start or stop group battles.
• Configure player-damage protection and combat behavior for customized gameplay and cinematic scenes.

👥 Instant Mass Cloning

Need to populate a city, battlefield, village, or server spawn?

Duplicate complex NPCs up to 20 times with a single action.

Cloning can preserve features such as:

• Skin
• Name
• Size / Scale
• Equipment
• Inventory
• Quests
• Shop data
• Whitelist records
• Group settings
• Other supported NPC configuration

🕹️ Dual Ecosystem: Server vs. Survival

Odyssey NPCs adapts to different playstyles through its Admin Wand system.

SERVER MODE

Designed for servers and creative administration.

• Administrative controls are available to authorized players.
• NPC configuration, cloning, shops, quests, combat systems, and other management features can be controlled through the UI.
• Regular players cannot freely modify administrator-controlled NPCs.

SURVIVAL MODE

Designed for survival and vanilla-plus gameplay.

• Administrative and creative-oriented functions are restricted.
• Players can hire NPC companions using the NPC Contract system.
• The contract system uses 1 Emerald, 1 Paper, and 1 Ink Sac.

🔒 Permissions & Safety

• NPC ownership and whitelist systems help protect your creations.
• Regular players cannot freely access protected NPC configuration.
• Players can still interact with systems such as shops and quests when permitted.
• Lost ownership can be reclaimed using the Admin Wand.

📜 Previous Major Update — v1.1.0

📏 NPC Size & Scale System

Customize the physical size of your NPCs directly from the Appearance menu.

• Baby: 0.5× scale
• Medium: 0.75× scale
• Normal: 1.0× scale
• No extra entities or textures are required.
• NPC scale is integrated with the cloning system, so cloned NPCs retain their selected size.

🎁 Give Held Item

Equip your NPCs with items directly from your hand without manually entering Item IDs.

Simply hold an item, select the desired equipment slot, and use Give Held Item.

• Supports weapons and armor from standard Minecraft.
• Supports compatible items from other add-ons.
• Useful for RPG, roleplay, cinematic, and modded-server creators.
• Equipment functionality such as damage, armor values, and durability can work normally when supported by the item's own implementation.

This system has been tested with equipment from third-party add-ons such as Epic Knights.

Compatibility Note: Add-ons that rely on highly customized player-only animations, rendering systems, or complex two-handed weapon behavior may not visually function correctly on NPCs.

⚙️ Technical Information

• Minecraft Bedrock Edition
• Stable API only
• No Beta APIs
• No command-based NPC control
• Built with a focus on stability, usability, and performance.
• Supports both English and Turkish localization.

📢 Technical Credits & Author Note

Engine Developer: RomanCraft (Murad Umarov)
Version: 1.2.0
Release: Official v1.2.0 Update

All Rights Reserved. Unauthorized redistribution, cloning of the source codebase, or claiming authorship of this framework is strictly prohibited.