Find me

## Version 1.2.2

### New: Name Paper Manual Binding

- Added Name Paper as the main manual binding item for creatures.
- Name Paper is crafted from three pieces of paper.
- A successful non-creative binding consumes one Name Paper.
- Manual binding is now the recommended way to add creatures.
- Automatic binding is disabled by default and can be re-enabled in config.
- Binding now blocks invalid targets more reliably, so unrelated creatures are less likely to be added by mistake.

### Binding Ceremony And Magic Effects

- Added an optional Name Paper contract ceremony.
- The ceremony can use a temporary cinematic camera.
- Ceremony effects include hexagram-style magic circles, contract visuals, warding effects, and storage-style completion.
- Ceremony animation and cinematic camera can be disabled in config.
- Binding visuals were cleaned up by removing older effects that looked noisy or unclear.

### Summon, Rescue, And Storage Visuals

- Added reusable magic-circle rendering for summon, rescue, storage, and binding effects.
- Mount summons usually use a vertical portal-style circle.
- Companion summons and companion rescue use horizontal ground circles.
- Rescue effects are brighter and faster than normal summons.
- Storage now uses a wrapping magic effect instead of an instant disappearance.
- Magic-circle colors now stay in a white/blue range with brightness changes instead of shifting through unrelated colors.
- Summon and rescue effects now try to appear before the creature becomes visible.
- Magic-circle size now uses visual bounds so large creatures receive larger circles.

### Dialogue And Feedback

- Added optional small subtitle dialogue for summon, rescue, storage, home, registration, cooldowns, and warnings.
- Dialogue is disabled by default.
- When dialogue is disabled, Find me falls back to practical action-bar style messages.
- Dialogue text is configurable through Forge config.
- Dialogue entries support placeholders such as `{player}`, `{name}`, and `{seconds}` where applicable.
- Creature arrival voice and magic effect volume are configurable separately.

### Small House / Home System

- Added the Small House block for home management.
- Small House is crafted with Name Paper and any wooden slab.
- Right-clicking a Small House opens the manager in home mode.
- Creatures can be assigned to that house as their home.
- Home-bound creatures show an `H` marker in the wheel and lists.
- Storing a home-bound creature returns it home when possible.
- If the home area is loaded and valid, creatures may appear near the Small House as residents.
- Breaking the exact Small House clears the house marker for affected online players without deleting the creature.

### Companion And Mount Improvements

- Companion deployment limit is enforced at the server state, not just the UI.
- Companion rescue is focused on combat rescue behavior.
- Rescue protection now reduces cases where the player or companion dies immediately after a rescue.
- Flying mount rescue and void handling were made stricter and safer.
- Flying mounts can be summoned directly in unsafe void conditions; non-flying mounts and companions refuse.
- Mount switching was revised to avoid dismount/remount jitter and to keep old rides safe until the new ride succeeds.
- Large and multipart mounts have improved contact-box handling.

### UI / UX Improvements

- Added blacklist controls for entity types.
- Improved manager context menus, rename overlays, search layout, and home actions.
- The manager no longer shows old home action buttons in places where Small House mode owns those actions.
- Wheels show home markers and better active/summon/store state.
- Preview rendering now caches entities more effectively and supports non-living vehicle previews used later in 1.2.3.

### Safety, Recovery, And Compatibility

- Improved player data copy handling for dimension return and clone-like situations.
- Added stronger backup/vault style recovery tools and safety checks.
- Sleep revive was moved to wake-up event handling for more reliable timing.
- External owned-entity recreation from other mods is handled more defensively.
- Stored entity NBT is cleaned so temporary animation, invisible, no-gravity, and NoAI states are not saved into long-term data.
- Restore logic avoids deleting stored NBT unless the entity was actually added successfully or a loaded same-UUID entity was safely reused.
- Added diagnostics config for contact boxes and Find me state debugging.