diff --git a/Home.md b/Home.md index 6a24fd0..cc9aa04 100644 --- a/Home.md +++ b/Home.md @@ -19,6 +19,7 @@ It also has a list with all available placeholders (Work in progress). **[[Commands]]** **[[Expansion cloud]]** **[[FAQ]]** +**[[Common Issues]]** **[[Plugins using PlaceholderAPI]]** **[[Placeholders]]** - [[Standalone|Placeholders#standalone]] diff --git a/_Sidebar.md b/_Sidebar.md index f744ed0..b2f65e8 100644 --- a/_Sidebar.md +++ b/_Sidebar.md @@ -19,6 +19,7 @@ **[[Commands]]** **[[Expansion cloud]]** **[[FAQ]]** +**[[Common Issues]]** **[[Plugins using PlaceholderAPI]]** **[[Placeholders]]** - [[Standalone|Placeholders#standalone]] diff --git a/img/readme/create-pr.png b/img/readme/create-pr.png new file mode 100644 index 0000000..6a67522 Binary files /dev/null and b/img/readme/create-pr.png differ diff --git a/img/readme/fork.png b/img/readme/fork.png new file mode 100644 index 0000000..e68d571 Binary files /dev/null and b/img/readme/fork.png differ diff --git a/img/readme/needs-update.png b/img/readme/needs-update.png new file mode 100644 index 0000000..9e28b2e Binary files /dev/null and b/img/readme/needs-update.png differ diff --git a/img/readme/new-branch.png b/img/readme/new-branch.png new file mode 100644 index 0000000..572bb35 Binary files /dev/null and b/img/readme/new-branch.png differ diff --git a/img/readme/pr-prompt.png b/img/readme/pr-prompt.png new file mode 100644 index 0000000..006e929 Binary files /dev/null and b/img/readme/pr-prompt.png differ diff --git a/img/readme/select-branch.png b/img/readme/select-branch.png new file mode 100644 index 0000000..c064080 Binary files /dev/null and b/img/readme/select-branch.png differ diff --git a/img/readme/up-to-date.png b/img/readme/up-to-date.png new file mode 100644 index 0000000..c30f477 Binary files /dev/null and b/img/readme/up-to-date.png differ diff --git a/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/.github/workflows/push_to_wiki.yml b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/.github/workflows/push_to_wiki.yml new file mode 100644 index 0000000..6920935 --- /dev/null +++ b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/.github/workflows/push_to_wiki.yml @@ -0,0 +1,39 @@ +# +# This is a GitHub Action that allows us to auto-update the wiki +# when a Pull request changes specific files in the wiki branch. +# +name: Update Wiki from Repository + +on: + push: + # + # Only trigger when the push changes any files in the wiki-folder. + # + branches: + - 'wiki' + # + # Ignore changes to the README.md file + # + paths-ignore: + - 'README.md' + # + # Releases cause this action to also fire. + # Using this prevents this problem. + # + tags-ignore: + - '**' + +jobs: + update: + runs-on: ubuntu-latest + steps: + - name: 'Checkout Code' + uses: actions/Checkout@v3 + - name: 'Update Wiki' + uses: Andrew-Chen-Wang/github-wiki-action@v3 + env: + WIKI_DIR: '.' + GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} + GH_MAIL: 'actions@github.com' + GH_NAME: 'github-actions[bot]' + EXCLUDED_FILES: 'README.md' diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Commands.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Commands.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Commands.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Commands.md diff --git a/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Common-Issues.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Common-Issues.md new file mode 100644 index 0000000..bbaa00b --- /dev/null +++ b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Common-Issues.md @@ -0,0 +1,35 @@ +This page lists common issues you may encounter with PlaceholderAPI and how you can solve them. + +If you have more questions, feel free to join the [Discord Server](https://discord.gg/helpchat). + +## `java.lang.NoClassDefFoundError: com/google/gson/Gson` + +If you encounter an issue such as + +``` +org.bukkit.plugin.InvalidPluginException: java.lang.NoClassDefFoundError: com/google/gson/Gson +``` + +does it mean that the Server you're using PlaceholderAPI on does not have Gson included. +This is often the case for servers running 1.8 or older. To fix this, make sure to use at least 1.8.8 as that version does include the required dependency. + +## Expansions won't work + +If one or multiple expansions don't work, make sure you checked the following: + +- You executed `/papi reload` after downloading the expansion(s). +- Any required plugin is installed and enabled. +- The expansion is valid (See next sections). + +## `Failed to load expansion class ...` + +### `- One of its properties is null which is not allowed` + +When this error appears does it mean that either `getAuthor()`, `getIdentifier()` or `getVersion()` in the expansion return `null` which is not allowed. +In such a case, contact the developer of the expansion and inform them about this issue and that it should be fixed. + +### `(Is a dependency missing?)` + +This error is given whenever the expansion cannot be loaded, which often happens due to a missing dependency (required plugin) or because creating an expansion instance failed. + +The only thing you can do is to provide the full error so that we can check if the issue is caused by PlaceholderAPI (More unlikely) or by the expansion. \ No newline at end of file diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Expansion-cloud.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Expansion-cloud.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Expansion-cloud.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Expansion-cloud.md diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/FAQ.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/FAQ.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/FAQ.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/FAQ.md diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Home.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Home.md similarity index 99% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Home.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Home.md index 6a24fd0..cc9aa04 100644 --- a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Home.md +++ b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Home.md @@ -19,6 +19,7 @@ It also has a list with all available placeholders (Work in progress). **[[Commands]]** **[[Expansion cloud]]** **[[FAQ]]** +**[[Common Issues]]** **[[Plugins using PlaceholderAPI]]** **[[Placeholders]]** - [[Standalone|Placeholders#standalone]] diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Hook-into-PlaceholderAPI.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Hook-into-PlaceholderAPI.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Hook-into-PlaceholderAPI.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Hook-into-PlaceholderAPI.md diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/PlaceholderExpansion.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/PlaceholderExpansion.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/PlaceholderExpansion.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/PlaceholderExpansion.md diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Placeholders.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Placeholders.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Placeholders.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Placeholders.md diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Plugins-using-PlaceholderAPI.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Plugins-using-PlaceholderAPI.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/Plugins-using-PlaceholderAPI.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/Plugins-using-PlaceholderAPI.md diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/_Footer.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/_Footer.md similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/_Footer.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/_Footer.md diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/_Sidebar.md b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/_Sidebar.md similarity index 99% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/_Sidebar.md rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/_Sidebar.md index f744ed0..b2f65e8 100644 --- a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/_Sidebar.md +++ b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/_Sidebar.md @@ -19,6 +19,7 @@ **[[Commands]]** **[[Expansion cloud]]** **[[FAQ]]** +**[[Common Issues]]** **[[Plugins using PlaceholderAPI]]** **[[Placeholders]]** - [[Standalone|Placeholders#standalone]] diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/img/icon.png b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/img/icon.png similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/img/icon.png rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/img/icon.png diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/img/papi-logo.png b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/img/papi-logo.png similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/img/papi-logo.png rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/img/papi-logo.png diff --git a/temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/img/wiki-logo.png b/temp_wiki_816be42c322671a98f50f2800a25037f24e73212/img/wiki-logo.png similarity index 100% rename from temp_wiki_ed5b58795eb840d8951065ae0d5b98f81fc460c3/img/wiki-logo.png rename to temp_wiki_816be42c322671a98f50f2800a25037f24e73212/img/wiki-logo.png diff --git a/temp_wiki_excluded_ed5b58795eb840d8951065ae0d5b98f81fc460c3.txt b/temp_wiki_excluded_816be42c322671a98f50f2800a25037f24e73212.txt similarity index 100% rename from temp_wiki_excluded_ed5b58795eb840d8951065ae0d5b98f81fc460c3.txt rename to temp_wiki_excluded_816be42c322671a98f50f2800a25037f24e73212.txt