TempPortals
- By
A shared TempMods library providing advanced seamless portal rendering, traversal, collision, and custom portal systems.
# TempPortals
**English**
**TempPortals** is an advanced portal engine and shared library for the **TempMods** ecosystem.
It provides reusable systems for creating, rendering and interacting with seamless portals, allowing different TempMods projects to use the same portal technology without implementing their own portal engine from scratch.
TempPortals is developed as a **fork of Immersive Portals**, with its portal systems modified and expanded for the needs of TempMods projects.
---
**Features**
TempPortals provides the core systems required for advanced portal mechanics:
- **Seamless portal traversal**
- **See-through portals**
- **Custom portal shapes**
- Portals placed on **walls, floors and ceilings**
- Correct player and entity interaction with portal openings
- Portal-aware collision handling
- Entity and item traversal
- Projectile interaction through portals
- Portal-to-portal position and rotation transformations
- Cross-dimensional portal connections
- Custom portal placement and manipulation
- Reusable portal systems and API functionality for TempMods projects
Instead of behaving like simple teleport triggers, TempPortals portals are designed to function like actual openings connecting two locations.
The engine distinguishes between the portal opening and the surrounding surface, allowing players, entities and other objects to interact with portal edges more naturally.
---
**TempMods Library**
TempPortals is primarily developed as a shared technical library for **TempMods** projects.
Instead of implementing separate portal systems in every mod, TempMods projects can use TempPortals as a common portal engine.
Individual mods can still control things such as:
- Portal appearance
- Portal size and shape
- Placement behavior
- Destinations
- Activation rules
- Traversal behavior
- Portal-specific gameplay mechanics
Different TempMods projects can use only the parts of the engine they require.
---
**Mods Using TempPortals**
One of the projects powered by TempPortals is:
**RiM – Reality is More**
RiM uses TempPortals as the foundation for its advanced portal technology and portal-based devices.
TempPortals is not limited to RiM and may also be used by other TempMods projects.
---
**For Players**
TempPortals is primarily a **library mod**.
If another mod lists TempPortals as a required dependency, install the compatible version of TempPortals alongside that mod.
In most cases, players do not need to configure TempPortals separately.
Always check the dependency and version information of the mod you are installing.
---
**For Developers**
TempPortals is designed as a reusable portal framework rather than a collection of hardcoded portal types.
It provides a common technical foundation for TempMods projects that require advanced portal functionality while allowing each project to implement its own gameplay logic on top of the engine.
Development focuses on systems such as:
- Portal geometry
- Rendering
- Traversal
- Collision
- Coordinate transformations
- Entity interaction
- Portal orientation
- Destination handling
- Portal lifecycle management
The library and its API may continue to expand as new TempMods projects require additional portal functionality.
---
**Dependencies**
**Required:**
- **Cloth Config API**
Other requirements may vary depending on the Minecraft version and mod loader.
Always check the dependency information for the specific TempPortals release you are installing.
---
**Fork Notice**
TempPortals is based on and developed as a **fork of Immersive Portals**.
The project uses Immersive Portals as its original technical foundation while introducing TempMods-specific changes, modifications and additional development.
TempPortals is maintained as a separate project for use throughout the TempMods ecosystem.
**Immersive Portals and its original development belong to their respective authors and contributors.**
---
**Compatibility**
Supported Minecraft versions, mod loaders and dependencies may vary between releases.
Check the information provided for each TempPortals file before installing.
---
**TempPortals**
*Shared portal technology for TempMods.*
---
# Русский
**TempPortals** — это продвинутый движок порталов и общая библиотека для экосистемы **TempMods**.
Она предоставляет переиспользуемые системы для создания, рендеринга и взаимодействия с бесшовными порталами, позволяя разным проектам TempMods использовать одну общую портальную технологию без необходимости создавать собственный движок порталов с нуля.
TempPortals разрабатывается как **форк Immersive Portals**, портальные системы которого изменяются, дорабатываются и расширяются под нужды проектов TempMods.
---
**Возможности**
TempPortals предоставляет основные системы, необходимые для реализации продвинутой портальной механики:
- **Бесшовное прохождение через порталы**
- **Сквозное отображение пространства по другую сторону**
- **Порталы произвольной формы**
- Размещение порталов на **стенах, полу и потолке**
- Корректное взаимодействие игроков и сущностей с отверстием портала
- Система коллизий, учитывающая форму портала
- Прохождение сущностей и предметов
- Взаимодействие снарядов через порталы
- Преобразование позиции и поворота между связанными порталами
- Соединение между измерениями
- Продвинутое размещение и управление порталами
- Переиспользуемые портальные системы и API для проектов TempMods
Вместо работы как обычные триггеры телепортации порталы TempPortals предназначены для поведения, максимально похожего на реальные отверстия, соединяющие две точки пространства.
Движок различает фактическое отверстие портала и окружающую поверхность, благодаря чему игроки, сущности и другие объекты могут естественнее взаимодействовать с его краями.
---
**Библиотека TempMods**
TempPortals в первую очередь разрабатывается как общая техническая библиотека для проектов **TempMods**.
Вместо создания отдельной портальной системы для каждого мода проекты TempMods могут использовать TempPortals как единый портальный движок.
При этом каждый мод может самостоятельно управлять такими параметрами, как:
- Внешний вид портала
- Размер и форма
- Способ размещения
- Точка назначения
- Условия активации
- Поведение при прохождении
- Уникальные игровые механики
Каждый проект TempMods может использовать только необходимые ему части движка.
---
**Моды, использующие TempPortals**
Одним из проектов, использующих TempPortals, является:
**RiM – Reality is More**
RiM использует TempPortals как основу для своей продвинутой портальной технологии и связанных с порталами устройств.
При этом TempPortals не ограничен RiM и может использоваться другими проектами TempMods.
---
**Для игроков**
TempPortals в первую очередь является **модом-библиотекой**.
Если другой мод указывает TempPortals в качестве обязательной зависимости, установите совместимую версию TempPortals вместе с ним.
В большинстве случаев отдельная настройка TempPortals со стороны игрока не требуется.
Перед установкой рекомендуется проверить зависимости и совместимость версий.
---
**Для разработчиков**
TempPortals разрабатывается как переиспользуемый портальный фреймворк, а не как набор жёстко заданных типов порталов.
Он предоставляет общую техническую основу для проектов TempMods, которым необходима продвинутая портальная функциональность, при этом позволяя каждому проекту реализовывать собственную игровую логику поверх движка.
Разработка сосредоточена на таких системах, как:
- Геометрия порталов
- Рендеринг
- Прохождение через порталы
- Коллизии
- Преобразование координат
- Взаимодействие с сущностями
- Ориентация порталов
- Обработка точек назначения
- Управление жизненным циклом порталов
Библиотека и её API могут продолжать расширяться по мере появления новых требований у проектов TempMods.
---
**Зависимости**
**Обязательные:**
- **Cloth Config API**
Дополнительные требования могут отличаться в зависимости от версии Minecraft и загрузчика модов.
Перед установкой рекомендуется проверить зависимости конкретной версии TempPortals.
---
**Информация о форке**
TempPortals основан на **Immersive Portals** и разрабатывается как его форк.
Проект использует Immersive Portals в качестве исходной технической основы, добавляя собственные изменения, переработки и дополнительную функциональность для экосистемы TempMods.
TempPortals развивается как отдельный проект для использования в модах TempMods.
**Immersive Portals и исходная разработка проекта принадлежат их соответствующим авторам и участникам.**
---
**Совместимость**
Поддерживаемые версии Minecraft, загрузчики модов и зависимости могут отличаться между релизами.
Перед установкой проверяйте информацию на странице конкретного файла TempPortals.
---
**TempPortals**
*Общая портальная технология для TempMods.*
TempPortals Team
