Gateways to Eternity

Introduction to the World of Portals

Gateways to Eternity is a unique mod that allows you to summon massive portals from which waves of enemies emerge. Each subsequent wave becomes more challenging and dangerous than the previous one. For successfully completing waves, you receive valuable rewards, and for finishing the entire portal - a special bonus.

Starting Your Journey

To begin your adventure, you'll need to craft a Gate Pearl - a special item for summoning portals. For example, the recipe for creating the Gateway of Overworldian Nights looks like this:

All available pearl recipes are displayed in JEI.

Studying Gate Pearls

Each Gate Pearl contains complete information about the upcoming challenge. In the item's tooltip, you'll find data about the number of waves, types of creatures in each wave, and expected rewards.

Wave Information

The wave display system allows you to view information about each wave separately, switching between them with the mouse wheel. Each wave includes:

• Enemies - mobs that will appear in this wave
• Modifiers - bonuses applied to all wave enemies
• Rewards - items you'll receive after completing the wave

Main Rewards

After fully completing the portal, you receive special bonus rewards in addition to the already collected wave rewards. These special rewards are always displayed in the Gate Pearl's tooltip.

Reward System Features

Some rewards are generated through loot tables rather than providing specific items. During generation, player characteristics are taken into account, including luck, looting, and other similar modifiers. It's recommended to hold a weapon with the "Looting" enchantment during wave completions and portal closure to maximize obtained resources.

Portal Mechanics

Before using a Gate Pearl, it's useful to familiarize yourself with the basic principles of portal operation.

Portal Rules

Portal functioning is regulated by a set of rules:

• Spawn Range: Distance in blocks from portal edges where mobs can appear (default: 8)
• Leash Range: Maximum distance from portal center that wave creatures can travel (default: 32)
• Count Discarded: Whether to count creatures marked as discarded as destroyed (default: no)
• Count Dimension Changes: Whether to count creatures that changed dimensions as destroyed (default: no)
• Player Damage Only: Whether wave creatures can only take damage from players (default: no)
• Remove on Failure: Whether to remove wave creatures upon unsuccessful portal completion (default: yes)
• Failure on Boundary Violation: Whether to complete the portal upon boundary violations, or reposition the creature (default: no)
• Distance Between Portals: Minimum distance between portals (default: 0)

Any deviations from standard rules are indicated in the Gate Pearl's tooltip.

Endless Portals

Some portals are endless and don't complete naturally. They can be recognized by a special marker in the tooltip:

Instead of standard wave definitions, you'll see a Base Wave and one or more Endless Modifiers that determine how the portal's difficulty changes over time. These portals become increasingly challenging but can provide infinite rewards if maintained long enough.

Summoning a Portal

While holding a Gate Pearl, right-click on a block to summon a portal. For proper portal operation, significant free space is required - don't use it in enclosed areas! Even with successful summoning, if the portal cannot create creatures for the wave, it will disappear with a lightning flash. Successful portal opening looks like this:

Completing a Wave

To complete a wave, you must destroy all enemies before time runs out. The number of remaining enemies is displayed on the boss bar at the top of the screen along with the current wave number and timer. When time expires, the portal disappears with a lightning flash, similar to the case of inability to create creatures.

After successfully completing a wave, a short break period begins before the next wave, and Wave Rewards emerge from the portal:

Closing the Portal

The only safe way to close a portal is to successfully complete all waves. After completing the final wave, wave rewards appear, and then the portal closes, creating Completion Rewards in its place. These rewards appear simultaneously as a powerful burst of loot and experience, unlike the gradual appearance of wave rewards.

Creating Custom Portals

For modpack developers, complete portal customization is available! Every aspect of a portal is defined through JSON files that can be modified using datapacks. Source data files are available in the project repository, and the JSON schema is documented.

Through customization, you can create any types of portals, fully defining all creatures in each wave, including specifying NBT data. All possibilities are at your disposal.