SOLEA API

# SOLEA API 26.5 This release fixes a critical RTP issue related to worldborder safety. ## Fixed - `/rtp` no longer uses the player's current position as the center of the random teleport range. - RTP coordinates are now generated from the world origin: `0,0`. - The effective RTP radius is now clamped to the current worldborder. - This prevents players near the worldborder from being teleported too far outside the safe playable area. - RTP still searches for a safe standing position before teleporting. ## Technical - Updated the mod version to `26.5`. - Added project safeguards so future RTP changes keep the origin-centered behavior and worldborder protection.

# 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.

# Fixes: The previous update, 26.3.2, was designated as a beta because it contained major bugs that prevented it from being released as an official version. - Text display fixes - Fixed mouse cursor repositioning upon click

# Fixed bugs - It wasn't possible to add money during a /trade ## Improvement - Dynamic cooldown during teleportation

# New Features and Fixes - Add auto-heal to admin claims and, by default, to the Safe Zone - Fix for /trade not working properly - The Shop wasn't working properly this time—is it down? - Various other corrections have been made

# Bug Fixes & New Features - Fixed a bug that prevented players from typing in chat - Fixed a bug that caused NPCs to duplicate - Added /trade - Can be disabled - Added /shop: Admin Shop configurable by admins via /solea edit adminshop

# SOLEA API 26.2 **Minecraft 1.21.1 · NeoForge** Release focused on **economy**, **auction house (HDV)**, and **NPC shop** improvements. **EN/FR** included. --- ## Economy (Money) ### Player Commands - **`/money`** — displays your balance - **`/pay <player> <amount>`** — transfer between players (amount required, tax configurable) - **`/baltop`** — ranking of the richest players ### Admin Commands - **`/money give|set|remove|view <player> [amount]`** ### GameRule - **`/gamerule moneysystem true|false`** — enables/disables the entire money system (default: `false`) - When disabled: money commands, monetary event rewards, monetary NPC shops, and **`/ah`** are blocked ### `soleaapi-money.toml` config - Provider **`internal`** (Solea balance in SavedData) or **`command`** (delegation via configurable console commands) - Symbol, starting balance, cap, min/max pay, tax, cooldown, baltop size - Command templates for external economies (`{player}`, `{amount}`, `{target}`) ### Events - Configurable **money** rewards (global + event-specific overrides) in the `/events` menus ### API & placeholders - **`SoleaApiFacade`**: `getBalance`, `deposit`, `withdraw`, `isMoneyEnabled` - Placeholders **`{money}`** and **`{money_formatted}`** --- ## Auction House ### Commands - **`/ah`** — main menu: browse, buy, sell - **`/ah sell`** — shortcut to the sell screen ### How it works - Sales **are for currency only** (no item-for-item trades) - One-click purchase on a listing - **My Listings**: cancel and retrieve the item - Price entered in **chat** (e.g., `5000`, `250k`, `1.5m`) — handy for large amounts - Sort: recent / price ↑ / price ↓ - Sales tax, listing limit per player, expired items returned to the seller (queue upon login if inventory is full) ### `soleaapi-ah.toml` configuration - `maxListingsPerPlayer`, `listingExpireMinutes`, `taxPercent`, `minPrice`, `maxPrice`, `pageSize` ### Admin runtime - **`/solea edit ah expiretime <minutes>`** — listing duration - **`/solea edit ah expiretime off`** — no expiration - **`/solea edit ah expiretime info`** — current value --- ## NPC — currency shops & trade editor ### Trade types - **Item ↔ Item** — standard trade (vanilla MerchantMenu) - **Purchase ($)** — the player pays money, receives the item - **Sale ($)** — the player gives the item, receives money ### Trade Editor (Redesign) - 6-line menu with self-explanatory buttons (Item / Buy / Sell) - **Empty item slots** for placing your items (no more collectible windows) - Enter money amounts in **chat** (click on gold bar) - Trade list: **left-click = edit**, **right-click = delete** - Detailed trade information (type, price, summary) --- ## Fixes - Client startup crash: money config loading moved to `ModConfigEvent` (no longer in common setup) - HDV: your own listings visible in `/ah` (marked “Your listing”) - GUI: decorative panes are not collectible; item slots are actually empty --- ## Requirements - **Minecraft** 1.21.1 - **NeoForge** 21.1+ - **JDK 21** (server) Install on the **server** for full functionality. Client optional (hybrid). --- ## Quick help `/solea help` — list of player & admin commands `/gamerule moneysystem true` — enable the economy before `/money`, `/pay`, `/ah`

# SOLEA API 26.1 — 1.21.1 NeoForge Server utility mod: homes, warps, TPA, teams, moderation, combat-log, and staff tools. **English & French.** ## New in 26.1 **Combat-log** — Action-bar countdown; red glow outline while in PvP combat. **Staff (OP 4)** — `/vanish`, `/god`, `/fly`, `/sudo`, `/near`, `/listvanished`, `/hat`, `/head <name>` (any player, e.g. Notch), `/top` **World** — `/day`, `/night`, `/end`, `/nether` (scaled cross-dimension teleport) **Fixes** — Vanish inventory/pickup fixed; vanilla-style fake join/leave messages Use `/solea help` in-game for the full command list. **Requires:** Minecraft 1.21.1, NeoForge 21.1+. Install on the **server** for all features.

## Changelog `26.0.1Beta` ### Fixed - Teleport cooldown behavior corrected and stabilized across teleport commands. - Team command access fixed so players can use `/team` correctly. - Freeze/unfreeze responsiveness improved (reduced delay, more immediate effect). - `/invsee` now supports direct live interaction with the target inventory. - `/echestsee` now properly syncs in real time with the target Ender Chest. - RTP performance and reliability improved: - reduced lag spikes/freezes, - safer position search, - better success rate for valid location detection (including flat worlds).