ВЕРСИИ (14)

# MR Portal 2.3 Changelog MR-Portal 2.3 is mainly an internal API/service-layer update that prepares the base mod for external teleport-style addons while preserving normal MR-Portal behavior. ## Main Changes - Added public teleport handler API. - Added `MRPortalApi`. - Added `MRPortalTeleportHandler`. - Added `MRPortalTeleportContext`. - Added `MRPortalWaypointView`. - Added `MRPortalTeleportActivator`. - Added handler registration and active handler selection by priority. - Added the default built-in handler for normal MR-Portal portal behavior. - Routed GUI waypoint teleport requests through the new service/API path. - Routed quick favorite teleport requests through the new service/API path. - Preserved payment, cooldown, and resource validation in the base mod. - Preserved regular staff pearl cost and cooldown. - Preserved Teleport Scroll consumption behavior. - Preserved Infinite Portal Staff no-cost behavior. - Preserved same-dimension restrictions for regular staff and scroll. - Added handler-controlled default preview spark hook through `usesDefaultPreviewSpark()`. - The default handler keeps normal preview spark behavior. - Addon handlers can opt out of base preview spark visuals. ## Fixes And Validation Highlights - Fixed the GUI Teleport Scroll consumption route by making scroll/staff GUI mode server-owned. - Fixed a quick favorite regular staff payment regression when a scroll was also present. - Verified GUI staff and scroll behavior manually. - Verified quick favorite staff and scroll behavior manually. - Verified preview spark open and cleanup behavior manually. - Removed temporary `[MRP07F]` diagnostic logs. ## Addon Support - This update does not bundle Chrono Portal. - It prepares the base mod for separate addons such as Chrono Portal. - MR-Portal does not hardcode Chrono. - Chrono should be a separate jar installed alongside MR-Portal. ## Developer Notes - The base mod owns validation, payment, cooldown, and resource checks. - Handlers own teleport execution style after validation. - `usesDefaultPreviewSpark()` controls only default preview visuals, not payment or session execution. - The default handler remains payment-free internally; payment is handled before handler execution. ## Known Notes - Portal Staff cooldown disappearing after rejoin remains legacy vanilla cooldown behavior. - Addon handler runtime validation is future work. - Chrono implementation is separate/future. ## Dependencies And Build - Fabric 1.20.1. - Java 17 target. - Java 21 Gradle runtime used in this workspace. - Build validated with: ```bash JAVA_HOME=/usr/lib/jvm/java-21-openjdk ./gradlew compileJava JAVA_HOME=/usr/lib/jvm/java-21-openjdk ./gradlew compileClientJava ```

# Changelog 2.2.0 ## Changes - **New mod display name**: The mod has been renamed to `Mentalitys | MR Portal`. - Name updated in Fabric metadata, the configuration screen title, the binds category, the item tab title, and both READMEs. ## Changed files - src/main/resources/fabric.mod.json - src/client/java/com/mentality/mrportal/client/config/MRPortalConfigScreen.java - src/main/resources/assets/mr_portal/lang/en_us.json - src/main/resources/assets/mr_portal/lang/ru_ru.json - gradle.properties - readme.md - readme_en.md

# Changelog 2.1.0 ## Fixes - **Clicking on the favorites star now simultaneously selects the marker**: Clicking on the star immediately sets the marker as the currently selected marker, as if the player had clicked the teleport line itself. - **Removed unnecessary text about favorites in the right GUI panel**: The message indicating whether a marker is a favorite is no longer displayed—it's already clear from the star in the list. - **Portal remains passable for other entities until it actually closes**: Checking the owner's position no longer blocks passage through an already open portal for other entities and players. While the portal is visually open, other entities can enter it for the rest of its life. ## Technical Changes - `WaypointScreen.mouseClicked()` now first selects the marker and then switches favorites when clicking on the star. - Added an update to the local selection status in `WaypointScreen.toggleFavorite()` so that the GUI immediately behaves as if a label was selected normally. - Separated the logic for the owner's progress through the portal from the logic for other entities in `PendingTeleportManager.tickInternal()`: the absence of the owner in the source dimension no longer interrupts processing of other entities. ## Changed files - src/client/java/com/mentality/mrportal/client/screen/WaypointScreen.java - src/main/java/com/mentality/mrportal/portal/PendingTeleportManager.java - gradle.properties - readme.md - readme_en.md

