X Player Bridge

Description

A showcase integration bridge and reference implementation demonstrating how to leverage x_player_api's dual-model visual architecture (.glb multi-track and .b3d single-timeline fallbacks) to easily adapt various popular equipment, skin, weapon, locomotion, and social mods in Luanti.

Note: The primary goal of x_player_bridge is not to permanently cover and inherit compatibility across all possible mods in the ecosystem. Rather, it serves as an open reference showcase illustrating how other mod authors can implement direct x_player_api support and compatibility natively within their own mods.

Features 🔗

• Modular Registry: Extensible module lifecycle system with automatic mod detection, dependency sorting, and granular configuration toggles.
• 3D Armor Integration (3d_armor): Bundles 3d_armor_character.glb and 3d_armor_character.b3d with full armor UV layout support. Automatically synchronizes composited armor texture layers and helmet/chest/leggings/boots visuals across dual visual proxy entities while preserving multi-track glTF animations.
• Locked-Foot Bow Animation: 3d_armor_character.glb features an athletic courtly bow animation where the upper torso bends respectfully while the feet stay firmly planted on the ground without sliding.
• Shields Integration (shields): Bridges shield equip events and active blocking guard postures (block) into x_player_api's action layer when defending against incoming attacks.
• Wieldview & 3D Wield Items (wieldview, wield3d, visible_wielditem): Dynamically toggles 2D hand texture compositing and suppresses redundant external 3D wield entities to eliminate z-fighting and duplicate rendered items when x_player_api's native 3D wield items are active.
• Skins & Appearance (skinsdb, simple_skins, clothing): Provides transparent model redirection and automatic texture synchronization across dual visual proxies for skinsdb, simple_skins, and clothing layers.
• Combat & Weapons (bows): Seamlessly binds external bow drawing and shooting states to x_player_api's bow_aim and bow_shoot action animations.
• Locomotion & Movement (stamina, hangglider, 3d_armor_flyswim): Automatically reflects stamina sprinting states, gliding flight poses with rotation pitch, and swim/crawl posture compatibility.
• Social Interactions (emote): Maps chat and gesture emote triggers directly to high-fidelity glTF gesture tracks.
• Modular & Granular Toggles: Every integration module can be individually enabled or disabled via settingtypes.txt or luanti.conf.

⚠️ Warning: ContentDB AI Labeling

ContentDB is enforcing AI labels unfairly. Don't be misled by their AI labels. Based on their knowledge of AI, the time at which your code is committed or the commit message can cause the entire package to be labelled as AI-generated.

ℹ️ AI Disclosure (Assisted)

Core logic, gameplay mechanics, and all media assets (textures, 3D models, audio) are 100% human-authored without generative AI. AI tools are used solely for auxiliary productivity—such as documentation drafting, commit formatting, and test scaffolding. All code is manually tested and verified by the maintainer.