Skip to content

Commit

Permalink
feat: Initial commit
Browse files Browse the repository at this point in the history
  • Loading branch information
GeekCornerGH committed May 29, 2024
0 parents commit 0db7baf
Show file tree
Hide file tree
Showing 38 changed files with 9,805 additions and 0 deletions.
44 changes: 44 additions & 0 deletions .github/workflows/CI.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
name: Deploy to the FTP

on:
- push
- workflow_dispatch
jobs:
deploy:
name: Deploy to FTP
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 #v4.1.6
name: Clone the repository
- uses: actions/setup-node@60edb5dd545a775178f52524783378180af0d1f8 #v4.0.2
name: Install Node.JS
with:
node-version: 20.x
- uses: pnpm/action-setup@fe02b34f77f8bc703788d5817da081398fad5dd2 #v4.0.0
name: Install pnpm
with:
version: 9
run_install: false
- name: Get pnpm store directory
shell: bash
run: echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
- name: Setup pnpm cache
uses: actions/cache@0c45773b623bea8c8e75f6c82b208c3cf94ea4f9 #
with:
path: ${{env.STORE_PATH}}
key: ${{runner.os}}-pnpm-cache-${{ hashFiles('./pnpm-lock.yaml')}}
restore-key: ${{runner.os}}-pnpm-cache-
- name: Install dependencies
shell: bash
run: pnpm install --frozen-lockfile
- name: Build website
shell: bash
run: pnpm build
- name: Send built files to the FTP server
uses: SamKirkland/FTP-Deploy-Action@8e83cea8672e3fbcbb9fdafff34debf6ae4c5f65 #v4.3.5
with:
server: ${{secrets.FTP_HOST}}
username: ${{secrets.FTP_USERNAME}}
password: ${{secrets.FTP_PASSWORD}}
local-dir: ./build/
server-dir: /
20 changes: 20 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Dependencies
/node_modules

# Production
/build

# Generated files
.docusaurus
.cache-loader

# Misc
.DS_Store
.env.local
.env.development.local
.env.test.local
.env.production.local

npm-debug.log*
yarn-debug.log*
yarn-error.log*
41 changes: 41 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,41 @@
# Website

This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.

### Installation

```
$ pnpm install
```

### Local Development

```
$ pnpm start
```

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

### Build

```
$ pnpm build
```

This command generates static content into the `build` directory and can be served using any static contents hosting service.

### Deployment

Using SSH:

```
$ USE_SSH=true yarn deploy
```

Not using SSH:

```
$ GIT_USER=<Your GitHub username> yarn deploy
```

If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
3 changes: 3 additions & 0 deletions babel.config.js
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
module.exports = {
presets: [require.resolve('@docusaurus/core/lib/babel/preset')],
};
50 changes: 50 additions & 0 deletions blog/2024-05-27-hello-world.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,50 @@
---
title: Hello World!
slug: hello-world
authors:
- geek
---

### Introducing... EarthMaker.world
That's it! If you are reading this, then welcome to this website!
Is there a reason for this site to exist? Nope!
Should it have existed? Nope!
Does it exist in spite of everything? Yop!
Stick around to see why this website actually exists.

<!-- truncate -->

### The PlanetMinecraft incident
:::danger[Warning]
Please don't harrass PlanetMinecraft staff. They do a wonderful job, and the whole issue was on our end.
:::

Back in the day, when we launched the project, we were not really known at all (and now we got over 300 members, which is way beyond our expectations).
We created a PlanetMinecraft account, to show around our maps, hopefully some people would notice (and yes, people noticed).

And everything went well, until that day, where all of our maps (but 3 for some reason) were taken down.

<img src="/img/blog/2024-05-27-takedown.png" alt="REDACTED moderated you for Minecraft Switzerland Map 1:30 Map. Mod action: Disabled, Reason: Other, Content temporarily disabled until changes are made. If providing a download, it must be through the Download button, not the description nor a Discord server. This is to properly label content as monetized or not in our system."></img>

