Skip to content

Commit

Permalink
Add guide about asking for help in FAQ
Browse files Browse the repository at this point in the history
  • Loading branch information
boholder committed Jan 11, 2024
1 parent a055e7b commit 34c6aaf
Showing 1 changed file with 50 additions and 3 deletions.
53 changes: 50 additions & 3 deletions doc/FAQ.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@
5. [Has this mod been uploaded to mod platforms?](#has-this-mod-been-uploaded-to-mod-platforms)
6. [Is this mod supports XX language?](#is-this-mod-supports-xx-language)
7. [How can I contribute to I18N?](#how-can-i-contribute-to-i18n)
8. [What information the others need when I ask them for help?](#what-information-the-others-need-when-i-ask-them-for-help)

## Is the mod enough to play the game normally?

Expand Down Expand Up @@ -39,11 +40,11 @@ We stick to the pure client-side strategy for now, since you need to install a s

## Why nobody answers my questions in Discord?

Sorry for the inconvenience. Here are some self-help materials to help you.
Sorry for the inconvenience. Here are some self-help materials.
If you have any question about installing, please read the [set-up guide](/doc/SET_UP.md).
If you have any question about original game functions, please search on the [wiki](https://minecraft.wiki/w/Special:Search?scope=internal) or just google it.
If you want to learn to play the game, there are [some detailed text tutorials on wiki](https://minecraft.wiki/w/Tutorials), you can also listen [Pixlriffs's Minecraft Survival Guide](https://www.youtube.com/watch?v=VfpHTJsn9I4&list=PLgENJ0iY3XBjmydGuzYTtDwfxuR6lN8KC) on YouTube, or just google the question and search answers on forums.
If you have any question about this ![img.png](img.png)mod, please read the [manual](/README.md).
If you have any question about this mod, please read the [manual](/README.md).

## Why this mod is updated slowly / the feature I asked was not released in the new version?

Expand All @@ -62,4 +63,50 @@ See [I18N Fallback Mechanism Feature](/doc/FEATURES.md#i18n-fallback-mechanism).

## How can I contribute to I18N?

We manage the translation of this mod in [another GitHub repository](https://github.com/khanshoaib3/minecraft-access-i18n#minecraft-access-i18n), take a look.
We manage the translation of this mod in [another GitHub repository](https://github.com/khanshoaib3/minecraft-access-i18n#minecraft-access-i18n), take a look.

## What information the others need when I ask them for help?

Chose the section that fits your progress:

### Haven't run the game yet

I assume you have taken a look at the [setup guide](/doc/SET_UP.md).

If you are walking on a path that the setup guide isn't mentioned (for example, you're not purchasing the game from the official site), developers can't help you since they just can't walk on the same path.
But you can still ask users in [Discord server](https://discord.gg/yQjjsDqWQX) (mc-help channel) for help with enough description, maybe there are users that solved that problem before.
Then we can update this path into the setup guide so everyone in the Future can benefit from it.

If you experience is not same as the setup guide describes you should expect when you're completely following the guide, it means there is something wrong or misleading in the setup guide.
Describe which step you currently are, what you find out is not same as the guide says.
I believe through talking we can find out what's wrong together and fix it.

### The game crushed when I start it from launcher

Great! Believe it or not, it's easier to be solved than "running but abnormal", game crushed because it KNEW something is wrong, better than knowing nothing.
There would be log files under the `logs` folder in your `.minecraft` folder, developers need the `debug.log` file, it contains enough information to find out where is the problem, please upload it to wherever that developers can view.
If the crush pop up dialog says something about "mod incompatibility", please refer [this section](/doc/SET_UP_ON_WINDOWS.md#upgrade-the-game-and-mods) in the setup guide.

### The game running but abnormal

#### Can't hear the game narration

Sorry but we don't have enough knowledge to solve this problem on Linux, we haven't got this type of report.

If you're in Windows, please check:

* There is no missing ["tolk" files](/doc/SET_UP_ON_WINDOWS.md#additional-installation-for-windows) under the game folder.
* You have set the ["Narrator"](https://minecraft.wiki/w/Options#Chat_Settings) game setting (under "Options", "Chat Settings") to "All" choice.

now open the launcher and start the game, when you're at the main screen (in which has "singleplayer game", "multiplayer game"...), close your screen reader and open built-in [Windows Narrator](https://support.microsoft.com/en-us/windows/complete-guide-to-narrator-e4397a0d-ef4f-b386-d8ae-c172f109bdb1) feature. Can you hear the menu selecting narration through Windows Narrator? If so the problem is in your screen reader, maybe the Narrator setting is wrong (for example, you need to close NVDA's keyboard narration setting since it will cover the narration from this mod), or there is a compatibility problem between it and "tolk".

#### This mod doesn't work like expected

I assume you have searched on [wiki](https://minecraft.wiki) or Internet to make sure you've understood the original game part of your question.
Please provide these information to developers in "mc-issues" channel:

* Your operation
* What you expected or what the mod manual premises
* What feedback the game and mod gave you

It might be a bug of this mod, or something in mod manual is misleading, or you misunderstand how the game works like.

0 comments on commit 34c6aaf

Please sign in to comment.