Skip to content
This repository has been archived by the owner on Apr 10, 2024. It is now read-only.

Commit

Permalink
docs(content): 📝 Updates
Browse files Browse the repository at this point in the history
  • Loading branch information
Nudelsuppe42 committed Jan 6, 2024
1 parent c3c1a45 commit ebc274c
Show file tree
Hide file tree
Showing 21 changed files with 320 additions and 228 deletions.
Original file line number Diff line number Diff line change
@@ -1,91 +1,91 @@
---
sidebar_position: 2
title: Building Guidebook
---
# Building guidebook

## Teleporting with TPLL

To travel to different places in the world we will use the TPLL command. This command takes real-world coordinates and using some mathematical equations converts this to the corresponding location in the BTE world, and then teleports you there.

Here is how you use it:

1. Open Google Maps by clicking [here](https://www.google.com/maps)
2. Use the search bar (write in an address/location and press enter) to find the building you want to build.

![](https://media.discordapp.net/attachments/1096118472909533368/1121212261906780293/googlemapssearch.png?width=1709&height=905)
3. Navigate the map by dragging and scrolling
4. After navigating to your location, right click a spesific spot where you will teleport to.

![](https://media.discordapp.net/attachments/1096118472909533368/1121551115335512274/eiffeltowergooglemapsedit.png?width=1709&height=905)
5. Left click the coordinates in the first row in the pop-up.

![](https://media.discordapp.net/attachments/1096118472909533368/1121552593760567376/eiffeltowergooglemapsclickcoordiantes.png?width=1709&height=905)
6. In Minecraft, write "/tpll" then press `CTRL + V` to paste the coordinates, then press `Enter`

![](https://media.discordapp.net/attachments/1096118472909533368/1121554927639072859/tpllminecraftedit.png?width=1664&height=905)
7. After waiting for a bit, you will be teleported to your location!

![](https://media.discordapp.net/attachments/1096118472909533368/1121555911937364049/minecraftatlocation.png?width=1692&height=905)

## Making the shell part 1: Making the building outline

The first step to making any building is building the building footprint, or what we call the outline. By making this first, we can extend these into walls and then make a roof on top.

If you have watched some of PippenFTS' old videos you might wonder "why not just use the brick outline?". In later times we found out that the brick outlines are not accurate, and therefore we make our own.

Here is how you do it:

### With 3D data

1. In Google Maps, go to one of the building you want to build
2. Click on Layers in the bottom-left area of your map.

![](https://media.discordapp.net/attachments/1096118472909533368/1122972729369436291/how-to-make-google-maps-3D-layers.webp)
3. Click on More.

![](https://media.discordapp.net/attachments/1096118472909533368/1122972730472550580/how-to-make-google-maps-3D-more.webp)
4. Click on Satellite and ensure that Globe View is checked. You can now get an angled view by holding shift while dragging. If you still see flat buildings go down to Without 3D data (<-- INSERT LINK) below

![](https://media.discordapp.net/attachments/1096118472909533368/1122972729855979670/how-to-make-google-maps-3D-globe-view.webp)
5. Remove all nearby trees with the command `//replacenear 40 log,leaves air`

![](https://media.discordapp.net/attachments/1096118472909533368/1123268394796462191/replacenar.png?width=1692&height=905)
6. Use the TPLL command you used above to teleport to each corner of the building, and make sure to place a block where you land in Minecraft.

![](https://media.discordapp.net/attachments/1096118472909533368/1123268340715110412/bergenbuildtpllpoinjts.png?width=1793&height=905)

![](https://media.discordapp.net/attachments/1096118472909533368/1123269034994044978/tpllinminecraft.png?width=1692&height=905)
7. In Minecraft, do the command `//wand`. This should give you a wooden axe

![](https://media.discordapp.net/attachments/1096118472909533368/1123285205143277722/wandinmc.png?width=1692&height=905)
8. With your axe in hand, left click one of the blocks you placed, then right click one of the blocks next to it.

![](https://media.discordapp.net/attachments/1096118472909533368/1123290504398905404/2023-06-27_18.29.03.png?width=1255&height=671)

![](https://media.discordapp.net/attachments/1096118472909533368/1123290504906407976/2023-06-27_18.29.15.png?width=1255&height=671)
9. Execute the command `//line wool` (Note: Minecraft block id's are quite different in 1.12, go to [this list](https://minecraft-ids.grahamedgecombe.com/) to see a list of id's).

![](https://media.discordapp.net/attachments/1096118472909533368/1123291419482804384/2023-06-27_18.38.14_2.png?width=1255&height=671)
10. Now do this with all the points so that you have a full shape. To get rid of the selection box do `//desel`. Note: You might ask "Why is my building no straight? Can i rotate it to make it easier to build?". No. Most buildings are not on a straight north-south rotation, in additon to the BTE map having a weird rotation some places. This means that we have to build them diagonally, but don't worry, it's not as hard as you think. [Here is an interesting video from PippenFTS about the problem](https://www.youtube.com/watch?v=5o8Psc6FvZ4&pp=ygUYYnVpbGQgc3RyYWlnaHQgcGlwcGVuZnRz)

![](https://media.discordapp.net/attachments/1096118472909533368/1123291420346814514/2023-06-27_18.38.52.png?width=1255&height=671)
11. place blocks under yay will write again im tired

### Without 3D data

## Making the shell part 2: Making the building walls

### With 3D data

### Without 3D data

## Making the shell part 3: Making the building roof

### With 3D data

### Without 3D data

## Making windows and doors

---
sidebar_position: 2
title: Building Guidebook
---
# Building guidebook

## Teleporting with TPLL

To travel to different places in the world we will use the TPLL command. This command takes real-world coordinates and using some mathematical equations converts this to the corresponding location in the BTE world, and then teleports you there.

Here is how you use it:

1. Open Google Maps by clicking [here](https://www.google.com/maps)
2. Use the search bar (write in an address/location and press enter) to find the building you want to build

![](https://media.discordapp.net/attachments/1096118472909533368/1121212261906780293/googlemapssearch.png?width=1709&height=905)
3. Navigate the map by dragging and scrolling
4. After navigating to your location, right click a specific spot where you will teleport to

![](https://media.discordapp.net/attachments/1096118472909533368/1121551115335512274/eiffeltowergooglemapsedit.png?width=1709&height=905)
5. Left click the coordinates in the first row in the pop-up

![](https://media.discordapp.net/attachments/1096118472909533368/1121552593760567376/eiffeltowergooglemapsclickcoordiantes.png?width=1709&height=905)
6. In Minecraft, write "/tpll" then press `CTRL + V` to paste the coordinates, then press `Enter`

![](https://media.discordapp.net/attachments/1096118472909533368/1121554927639072859/tpllminecraftedit.png?width=1664&height=905)
7. After waiting for a bit, you will be teleported to your location!

![](https://media.discordapp.net/attachments/1096118472909533368/1121555911937364049/minecraftatlocation.png?width=1692&height=905)

## Making the shell part 1: Making the building outline

The first step to making any building is building the building footprint, or what we call the outline. By making this first, we can extend these into walls and then make a roof on top.

If you have watched some of PippenFTS' old videos you might wonder "why not just use the brick outline?". In later times we found out that the brick outlines are not accurate, and therefore we make our own.

Here is how you do it:

### With 3D data

1. In Google Maps, go to one of the building you want to build
2. Click on Layers in the bottom-left area of your map.

![](https://media.discordapp.net/attachments/1096118472909533368/1122972729369436291/how-to-make-google-maps-3D-layers.webp)
3. Click on More.

![](https://media.discordapp.net/attachments/1096118472909533368/1122972730472550580/how-to-make-google-maps-3D-more.webp)
4. Click on Satellite and ensure that Globe View is checked. You can now get an angled view by holding shift while dragging. If you still see flat buildings go down to [Without 3D data](#without-3d-data) below

![](https://media.discordapp.net/attachments/1096118472909533368/1122972729855979670/how-to-make-google-maps-3D-globe-view.webp)
5. Remove all nearby trees with the command `//replacenear 40 log,leaves air`

![](https://media.discordapp.net/attachments/1096118472909533368/1123268394796462191/replacenar.png?width=1692&height=905)
6. Use the TPLL command you used above to teleport to each corner of the building, and make sure to place a block where you land in Minecraft.

![](https://media.discordapp.net/attachments/1096118472909533368/1123268340715110412/bergenbuildtpllpoinjts.png?width=1793&height=905)

![](https://media.discordapp.net/attachments/1096118472909533368/1123269034994044978/tpllinminecraft.png?width=1692&height=905)
7. In Minecraft, do the command `//wand`. This should give you a wooden axe

![](https://media.discordapp.net/attachments/1096118472909533368/1123285205143277722/wandinmc.png?width=1692&height=905)
8. With your axe in hand, left click one of the blocks you placed, then right click one of the blocks next to it.

![](https://media.discordapp.net/attachments/1096118472909533368/1123290504398905404/2023-06-27_18.29.03.png?width=1255&height=671)

![](https://media.discordapp.net/attachments/1096118472909533368/1123290504906407976/2023-06-27_18.29.15.png?width=1255&height=671)
9. Execute the command `//line wool` (Note: Minecraft block id's are quite different in 1.12, go to [this list](https://minecraft-ids.grahamedgecombe.com/) to see a list of id's).

![](https://media.discordapp.net/attachments/1096118472909533368/1123291419482804384/2023-06-27_18.38.14_2.png?width=1255&height=671)
10. Now do this with all the points so that you have a full shape. To get rid of the selection box do `//desel`. Note: You might ask "Why is my building not straight? Can i rotate it to make it easier to build?". No. Most buildings are not on a straight north-south rotation, in additon to the BTE map having a weird rotation some places. This means that we have to build them diagonally, but don't worry, it's not as hard as you think. [Here is an interesting video from PippenFTS about the problem](https://www.youtube.com/watch?v=5o8Psc6FvZ4&pp=ygUYYnVpbGQgc3RyYWlnaHQgcGlwcGVuZnRz)

![](https://media.discordapp.net/attachments/1096118472909533368/1123291420346814514/2023-06-27_18.38.52.png?width=1255&height=671)
11. place blocks under yay will write again im tired

### Without 3D data

## Making the shell part 2: Making the building walls

### With 3D data

### Without 3D data

## Making the shell part 3: Making the building roof

### With 3D data

### Without 3D data

## Making windows and doors

## Adding details
5 changes: 0 additions & 5 deletions docs/building/guidebook/index.md

This file was deleted.

3 changes: 1 addition & 2 deletions docs/concepts/_category_.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,6 @@
"label": "Concepts",
"position": 1,
"link": {
"type": "generated-index",
"description": "Crucial Parts of BuildTheEarth"
"type": "generated-index"
}
}
1 change: 1 addition & 0 deletions docs/development/apis.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: APIs
sidebar_position: 1
tags:
- API
- Website
Expand Down
2 changes: 1 addition & 1 deletion docs/development/general.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 1
sidebar_position: 0
title: General Development
---
The BuildTheEarth Development Team is divided into multiple Subteams:
Expand Down
2 changes: 1 addition & 1 deletion docs/development/smybteapi.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
sidebar_position: 1
sidebar_position: 2
title: Conversion between XYZ and Latitude/Longitude
---
Below is a tool that will help you convert up to 1000 coordinates at a time from the BTE Dymaxion projection to latitude and longitude and vice-versa. Input one coordinate pair per line, separated by a space, in the order x, z or latitude, longitude. Courtesy of [SmylerMC](https://github.com/SmylerMC).
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 25 additions & 0 deletions docs/development/website/index.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
---
sidebar_position: 3
title: BuildTheEarth Website
---


:::note

This documentation is written for the <b>new</b> BuildTheEarth Website.

:::


# Github Repositories

1. [Bug Reports](https://github.com/orgs/BuildTheEarth/projects/7/views/1)
2. [Roadmap](https://github.com/orgs/BuildTheEarth/projects/8/views/4)
3. [Website Frontend](https://github.com/BuildTheEarth/website-frontend)
4. [BuildTheEarth API](https://github.com/BuildTheEarth/website-node-backend)

# Guides

* [My BuildTheEarth](/docs/development/website/my-buildtheearth)
* [Manage Teams](/docs/development/website/manage-teams)

68 changes: 68 additions & 0 deletions docs/development/website/manage-teams.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
---
sidebar_position: 1
title: Manage Build Teams
---

# Permissions

There are multiple way how you can have access to Build Team specific settings:

1. Global Permissions - Build Team Managers and Administrators
2. Manager Permissions - Build Team Staff and Co-Leaders
3. Owner - Build Team Owner (There can only be one Build Team owner, co owners should recive Manage Permissions instead)

The BuildTheEarth website is build around a permission-based System. This means there are no hard-coded roles anymore. Each member of your Team can recive additional Permissions to their Builder Status. With these permissions they can optain specific rights.
Below is a list of all aviable permissions that a member of your Team can have:

| Permission | Description |
|--------------------------|--------------------------------------|
| permission.add | Add a permission to someone |
| permission.remove | Remove a permission from someone |
| team.application.edit | Edit Application Questions |
| team.application.list | View a list of all Applications |
| team.application.review | Review Applications |
| team.socials.edit | Edit Social Links |
| team.settings.edit | Edit Settings |
| team.showcases.edit | Edit Showcase Images |
| team.application.notify | Be notified of new Applications |
| team.application.blocked | Blocked from submitting Applications |

:::note team.application.blocked

This Permissions is there to block potential application spammers. Activating it on a user will remove his rights for applications. Do not give this to your actual managers.

:::

An example setup of your permissios may look like this:

| Discord Role | Permissions |
|-------------------|-----------------------------------------------------------------------|
| Administrator | All Permissions |
| Reviewer | team.application.list, team.application.review, team.application.notify |
| Social Media Team | team.socials.edit |
| All Staff members | team.showcases.edit |

To edit permissions of your Team members you can go to the "Members" category of your Team Settings. There you can find two tables, the "Managers" table and "Builders" table.
Managers are all users which have more permissions than the default Builder permissions (create claims).

# Settings

All Settings can be changed with the team.settings.edit permission. Changes will be reflected instantly, if not they should update within 15 Minutes.
Some special settings:
* Slug: The short name of the server, which is used in the URL. If possible this should be the country code of your country.
* Location: A comma seperated list of country codes, including: glb -> Globe and ost -> Oversea Territories
* Minecraft IP: You IP, if you set it to buildtheearth.net the website will use your slug as a template for the /bt < id > command

Dont forget to save your settings!

# Application Questions

The new website features a more flexible application system. You can configure Application Questions with different Input types for Trial and Builder applications seperately.
In the Dialog boxes for each Question you will also see an example of how the question will look on the Form itself.
As a form of styling you can add icons to each question, a list of avaible icons can be found at [tabler/icons](https://tabler.io/icons). If you want to remove the icon, delete everything in the Icon Input. Some question types will also allow for additional information to validate input data before submission.
Dont forget to save your settings!

# Showcase Images

You can upload images of built places to be showcased on the Gallery and Main page of the Website. These images will rotate randomly every 2 minutes.
If you want to add an image, please input the name of the location in the format of `[Building], [City]` (Or only `[City]`) . The Date should be the Date of Construction, not your uploading date.
19 changes: 19 additions & 0 deletions docs/development/website/my-buildtheearth.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
---
sidebar_position: 0
title: My BuildTheEarth
---
![Alt text](beta.buildtheearth.net_me.png)

You can access your My BuildTheEarth Page when you are signed in at [https://buildtheearth.net/me](https://buildtheearth.net/me) or by clicking on your account and selecting "My BuildTheEarth".

On the My BuildTheEarth page you can find details about your status at BuildTheEarth, for example all Build Teams you have joined or are a Manager of. You can also view all claims associated with your account on the bottom and create new ones.

:::note Claims

Not all Build Teams allow their members to create Claims by themselfes on the website, this is why some Teams will be grayed-out when you open the "Create new Claim" dialog. Most of those teams will implement a System to reflect their own Claim map onto the BuildTheEarth Website.

:::

On your My BuildTheEarth page you can also optain your **User ID**, which your Team Owner may need to give you the Manager role on the Build Team.

You can also change various settings and profile details when clicking on the "Open Settings" Button. Note that you do not need to enter your First and Last Name. We only require you to choose an username and email address. Your username should reflect the one you have on Discord.
Loading

0 comments on commit ebc274c

Please sign in to comment.