feat: Reworked commands docs and added title to many pages

Author: 4drian3d

docs/developer-guide/Developer-Fabric-Setup.md

@@ -1,4 +1,5 @@
 ---
+title: Mod Development
 sidebar_label: 'Mod Development'
 sidebar_position: 6
 ---

docs/developer-guide/Developer-Getting-Started.mdx

@@ -1,4 +1,5 @@
 ---
+title: Getting Started
 sidebar_label: 'Getting Started'
 sidebar_position: 1
 ---
@@ -56,7 +57,7 @@ If you want a template to create your next expansion, you can use our template h
 
 Kotlin Extra is an API submodule that makes it easy to develop Expansions in Kotlin environments.
 
-It can only be used in environments that provide kotlin-stdlib, such as Krypton, Fabric with [Fabric Language Kotlin](https://modrinth.com/mod/fabric-language-kotlin), or with plugins that provide it, such as [MCKotlin](https://modrinth.com/plugin/mckotlin)
+It can only be used in environments that provide kotlin-stdlib, such as Fabric with [Fabric Language Kotlin](https://modrinth.com/mod/fabric-language-kotlin), or with plugins that provide it, such as [MCKotlin](https://modrinth.com/plugin/mckotlin)
 
 
 <Tabs groupId="build-system">

docs/developer-guide/Expansion-Creation.md

@@ -1,4 +1,5 @@
 ---
+title: Expansion Creation
 sidebar_label: 'Expansion Creation'
 sidebar_position: 2
 ---

docs/developer-guide/Expansion-Providers.md

@@ -1,4 +1,5 @@
 ---
+title: Expansion Provider
 sidebar_label: 'Expansion Providers'
 sidebar_position: 4
 ---

docs/developer-guide/Integration.md

@@ -3,9 +3,11 @@ sidebar_label: 'Project Integration'
 sidebar_position: 3
 ---
 
+This guide will teach you how to use the MiniPlaceholders API in your plugins or mods to parse placeholders from other projects.
+
 ## Obtaining Placeholders
 
-You can get the required plugin placeholders whenever you want, from the methods located in the main `MiniPlaceholders` class
+You can get the required plugin/mod placeholders whenever you want, from the methods located in the main `MiniPlaceholders` class
 
 ### Global
 
@@ -15,7 +17,7 @@ TagResolver resolver = MiniPlaceholders.globalPlaceholders();
 Component parsedMessage = MiniMessage.miniMessage().deserialize("Online Players: <proxy_online_players>", resolver);
 ```
 
-::: note
+:::note
 
 Starting with MiniPlaceholders v3, the returned TagResolvers do not depend on an Audience or a RelationalAudience. This was done to modernize the API, improve placeholder processing performance, and avoid potential issues when caching TagResolvers.
 

docs/developer-guide/MiniMessage-API-in-MiniPlaceholders.md

@@ -1,24 +1,27 @@
 ---
+title: MiniMessage API Usage
 sidebar_label: 'MiniMessage Integration'
 sidebar_position: 5
 ---
 
 MiniPlaceholders is a plugin that is completely based on the MiniMessage API. Therefore, to get the placeholders and to create expansions you need to have a basic knowledge.
 Here I will try to explain you in the best way how these APIs are related.
 
-# Obtaining Placeholders
---- TODO ---
+## TagResolver
+
+When you obtain the placeholders of a respective type, you will get an object of the TagResolver type. This object is capable of providing a Tag from a text or null if it does not correspond.
+
 ```java
 final TagResolver resolver = MiniPlaceholders.globalPlaceholders();
 ```
 
+It is recommended not to use TagResolver directly, but to delegate its use to MiniMessage parsing as appropriate.
+
 ```java
 final MiniMessage miniMessage = MiniMessage.miniMessage();
 final Component component = miniMessage.deserialize("some string with placeholders", resolver);
 ```
 
-# Creating an expansion
-
 ## Tags
 
 A Tag is an object to be inserted in the final component resulting from the parse of a TagResolver. This object determines how it will be inserted and how it will relate to other placeholders. There are several types of Tags that allow you to either directly insert a component without affecting other placeholders, or allow the result to be used as an argument in other placeholders.
@@ -52,15 +55,16 @@ This tag inserts a component and passes its attributes to the other characters u
 ```java
 return Tag.inserting(Component.text("Hi", NamedTextColor.RED));
 ```
-
-#### Desired Usage
+:::note[Recommended Usage]
 
 ```java
 // In this example, the placeholder player_prefix would use an inserting tag,
 // which would inherit the formatting to the following characters until a <reset> is done or the </player_prefix> tag is closed
 String string = "<player_prefix><player_name><gray>:<reset> <message>"
 ```
 
+:::
+
 ### Styling
 
 This tag applies formatting to the following characters until it is closed
@@ -69,12 +73,15 @@ This tag applies formatting to the following characters until it is closed
 return Tag.styling(NamedTextColor.AQUA);
 ```
 
-#### Desired Usage
+
+:::note[Recommended Usage]
 
 ```java
 String string = "<player_prefix><player_name><gray>: <player_chat_color><message>";
 ```
 
+:::
+
 ## ArgumentQueue
 
 The ArgumentQueue object allows you to get the arguments of the placeholder. The player can enter as many arguments as he wants, but you have the ability to specify whether a specific number of arguments is required.

docs/user-guide/Commands.md

@@ -5,14 +5,31 @@ sidebar_position: 3
 
 In MiniPlaceholders you are provided with a command in each platform to get the plugin information and to be able to parse the placeholders directly
 
-In Paper, Folia, Fabric and Krypton the command is `/miniplaceholders` and in Velocity the command is `/vminiplaceholders`
+In Paper, Folia, Fabric and Sponge the command is `/miniplaceholders` and in Velocity the command is `/vminiplaceholders`
 
 ## Commands
 
-- `/miniplaceholders <parse|help> player [some-player] "[message with placeholders]`
-- `/miniplaceholders parse player [some-player] "[message with placeholders]"`
+### Main Command
 
-#### Examples
+- `/miniplaceholders`
 
-- `/miniplaceholders parse me "<player_xp>"`
-- `/vminiplaceholders parse player 4drian3d "<player_name>"`
+Displays plugin information, such as the version, contributors, and links of interest.
+
+### Parse SubCommand
+
+- `/miniplaceholders parse me [message]`
+- `/miniplaceholders parse [some player] [message]`
+
+Allows you to preview how text would be displayed to the player by applying global and audience placeholders, providing the specific audience. If the “me” argument is used, the audience provided will be the executor of the command, whether it is an OP player or the console, and if the name of a connected player is used, that player will be used in the context.
+
+### Expansions SubCommand
+
+- `/miniplaceholders expansions`
+
+Allows you to review currently installed expansions and their information.
+
+### Help SubCommand
+
+- `/miniplaceholders expansions`
+
+It shows you all the available subcommands and how to use them.

docs/user-guide/Placeholders.md

@@ -104,14 +104,14 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 :::note[Built-in expansion]
 :::
 
-[Wiki](https://github.com/4drian3d/AuthmeVelocity)
-
 ```
 <authme_is_logged>
 <authme_is_player_logger:[player name]>
 ```
 
-## [AFKPlus](https://github.com/NotAlexNoyle/MiniPlaceholders-AFKPlus)
+## [AFKPlus](https://www.spigotmc.org/resources/afk.35065/)
+
+[Expansion Download](https://github.com/NotAlexNoyle/MiniPlaceholders-AFKPlus)
 
 ```
 <afkplus_status>
@@ -172,19 +172,40 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 <chatregulator_infractions_count:[infraction type]>
 ```
 
-## Chunky
+## [Chunky](https://modrinth.com/plugin/chunky)
 
-[Chunky Download](https://modrinth.com/plugin/chunky)
+[Expansion Download](https://github.com/MiniPlaceholders/Chunky-Expansion)
 
-[Wiki](https://modrinth.com/plugin/miniplaceholders-chunky-expansion)
+```
+<chunky_task_pregen_exists:<world>>
+<chunky_task_pregen_running:<world>>
+<chunky_task_pregen_cancelled:<world>>
+<chunky_task_pregen_centerx:<world>>
+<chunky_task_pregen_centerz:<world>>
+<chunky_task_pregen_radiusz:<world>>
+<chunky_task_pregen_radiusx:<world>>
+<chunky_task_pregen_radius:<world>>
+<chunky_task_pregen_count:<world>>
+<chunky_task_pregen_pattern:<world>>
+<chunky_task_pregen_shape:<world>>
+<chunky_task_pregen_time:<world>>
+<chunky_task_pregen_world:<world>>
+<chunky_task_pregen_chunks:<world>>
+<chunky_task_pregen_complete:<world>>
+<chunky_task_pregen_percent:<world>>
+<chunky_task_pregen_hours:<world>>
+<chunky_task_pregen_minutes:<world>>
+<chunky_task_pregen_seconds:<world>>
+<chunky_task_pregen_rate:<world>>
+<chunky_task_pregen_x:<world>>
+<chunky_task_pregen_z:<world>>
+```
 
 ## [ClientCatcher](https://modrinth.com/plugin/clientcatcher)
 
 :::note[Built-in expansion]
 :::
 
-[Wiki](https://modrinth.com/plugin/clientcatcher)
-
 ```
 <clientcatcher_client>
 <clientcatcher_mods>
@@ -197,17 +218,13 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 :::note[Built-in expansion]
 :::
 
-[Wiki](https://modrinth.com/plugin/creative-faces)
-
 ```
 <faces_player>
 ```
 
-## Cobblemon
-
-[Cobblemon Download](https://modrinth.com/mod/cobblemon)
+## [Cobblemon](https://modrinth.com/mod/cobblemon)
 
-[Cobblemon Expansion Download](https://modrinth.com/mod/cobblemonplaceholders)
+[Expansion Download](https://modrinth.com/mod/cobblemonplaceholders)
 
 [Wiki](https://github.com/PokeSkies/CobblemonPlaceholders/wiki/Placeholders)
 
@@ -235,9 +252,7 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 <epicguard_connections_per_second>
 ```
 
-## Floodgate
-
-[Floodgate Download](https://geysermc.org/download)
+## [Floodgate](https://geysermc.org/wiki/floodgate/)
 
 [Expansion Download](https://github.com/MiniPlaceholders/Floodgate-Expansion/releases)
 
@@ -248,8 +263,6 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 :::note[STANDALONE EXPANSION]
 :::
 
-[Expansion Download]
-
 [Wiki](https://github.com/MiniPlaceholders/ItemDisplay)
 
 <table>
@@ -267,17 +280,13 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
   </tr>
 </table>
 
-## Insights
-
-[Insights Download](https://modrinth.com/plugin/insights)
+## [Insights](https://modrinth.com/plugin/insights)
 
 [Expansion Download](https://github.com/MiniPlaceholders/Insights-Expansion/releases)
 
 [Wiki](https://github.com/MiniPlaceholders/Insights-Expansion)
 
-## Impactor
-
-[Impactor Download](https://modrinth.com/mod/impactor)
+## [Impactor](https://modrinth.com/mod/impactor)
 
 [ImpactorPlaceholders Download](https://github.com/PokeSkies/ImpactorPlaceholders)
 
@@ -305,9 +314,7 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 <libsdisguises_player_disguise_name>
 ```
 
-## LuckPerms
-
-[LuckPerms Download](https://luckperms.net/)
+## [LuckPerms](https://luckperms.net/)
 
 [Expansion Download](https://github.com/MiniPlaceholders/LuckPerms-Expansion/releases)
 
@@ -531,9 +538,7 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 <simplyrank_primary_rank>
 ```
 
-## Spark
-
-[Spark Download](https://spark.lucko.me/)
+## [Spark](https://spark.lucko.me/)
 
 [Expansion Download](https://github.com/MiniPlaceholders/Spark-Expansion/releases)
 
@@ -626,17 +631,23 @@ MiniPlaceholders v3 was recently released, and several of the expansions shown h
 <unemoji_emoji:[id]>
 ```
 
-## Vault
-
-[Vault Download](https://www.spigotmc.org/resources/vault.34315/)
+## [Vault](https://www.spigotmc.org/resources/vault.34315/)
 
 [Expansion Download](https://github.com/MiniPlaceholders/Vault-Expansion)
 
-[Wiki](https://github.com/MiniPlaceholders/Vault-Expansion)
-
-## ViaVersion
+```
+<vault_prefix>
+<vault_suffix>
+<vault_has_permission:[permission]>
+<vault_group>
+<vault_groups>
+<vault_group_prefix>
+<vault_group_suffix>
+<vault_in_group:[group]>
+<vault_in_primary_group:[group]>
+```
 
-[ViaVersion Download](https://modrinth.com/plugin/viaversion)
+## [ViaVersion](https://hangar.papermc.io/ViaVersion/ViaVersion)
 
 [Expansion Download](https://github.com/MiniPlaceholders/ViaVersion-Expansion)
 

docs/user-guide/Projects-using-MiniPlaceholders-API.md

@@ -1,5 +1,6 @@
 ---
-sidebar_label: 'MiniPlaceholders Compatible Projects'
+title: Compatible Projects
+sidebar_label: 'Compatible Projects'
 sidebar_position: 4
 ---
 

docs/user-guide/User-Getting-Started.md

@@ -6,7 +6,6 @@ title: Getting Started
 
 MiniPlaceholders is a plugin and mod that will allow you to use placeholders that various plugins/mods provide in various plugins/mods. These placeholders can contain text and colors, as well as click events, hovers, translatable messages, formatted messages, gradients and many more options.
 
-To use MiniPlaceholders, you need at least [Paper 1.21+](https://papermc.io/downloads/paper), Folia, [Velocity 3.3+](https://papermc.io/downloads/velocity), [Fabric 1.21.1+](https://fabricmc.net/) or [Sponge](https://spongepowered.org/) API 12+.
-
-It also requires a Java 21 version.
+To use MiniPlaceholders, you need at least [Paper 1.21+](https://papermc.io/downloads/paper), Folia, [Velocity 3.3+](https://papermc.io/downloads/velocity), [Fabric 1.21.6+](https://fabricmc.net/) or [Sponge](https://spongepowered.org/) API 12+.
 
+It also requires Java 21 or higher.