genderswap Play as Sammy (Luanti - formerly "Minetest Game") 1.0.0

Play-as-Sammy_Mod.zip

Core Mechanics

This Minetest mod implements a character selection system that allows players to choose between a default model and a custom "Sammy" mesh. For players who select Sammy, it enables a layered clothing system with a dedicated inventory tab for managing and visually updating boots, pants, and sweaters in real-time.

1. Dynamic Character Selection

Upon first joining the world, players are presented with a choice: remain as a standard explorer ("Sam") or embrace the "Sammy" identity.

• Sammy Mesh: Selecting Sammy swaps the player model to a high-quality .b3d mesh with dedicated bone structures for animations and item wielding.
• Persistence: The choice is saved via player metadata, ensuring your identity remains consistent across sessions.

2. Layered Clothing System

We’ve implemented a dedicated "Her Clothes" inventory tab. This isn't just cosmetic; it's a real-time visual system:

• Real-time Updates: Equipping boots, pants, or sweaters instantly updates the player's texture through a prioritized layering script.
• Inventory Restrictions: To maintain the character's integrity, the clothing slots only accept specific items (e.g., you cannot put a sword in the "pants" slot).
• Interactive Preview: The inventory UI features a live 3D model of Sammy that rotates, allowing players to see their outfits from all angles.

3. Biological Logic: The Milking System

A standout feature brought back from the original tribute is the Milk Extraction mechanic. This adds a layer of survival and character management:

• The Milk Slot: A dedicated slot in the "Her Milk" tab for glass vessels.
• Extraction States: The system tracks whether Sammy is wearing a sweater (which blocks extraction), if a glass is present, or if the process is underway.
• Progressive UI: The interface updates with custom textures representing states like milking, milked, or out (no glass).
• Health Utility: The resulting Breast Milk Glass is a potent food source, restoring 6.5 hearts (13 HP).

4. Wielded Item & Lighting Overrides

To ensure Sammy feels grounded in the world, we’ve integrated custom 3D wielding logic:

• Bone Attachment: Items are attached to a hand bone rather than just floating, with specific rotation offsets for tools like shovels and buckets to prevent clipping.
• Dynamic Lighting: If Sammy holds a torch or light-emitting item, the mod calculates and places invisible light nodes around the player in real-time, illuminating the environment naturally.

Technical Deep Dive

The mod is built on a modular architecture:

• player_sammy.lua: Handles the heavy lifting of mesh swapping and clothing logic.
• milk_logic.lua: A driven state machine that manages the extraction timer and inventory validation.
• wield_3d.lua: Uses an entity-based approach to render held items as 3D objects rather than 2D sprites.