Update to 1.20 Docs (#172)

Author: olijeffers0n

docs/paper/dev/api/event-api/event-listeners.md

@@ -42,7 +42,7 @@ public class ExampleListener implements Listener {
 :::note[Events]
 
 There is no list of events that can be listened to, however take a look 
-[here](https://jd.papermc.io/paper/1.19/org/bukkit/event/Event.html) to see all events that extend `Event`.
+[here](https://jd.papermc.io/paper/1.20/org/bukkit/event/Event.html) to see all events that extend `Event`.
 
 An event can only be listened to if it has a static `getHandlerList` method.
 

docs/paper/dev/getting-started/paper-plugins.md

@@ -29,7 +29,7 @@ name: Paper-Test-Plugin
 version: '1.0'
 main: io.papermc.testplugin.TestPlugin
 description: Paper Test Plugin
-api-version: '1.19'
+api-version: '1.20'
 bootstrapper: io.papermc.testplugin.TestPluginBootstrap
 loader: io.papermc.testplugin.TestPluginLoader
 ```

docs/paper/dev/getting-started/plugin-yml.md

@@ -31,7 +31,7 @@ main: io.papermc.testplugin.ExamplePlugin
 description: An example plugin
 author: PaperMC
 website: https://papermc.io
-api-version: 1.19
+api-version: '1.20'
 ```
 
 ## Fields
@@ -89,8 +89,8 @@ This will be shown in the plugin info commands.
 
 The version of the Paper API that your plugin is using. This doesn't include the minor version.
 Servers with a version lower than the version specified here will refuse to load the plugin.
-The valid versions are 1.13 - 1.19.
-- `api-version: 1.19`
+The valid versions are 1.13 - 1.20.
+- `api-version: '1.20'`
 
 :::info
 

docs/paper/dev/getting-started/project-setup.md

@@ -31,7 +31,7 @@ repositories {
 }
 
 dependencies {
-    compileOnly("io.papermc.paper:paper-api:1.19.4-R0.1-SNAPSHOT")
+    compileOnly("io.papermc.paper:paper-api:1.20-R0.1-SNAPSHOT")
 }
 
 java {

docs/velocity/admin/reference/server-compatibility.md

@@ -10,7 +10,7 @@ we can.
 
 ## Compatible game versions
 
-As of this writing, Velocity is compatible with Minecraft 1.7.2 through 1.19.4.
+As of this writing, Velocity is compatible with Minecraft 1.7.2 through 1.20.
 
 ## Vanilla setups
 

docs/versioned/paper.json

@@ -1 +1,4 @@
-["1.18"]
+[
+  "1.19",
+  "1.18"
+]

docs/versioned/paper/content/1.19/README.md

@@ -0,0 +1,5 @@
+# Welcome to the Paper Docs
+
+Paper is a high performance fork of the Spigot Minecraft Server that aims to fix gameplay and
+mechanic inconsistencies as well as to improve performance. Paper contains numerous features, bug
+fixes, exploit preventions and major performance improvements not found in Spigot.

docs/versioned/paper/content/1.19/admin/README.mdx

@@ -0,0 +1,15 @@
+---
+slug: /admin
+---
+
+import DocCardList from "@theme/DocCardList";
+import { useCurrentSidebarCategory } from "@docusaurus/theme-common";
+
+# Paper Server Administration
+
+Welcome to the Paper Server Administration Guide! This guide includes information and tutorials
+regarding the administration of a Paper server.
+
+---
+
+<DocCardList items={useCurrentSidebarCategory().items} />

docs/versioned/paper/content/1.19/admin/getting-started/adding-plugins.md

@@ -0,0 +1,139 @@
+---
+toc_max_heading_level: 4
+slug: /adding-plugins
+---
+
+# Adding Plugins
+
+Plugins are the most powerful way to extend the functionality of Paper beyond the configuration
+files. Functionality added by plugins can range from making milk restore hunger or dead bushes grow,
+to adding entirely new and original game modes or items.
+
+:::danger[Malicious Plugins]
+
+Ensure you fully trust the source of any plugin before installing it. Plugins are given **full and
+unrestricted** access to not only your server but also the machine that it runs on. Because of this,
+it is imperative that plugins only be installed from trusted sources. Be careful!
+
+:::
+
+## Finding Plugins
+
+Before installing a plugin, you'll need to find what you want to install. The best place to find plugins is [Hangar](https://hangar.papermc.io), Paper's plugin repository, but you can also find many plugins
+on [SpigotMC](https://www.spigotmc.org/resources/),
+[BukkitDev](https://dev.bukkit.org/bukkit-plugins), or the
+[PaperMC Forums](https://forums.papermc.io/forums/paper-plugin-releases/), while other plugins may
+release on [GitHub](https://github.com). One of the best ways to find plugins isn't to browse any of
+these sites directly but to search for plugins using a search engine. Searching for the function you
+desire followed by `Minecraft plugin` will often yield good results.
+
+:::tip[Spigot and Bukkit Plugins]
+
+Paper is compatible with both Spigot and Bukkit plugins. It's okay if a plugin does not explicitly
+mention Paper compatibility. It'll still work.
+
+:::
+
+## Installing Plugins
+
+1. Once you've found the plugin you'd like to install, download it. Ensure the file you have
+   downloaded ends in `.jar`. Some plugins also distribute as `.zip` files, in which case you will
+   need to extract the file and locate the `.jar` for your platform, often labelled `bukkit` or
+   `paper`.
+2. Once you have the plugin downloaded locally, locate the `plugins` folder from the root directory
+   of your Paper server.
+3. Drag and drop the plugin file (`.jar`) into the `plugins` folder. If you are using a shared
+   hosting service, you may need to use their web panel or SFTP to upload the plugin; however, the
+   procedure will be the same.
+4. Restart your server. The plugin should load.
+5. Check your work. Once the server has finished loading, run the `/plugins` command in-game or type
+   `plugins` into the console. You should see your freshly installed plugin listed in green. If it
+   is not listed or is colored red, continue to [troubleshooting](#troubleshooting). A plugin listed
+   in red means that it is not currently enabled. For a freshly installed plugin, this often means
+   that the plugin failed to load.
+
+## Troubleshooting
+
+### Check your logs
+
+The first step to troubleshooting installing plugins is to check the log of your server. Your
+server's most recent logs will be stored to the `logs/latest.log` file. You may need to scroll near
+the beginning of this file to see when plugins were loaded.
+
+#### Missing Dependencies
+
+If you see something like this:
+
+```log
+Could not load 'plugins/MyAwesomePlugin-1.0.0.jar' in folder 'plugins'
+org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MyAwesomePlugin'.
+```
+
+This means that the plugin you tried to install is missing a dependency. A dependency, in this case,
+is another plugin that you must install for the first to function. While you will get a big scary
+error, the important line to look at is
+
+```log
+Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MyAwesomePlugin'.
+```
+
+This is telling you that in order to load `MyAwesomePlugin`, you must first install `Vault`.
+
+#### Invalid plugin.yml
+
+If you see something closer to this:
+
+```log
+Could not load 'plugins/MyAwesomePlugin-1.0.0.jar' in folder 'plugins'
+org.bukkit.plugin.InvalidDescriptionException: Invalid plugin.yml
+```
+
+This means that what you have downloaded isn't a valid Paper plugin. This is generally caused by one
+of the following:
+
+1. The plugin you downloaded isn't a plugin at all, but instead a mod for Forge, Fabric, or similar.
+   These will not run on Paper.
+2. The plugin failed to download completely. Especially when using tools such as `curl` or `wget`,
+   you can easily download error pages rather than the plugin you intended. This may also be caused
+   by a network issue. Attempt to download the plugin again. If you are using FTP (not SFTP or a web
+   panel) to upload your plugin to a shared hosting service, ensure your FTP client is in `binary`
+   and not `ASCII` mode. Consult the documentation for your FTP client for details.
+
+#### Ambiguous plugin name
+
+If you see something like this:
+
+```log
+Ambiguous plugin name `Essentials' for files `plugins/EssentialsX-2.19.4.jar' and `plugins/Essentialsx-2.20.0-dev.jar' in `plugins'
+```
+
+This means you have two plugins with the same name, which is not supported. In this case, two
+versions of EssentialsX are installed. Both the release `2.19.4`, and a development build of
+`2.20.0`. Ensure you only have one version of each plugin installed at one time. Delete the older
+version of the duplicate plugin, and restart your server.
+
+[//]: # "To prevent accidentally installing two versions of one plugin while updating, you can use"
+[//]: # "the `update` folder as described in the [Update Guide](/paper/how-to/update)."
+
+#### Something Else
+
+If you see an error, but it isn't similar to one of the above, attempt to read it yourself. While
+the full error may be large and scary, you likely only have to read the first one or two lines to
+understand what is going on. If you're not sure, do not hesitate to reach out for support on our
+[Discord](https://discord.gg/papermc) in the `#paper-help` channel.
+
+### If nothing is logged
+
+If nothing is logged, your server is likely not attempting to load any plugins. The conditions
+needed for the server to load a plugin are as follows:
+
+1. The file is at the root of the `plugins` folder, relative to its working directory. This is
+   usually the same folder as the server JAR file. **Subdirectories of the `plugins` folder will not
+   be checked.** All plugins must be in the root folder.
+2. The file ends in `.jar`. If your plugin does not end in `.jar`, what you have downloaded may not
+   be a plugin. Note that some plugins distribute multiple jars as `.zip` files. If this is the
+   case, you have to extract them before installing the plugin.
+
+If both of these are true and you still see no logs please reach out for support on our
+[Discord](https://discord.gg/papermc) server in the `#paper-help` channel. We will be happy to
+assist you.

docs/versioned/paper/content/1.19/admin/getting-started/getting-started.md

@@ -0,0 +1,62 @@
+---
+slug: /getting-started
+---
+
+# Getting Started
+
+## Requirements
+
+:::tip
+
+With the release of Minecraft 1.18, Paper now requires **Java 17** to run. If you don't already have
+Java 17, [it's easy to download and install](/misc/java-install).
+
+:::
+
+| Paper Version  | Recommended Java Version |
+| -------------- | ------------------------ |
+| 1.8 to 1.11    | Java 8                   |
+| 1.12 to 1.16.4 | Java 11                  |
+| 1.16.5         | Java 16                  |
+| 1.17.1-1.18.1+ | Java 17                  |
+
+## Migrating to Paper
+
+### From Vanilla
+
+Migrating from Vanilla is easy, but there are some differences, namely in world saves. Paper (and
+CraftBukkit and Spigot) separate out each dimension of a world (nether, the end, etc.) into separate
+world folders.
+
+Paper will handle this conversion for you automatically. No additional consideration is required.
+
+### From Craftbukkit or Spigot
+
+Paper is a drop in replacement for both CraftBukkit and Spigot, you don't need to make any changes.
+
+## Downloading Paper
+
+Paper provides runnable server jars directly from our
+[website's downloads page](https://papermc.io/downloads).
+
+Click on the build number to download a file.
+
+## Running The Server
+
+To run the server, simply start it up like any other Java application.
+
+Open your terminal, navigate to the saved location, and then run
+`java -Xms2G -Xmx2G -jar paper.jar --nogui`. Ensure you replace `paper.jar` with the name of the jar
+you have downloaded.
+
+The amount of RAM can be set by changing the numbers in the `-Xms` and `-Xmx` arguments. `--nogui`
+disables Vanilla's GUI, so you don't get double interfaces when using the command line.
+
+For more advanced Java tuning, see [Aikar's Flags](../how-to/aikars-flags.md).
+
+To configure your server, see the [Global Configuration](../reference/global-configuration.md) and
+[Per World Configuration](../reference/world-configuration.md) pages.
+
+## Updating The Server
+
+Updating Paper is simple! See our [Update Tutorial](../how-to/update.md) for more information.