Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/en/goatcraft/.nav.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
title: GoatCraft
48 changes: 48 additions & 0 deletions docs/en/goatcraft/auth.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: GoatCraft Auth
description: How to use GoatCraft Auth to log in to the server
---

GoatCraft Auth (short for GCA) is an external authentication tool that allows players to log in to the GoatCraft server without using an official Minecraft account.
This is particularly useful for players who do not own an official account but still wish to experience GoatCraft.

To use GCA, you first need a Minecraft launcher that supports external authentication.
Below are some Minecraft launchers that support this feature:

- PojavLauncher
- HMCL
- ...

Additionally, you will need a Solarpass account to authorize GoatCraft Auth for login.

!!! note

GoatCraft Auth is a deployment instance of the open-source project Drasl. Thanks to the development team for their contributions.
If you want an external authentication service but dislike the PHP and bloated features of Blessing, you can check out the [Drasl](https://github.com/unmojang/drasl) project.

## Direct Usage of GCA

1. Visit the [GoatCraft Auth](https://authmc.solsynth.dev) website.
2. Click the "Sign in with Solarpass" button.
3. Authorize GoatCraft Auth to access your Solarpass account.
4. Follow the prompts to set a Minecraft username.
- **Note: If you have previously logged in to GoatCraft using an official account, please link your existing Mojang account here. Otherwise, it may cause player data conflicts and result in loss of gameplay progress.**
**Refer to the section below, 'Players Who Previously Used Official Login', for more details.**
5. Upon completion, you will receive an MC Token and Username. Make a note of them.
6. Open your Minecraft launcher and navigate to the settings page.
7. Locate the "External Login" or similar option, and enter the MC Token and Username obtained from GCA.
- The setup process may vary depending on the launcher; please refer to your launcher's documentation.
- The username field should be filled with the character name set in GCA; the password field should be filled with the obtained MC Token.
- Set the server address to `authmc.solsynth.dev/authlib-injector`.
8. Save the settings and launch the game. You should now be able to log in to the GoatCraft server using GCA.

## Players Who Previously Used Official Login

Even if you have previously logged in to GoatCraft using an official Minecraft account, you can still use GCA. This brings several benefits, such as features that interact with Solar Network, and you won't be prompted with "Link your Solarpass account to unlock more features!" upon rejoining the server.

When following the steps above and reaching step 4, please do not create a new player character. Instead, link your existing Mojang account:

1. On the GCA website, when you see the "Register from an existing account" option, enter the username of your official Minecraft account as prompted.
2. GCA will then ask you to download a skin file, which you need to set as the skin for your official Minecraft account. This is to verify your ownership of the official account.
3. After setting the skin, return to the GCA website and click the "Register" button.
4. You're all set! You can now proceed to step 5 of the previous section to continue with the client configuration.
48 changes: 48 additions & 0 deletions docs/en/goatcraft/culture.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,48 @@
---
title: GoatCraft Culture
description: An introduction to the various nations
---

In GoatCraft, players have established numerous nations using the Towny plugin. This chapter introduces you to the unique culture and characteristics of these regions.

## The Chinese Sheep Nation

The Chinese Sheep Nation was founded by Littlesheep, the server owner and founder of Solsynth. It is the nation with the most developed military industry on the server. The Happy Ghast fighter jets they developed boast high maneuverability and strong combat capabilities. At the same time, the Chinese Sheep Nation has a highly developed economy, standing as the largest economic entity in GoatCraft.

The Chinese Sheep Nation governs three cities:

- Nanjing

Nanjing is the capital of the Chinese Sheep Nation, located in the southeast of the Hehuan Plateau. The main urban area is surrounded by mountains on all sides, serving as the economic and political center of the nation.

- Xi'an

Xi'an is the largest industrial base of the Chinese Sheep Nation, established by Longyuan. Located in the northeast of Taiping Island, it possesses the most comprehensive air defense system and railway control system in all of GoatCraft.

- Hong Kong

Hong Kong is the window for the Chinese Sheep Nation's overseas trade, established by AIRBUS. Located in the south of the Zhaomo Peninsula, it hosts the largest luxury goods trading market in GoatCraft.

## The Corporate Consortium

The Corporate Consortium is a nation founded by the player Texas0295 and is the most industrially advanced nation on the server. Almost all infrastructure facilities in GoatCraft were built by the nation's owner, Texas0295, including but not limited to: the Swamp Mob Farm, the End XP Farm, and the Sand Duper.

Currently, the Corporate Consortium governs only one city:

- Kimura Heavy Industries Co., Ltd.

Kimura Heavy Industries Co., Ltd. is the most industrially developed city in GoatCraft, located on the Dapingyang Plain in the north of the Central Island. The former mayor of Hong Kong, AIRBUS, once stayed here for a long time.

## The Flora Socialist Federation

The Flora Socialist Federation is a nation founded by the player Jason_CJ and is the only developing country on the server.

The Flora Socialist Federation governs two cities:

- Sakura Continent

Sakura Continent is the capital of the Flora Socialist Federation, located in the east of the Qianlong Peninsula in the south of the Hehuan Plateau. It is only about 300 blocks away from Nanjing at its closest point. It is a tourist destination in GoatCraft, and the first GoatCraft Spring Festival Gala was held here. This city is famous for its abundance of cherry blossom trees.

- Golden Flower Continent

Golden Flower Continent is a town within the Flora Socialist Federation, established by deng. Located on Jinhua Island in the west of the Qianlong Peninsula.
54 changes: 54 additions & 0 deletions docs/en/goatcraft/getting-started.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
---
title: Getting Started
description: Something important for new players of GoatCraft
---

GoatCraft is a server that use plugins,so we have some different tips from common edition game.
Get to know these information can help you enjoy the time in GoatCraft and integrate our community.


## Solar Network Integration

As both are products of Solsynth, GoatCraft and Solar Network have achieved chat integration.
This means you can send messages between GoatCraft and Solar Network.

The currently integrated chat room is the `摸鱼 | General` chat room under the `Solsynth` realm.
You can join the Solsynth realm from <here> (https://solian.app/realms/solsynth?invite=1).

Additionally, the server provides a `/sn` command, allowing you to convert in-game currency into Solar Network's Source Points.
The exchange rate is 1:100 (i.e., 1 Source Point equals 100 in-game currency), and an additional 20% handling fee will be charged during withdrawal.
You can also purchase in-game currency using Source Points, and there is no handling fee for purchases.

## Web Map

GoatCraft features a web-based map that you can access via your browser at <playmc.solsynth.dev> (https://playmc.solsynth.dev).
This map displays the locations of all online players, as well as the structures they have built and other information.

Powered by BlueMap.

## Teleportation System

Any GoatCraft player can use the `/tpa` and `/tpahere` commands to request to teleport to a selected player or invite them to teleport to your current location.

You can press the <kbd>T</kbd> key (to open the chat box) and click Accept or Reject to decide whether to accept the request.
Alternatively, you can type the command `/tpaccept` to accept the teleport request.

## Land Claim System

GoatCraft uses Towny to manage player claims. Since it can be slightly complex,
please refer to the Towny plugin documentation to learn more.

## Chest Shops

You can create a chest shop by holding an item, left-clicking on most containers, and then typing your desired price in the chat box.
For more features, please refer to the QuickShop-Hikari plugin documentation.

Powered by QuickShop-Hikari.

## Slimefun

GoatCraft has Slimefun4 installed. However, since its development has ceased,
the current experimental version for 1.21.8 may not be stable.
Nevertheless, if you feel like you've exhausted the vanilla gameplay, you might want to give it a try.

*Let's observe a moment of silence for Slimefun4...*
15 changes: 15 additions & 0 deletions docs/en/goatcraft/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
---
title: What is GoatCraft?
description: Can you eat it?
---

GoatCraft is a Minecraft server hosted by Solsynth,
aiming to provide players with a fun and creative gaming environment. Whether you are a master builder,
an adventurer, or a redstone engineer, GoatCraft welcomes you to join!

For the server IP and other information, you can visit
[this post](https://solian.app/posts/0199bee5-8494-74b5-83f9-3380777db628)
to learn more.

The server supports direct login with an official Minecraft account, or external login via GoatCraft Auth.
For instructions on how to use GCA, please refer to the GCA section.
5 changes: 5 additions & 0 deletions docs/en/solar-network/.nav.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
title: Solar Network
nav:
- "*.md"
- developers
- apis
99 changes: 99 additions & 0 deletions docs/en/solar-network/account-status.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
---
title: Account Status and Online Presence
description: Learn how to manage your online status, customize your personal settings, and view the status of others.
---

# Account Status and Online Presence

Learn how to manage your online status, customize your personal settings, and view the status of others.

## Online Status Types

Solar Network offers four online statuses that you can switch between freely based on your needs:

| Status Type | Value | Description | What Others See |
|-------------|-------|-------------|-----------------|
| Normal | 0 | Normal visible status | Displays "Online" |
| Busy | 1 | Visible busy status | Displays "Busy" |
| Do Not Disturb | 2 | Visible DND status | Displays "Do Not Disturb" |
| Invisible | 3 | Completely hidden status | Displays "Offline" |

### Status Details

- **Normal**: Your default status; others can see that you are online as usual.
- **Busy**: Indicates you are occupied with other things and prefer not to be disturbed.
- **Do Not Disturb**: When enabled, push notifications will be disabled.
- **Invisible**: Completely hides your online status; others will see you as offline.

!!! tip

If you set your status to "Invisible", others will see "Offline" when viewing your profile, with no way of knowing you are actually online.

## Setting Your Status

### Where to Set
Go to **Account** > Click **Status**.

### Configurable Fields

| Field | Description | Limit |
|-------|-------------|-------|
| Status Type | Select your online status | Required |
| Status Label | Custom status text | Max 1024 characters |
| Icon | Status icon | Max 128 characters |
| Clear After | Time to automatically clear the status | Optional |

### Auto Clear

You can set your status to automatically clear at a specific time. For example:

- Set to "Busy" during a meeting, and automatically revert to "Normal" after 1 hour.
- Set to "Do Not Disturb" while resting, and automatically revert after work hours.

## Status Sentiment

In addition to your online status, you can set a "Status Sentiment" to express your current mood:

| Sentiment Type | Description |
|----------------|-------------|
| Positive | Indicates a positive and upbeat mood |
| Neutral | Indicates a general or neutral mood |
| Negative | Indicates a negative or down mood |

Your status sentiment will be displayed in your activity calendar.

## Online Members in Chat Rooms

In chat rooms, you can view the members who are currently online.

### Group Chat Rooms

In group chat rooms, you can see:

- The number of online users
- A list of nicknames of online members
- Detailed information of online members (click to view)

### Direct Messages (DM)

In private messages, you can see:

- The other party's online status
- Their specific status message (e.g., "In a meeting")
- Their online/offline status

## Online Status FAQ

### Why is my status displaying incorrectly?

Status display might have a slight delay because the system caches your status information. If you just changed your status, please wait a moment before checking.

### Why do others see me as offline when I'm actually online?

This could be because you have set your status to "Invisible". In this case, your online status is hidden from other users.

Alternatively, the client's WebSocket connection might have been disconnected, failing to accurately report your online status to the server.

### Can I set multiple statuses at the same time?

No. You can only have one current status at a time. However, you can set a "Clear After" time to let the status automatically revert to the default after a specified period.
115 changes: 115 additions & 0 deletions docs/en/solar-network/account.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,115 @@
---
title: Solarpass
---

Accounts on Solar Network are also known as Solarpass, which can be used across all Solsynth products.

!!! warning

According to Article 3.5 of the Solar Network User Agreement, you are not allowed to create a second account on Solar Network. Creating "alt accounts" (smurf accounts) is a violation of the User Agreement.
This includes creating new accounts to evade bans after being penalized. **However, creating a new account after deleting your previous account data is not included in this restriction.**

> A natural person can only register and own one Solarpass account. We reserve the right to delete data from any sub-accounts belonging to the same user.

Fact Check: [Solsynth ToS](https://solsynth.dev/en/legal/user-agreement/)

## Creating an Account

You can create an account within Solian. To create an account, you need to provide the following information:

- **Username:** Can contain English letters, numbers, underscores, and hyphens.
It must be globally unique. **The username cannot be changed after creation, except in special cases by contacting customer support.**
- **Display Name:** There are few restrictions on the display name; any 4-32 characters will suffice.
- **Email:** Please provide a valid email address, as you will need to receive a registration confirmation email.
To enforce the policy against creating sub-accounts, this email must be globally unique.
- **Password:** The account password used for future logins. Please ensure it is secure.

After registering an account, you need to check the inbox of your bound email for a message from the Solarpass service,
which contains a link to confirm your registration. Before you use this link to confirm your registration, your account will lack permissions,
causing most features to be unusable. Any errors generated during this time are normal; please do not report them.

### Logging In

Solar Network uses a self-developed Multi-Factor Authentication (MFA) system, which is more convenient than traditional Two-Factor Authentication (2FA). You can choose any verification factor that is convenient for you to log in.

### Account Recovery Code

The Account Recovery Code is an important security backup for your account. When you cannot log in via other methods (such as email verification codes or authenticator app codes), the recovery code can help you regain access to your account.

!!! warning

**Please keep your recovery code safe!** The recovery code is displayed only once and cannot be retrieved if lost.

#### Why You Need a Recovery Code

- If you change your phone and cannot receive email verification codes or app codes.
- If you accidentally delete your authenticator app.
- If you temporarily cannot access your email.

The recovery code ensures you always have a way to regain access to your account.

#### How to Enable Recovery Code

1. Log in to your account.
2. Go to **Account** > **Account Settings** > **Verification Factors**.
3. Find the "Authentication" or "Two-Factor Authentication" settings.
4. Follow the instructions to enable the recovery code.
5. **Immediately save the recovery code in a secure place** (a password manager is recommended).

#### Logging In with a Recovery Code

If you cannot use other verification methods to log in:

1. Select "Use Recovery Code" on the login page.
2. Enter your account (username or email).
3. Enter your recovery code.
4. Complete the CAPTCHA (human verification).
5. The system will allow you to log in.

After logging in with a recovery code, the system will:

- Automatically disable that recovery code (you will need to generate a new one).
- Temporarily disable other verification methods.
- Log out all other devices.

#### Regenerating a Recovery Code

A recovery code becomes invalid after a single use. If you need a new recovery code:

1. Log in to your account.
2. Go to **Account** > **Account Settings** > **Verification Factors**.
3. Find the "Authentication" settings.
4. Re-enable the recovery code.
5. **Immediately save the new code.**

#### Security Recommendations

- **Generate only once:** Each generation displays a new code, and the old code becomes invalid immediately.
- **Store securely:** It is recommended to use a password manager or write it down and store it in a safe place.
- **Do not share:** Never share your recovery code with anyone.
- **Check regularly:** Ensure you still remember where you saved it.

### Deleting an Account

You may want to delete your Solarpass account because you no longer need it. This is divided into two sections:

- Things to know when deleting an account.
- How to delete my account.

### Things to Note When Deleting an Account

1. Publishers under your account will be deleted, including posts and stickers created by them.
2. You will no longer be able to log in to your account.
3. Data deletion will be processed with a delay, up to a maximum of 48 hours.

!!! warning

Deleting a Solarpass will only automatically clear your data on Solar Network. For accounts and data on other affiliated services such as SolarWatt and Solsynth Git, please delete/clear them before deregistering your Solarpass account; otherwise, you will lose access rights to them.

### How to Delete an Account

1. Click on "Account".
2. Scroll down and find "Account Settings".
3. Click "Delete Account".
4. The server will send a confirmation email to your bound primary email address.
You need to confirm the deletion within the valid time frame.
Loading