Improve docs

Author: misieur

.gitignore

@@ -0,0 +1,4 @@
+.idea
+.vitepress/cache
+.vitepress/dist
+node_modules

.vitepress/config.mts

@@ -23,6 +23,13 @@ export default defineConfig({
                     {text: 'Introduction', link: '/introduction/introduction'},
                     {text: 'Getting Started', link: '/introduction/getting-stated'},
                 ]
+            },
+            {
+                text: 'General',
+                items: [
+                    {text: 'Web Server', link: '/general/web-server'},
+                    {text: 'Web Editor', link: '/general/web-editor'},
+                ]
             }
         ],
 

src/general/web-editor.md

@@ -0,0 +1,18 @@
+---
+outline: deep
+---
+
+# LostEngine Web Editor
+
+## Introduction
+LostEngine has a built-in web editor to help you to manage your custom resources.
+
+## How to use it
+In order to use the editor, you need to have enabled the `self_hosted` pack hosting method (see [Web Server](/general/web-server)),
+and use the `/le editor` command to get the write and read only link. The write link can do anything while the read only link
+can only view files but cannot create or edit them.
+
+:::tip
+Sharing a read only link to the editor can help people that help you if you have a bug or a question.
+The read only link will always end with "_readonly", and links expire each time you restart your server.
+:::

src/general/web-server.md

@@ -0,0 +1,32 @@
+---
+outline: deep
+---
+
+# LostEngine Integrated Web Server
+
+## Introduction
+LostEngine has an integrated web server for sending the resource pack to players and for the [Web Editor](/general/web-editor).
+It can work two different ways. The first one, like every other plugins, creates a separate HTTP server on a second port,
+this is great if you have multiple ports available on your server, but it needs to be configured manually. The second option,
+will use your Minecraft server's TCP connection to create an HTTP server, this means that the same port as your Minecraft server will be 
+used for the Web server. It works by detecting when a packet from a handshake connection is sent to your server, if it looks like
+an HTTP request or not. If it is the case, it switches the packet handler to LostEngine's HTTP packet handler and works the same as 
+on a second port without affecting it or removing any feature.
+
+## Configuring it
+::: code-group
+
+```yaml [config.yml]
+pack_hosting:
+  resource_pack_prompt: "Download the Lost Engine resource pack"
+  self_hosted:
+    enabled: true  # [!code highlight]
+    hostname: 0.0.0.0 # your server's public IP address [!code highlight]
+    use_minecraft_port: true # if it uses Minecraft's port or `port` below [!code highlight]
+    port: 7270 # if not using `use_minecraft_port` [!code highlight]
+  external_host:
+    enabled: false # [!code highlight]
+    url: ""
+```
+
+:::

src/introduction/getting-stated.md

@@ -8,6 +8,6 @@ outline: deep
 and install the corresponding Paper or Folia version *(other forks may work but are not supported)*.  
 For example:  
 `LostEngine-0.0.6-mc1.21.11.jar` needs Paper or Folia 1.21.11.
- - You will then need to put the JAR file into your servers' `plugins` folder and **restart your server**
+ - You will then need to put the JAR file into your server's `plugins` folder and **restart your server**
  - After restarting your server, some default items will be added, the resource pack should be working by default, 
 and you can access LostEngine's Web Editor using the `/le editor` command.

src/introduction/introduction.md

@@ -2,6 +2,7 @@
 outline: deep
 ---
 
+# Introduction
 ## What is LostEngine?
 
 LostEngine is a custom item plugin whose particularity is that it creates new items