![Portalist's Toolkit](https://cdn.modrinth.com/data/cached_images/6ff4f767781855d5691b982c7d346640b2941d82.png) [![Modrinth](https://img.shields.io/badge/Modrinth-%23555555?style=for-the-badge&logo=modrinth)](https://modrinth.com/) [![Fabric](https://img.shields.io/badge/Fabric-%23555555?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAMAAACdt4HsAAABN2lDQ1BBZG9iZSBSR0IgKDE5OTgpAAAokZWPv0rDUBSHvxtFxaFWCOLgcCdRUGzVwYxJW4ogWKtDkq1JQ5ViEm6uf/oQjm4dXNx9AidHwUHxCXwDxamDQ4QMBYvf9J3fORzOAaNi152GUYbzWKt205Gu58vZF2aYAoBOmKV2q3UAECdxxBjf7wiA10277jTG+38yH6ZKAyNguxtlIYgK0L/SqQYxBMygn2oQD4CpTto1EE9AqZf7G1AKcv8ASsr1fBBfgNlzPR+MOcAMcl8BTB1da4Bakg7UWe9Uy6plWdLuJkEkjweZjs4zuR+HiUoT1dFRF8jvA2AxH2w3HblWtay99X/+PRHX82Vun0cIQCw9F1lBeKEuf1UYO5PrYsdwGQ7vYXpUZLs3cLcBC7dFtlqF8hY8Dn8AwMZP/fNTP8gAAAAbUExURQAAADg0KoB6bZqSfq6mlLyynMa8pdvQtOjo6H4FWGcAAAAJdFJOUwD//////////zcCm9QAAAAJcEhZcwAALiMAAC4jAXilP3YAAAXiaVRYdFhNTDpjb20uYWRvYmUueG1wAAAAAAA8P3hwYWNrZXQgYmVnaW49Iu+7vyIgaWQ9Ilc1TTBNcENlaGlIenJlU3pOVGN6a2M5ZCI/PiA8eDp4bXBtZXRhIHhtbG5zOng9ImFkb2JlOm5zOm1ldGEvIiB4OnhtcHRrPSJBZG9iZSBYTVAgQ29yZSA2LjAtYzAwMiA3OS4xNjQzNTIsIDIwMjAvMDEvMzAtMTU6NTA6MzggICAgICAgICI+IDxyZGY6UkRGIHhtbG5zOnJkZj0iaHR0cDovL3d3dy53My5vcmcvMTk5OS8wMi8yMi1yZGYtc3ludGF4LW5zIyI+IDxyZGY6RGVzY3JpcHRpb24gcmRmOmFib3V0PSIiIHhtbG5zOnhtcD0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wLyIgeG1sbnM6ZGM9Imh0dHA6Ly9wdXJsLm9yZy9kYy9lbGVtZW50cy8xLjEvIiB4bWxuczpwaG90b3Nob3A9Imh0dHA6Ly9ucy5hZG9iZS5jb20vcGhvdG9zaG9wLzEuMC8iIHhtbG5zOnhtcE1NPSJodHRwOi8vbnMuYWRvYmUuY29tL3hhcC8xLjAvbW0vIiB4bWxuczpzdEV2dD0iaHR0cDovL25zLmFkb2JlLmNvbS94YXAvMS4wL3NUeXBlL1Jlc291cmNlRXZlbnQjIiB4bXA6Q3JlYXRvclRvb2w9IkFkb2JlIFBob3Rvc2hvcCAyMS4xIChXaW5kb3dzKSIgeG1wOkNyZWF0ZURhdGU9IjIwMjAtMDYtMDFUMTc6MDY6MzkrMDM6MDAiIHhtcDpNb2RpZnlEYXRlPSIyMDIwLTA2LTAxVDE3OjE4OjQ1KzAzOjAwIiB4bXA6TWV0YWRhdGFEYXRlPSIyMDIwLTA2LTAxVDE3OjE4OjQ1KzAzOjAwIiBkYzpmb3JtYXQ9ImltYWdlL3BuZyIgcGhvdG9zaG9wOkNvbG9yTW9kZT0iMiIgcGhvdG9zaG9wOklDQ1Byb2ZpbGU9IkFkb2JlIFJHQiAoMTk5OCkiIHhtcE1NOkluc3RhbmNlSUQ9InhtcC5paWQ6ZmU5ZjBmZjctMjVlZS03MzRlLWJlMzQtY2EzYjI0MWM5OWQzIiB4bXBNTTpEb2N1bWVudElEPSJ4bXAuZGlkOmUyYmU0ZDAzLTYyYmItYTc0OC1hZjYzLWYwMDQxZDUwNmZkYiIgeG1wTU06T3JpZ2luYWxEb2N1bWVudElEPSJ4bXAuZGlkOmUyYmU0ZDAzLTYyYmItYTc0OC1hZjYzLWYwMDQxZDUwNmZkYiI+IDx4bXBNTTpIaXN0b3J5PiA8cmRmOlNlcT4gPHJkZjpsaSBzdEV2dDphY3Rpb249ImNyZWF0ZWQiIHN0RXZ0Omluc3RhbmNlSUQ9InhtcC5paWQ6ZTJiZTRkMDMtNjJiYi1hNzQ4LWFmNjMtZjAwNDFkNTA2ZmRiIiBzdEV2dDp3aGVuPSIyMDIwLTA2LTAxVDE3OjA2OjM5KzAzOjAwIiBzdEV2dDpzb2Z0d2FyZUFnZW50PSJBZG9iZSBQaG90b3Nob3AgMjEuMSAoV2luZG93cykiLz4gPHJkZjpsaSBzdEV2dDphY3Rpb249InNhdmVkIiBzdEV2dDppbnN0YW5jZUlEPSJ4bXAuaWlkOmZlOWYwZmY3LTI1ZWUtNzM0ZS1iZTM0LWNhM2IyNDFjOTlkMyIgc3RFdnQ6d2hlbj0iMjAyMC0wNi0wMVQxNzoxODo0NSswMzowMCIgc3RFdnQ6c29mdHdhcmVBZ2VudD0iQWRvYmUgUGhvdG9zaG9wIDIxLjEgKFdpbmRvd3MpIiBzdEV2dDpjaGFuZ2VkPSIvIi8+IDwvcmRmOlNlcT4gPC94bXBNTTpIaXN0b3J5PiA8L3JkZjpEZXNjcmlwdGlvbj4gPC9yZGY6UkRGPiA8L3g6eG1wbWV0YT4gPD94cGFja2V0IGVuZD0iciI/Ph7Xp9cAAADhSURBVFiF7ZbNDoQgDIS/orvv/7yEyB7kdwXZA5smxF7AFsd2MsUKQxMA34uaMcC96QPIOPwGsNAmQr8EfYAfSHylc5Yrkfol6AP0SRQ4VWgB9vi1b0nql/AfDgRK/UBBhIlPflIGCwBcSEyXGHAylY9YgqJcjuuXMJWD1D61+Wrn4kl/evRL0AfYw1rpx0dPCnFUb3lW6sY91LiVznoqylpzPL+2lkkgydBiM+vHwTNk9UyK1cRNJvLghr85GegDXK71pCiBdv9NzmABgOZ8YKBoxOVJ7A+awKj+KRksAPABKYwmfSXpKIIAAAAASUVORK5CYII=)](https://fabricmc.net/) ![Minecraft Version 1.20.1](https://img.shields.io/badge/MC%20Version-1.20.1-%2300bb00?style=for-the-badge) ![Thank you for ## downloads](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.modrinth.com%2Fv2%2Fproject%2Fportalists-toolkit&query=downloads&suffix=%20downloads&label=Thank%20you%20for&style=for-the-badge&color=%2300bb00) ![and ## followers!](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.modrinth.com%2Fv2%2Fproject%2Fportalists-toolkit&query=followers&suffix=%20followers!&label=and&style=for-the-badge&color=%23ee0044) # A good Portalist needs only three items. **Harness the power of quantum entanglement and Ender magic to create gateways through space. Use your Redstone knowledge to send and receive remote signals. Tamper with relativity to bend gravity to your advantage. Do it all with Portalist's Toolkit.** ## Mod Requirements * [Immersive Portals](https://modrinth.com/mod/immersiveportals) * [Gravity Changer (qouteall fork)](https://modrinth.com/mod/gravity-api-fork) * [Fabric API](https://modrinth.com/mod/fabric-api) ## The Toolkit ### Entangled Eye of Ender Created by combining two Eyes of Ender with an Amethyst Shard, this is the most essential item in the mod. Every pair of Entangled Eyes of Ender is unique. You can also add an Echo Shard to create an interdimensional bond. ![Entangled Eye of Ender Recipe](https://cdn.modrinth.com/data/cached_images/ff10d1e66c9e4295030ce1711680f4ff46de623f_0.webp) ![Interdimensional Entangled Eye of Ender Recipe](https://cdn.modrinth.com/data/cached_images/a4cb530e9cb07e55f9123752f02b0a07467116bd_0.webp) ### Chiseled Obsidian A block made by putting Obsidian in a Stonecutter, or by combining 2 Obsidian in a Crafting Table. Is used as the frame material for portals (in combination with the Obsidian Core). Also can be used as a decorative block. ![Chiseled Obsidian](https://cdn.modrinth.com/data/cached_images/cfecec872be95122a3e82d92b6936c4c722ff543.png) ### Obsidian Core The Obsidian Core has a slot on the front that can hold an Eye of Ender, which can be inserted by right-clicking the front of the block. Sneak-right-click the front of the block with both hands empty to remove the Eye from the slot. Hoppers and other Redstone components can also be used to manipulate and detect the Eye in the slot. Obsidian Cores will amplify the signal of any Eye of Ender placed in their slot. For Entangled Eyes of Ender, this allows you to use their bond to your advantage. For regular Eyes of Ender, this allows for chunk loading. The Obsidian Core also has an iron pad on top that sets the rotation of portals. This pad can be rotated by right-clicking the Core while its slot is empty. Obsidian Cores can be disabled with a redstone signal. ![Obsidian Core Recipe](https://cdn.modrinth.com/data/cached_images/ac5ea615a5c798061d55e11506b42012b7bbaf2f_0.webp) ![Inserting and removing an Eye of Ender from an Obsidian Core](https://github.com/the-can-of-soup/large_files/blob/main/files/insert_and_remove_eye_of_ender.gif?raw=true) ## Portals To create a portal, create two portal frames out of Chiseled Obsidian (corners required). The frames must be the same shape and size, but can be any distance apart. Add an Obsidian Core to each frame in the same relative position. Make sure the Obsidian Core's pad is facing the interior of the portal, and the slot of the Core is facing towards the front of the portal. Create a pair of Entangled Eyes of Ender, and put one in each Core. Portals only work in the same dimension, unless your Entangled Eyes of Ender have an interdimensional bond. ![Building a portal](https://github.com/the-can-of-soup/large_files/blob/main/files/build_small_portal_compressed.gif?raw=true) ORIENTATION MATTERS. Make sure that your Core lines up with how your portal should behave. If you enter the portal facing the Eye in one Core, you should come out of the other frame with its Eye behind you. ![Orientation Matters](https://github.com/the-can-of-soup/large_files/blob/main/files/orientation_matters_compressed.gif?raw=true) If you can't get your portal to work, you can make a model like this to help you figure out where to place your Obsidian Core: ![Orientation Helper](https://github.com/the-can-of-soup/large_files/blob/main/files/orientation_helper_compressed.gif?raw=true) ## Gravity Manipulation You can right-click an empty Obsidian Core to rotate it around the front. By making two portal frames with differently-oriented Cores, your gravity will be changed when you walk through. Just make sure they are in the same relative position. For example, if one frame is 3x3 with a Core in the bottom-middle block, an example of a valid partner would be another 3x3 frame with a Core in the left-middle block, rotated so that the pad faces the center of the portal. ![Gravity Manipulation](https://github.com/the-can-of-soup/large_files/blob/main/files/gravity_changing_compressed.gif?raw=true) If you want to disable Gravity Manipulation on your world/server, you can uninstall the Gravity Changer mod, as it is not required (only recommended). ## Chunk Loading Obsidian Cores with an Eye of Ender in them will load chunks. If being used solely for this purpose, you don't actually need an entanglement; a regular Eye of Ender will do. Chunks loaded with Obsidian Cores are given a load ticket of 31, which means that the chunk the Core is in will be fully loaded, and the 8 surrounding chunks will be lazy chunks (more info on tickets [here](https://minecraft.wiki/w/Chunk#Tickets)). Chunk loading will be disabled if the Obsidian Core is powered with redstone. ![Chunk Loading](https://github.com/the-can-of-soup/large_files/blob/main/files/loading_chunks_compressed.gif?raw=true) ## Signal Detection Entangled Eyes of Ender can be used to detect the signal of their partner. First, place one Obsidian Core and place an Entangled Eye of Ender in it. Then, use the other Entangled Eye by right-clicking it. It will tell you the distance in blocks to the Core. This can be used like a more accurate Lodestone Compass. Giving the Core a redstone signal will disable its ability to be tracked. ![Signal Detection](https://github.com/the-can-of-soup/large_files/blob/main/files/signal_detection_compressed.gif?raw=true) ## Redstone Obsidian Cores can be disabled with a redstone signal. This will disable the portal if there is one, disable chunk loading, and disable signal detection. ![Redstone Signal Disables](https://github.com/the-can-of-soup/large_files/blob/main/files/redstone_signal_disables_compressed.gif?raw=true) Obsidian Cores give a Comparator output of 0, 5, 10, or 15 depending on their state. |State|Signal Strength| |-|-| |Empty|0| |Has Eye, but cannot detect its partner|5| |Has Eye and detects its partner|10| |Portal active|15| ![Redstone Signal Strengths Demonstration](https://github.com/the-can-of-soup/large_files/blob/main/files/redstone_signal_strengths_compressed.gif?raw=true) This can be combined with the fact that powering a Core will disable it. This enables wireless redstone. When a Core is disabled or destroyed, the Comparator output of the other Core will drop from 10 or 15 to 5, which can be detected. ![Wireless Redstone Demonstration 1](https://github.com/the-can-of-soup/large_files/blob/main/files/wireless_redstone_1_compressed.gif?raw=true) This also works 2 ways because disabled Obsidian Cores will still give an accurate Comparator signal based on the state of their partner. Here is an example circuit for simple 2-way communication. ![Wireless Redstone Demonstration 2](https://github.com/the-can-of-soup/large_files/blob/main/files/wireless_redstone_2_compressed.gif?raw=true) ## Gamerules |Gamerule|Default Value|Allowed Range|Description| |-|-|-|-| |`maxPortalLength`|`32`|[`0`,`64`]|Sets the maximum allowed width/height for portals. Can be set to 0 to disable portals altogether.| |`minPortalLength`|`1`|[`1`,`64`]|Sets the minimum width and height required for portals. For example, if set to 2, all portals must be 2x2 or larger. ## Commands |Command|Description| |-|-| |`pt_clear_cache`|Clears the Eye NBT storage, potentially clearing up memory if there are many different Entangled Eyes of Ender that aren't being used.| |`pt_regenerate_portals`|Destroys and regenerates all active portals. Can sometimes resolve temporary glitches.| |`pt_forceload_temporary `|Used internally.| |`pt_create_portal `|Used internally.| ## Usage in Modpacks Feel free to include this mod in your modpacks!