Troubleshooting section

FlyingPikachu 2018-11-30 23:50:58 -05:00
parent 6711462a42
commit 3048630f20

@ -1,7 +1,5 @@
Quests has many language files which are located at /plugins/Quests/lang/**ISO**/strings.yml by default, where "**ISO**" represents your preferred [language code](https://support.crowdin.com/api/language-codes/). Translations are provided [via Crowdin](https://crowdin.com/project/translate-quests), with English(en-US) being the source language. You may select the language of choice for your server by changing the [language code](https://support.crowdin.com/api/language-codes/) value of `language` in [config.yml](https://github.com/FlyingPikachu/Quests/wiki/Configuration). If a particular string/sentence has not been localized, it will default to English. To avoid this, you may edit the strings.yml file directly or [contribute a translation on Crowdin](https://crowdin.com/project/translate-quests).
Note that certain menu options may be difficult to use as a result of crowdsourced localization. Setting the value of `ask-confirmation` to `false` in [config.yml](https://github.com/FlyingPikachu/Quests/wiki/Configuration) may help minimize these issues.
### Viewing
Opening a strings.yml file that contains non-English characters on an English computer may not display those characters correctly. In the case of Windows, this is because Windows in English uses the ANSI character set, while the preferred format is UTF-8. Unfortunately, Windows makes this difficult to change, so we recommend an editing program that supports UTF-8. [Notepad++](https://notepad-plus-plus.org/) is a popular choice.
@ -62,4 +60,18 @@ Starting with Quests 3.2.4, [PlaceholderAPI](https://www.spigotmc.org/wiki/place
`journalPutAway: "You put away your Quest Journal."` --> `journalPutAway: "You put away %player_name%'s Quest Journal."`
Be advised that the "journalTitle" string will not accept placeholders, as allowing tokens there would break the book's metadata. If you're skeptical as to whether a string will accept a placeholder, best practice is to just try it!
Be advised that the "journalTitle" string will not accept placeholders, as allowing tokens there would break the book's metadata. If you're skeptical as to whether a string will accept a placeholder, best practice is to just try it!
### Troubleshooting
#### Some menu options aren't working!
Certain menu options may be difficult to use as a result of crowdsourced localization. Setting the value of `ask-confirmation` to `false` in [config.yml](https://github.com/FlyingPikachu/Quests/wiki/Configuration) may help minimize these issues.
#### There are no language files or folders!
Chances are Quests does not have permissions to generate the files. You may try running your server as an Administrator, or granting comprehensive folder permissions.
If you're on Windows, right-click on your /plugins folder, select Properties, and go to the Security tab. Click "Advanced" and then, in the Permissions tab, select "Change Permissions". Choose "Add" and in the Select User or Group window, type "everyone" in the text box. Click "Check Names" and then choose "OK". Continue clicking "OK" until all windows are closed.
Now, backup your Quests folder and delete the original (you can copy over any data from the backup later). Try running the server, allowing Quests to generate new files, and see if the issue is resolved.