[车万女仆_超时空救援]TLM Beyond Space

# TLM Beyond Space

**TLM Beyond Space** is an unofficial addon for **Touhou Little Maid** that expands maid combat support with configurable rescue behavior, active distress signals, cross-dimensional reinforcement, temporary weapon switching, and safe return mechanics.

> **Touhou Little Maid is required.**

The goal of this addon is to let maids continue their normal daily tasks while still being able to temporarily respond to dangerous situations when their owner needs help.

---

## Features

### Combat Maid Book

The Combat Maid Book allows each maid to use configurable rescue behavior based on her current work task.

Available rescue modes include:

- **Forbidden** — the maid will not participate in regular automatic rescue while using that work task.
- **Solo** — the maid may temporarily enter combat when she is directly threatened.
- **Bond** — the maid can also respond when her owner is in danger.

A single global combat task can be selected for the book.

Combat tasks are discovered through Touhou Little Maid's standard `IAttackTask` system, allowing compatible third-party combat task addons to work without requiring hardcoded weapon lists.

After editing a Combat Maid Book, re-bind it to an already bound maid to update that maid's saved rescue profile.

---

## Distress Signal

The Distress Signal provides active emergency reinforcement.

Sneak + Right Click opens the maid roster, where individual maids can be enabled or disabled for distress response.

Normal Right Click activates the signal.

Features include:

- Up to 20 successfully summoned maids per signal activation
- Support for loaded maids in other dimensions
- Cross-dimensional emergency reinforcement
- Safe return to the maid's original dimension and location
- Automatic return after the battlefield remains safe
- Manual recall mode
- Automatic recall when the owner dies, disconnects, or leaves the current rescue dimension

Only loaded maids are currently eligible for distress summoning.

The addon does not forcibly load unloaded maids.

---

## Cross-Dimensional Rescue

Cross-dimensional rescue is exclusive to **Distress Signal** sessions.

Regular automatic Bond/Solo rescue does not perform cross-dimensional teleportation.

When a maid responds from another dimension, the addon migrates the maid to the owner's current dimension while preserving her live entity state.

After the rescue ends, the maid attempts to return to a safe position near her original location.

If a safe return cannot be completed, the rescue session is retained instead of silently sending the maid to an arbitrary fallback location.

---

## Safer Rescue Completion

Distress rescue does not end immediately just because a maid temporarily loses her attack target.

The addon also monitors:

- The maid's current target
- Recent damage to the maid
- Recent damage to the owner
- Threats around the maid's current position
- Threats around the owner's current position

A Distress rescue normally ends after the battlefield has remained safe for approximately 5 continuous seconds.

A Distress session also has a maximum active duration of approximately 5 minutes as a failsafe.

---

## Manual Recall

The Distress Signal roster includes:

**Recall currently rescuing maids: Yes / No**

When enabled, normal Right Click no longer summons new maids.

Instead, it attempts to return all currently active Distress-response maids belonging to the player.

Regular automatic rescue sessions are not affected by this option.

---

## Maid Weapon Case

The Maid Weapon Case can store one combat item and can be equipped by a maid.

During rescue, the addon checks whether the selected combat task recognizes the stored item as a valid weapon.

If compatible:

- The weapon case item is temporarily moved to the maid's main hand
- The previous main-hand item is temporarily stored
- The original relationship is restored after rescue

Weapon compatibility is determined by the selected `IAttackTask`, rather than by hardcoded sword/gun/staff categories.

The restoration system also tracks the temporary weapon if another combat task moves it from the main hand into the maid's backpack.

Real combat changes such as durability loss, ammunition consumption, health changes, and collected items are preserved.

---

## Rescue State Philosophy

TLM Beyond Space intentionally avoids restoring a full pre-rescue entity snapshot.

Only temporary rescue-controlled state is restored where appropriate, such as:

- Work/combat task
- Home mode
- Schedule
- Temporary weapon-case swap state
- Rescue session state

Normal gameplay changes that happened during combat remain real.

---

## Current Limitations

- Only loaded maids can respond to the Distress Signal.
- Regular automatic rescue does not support cross-dimensional summoning.
- Sitting-state handling is currently not modified by this addon.
- Changing the maid's task externally during an active rescue may end that rescue session while leaving the maid at her current position.
- Client and server should use the same version of TLM Beyond Space.

---

## Requirements

### Required

- Minecraft **1.20.1**
- Forge
- Touhou Little Maid

### Tested Environment

- Minecraft 1.20.1
- Forge 47.3.22
- Touhou Little Maid 1.5.3-forge+mc1.20.1

Other Forge 47.x builds may work, but are not currently guaranteed or individually tested.

---

## Optional Compatibility

TLM Beyond Space is designed to work with compatible Touhou Little Maid combat task addons that implement the standard TLM task interfaces.

Some integrations have been developed with environments containing addons such as:

- Touhou Little Maid: Combat Plus
- Maid Useful Task

These are not replacements for the required Touhou Little Maid dependency.

---

## Installation

1. Install Minecraft 1.20.1.
2. Install Forge for Minecraft 1.20.1.
3. Install Touhou Little Maid.
4. Place the TLM Beyond Space `.jar` file into the `mods` folder.
5. Launch the game.

For multiplayer, install the same TLM Beyond Space version on both the client and server.

---

## Important Multiplayer Note

Client and server should use the exact same TLM Beyond Space version.

Do not intentionally mix older and newer versions of the addon in multiplayer installations.

---

## Unofficial Addon Notice

TLM Beyond Space is an independent, unofficial addon for Touhou Little Maid.

Touhou Little Maid belongs to its respective authors and contributors.

This project is not an official Touhou Little Maid release.

---

## Promotional Artwork Notice

The project logo is AI-assisted illustrative promotional artwork.

It is not an in-game screenshot and should not be interpreted as a representation of Minecraft's actual in-game rendering.