However, there was more than just a link issue. We tried to appeal for one map only (to save both our and PMC's staff time), and we learned about a rule that makes the whole project forbidden on PMC.

<img src="/img/blog/2024-05-27-review.png" alt="Additionally, if your maps are made simply by converting a heightmap to a Minecraft map via a string of programs then this is also not allowed, no matter how many hours you spend running files through a program to convert them, if this is what you are doing do not request review for this post."></img>

To be fair, that rule actually makes sense, yet in that case it wouldn't be possible to build our maps by hand, a block at a time.

### Moving on

We then had to comply, and removed all of our maps from PlanetMinecraft. The only way we now have to gain attention is to have our own website... A website like the one you're currently viewing.

:::info[Random fact]
We first planned to get the `earthmaker.ch` domain, but we figured out the `earthmaker.world` domain was available at a decent price, so we took this one instead!
:::

Of course, we won't get the same attention we had on PlanetMinecraft, so if you enjoy our maps, feel free to share our website with your friends!

Instead of posting the maps on PlanetMinecraft, we'll post them on this website, and we'll make teasers to post on our <a href="https://youtube.com/@earthmaker-mc" target="_blank">YouTube channel</a>.

### Closing thoughts

I'd like to apologie to the PlanetMinecraft staff for wasting their time and breaking their rules.
Also, again, please don't harass them (screenshot was slightly censored for a reason), they are doing a wonderful job at moderating their website, which even in 2024 is still a good place to find awesome Minecraft content.
5 changes: 5 additions & 0 deletions blog/authors.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
geek:
name: GeekCorner
title: Full-time geek
url: https://github.com/GeekCornerGH
image_url: /img/avatars/geek.png
52 changes: 52 additions & 0 deletions docs/faq.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
---
title: What da FAQ? Our answers to the most common questions
---
import Link from '@docusaurus/Link';

## Map creation
### Do you build your maps block by block?
No sorry, it would take too long to get only one map out. We're using a software that generates the maps instead.

### How are your maps generated?
We're using a tool called <a href="https://earth.motfe.net/" target="_BLANK">EarthTiles</a>, which allows us to get data from <a href="https://openstreetmap.org" target="_BLANK">OpenStreetMap</a>, and convert it to a proper Minecraft map.

### Are thoses maps made for Java edition or Bedrock edition?
Our maps are made for Java edition. But you may convert them to Bedrock edition if you want.
If you're using a Windows computer, you may download <a href="https://www.microsoft.com/store/apps/9PC9MFX9QCXS" target="_BLANK">this app from the Microsoft Store</a> to convert to bedrock. Otherwise, you can <a href="https://je2be.app/" target="_BLANK">run the tool from your browser (slower)</a>.

### Next map when?
Once ready!

### Are the maps free?
For now, yes, all of our maps are free. We're planning to launch paid maps at some point in the future, but all existing maps wil remain free.

### Can you generate a map for me?
We can, but it would be a commissioned work. Prices vary according to the size of the map and the time taken to generate it.

## Downloading maps
### What are the .001, .002, .003, ... files?
We split our maps in 45GB chunks. This means you'll need to download all of the chunks to open the final file.

### How do I open the 001, 002, 003, ... files?
Simply download <a href="https://www.7-zip.org/download.html" target="_BLANK">7-Zip</a> and open the 001 file in this program. If you can't open the file, make sure you downloaded every chunk, and make sure to verify the MD5 hash for each chunk.

### How do I verify the MD5 hash for a file?
Take a look at <Link to="/docs/getting-started/get-maps#verifying-integrity-of-the-maps">our map downloading guide</Link>.

## Usage
### Can I use your map on my public server?
Of course you can, as long you don't claim you created the map yourself!
We'd appreciate if you could at least link back to our homepage however.

### Even on a server that has a shop?
Yes!

### I'm using your map on my server. Can I advertise it?
We got a server list on our <a href="https://download.earthmaker.world">Discord server</a>. Take a look at the requirements and submit your server!

### How can I convert GPS coordinates to Minecraft coordinates? (and vice-versa)
DerMattinger got you covered. Open <a href="https://earth.motfe.net/coordinate-calculator/" target="_BLANK">this link</a> and select <code>3584</code> under "Blocks per tile" and <code>1</code> under Tiles per map.

### Can I donate to you?
Of course! Drop a DM to an admin. Your donation be processed through Stripe.
But you'll probably want to <a href="https://donatebot.io/checkout/656100677755338753" target="_BLANK">donate to DerMattinger</a>, the developer of the tool we use to generate the maps instead (make sure to join his <a href="https://discord.gg/minecraft-earth-map-656100677755338753" target="_BLANK">Discord server</a> first to get the donation perks).
8 changes: 8 additions & 0 deletions docs/getting-started/_category.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"position": 1,
"label": "Download maps",
"collapsable": true,
"collapsed": false,
"className": "download",
"link": null
}
99 changes: 99 additions & 0 deletions docs/getting-started/get-maps.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
---
sidebar-position: 2
title: Claim maps
---

import { DiscordActionRow, DiscordAttachments, DiscordButton, DiscordCode, DiscordEmbed, DiscordEmbedDescription, DiscordMessage, DiscordMessages, DiscordMention, DiscordReply } from "@skyra/discord-components-react";
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

### Why?
The bot has been designed to work with both free and paid maps.

### How?
Open the #get-maps channel, and find the map you'd like to get. Then click the claim button and *voilà*!

If you're trying to claim a paid map, you will be prompted to purchase the map through Stripe.

