{"id":15104759,"url":"https://github.com/crystal-nest/server-sided-portals","last_synced_at":"2026-02-03T14:06:53.491Z","repository":{"id":252370922,"uuid":"839439076","full_name":"Crystal-Nest/server-sided-portals","owner":"Crystal-Nest","description":"Create custom portals and dimensions compatible with any client!","archived":false,"fork":false,"pushed_at":"2025-12-31T18:18:58.000Z","size":1803,"stargazers_count":1,"open_issues_count":2,"forks_count":2,"subscribers_count":1,"default_branch":"1.21.11","last_synced_at":"2026-01-05T04:20:40.319Z","etag":null,"topics":["minecraft","minecraft-api","minecraft-fabric-mod","minecraft-forge-mod","minecraft-mod","minecraft-neoforge-mod","mod-api"],"latest_commit_sha":null,"homepage":"https://modrinth.com/mod/server-sided-portals","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Crystal-Nest.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"patreon":"crystalspider","ko_fi":"crystalspider"}},"created_at":"2024-08-07T15:57:30.000Z","updated_at":"2025-11-15T01:05:40.000Z","dependencies_parsed_at":"2025-02-08T03:32:26.291Z","dependency_job_id":"dcf1fe67-ee1a-4a1b-9df0-356944826da0","html_url":"https://github.com/Crystal-Nest/server-sided-portals","commit_stats":{"total_commits":25,"total_committers":3,"mean_commits":8.333333333333334,"dds":0.4,"last_synced_commit":"3b8123a340258d8716427f779f44c10e31e00ed9"},"previous_names":["crystal-nest/server-sided-portals"],"tags_count":42,"template":false,"template_full_name":"Crystal-Nest/cobweb-mod-template","purl":"pkg:github/Crystal-Nest/server-sided-portals","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crystal-Nest%2Fserver-sided-portals","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crystal-Nest%2Fserver-sided-portals/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crystal-Nest%2Fserver-sided-portals/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crystal-Nest%2Fserver-sided-portals/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Crystal-Nest","download_url":"https://codeload.github.com/Crystal-Nest/server-sided-portals/tar.gz/refs/heads/1.21.11","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Crystal-Nest%2Fserver-sided-portals/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29047212,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-03T10:09:22.136Z","status":"ssl_error","status_checked_at":"2026-02-03T10:09:16.814Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["minecraft","minecraft-api","minecraft-fabric-mod","minecraft-forge-mod","minecraft-mod","minecraft-neoforge-mod","mod-api"],"created_at":"2024-09-25T20:02:13.359Z","updated_at":"2026-02-03T14:06:50.994Z","avatar_url":"https://github.com/Crystal-Nest.png","language":"Java","funding_links":["https://patreon.com/crystalspider","https://ko-fi.com/crystalspider","https://www.patreon.com/crystalspider"],"categories":[],"sub_categories":[],"readme":"![Server Sided Portals banner](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/server-sided-portals/banner.png \"Server Sided Portals banner\")\n\n---\n\n![Minecraft](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/minecraft.svg \"Minecraft\")[![1.21.11](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/1-21-11.svg)](https://modrinth.com/mod/server-sided-portals/versions?g=1.21.11)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![1.21.10](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/1-21-10.svg)](https://modrinth.com/mod/server-sided-portals/versions?g=1.21.10)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![1.21.8](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/1-21-8.svg)](https://modrinth.com/mod/server-sided-portals/versions?g=1.21.8)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![1.21.7](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/1-21-7.svg)](https://modrinth.com/mod/server-sided-portals/versions?g=1.21.7)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![1.21.6](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/1-21-6.svg)](https://modrinth.com/mod/server-sided-portals/versions?g=1.21.6)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![1.21.1](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/1-21-1.svg \"1.21.1\")](https://modrinth.com/mod/server-sided-portals/versions?g=1.21.1)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![1.21](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/minecraft/1-21.svg \"1.21\")](https://modrinth.com/mod/server-sided-portals/versions?g=1.21)\n\n![Loader](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/loader/loader.svg \"Loader\")[![NeoForge](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/loader/neoforge.svg \"NeoForge\")](https://modrinth.com/mod/server-sided-portals/versions?l=neoforge)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![Forge](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/loader/forge.svg \"Forge\")](https://modrinth.com/mod/server-sided-portals/versions?l=forge)![Separator](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/separator.svg)[![Fabric](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/loader/fabric.svg \"Fabric\")](https://modrinth.com/mod/server-sided-portals/versions?l=fabric)\n\n![Overlay](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/side/server.svg)\n\n![Issues](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/github/issues.svg \"Issues\")[![GitHub](https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/github/github.svg \"GitHub\")](https://github.com/crystal-nest/server-sided-portals/issues)\n\n---\n\n## 📝 **Description**\n\nThis is a mod API that provides easily customizable and server-sided portals to any custom dimension.  \nThis mod is required server side only, and is thus compatible with any client, Vanilla included.  \nThis mod can be used as a dependency for another mod/datapack, or bundled in a modpack with a custom datapack or with mods that require it.\n\nCheck out the usage details below or on the [Wiki](https://github.com/Crystal-Nest/server-sided-portals/wiki)!\n\n## ✨ **Features**\n\n- 🔮 **Custom Portals**: Create portals with fully customizable frames linked to any dimension.\n- 🧱 **Flexible Frame Design**: Define valid frame blocks using block tags — supports multiple block types!\n- 🔥 **Custom Igniters**: Choose which items can light the portal using item tags — supports multiple items!\n- 🖥️ **Server-Side Only**: No need to install the mod on clients — works entirely server-side.\n- 🌍 **Cross-Dimension Support**: Add portals to *any* dimension, even ones added by other mods.\n- ✅ **Fully Compatible**: Works seamlessly with both Vanilla and modded clients.\n- 🧩 **Mod \u0026 Datapack Friendly**: Simple integration whether you're using a datapack or developing a mod.\n- 📚 **Comprehensive Wiki**: Check out the [Wiki](https://github.com/Crystal-Nest/server-sided-portals/wiki) for guides, examples, and more features!\n\n## 🚀 **Usage**\n\nFor detailed examples, check out the [Wiki](https://github.com/Crystal-Nest/server-sided-portals/wiki/Working-examples).  \nThere, you'll find step-by-step guides for creating custom dimensions, portal frames, igniters, and additional tweaks!\n\n### 📦 Datapack\n\nMaking use of this mod with a datapack is easy! Just follow these simple steps:\n\n1. **Set up a datapack**: Start by creating a datapack following [this Minecraft tutorial](https://minecraft.wiki/w/Tutorials/Creating_a_data_pack).\n2. **Define a dimension Type**: Generate a custom dimension type with [this generator](https://misode.github.io/dimension-type/).\n3. **Create your dimension**: Use [this generator](https://misode.github.io/dimension/) to set up your custom dimension.\n4. **Specify portal frame blocks**: Create a block tag called `dimension_portal_frame`, replacing `dimension` with your dimension name. You can include multiple blocks or even other tags!\n5. **(Optional) Choose portal igniters**: Optionally create an item tag named `dimension_portal_igniter`, replacing `dimension` with your dimension name, for items that can ignite the portal. You can also use multiple items or tags.\n6. **Organize your files**: Make sure all JSON files from the above steps are under the same namespace.\n\nThat's it! Load your datapack alongside this mod, and your dimensions and portals are ready to use.  \nYou're free to add multiple dimensions, each with unique portal frames and igniters!\n\nSince **v2.1.0**, you can further customize your dimensions by setting specific gamemodes for players entering them or defining custom entry points other than the Overworld.  \nCheck out the [Wiki](https://github.com/Crystal-Nest/server-sided-portals/wiki) for details.\n\n### 🛠️ Mod\n\nIntegrating this API into your mod is straightforward:\n\n- Follow the steps outlined in the Datapack section above.\n- Instead of placing files in a datapack, place them under your mod's resource folder: `resources/data/mod_id/`.\n\nIf you prefer giving users the choice to enable or disable your datapack, consider using [Cobweb static datapack API](https://github.com/Crystal-Nest/cobweb/wiki/Common-API#static--dynamic-resource-packs).\n\nCreating a mod (rather than a datapack) allows you to add extra functionality and enhance your custom dimensions further.\n\nAdditionally, this API provides several helpful utility methods. Explore the Javadoc for detailed documentation on these methods.\n\n## 🔄 **Compatibilities**\n\n| Mod                                                            | Loader |                                                         Compatibility                                                          |\n|:---------------------------------------------------------------|:------:|:------------------------------------------------------------------------------------------------------------------------------:|\n| [Crying Portals](https://modrinth.com/mod/crying-portals)      |  All   |                                                          Incompatible                                                          |\n| [Immersive Portals](https://modrinth.com/mod/immersiveportals) |  All   |                                                          Incompatible                                                          |\n| [BetterNether](https://modrinth.com/mod/betternether)          | Fabric |                                                           Compatible                                                           |\n| [Very Many Players](https://modrinth.com/mod/vmp-fabric)       | Fabric |                                           Compatible with `use_async_portals=false`                                            |\n| [Canary](https://modrinth.com/mod/canary)                      | Forge  | Compatible with [fast portals](https://github.com/AbdElAziz333/Canary/wiki/Configuration-File#mixinaipoifast_portals) disabled |\n\n## 🔗 **Dependencies**\n\n| Mod                                       | Loader | Requirement |\n|:------------------------------------------|:------:|:-----------:|\n| [Cobweb](https://modrinth.com/mod/cobweb) |  All   |  Required   |\n\n## 📜 **License and right of use**\n\nFeel free to use this mod for any modpack or video, just be sure to give credit and possibly link [here](https://github.com/crystal-nest/server-sided-portals#readme).  \nThis project is published under the [Crystal Nest Community License v1](https://github.com/crystal-nest/server-sided-portals/blob/master/LICENSE).\n\n## ❤️ **Support us**\n\n\u003ca href=\"https://crystalnest.it\"\u003e\u003cimg alt=\"Crystal Nest Website\" src=\"https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/crystal-nest/pic512.png\" width=\"14.286%\"\u003e\u003c/a\u003e\u003ca href=\"https://discord.gg/BP6EdBfAmt\"\u003e\u003cimg alt=\"Discord\" src=\"https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/discord/discord512.png\" width=\"14.286%\"\u003e\u003c/a\u003e\u003ca href=\"https://www.patreon.com/crystalspider\"\u003e\u003cimg alt=\"Patreon\" src=\"https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/patreon/patreon512.png\" width=\"14.286%\"\u003e\u003c/a\u003e\u003ca href=\"https://ko-fi.com/crystalspider\"\u003e\u003cimg alt=\"Ko-fi\" src=\"https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/kofi/kofi512.png\" width=\"14.286%\"\u003e\u003c/a\u003e\u003ca href=\"https://github.com/Crystal-Nest\"\u003e\u003cimg alt=\"Our other projects\" src=\"https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/github/github512.png\" width=\"14.286%\"\u003e\u003ca href=\"https://modrinth.com/organization/crystal-nest\"\u003e\u003cimg alt=\"Modrinth\" src=\"https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/modrinth/modrinth512.png\" width=\"14.286%\"\u003e\u003c/a\u003e\u003ca href=\"https://www.curseforge.com/members/crystalspider/projects\"\u003e\u003cimg alt=\"CurseForge\" src=\"https://raw.githubusercontent.com/crystal-nest/mod-fancy-assets/main/curseforge/curseforge512.png\" width=\"14.286%\"\u003e\u003c/a\u003e\n\n[![Bisect Hosting](https://www.bisecthosting.com/partners/custom-banners/d559b544-474c-4109-b861-1b2e6ca6026a.webp \"Bisect Hosting\")](https://bisecthosting.com/crystalspider)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrystal-nest%2Fserver-sided-portals","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcrystal-nest%2Fserver-sided-portals","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcrystal-nest%2Fserver-sided-portals/lists"}