# Changelog 2.0.0 ## New Features - **Favorite Star Directly in the List**: The favorite marker toggle has been moved to the beginning of the teleport point line. An empty star, `☆`, is now used for a regular point, and a yellow filled star, `★`, is used for a favorite point. - **Fast Favorite Portal Delay**: The fast favorite portal bind no longer opens the portal instantly. By default, 30 ticks (1.5 seconds) pass, during which sparks are visible in the center of the future portal, and only then does the portal begin opening. - **Custom Exit Portal Offset**: The new `portalExitBehindDistance` parameter (default 0.2) controls how far behind the player the destination portal appears after a teleport. - **Customizable Quick Favorite Portal DelayTicks**: The new `quickFavoritePortalDelayTicks` parameter (default 30) controls the delay before the portal starts opening after pressing the quick bind. ## Fixes - **Extra Sound at Exit Portal**: The destination portal no longer plays an opening sound when appearing after a teleport. - **Interdimensional Markers for Common Items**: For the common staff and scroll, the selection screen and teleport logic are now limited to markers in the current dimension. The Infinite Staff can still work between dimensions. - **Favorite Quick Bind and Other Dimensions**: If the favorite marker is in another dimension, the quick bind now correctly displays a limitation message instead of attempting to open the portal with a common item. ## Technical Changes - `PendingTeleportManager` has received a `PendingFavoriteActivation` queue for delayed opening of a favorite portal with pre-sparks. - `PortalSession` has been extended with a separate `destinationExitPos` exit point, allowing the visual portal to be moved back without moving the player's spawn point. - The `playChime` and `playOpenSound` flags have been added to the portal creation network packets to separately control the appearance sounds of the source and output portals. - `sendWaypointScreen()` now filters the list of markers by the current dimension if the player does not have creative access to inter-world portals. ## Changed files - src/main/java/com/mentality/mrportal/config/MRPortalConfig.java - src/main/java/com/mentality/mrportal/network/MRPortalNetworking.java - src/main/java/com/mentality/mrportal/portal/PendingTeleportManager.java - src/main/java/com/mentality/mrportal/portal/PortalSession.java - src/client/java/com/mentality/mrportal/client/config/MRPortalConfigScreen.java - src/client/java/com/mentality/mrportal/client/render/ClientPortalEffectManager.java - src/client/java/com/mentality/mrportal/client/screen/MRPortalClientNetworking.java - src/client/java/com/mentality/mrportal/client/screen/WaypointScreen.java - src/main/resources/assets/mr_portal/lang/en_us.json - src/main/resources/assets/mr_portal/lang/ru_ru.json - gradle.properties