<DiscordMessages>
<DiscordMessage author="EarthMaker Assistant" roleColor="#f1c40f" bot avatar="/img/assistant.webp">
<DiscordEmbed color="#99FFCC" slot="embeds" image="/img/lorem-ipsum-dolor-sit-amet.png"embedTitle="Lorem ipsum" thumbnail="/img/dolor-sit-amet.png">
<DiscordEmbedDescription slot="description">
<ul style={{ paddingInlineStart: '20px', marginBlockStart: '0.5em' }}>
<li>Size: ~42km2</li>
<li>Version: 1.20</li>
<li>Coordinates for Chunky border: 42 42 -42 -42</li>
<li>Total download size: 42GB</li>
<li>Price: 0€</li>
</ul>
</DiscordEmbedDescription>
</DiscordEmbed>
<DiscordAttachments slot="components">
<DiscordActionRow>
<DiscordButton type="primary" emoji-name="⬇️" emoji="/img/down-arrow.png" onClick={() => window.open("https://www.youtube.com/watch?v=dQw4w9WgXcQ")}>Get</DiscordButton>
</DiscordActionRow>
</DiscordAttachments>
</DiscordMessage>
<DiscordMessage ephemeral author="EarthMaker Assistant" roleColor="#f1c40f" bot avatar="/img/assistant.webp">
<DiscordReply slot="reply" bot attachment author="EarthMaker Assistant" roleColor="#f1c40f" avatar="/img/assistant.webp">
<i>Click to see attachment</i>
</DiscordReply>
You have unlocked the Lorem Ipsum map for free.
</DiscordMessage>
</DiscordMessages>

### Download the map
Just press the "Get" button again. You will get a message that allows you to download the file, and will provide additional informations about the download.
<DiscordMessages>
<DiscordMessage author="EarthMaker Assistant" roleColor="#f1c40f" bot avatar="/img/assistant.webp">
<DiscordEmbed color="#99FFCC" slot="embeds" image="/img/lorem-ipsum-dolor-sit-amet.png"embedTitle="Lorem ipsum" thumbnail="/img/dolor-sit-amet.png">
<DiscordEmbedDescription slot="description">
<ul style={{ paddingInlineStart: '20px', marginBlockStart: '0.5em' }}>
<li>Size: ~42km2</li>
<li>Version: 1.20</li>
<li>Coordinates for Chunky border: 42 42 -42 -42</li>
<li>Price: 0€</li>
</ul>
</DiscordEmbedDescription>
</DiscordEmbed>
<DiscordAttachments slot="components">
<DiscordActionRow>
<DiscordButton type="primary" emoji-name="⬇️" emoji="/img/down-arrow.png" onClick={() => window.open("https://www.youtube.com/watch?v=dQw4w9WgXcQ")}>Get</DiscordButton>
</DiscordActionRow>
</DiscordAttachments>
</DiscordMessage>
<DiscordMessage ephemeral author="EarthMaker Assistant" roleColor="#f1c40f" bot avatar="/img/assistant.webp">
<DiscordReply slot="reply" bot attachment author="EarthMaker Assistant" roleColor="#f1c40f" avatar="/img/assistant.webp">
<i>Click to see attachment</i>
</DiscordReply>
<DiscordEmbed color="#99FFCC" slot="embeds" embedTitle="Your download">
<DiscordEmbedDescription slot="description">
<ul style={{ paddingInlineStart: '20px', marginBlockStart: '0.5em' }}>
<li>Filename: tominecon.7z</li>
<li>MD5 hash: <DiscordCode multiline>07e087b30b0e2b5ce1654a5c4e1a2c0c</DiscordCode></li>
<li>Part 1/2</li>
</ul>
</DiscordEmbedDescription>
</DiscordEmbed>
<DiscordAttachments slot="components">
<DiscordActionRow>
<DiscordButton type="success" emoji-name="⬇️" url="javascript:void()" emoji="/img/down-arrow.png" onClick={() => window.open("https://www.youtube.com/watch?v=dQw4w9WgXcQ")}>Download</DiscordButton>
<DiscordButton type="success" emoji-name="➡️" emoji="/img/right-arrow.png" onClick={() => window.open("https://www.youtube.com/watch?v=dQw4w9WgXcQ")}>Next file</DiscordButton>
</DiscordActionRow>
</DiscordAttachments>
</DiscordMessage>
</DiscordMessages>

### Verifying integrity of the maps
Open your favorite terminal and launch the following command:
<Tabs>
<TabItem default value="windows" label="Windows">
<code>powershell Get-FileHash [filename] -Algorithm MD5</code>
</TabItem>
<TabItem value="macos" label="macOS">
<code>md5 [filename]</code>
</TabItem>
<TabItem value="linux" label="Linux">
<code>md5sum [filename]</code>
</TabItem>
</Tabs>
14 changes: 14 additions & 0 deletions docs/getting-started/join-discord.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
---
sidebar-position: 1
title: Join Discord
slug: discord
---
To get started, you need to join our Discord.

### Why?
Discord is probably the best place we can find to keep you updated about updates on EarthMaker. It also allows you to get your server featured on our currated community server list.

### How?
Just join our server using <a href="https://download.earthmaker.world" target="_BLANK">this link</a>. Signup for a Discord account if you need one, and that's it. If you can see the "readme-first" channel, please DM an admin to receive that shiny `Visitor` role.

Once you joined, you're good to go.
6 changes: 6 additions & 0 deletions docs/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
---
sidebar-position: 1
title: Welcome
---

Welcome to our documentation. You'll find here questions to the most common questions you may think of, and you'll learn how to download our maps.
Loading

0 comments on commit 0db7baf

Please sign in to comment.