Skip to content

Commit

Permalink
Merge pull request #1 from tayrp/master
Browse files Browse the repository at this point in the history
Changes & Improvements to README.md by tayrp
  • Loading branch information
MagicQuartz authored Aug 29, 2024
2 parents 8d57d6f + ea3f85b commit 098cc23
Showing 1 changed file with 20 additions and 8 deletions.
28 changes: 20 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,31 @@
<center>
<h2>Ever Changing</h2>
<a href="https://modrinth.com/mod/fabric-api"><img src="https://wsrv.nl/?url=https://cdn.modrinth.com/data/cached_images/8bd6d7ff822dc33ffb55af6cc0c7062cec53e9e3.png&amp;n=-1" alt="Requires Fabric API" width="200"></a>
</center>
<!-- This below commented out text is the original message on line 5, I kept it here for reference purposes. -->
<!-- Run `.\gradlew build` in IntelliJ IDEA Powershell Terminal or Powershell to build this mod, Or download it from [Modrinth](https://modrinth.com/mod/everchanging). -->

<!-- <div align="center">
<p>Run ".\gradlew build" in IntelliJ IDEA Powershell Terminal or Powershell to build this mod, Or download it from Modrinth</p> -->

> [!IMPORTANT]
> Run `.\gradlew build` in IntelliJ IDEA Powershell Terminal or Powershell to build this mod, Or download it from [Modrinth](https://modrinth.com/mod/everchanging).

<div align="center">
<h2>Ever Changing</h2>
<a href="https://modrinth.com/mod/fabric-api"><img src="https://wsrv.nl/?url=https://cdn.modrinth.com/data/cached_images/8bd6d7ff822dc33ffb55af6cc0c7062cec53e9e3.png&amp;n=-1" alt="Requires Fabric API" width="200"></a>
</div>
<div align="center">
<h2></h2>
</div>

Ever Changing lets you paste the URL of a GitHub gist (compatible with the [Engrok mod](https://modrinth.com/mod/engrok)) instead of a regular server IP in the multiplayer screen, and it pulls the ip from that gist every time you start an Ngrok tunnel, which conveniently can be automatically updated using the Engrok mod!
The Ever Changing mod is a client mod, as it is needed on the client to prevent the server IP from changing on the client, not on the server.

## Simplest explanation
When you start the server, the Engrok mod automatically opens an Ngrok tunnel. By what you said, you're aware of that, and you're also aware of the fact that the IP changes every time you open the tunnel. For that reason, I specifically added a GitHub Gist integration (essentially these are text files) which you can add to automatically update the tunnel IP on the gist file (which is online and accessible to people with its ID) whenever the tunnel opens.
When you start the server, the Engrok mod automatically opens an Ngrok tunnel. The IP changes every time you open the tunnel, For that reason, I specifically added a GitHub Gist integration (essentially these are text files) which you can add to automatically update the tunnel IP on the gist file (which is online and accessible to people with its ID) whenever the tunnel opens.

## How does the Ever Changing mod connect?
Well, when you the mod's IP address format instead of the regular IP format, it automatically connects to the GitHub servers, hassle free from the client's side - no need for verifications, no nothing - and fetches the data and connection address from that gist. So every time you hit refresh in the the multiplayer screen, the ip is fetched again from the gist. The same thing also happens when you try to join.
When you use the mod's IP address format instead of the regular IP format, it automatically connects to the GitHub servers, hassle free from the client's side - no need for verifications, no nothing - and fetches the data and connection address from that gist. So every time you hit refresh in the the multiplayer screen, the ip is fetched again from the gist. The same thing also happens when you try to join.

# Usage
## Usage
To use ever changing, you don't need to use any settings whatsoever! All you have to do is add a server on the multiplayer screen in Minecraft, and instead of a regular IP address, you type in one of three things (the example gist's id is this: `3bef909cddbfbb117f0bcf101222a5dc`):
1. The GitHub gist's main URL, which looks like this if you're on the gist's page:
`gist://https://gist.github.com/MagicQuartz/3bef909cddbfbb117f0bcf101222a5dc`<br>
Expand All @@ -27,5 +40,4 @@ To use ever changing, you don't need to use any settings whatsoever! All you hav

Any of these can be provided by the server's owner for seamless connection. have fun!


Please keep in mind this mod was made in about 5 hours so it may not work perfectly, but I did my best to patch everything, so please do not try to intentionally break things.

0 comments on commit 098cc23

Please sign in to comment.