# Changelog 1.9.0 ## Fixes - **Portal Hitbox Too Large**: Teleportation no longer triggers early when simply approaching. The entry check has been rewritten from a large cylinder around the portal's center to an intersection with the portal's thin plane, taking into account the yaw rotation. - **Staff in Inventory**: The staff search logic now considers not only hands but also the inventory, making the binding behavior more consistent. ## New Features - **Favorite Marker**: You can now mark a single teleport point as a favorite. The favorite point is saved on the server, highlighted with a star in the list, and displayed in the sidebar. - **Quick Portal to Favorite Point**: A second configurable bind has been added. The default key is the 'ё' key (the same physical keycode as the grave accent). - **Quick Open Item Priority**: When activating a quick portal, the following order is used: infinite staff, regular staff, teleport scroll. ## Behavior - If the favorite waypoint is in another dimension, the quick bind will only work if the player has an infinite staff or creative access. - If the favorite waypoint is not selected, the player receives a separate message about it. ## Technical Changes - `WaypointData` has been expanded with the `favorite` flag, serialization to NBT, network buffer, and server JSON storage have been updated. - `ServerWaypointStore` has been updated with the `setFavoriteWaypoint`, `clearFavoriteWaypoint`, and `getFavoriteWaypoint` methods. - `MRPortalNetworking` has been updated with new packages: `set_favorite_waypoint` and `quick_teleport_by_keybind`. - In `PendingTeleportManager`, portal hit checking now uses the entity's AABB, portal plane, and bounded thickness instead of a circular zone with no direction. ## Changed files - src/main/java/com/mentality/mrportal/portal/PendingTeleportManager.java - src/main/java/com/mentality/mrportal/network/MRPortalNetworking.java - src/main/java/com/mentality/mrportal/waypoint/WaypointData.java - src/main/java/com/mentality/mrportal/waypoint/ServerWaypointStore.java - src/client/java/com/mentality/mrportal/MRPortalClient.java - src/client/java/com/mentality/mrportal/client/screen/MRPortalClientNetworking.java - src/client/java/com/mentality/mrportal/client/screen/WaypointScreen.java - src/main/resources/assets/mr_portal/lang/en_us.json - src/main/resources/assets/mr_portal/lang/ru_ru.json - gradle.properties

# Changelog 1.8.0 ## New Features - **Customizable Portal Vertical Offset**: The new `portalVerticalOffset` parameter (default 0.0) allows you to raise or lower the portal relative to its default position. Range: -2.0 to 5.0. - **Portal Animation Speed**: The new `portalAnimationSpeed` parameter (default 1.0) is a multiplier for the opening and closing speed of the portal. 2.0 = twice as fast, 0.5 = half as slow. Range: 0.1 to 5.0. ## Fixes - **Mod language setting changed the entire Minecraft interface**: Previously, selecting a language in the mod settings (`en` / `ru`) changed the global Minecraft language and reloaded all resources. Now the mod language works completely independently – it only affects the mod's text (GUI, tooltips, messages), without affecting the rest of the game interface. ## Updated default values - `portalActiveTicks`: 60 → 100 - `portalScale`: 1.2 → 1.5 - `portalSpawnDistance`: 2.0 → 2.2 ## Optimizations - Configuration is cached in local variables when processing network packets instead of repeatedly calling `MRPortalConfigManager.get()`. ## Technical changes - Created a utility class `ModTranslation` (`com.mentality.mrportal.util`), which loads mod translation files from resources and provides a `get(key, args...)` method. In `auto` mode, it returns `Component.translatable()`; in `en`/`ru` mode, it returns `Component.literal()` with the substituted translation. - All calls to `Component.translatable()` in mod GUIs and messages have been replaced with `ModTranslation.get()`: WaypointScreen, MRPortalConfigScreen, PendingTeleportManager, MRPortalNetworking, PortalStaffItem, TeleportScrollItem. - The `applyLanguage()` method has been removed from `MRPortalConfigScreen`, which called `minecraft.getLanguageManager().setSelected()` and `reloadResourcePacks()`. - The `VERTICAL_PORTAL_OFFSET` constant in `PendingTeleportManager` has been replaced with the dynamic `verticalOffset(config)` method, which takes `portalVerticalOffset` from the config into account. - Animation speed (`animSpeed`) is transmitted via portal creation network packets to the client, where it scales `SPARK_DURATION` and `CLOSE_DURATION`. ## Changed files - src/main/java/com/mentality/mrportal/config/MRPortalConfig.java - src/main/java/com/mentality/mrportal/portal/PendingTeleportManager.java - src/main/java/com/mentality/mrportal/network/MRPortalNetworking.java - src/main/java/com/mentality/mrportal/item/PortalStaffItem.java - src/main/java/com/mentality/mrportal/item/TeleportScrollItem.java - src/client/java/com/mentality/mrportal/client/render/ClientPortalEffectManager.java - src/client/java/com/mentality/mrportal/client/network/MRPortalClientNetworking.java - src/client/java/com/mentality/mrportal/client/screen/MRPortalConfigScreen.java - src/client/java/com/mentality/mrportal/client/screen/WaypointScreen.java - src/main/resources/assets/mr_portal/lang/en_us.json - src/main/resources/assets/mr_portal/lang/ru_ru.json - gradle.properties ## New files - src/main/java/com/mentality/mrportal/util/ModTranslation.java

