Guide · Converting

Convert Models Between Yes Steve Model and Touhou Little Maid

Starting from version 1.1.3, the Touhou Little Maid (TLM) mod natively supports unencrypted Yes Steve Model (YSM) geometry and animation files. This guide explains the shared locator bones, animation differences, and Molang variables you need to know when adapting models between the two mods.

Compatibility and Requirements

Touhou Little Maid (since 1.1.3) can directly load unencrypted YSM model and animation files, making it easy to port your custom characters between player models and maid entities. Since TLM version 1.1.13, its Molang engine is fully synchronized with the Molang system used in YSM 2.2.2.

Encrypted single-file YSM packages (files ending in .ysm) cannot be read or converted. You must have access to the original unencrypted source files to adapt a model for Touhou Little Maid. You can use the Blockbench plugin tlm-utils.js to package the raw files into a TLM model pack.

Always obtain permission from the original author before converting or redistributing someone else's model.

Model Locator Bones and Glow Groups

TLM uses bone locator groups to render held items, back items, headwear, SlashBlade katanas, and TaCZ firearms. If you omit a locator bone from your model hierarchy, the corresponding equipment simply will not render on the maid.

Most locator names are identical to YSM, with a few maid-specific additions:

1. LeftHandLocator and RightHandLocator: Positions items held in the left and right hands, matching YSM.

2. LeftWaistLocator: Renders a SlashBlade katana on the left waist when the maid holds it in her right hand.

3. RightWaistLocator: Renders a SlashBlade katana on the right waist when the maid holds it in her left hand.

4. BackpackLocator: Placed between the shoulders to position the maid's backpack, or a decorative SlashBlade or banner placed in her bauble/decoration slot.

5. Head: Standard head locator bone, matching YSM.

6. PistolLocator and RifleLocator: Renders a holstered pistol at the waist or a rifle/RPG on the back when placed in the maid's decoration slot, matching YSM.

7. ysmGlow prefix: Any bone group starting with ysmGlow (such as ysmGlowHead or ysmGlowRingBow) emits light under most shaders. The emissive effect only applies to that specific group, not its children.

Shared Main Animations

Many core animations in your main animation file work in both YSM and TLM without renaming. Because maids cannot ride horses, sneak, crawl, fly, or use an elytra, TLM requires fewer total animations than a full YSM player model.

The following main animation names share the exact same triggers in both mods:

idle             - Loops when standing still
walk             - Loops while walking
run              - Loops while sprinting (maids rarely reach sprint speed)
jump             - Loops while jumping
attacked         - Plays once when taking damage
swim_stand       - Loops while treading water vertically
swim             - Loops while swimming (added in TLM 1.1.14)
sit              - Loops in standby mode (Shift + right-click)
boat             - Loops while riding in a boat
sleep            - Loops while sleeping
death            - Plays once on death (1 second duration)
swing_hand       - Plays once on left-click arm swing
use_mainhand     - Plays once when using right hand (right-click)
use_offhand      - Plays once when using left hand (right-click)
ladder_up        - Loops while climbing up a ladder (added in TLM 1.1.14)
ladder_stillness - Loops while pausing on a ladder (added in TLM 1.1.14)
ladder_down      - Loops while climbing down a ladder (added in TLM 1.1.14)
The sit animation in TLM has a slightly different vertical offset compared to YSM's sitting pose, so you should adjust the root bone height when porting.

Touhou Little Maid Exclusive Animations

Maids have unique idle hobbies and interactions that players do not have. To make your YSM model feel complete inside Touhou Little Maid, add these looping animations to your main animation file:

gomoku    - Sitting next to a Gomoku, Xiangqi, or Chess board
bookshelf - Sitting on a bookshelf
computer  - Sitting at a computer desk
keyboard  - Sitting at an electronic keyboard
chair     - Sitting on a cushion
picnic    - Sitting on a picnic mat
beg       - Triggered when a player approaches holding a cake
game_lost - Triggered when the maid loses a board game
game_win  - Triggered when the maid wins a board game

Conditional Animations

TLM supports almost all YSM conditional animations triggered by item or entity names. Keep in mind that maids cannot swing their offhand weapon and currently cannot use shields.

You can directly reuse or add the following conditional animation patterns:

1. hold_mainhand and hold_offhand: Plays when holding specific items (e.g., hold_mainhand:fishing).

2. use_mainhand and use_offhand: Plays when actively using items, such as eating (use_mainhand:eat) or firing danmaku with a gohei (use_mainhand:gohei).

3. swing: Plays when swinging a specific mainhand item (swing_offhand is not executable by maids).

4. passenger and vehicle: Plays when an entity rides the maid, or when the maid rides another entity—such as being picked up by a player with a saddle (vehicle$minecraft:player).

5. head, chest, legs, feet: Armor-specific conditional animations (note that legs is plural).

6. tac: TaCZ gun compatibility animations, identical to YSM.

7. chair$: A TLM-exclusive conditional prefix followed by a cushion's model ID, allowing custom poses per chair type.

hold_mainhand:fishing
use_mainhand:eat
use_mainhand:gohei
vehicle$minecraft:player
chair$touhou_little_maid:class_chair

Molang Variables and Function Differences

While TLM includes every Molang function found in YSM, some return fixed or fallback values because maid entities lack certain player mechanics like hunger or capes. Furthermore, TLM adds three exclusive boolean variables for maid states.

Review these Molang differences before reusing complex YSM expressions:

// TLM Exclusive Variables
tlm.is_begging               // true when begging for cake, otherwise false
tlm.is_sitting               // true when in standby/sitting state, otherwise false
tlm.has_backpack             // true when wearing a backpack, otherwise false

// Behavioral Differences in TLM
ysm.bone_pivot_abs           // Empty function in TLM
ysm.food_level               // Fixed at 20 (maids have no hunger system)
ysm.texture_name             // Always returns an empty string
ysm.rendering_in_inventory   // Always returns false
query.player_level           // Returns the maid's current experience value
query.has_cape               // Always returns false (maids have no cape mechanic)
All debugging Molang functions—such as query.debug_output, ysm.dump_mods, and ysm.dump_effects—are disabled and act as empty functions in Touhou Little Maid.

Questions

Can I convert a downloaded .ysm file into a Touhou Little Maid model?

No. Encrypted single-file .ysm packages cannot be read or converted by Touhou Little Maid. You can only use unencrypted folder-based YSM model and animation files.

Why does my model hover or clip into the floor when the maid sits down?

The sit animation in Touhou Little Maid has a slightly different vertical position offset compared to the YSM player sitting animation. Open the animation in Blockbench and adjust the root bone height for the sit animation.

Why is the SlashBlade katana rendering on the wrong side of the waist?

SlashBlade locators sit on the opposite side of the drawing hand: RightWaistLocator renders the sheath on the right waist for a left-handed blade, while LeftWaistLocator renders it on the left waist for a right-handed blade.

Do TaCZ gun animations from YSM work on maids?

Yes. Both the tac conditional animations and the PistolLocator / RifleLocator bone groups work identically in Touhou Little Maid and Yes Steve Model.

Next: YSM for Minecraft China Edition (NetEase) →

More in Converting