SOLEA API

# SOLEA API 26.4

This update introduces advanced server performance tools and fixes several important gameplay and interface issues.

## New: Advanced ClearLag System

- Added `/gamerule clearlag true/false`.
- ClearLag is disabled by default.
- Added `/clearlag`, available to every player, to display the remaining time.
- Added configurable ClearLag intervals.
- Added separate cleanup options for:
  - Dropped items
  - Passive mobs
  - Hostile mobs
  - Named mobs
- Solea NPCs, minibosses, and tamed animals are always protected.

### Configuration Commands

- `/solea edit clearlag`
- `/solea edit clearlag time <minutes>`
- `/solea edit clearlag clear entity_passif <true/false>`
- `/solea edit clearlag clear entity_monster <true/false>`
- `/solea edit clearlag clear items <true/false>`
- `/solea edit clearlag clear nametag <true/false>`

## New: Mob Compression System

- Added `/gamerule mobscompression true/false`.
- Mob compression is disabled by default.
- Newly spawned mobs of the same type can be grouped inside their spawn chunk.
- Compression limits can be configured from `2` to `999`.
- Compressed mobs display a bold red `xN` counter.
- Killing a compressed mob now correctly decreases its counter and respawns it until only one remains.
- Named or tamed mobs are automatically separated from their group.
- Named mobs, tamed animals, Solea NPCs, and minibosses are excluded from compression.
- Mobs are only considered during their initial spawn and are not compressed after moving between chunks.

### Configuration Command

- `/solea edit mobscompression number <2-999>`

## Trade Improvements

- Completely reworked the player trading interface.
- The requesting player is always displayed on the left.
- Both players can offer items and money.
- Added player heads to clearly identify each side.
- Added secure confirmation controls.
- Editing an offer resets both confirmations.
- Closing or cancelling a trade safely returns every offered item.
- Improved transaction validation for inventory space and money balances.

## TPA Fixes

- Fixed cross-dimension TPA synchronization.
- Fixed unsafe teleportation in dimensions such as The End.
- Players are now teleported directly onto or safely near the target player.
- Teleportation is cancelled when no safe destination can be found.
- Velocity and fall distance are reset after teleportation.

## Interface and Command Fixes

- Fixed custom GUI buttons recentering the mouse cursor after clicking.
- Fixed Admin Shop quantity controls reopening the interface.
- Fixed command messages such as `/solea help` sometimes not appearing correctly.
- Improved command feedback and translation consistency.

## Technical Improvements

- Improved mob compression stability during simultaneous spawns.
- Fixed duplicate UUID issues preventing compressed mobs from respawning.
- Added persistent protection against compression after chunk reloads.
- Updated the shared project coordination rules to prevent regressions.