# Changelog 1.7hotfix ## Fixes - **The portal was spawning at the player's position instead of in front of them**: The portal source (`sourcePos` in `startSession()`) was calculated using `player.position()` instead of `calculateSourcePortalCenter()`. The portal now always spawns at `portalSpawnDistance` (default 2 blocks) in front of the player—for both staffs and scrolls. - **The portal was sinking into the ground**: `VERTICAL_PORTAL_OFFSET` was equal to `(0, 1.0, 0)`, causing the bottom edge of the portal (with a height of 1.34 blocks) to be 0.34 blocks below the surface. Now the offset is `BASE_PORTAL_HALF_HEIGHT` (1.34), and the portal is level with the ground. - **The teleport scroll worked differently than the staff**: The portal from the scroll now creates with the same distance and behavior as from a regular staff. ## New Features - **Automatic Recipe Unlocking**: Upon receiving any recipe ingredient (obsidian, eye of ender, nether star for the staff; ender pearl, paper for the scroll), the recipe automatically appears in the crafting book. ## Technical Changes - PendingTeleportManager: `startSession()` now uses `calculateSourcePortalCenter(player, config)` instead of `player.position()`. The `VERTICAL_PORTAL_OFFSET` constant has been changed from `(0, 1.0, 0)` to `(0, BASE_PORTAL_HALF_HEIGHT, 0)`. - Added advancements for unlocking recipes: `data/mr_portal/advancements/recipes/misc/portal_staff.json` and `teleport_scroll.json`. ## Changed files - src/main/java/com/mentality/mrportal/portal/PendingTeleportManager.java - gradle.properties ## New files - src/main/resources/data/mr_portal/advancements/recipes/misc/portal_staff.json - src/main/resources/data/mr_portal/advancements/recipes/misc/teleport_scroll.json

# Changelog 1.6.0 ## New Features - **Teleportation of mobs and other players**: Any entity (mobs, animals, other players) entering an active portal is teleported to the destination. The portal now works for everyone, not just the owner. This works both on the server and in single-player. - **Preview spark visible to other players**: When a player opens the point selection screen and a spark appears, other players nearby (64 blocks) also see it. The spark disappears when the screen is closed or when teleported. ## Technical Changes - PendingTeleportManager: Added the `teleportNearbyEntities()` method — scans the portal's AABB zones and teleports all entities other than the owner through the portal. Tracking of already teleported entities is now possible via `Map<UUID, Set<UUID>> teleportedEntities`. - MRPortalNetworking: Added `PREVIEW_SPARK_S2C`, `PREVIEW_SPARK_REMOVE_S2C`, `SCREEN_CLOSED_C2S` packages. Server-side tracking of active sparks via `activePreviewSparks`/`activePreviewDimensions`. `broadcastPreviewSpark()` and `removePreviewSpark()` methods. - ClientPortalEffectManager: Added `remoteSparks` map for displaying sparks from other players. `showRemoteSpark()` and `hideRemoteSpark()` methods. Render and tick remote sparks. - MRPortalClientNetworking: PREVIEW_SPARK_S2C and PREVIEW_SPARK_REMOVE_S2C handlers. `sendScreenClosed()` method. - WaypointScreen: When the screen closes, sends `SCREEN_CLOSED_C2S` to the server. - fabric.mod.json: updated source code link → https://github.com/sapexzzz/MR-portal ## Changed files - src/main/java/com/mentality/mrportal/portal/PendingTeleportManager.java - src/main/java/com/mentality/mrportal/network/MRPortalNetworking.java - src/client/java/com/mentality/mrportal/client/render/ClientPortalEffectManager.java - src/client/java/com/mentality/mrportal/client/screen/MRPortalClientNetworking.java - src/client/java/com/mentality/mrportal/client/screen/WaypointScreen.java - src/main/resources/fabric.mod.json - gradle.properties

# Changelog 1.5.0 ## Fixes - The destination portal now appears even when teleporting outside the draw distance. Previously, the PORTAL_CREATE_S2C packet was only sent to players within a 64-block radius of the destination; now, after teleporting, the packet is sent directly to the teleported player with recalculated timings. ## New Features - **Cloth Config API**: All mod settings can be edited directly in-game via ModMenu → MR Portal. The configuration screen contains two categories: "Basic" and "Portal." - **Language Settings**: Added the 'language' option to the config (auto / en / ru). Selecting a specific language applies it to Minecraft and reloads resources. - **ModMenu Integration**: The mod registers the settings screen via the ModMenu API. ## Technical Changes - MRPortalNetworking: Added `sendPortalCreateToPlayer()` and `sendSinglePortalToPlayer()` methods for sending a portal to a specific player after teleporting. - PendingTeleportManager: Call `sendPortalCreateToPlayer()` after `player.teleportTo()`. - MRPortalConfig: Added `language` field with validation in `sanitize()`. - MRPortalConfigScreen (client): Full Cloth Config screen with all parameters. - MRPortalModMenuIntegration (client): ModMenu API entrypoint. - fabric.mod.json: Added `modmenu` entrypoint, `suggests` block for cloth-config and modmenu. - build.gradle: Added Shedaniel and TerraformersMC Maven repositories, cloth-config-fabric and modmenu dependencies. ## New Dependencies - Cloth Config API 11.1.136 (recommended) - ModMenu 7.2.2 (recommended) ## New Files - src/client/java/com/mentality/mrportal/client/config/MRPortalConfigScreen.java - src/client/java/com/mentality/mrportal/client/config/MRPortalModMenuIntegration.java ## Changed Files - src/main/java/com/mentality/mrportal/MRPortalNetworking.java - src/main/java/com/mentality/mrportal/PendingTeleportManager.java - src/main/java/com/mentality/mrportal/MRPortalConfig.java - src/main/resources/fabric.mod.json - src/main/resources/assets/mr_portal/lang/ru_ru.json - src/main/resources/assets/mr_portal/lang/en_us.json - build.gradle - gradle.properties

# Changelog 1.4.0 ## GUI - Completely redesigned waypoint selection interface - Waypoints are now grouped by dimensions with section headers - The player's current dimension is always displayed first in the list - The waypoint name is requested via a modal dialog only when adding a new waypoint - Removed the name input field from the main screen — it no longer gets in the way - Added a "Name" button for renaming existing waypoints - Improved waypoint selection — clickable lines with correct positioning - Added a scrollbar for long waypoint lists - Confirmation dialogs (delete, enter name, rename) overlay the interface with a semi-transparent background ## Portal - The portal now always collapses smoothly at the end of its lifespan, even if no one has accessed it - The server begins closing after the active period (portalOpenDelay + portalActiveTicks) ends, then waits for portalCloseDelayTicks before sending PORTAL_CLOSE - The client-side portal effect receives an increased lifetime (+40 ticks) to ensure smooth shutdown on server command ## Network - Added RENAME_WAYPOINT_C2S package for waypoint renaming - The server normalizes the name when renaming (trim, 32-character limit, fallback to autoname) ## Storage - ServerWaypointStore: Added renameWaypoint method for updating waypoint names by UUID ## Localization - Added keys: screen.mr_portal.rename, screen.mr_portal.rename_title, screen.mr_portal.dialog_ok, screen.mr_portal.dialog_cancel - Updated both localization files (ru_ru.json, en_us.json) ## Other - Updated version to 1.4.0 - Updated readme.md and readme_en.md

# MR Portal 1.3 Date: 2026-03-22 ## Changed - Mod version updated to 1.3.0 - After entering the portal, it no longer disappears instantly - By default, the portal lasts 3 seconds after teleporting and only then begins to smoothly collapse - Added the portalCloseDelayTicks parameter to control this delay - Spark has been switched to white particles only - The teleport button now automatically disables if resources are low - The standard staff tooltip now shows "Charged" instead of "0" cooldown - The GUI has been redesigned for a neater layout without text spilling beyond the panel boundaries ## Added - Ability to set a custom name for a new waypoint before saving - Persistent enchanted-glint for both staves - White particles around the staves when equipped - New changelog for version 1.3 ## Config 1.3.0 - cooldownSeconds = 60 - maxWaypoints = 10 - portalOpenDelay = 60 - portalActiveTicks = 60 - portalCloseDelayTicks = 60 - portalPearlCost = 3 - applyBlindnessOnTeleport = true - blindnessDuration = 40 - portalScale = 1.2 - portalSpawnDistance = 2.0

# MR Portal 1.2 Date: 2026-03-22 ## Changed - Mod version updated to 1.2.0 - The standard staff now uses a fixed teleport cost instead of a distance-based one - Teleport cost with a standard staff moved to the config via portalPearlCost - Added the ability to disable blindness after teleporting via applyBlindnessOnTeleport - The GUI has been redesigned and made more intuitive: the selected point, resources, and action status are now immediately visible - The preview spark appears immediately after right-clicking the staff and disappears when closing the screen without selecting it - The spark has received a new particle effect - Portal collapse after teleporting has been preserved and synchronized with the new spark ## Added - New changelog for version 1.2 - Updated README in Russian and English ## Config 1.2.0 - cooldownSeconds = 60 - maxWaypoints = 10 - portalOpenDelay = 60 - portalActiveTicks = 60 - portalPearlCost = 3 - applyBlindnessOnTeleport = true - blindnessDuration = 40 - portalScale = 1.2 - portalSpawnDistance = 2.0

# MR Portal 1.1 Date: 2026-03-22 ## Changed - Mod version updated to 1.1.0 - The waypoint screen no longer pauses the game in single-player worlds - The Black Portal has been enlarged and moved to a separate config setting - The portal source now appears in front of the player, not at their position - The source portal spawn distance has been moved to a config setting - The default portal opening timing has been changed to 60 ticks - The default portal open duration has been changed to 60 ticks - The spark now appears in the exact center of the portal at both the start and arrival point - The portal now closes by collapsing back to its point - The portal rendering has been made static in the world and is no longer tied to camera movement ## Added - New portalActiveTicks parameter - New portalScale parameter - New portalSpawnDistance parameter - Russian and English README ## Config 1.1.0 - cooldownSeconds = 60 - maxWaypoints = 10 - portalOpenDelay = 60 - portalActiveTicks = 60 - blindnessDuration = 40 - portalScale = 1.2 - portalSpawnDistance = 2.0

# MR Portal 1.0 Date: 2026-03-22 ## Added - Fabric 1.20.1 base mod with MR Portal items - Regular and infinite portal staff - Personal waypoints saved on the server - GUI for selecting, adding, and deleting waypoints - Waypoint limitation per player - C2S and S2C network packets for teleportation and effects - White spark and black portal on the client - Teleportation through the portal entrance - Blindness during transfer - Regular staff crafting - RU and EN localization ## Default - Staff cooldown: 60 seconds - Waypoint limit: 10 - Portal opening: 40 ticks - Blindness: 40 ticks