From f110774b9a82e13f6996bcf79232065800bb7a01 Mon Sep 17 00:00:00 2001 From: Oliver Date: Sat, 17 May 2025 13:32:57 +0200 Subject: [PATCH] fancydialogs: Add docs for fancydialogs --- docs/src/fancyanalytics/fancyanalytics.md | 2 +- docs/src/fancydialogs/api/api.yml | 2 + docs/src/fancydialogs/api/getting-started.md | 53 +++++++++++++++++++ docs/src/fancydialogs/changelog/changelog.yml | 2 + docs/src/fancydialogs/changelog/v1.md | 9 ++++ docs/src/fancydialogs/commands/commands.yml | 2 + docs/src/fancydialogs/commands/dialog.md | 10 ++++ .../src/fancydialogs/commands/fancydialogs.md | 13 +++++ docs/src/fancydialogs/fancydialogs.md | 49 +++++++++++++++++ docs/src/fancydialogs/faq.md | 10 ++++ docs/src/fancydialogs/getting-started.md | 27 ++++++++++ docs/src/fancydialogs/inspiration.md | 10 ++++ docs/src/fancydialogs/tutorials/tutorials.yml | 2 + 13 files changed, 190 insertions(+), 1 deletion(-) create mode 100644 docs/src/fancydialogs/api/api.yml create mode 100644 docs/src/fancydialogs/api/getting-started.md create mode 100644 docs/src/fancydialogs/changelog/changelog.yml create mode 100644 docs/src/fancydialogs/changelog/v1.md create mode 100644 docs/src/fancydialogs/commands/commands.yml create mode 100644 docs/src/fancydialogs/commands/dialog.md create mode 100644 docs/src/fancydialogs/commands/fancydialogs.md create mode 100644 docs/src/fancydialogs/fancydialogs.md create mode 100644 docs/src/fancydialogs/faq.md create mode 100644 docs/src/fancydialogs/getting-started.md create mode 100644 docs/src/fancydialogs/inspiration.md create mode 100644 docs/src/fancydialogs/tutorials/tutorials.yml diff --git a/docs/src/fancyanalytics/fancyanalytics.md b/docs/src/fancyanalytics/fancyanalytics.md index d54da6c0..57a233da 100644 --- a/docs/src/fancyanalytics/fancyanalytics.md +++ b/docs/src/fancyanalytics/fancyanalytics.md @@ -1,7 +1,7 @@ --- title: FancyAnalytics icon: graph -order: 90 +order: 80 --- # diff --git a/docs/src/fancydialogs/api/api.yml b/docs/src/fancydialogs/api/api.yml new file mode 100644 index 00000000..f9bb072b --- /dev/null +++ b/docs/src/fancydialogs/api/api.yml @@ -0,0 +1,2 @@ +icon: code +order: 6 \ No newline at end of file diff --git a/docs/src/fancydialogs/api/getting-started.md b/docs/src/fancydialogs/api/getting-started.md new file mode 100644 index 00000000..30f56f33 --- /dev/null +++ b/docs/src/fancydialogs/api/getting-started.md @@ -0,0 +1,53 @@ +--- +icon: dot +--- + +# Getting started + +## Include the API in your project + +To include the FancyNPCs API in your project, you need to add the following dependency to your `build.gradle.kts` or `pom.xml` file. + +**Gradle:** +```kotlin +repositories { + maven("https://repo.fancyinnovations.com/releases") +} +``` + +```kotlin +dependencies { + compileOnly("de.oliver:FancyDialogs:VERSION") +} +``` + +**Maven:** +```xml + + fancyinnovations-releases + FancyInnovations Repository + https://repo.fancyinnovations.com/releases + +``` + +```xml + + de.oliver + FancyDialogs + VERSION + provided + +``` + +Replace `VERSION` with the version of the API you want to use. You can find the latest version on the download pages or in the GitHub releases. + +## Create a new dialog + +TODO + +## JavaDocs and help + +You can find the JavaDocs for the FancyNpcs API [here](https://repo.fancyinnovations.com/javadoc/releases/de/oliver/FancyNpcs/latest). + +Join the [FancyInnovations Discord](https://discord.gg/ZUgYCEJUEx) for help and support. There is a dedicated channel for help about the api (`#npcs-dev`). +``` \ No newline at end of file diff --git a/docs/src/fancydialogs/changelog/changelog.yml b/docs/src/fancydialogs/changelog/changelog.yml new file mode 100644 index 00000000..ee9a3264 --- /dev/null +++ b/docs/src/fancydialogs/changelog/changelog.yml @@ -0,0 +1,2 @@ +icon: log +order: 5 \ No newline at end of file diff --git a/docs/src/fancydialogs/changelog/v1.md b/docs/src/fancydialogs/changelog/v1.md new file mode 100644 index 00000000..be2464a0 --- /dev/null +++ b/docs/src/fancydialogs/changelog/v1.md @@ -0,0 +1,9 @@ +--- +icon: dot +order: 1 +--- + +![](../../static/changelog_v1_x_x.png) + +# + diff --git a/docs/src/fancydialogs/commands/commands.yml b/docs/src/fancydialogs/commands/commands.yml new file mode 100644 index 00000000..4aaae68a --- /dev/null +++ b/docs/src/fancydialogs/commands/commands.yml @@ -0,0 +1,2 @@ +order: 9 +icon: command-palette \ No newline at end of file diff --git a/docs/src/fancydialogs/commands/dialog.md b/docs/src/fancydialogs/commands/dialog.md new file mode 100644 index 00000000..f341154d --- /dev/null +++ b/docs/src/fancydialogs/commands/dialog.md @@ -0,0 +1,10 @@ +--- +icon: dot +order: 10 +--- + +![](../../static/commands.png) + +# /Dialog + +The `/dialog` command is the main command for managing dialogs. diff --git a/docs/src/fancydialogs/commands/fancydialogs.md b/docs/src/fancydialogs/commands/fancydialogs.md new file mode 100644 index 00000000..508ef6bf --- /dev/null +++ b/docs/src/fancydialogs/commands/fancydialogs.md @@ -0,0 +1,13 @@ +--- +icon: dot +order: 9 +--- + +![](../../static/commands.png) + +# /FancyDialogs + +### Version + +- **Syntax**: `/fancydialogs version` +- **Permissions**: `fancydialogs.commands.fancydialogs.version` diff --git a/docs/src/fancydialogs/fancydialogs.md b/docs/src/fancydialogs/fancydialogs.md new file mode 100644 index 00000000..376eda97 --- /dev/null +++ b/docs/src/fancydialogs/fancydialogs.md @@ -0,0 +1,49 @@ +--- +title: FancyDialogs +icon: browser +order: 90 +--- + +# + +![](../static/logos-and-banners/fancydialogs-banner.png) + +!!! +Simple and lightweight dialogs plugin for Paper servers and other plugin developers. +!!! + +## Features + +With this plugin you can create fancy dialogs for your server or plugin. +FancyDialogs uses the new dialog feature, Minecraft introduced in **1.21.6** and combines it with the power of packets. + +!!!warning +The plugin will only for **Paper** servers on **1.21.6** or newer! +!!! + +**Core advantages of FancyDialogs:** +- Simple custom dialog creation (in JSON format or in code) +- Many different dialog types (simple, notice, confirmation, form, etc.) +- A lot of different dialog components (text, buttons, input fields, etc.) +- MiniMessages and PlaceholderAPI support + +### For servers + +If you use FancyDialogs as a plugin, you can take advantage of the following features: +- Dialog as welcome-screen for players joining the first time +- Custom tutorial dialogs +- Integration with FancyNpcs and FancyAnalytics + +### For plugin developers + +If you are a plugin developer and want to spice up your plugin with dialogs, you can use FancyDialogs as a library. + +You can define default dialogs, which will be persisted in the `plugins/FancyDialogs/dialogs` folder. +This allows server administrators to customize the dialogs for their server. +You can then use the dialogs in your plugin and show them to the players whenever you want. + +Common use cases are: +- Help dialogs (e.g. for commands or features) +- Confirmation dialogs for critical actions +- Shop UIs (replacing inventories UIs) +- Dialogs for quests diff --git a/docs/src/fancydialogs/faq.md b/docs/src/fancydialogs/faq.md new file mode 100644 index 00000000..8a859d42 --- /dev/null +++ b/docs/src/fancydialogs/faq.md @@ -0,0 +1,10 @@ +--- +order: 6 +icon: book +--- +# FAQ + +### Are older versions of Minecraft supported? + +No, FancyDialogs only supports 1.21.6 or newer. FancyDialogs uses the new dialogs, which only exist in 1.21.6 and newer. + diff --git a/docs/src/fancydialogs/getting-started.md b/docs/src/fancydialogs/getting-started.md new file mode 100644 index 00000000..ebfdeb80 --- /dev/null +++ b/docs/src/fancydialogs/getting-started.md @@ -0,0 +1,27 @@ +--- +order: 10 +icon: info +--- +# Getting started + +!!! danger +Be aware, that only Paper and Folia is supported, but the plugin should work on any of its forks (like Purpur or Pufferfish). Spigot, Bukkit, Sponge and Fabric is not supported. +!!! + +## Installation + +To install FancyDialogs, you need to download the latest version from one of the following sources: + +[!button size="s" icon="download" iconAlign="left" text="Modrinth" target="blank"](https://modrinth.com/plugin/fancydialogs/versions) + +[!button size="s" icon="download" iconAlign="left" text="Hangar" target="blank"](https://hangar.papermc.io/Oliver/FancyDialogs/versions) + +After downloading the plugin, you can install it by placing the downloaded file in the `plugins` folder of your server. + +Restart your server and you are ready to go! + +To check if the plugin is installed correctly, you can use the command `/fancydialogs version`. If the plugin is installed correctly, it will show you the version of the plugin. + +## Create your first dialog + +TODO \ No newline at end of file diff --git a/docs/src/fancydialogs/inspiration.md b/docs/src/fancydialogs/inspiration.md new file mode 100644 index 00000000..6be667fb --- /dev/null +++ b/docs/src/fancydialogs/inspiration.md @@ -0,0 +1,10 @@ +--- +order: 8 +icon: image +--- + +# Inspiration + +The following examples show how to use FancyDialogs in different ways. They are meant to give you an idea of what you can do with the plugin. + +Almost all examples are made by the community. If you have a nice example that you want to share, feel free come to our discord server and show it to us. diff --git a/docs/src/fancydialogs/tutorials/tutorials.yml b/docs/src/fancydialogs/tutorials/tutorials.yml new file mode 100644 index 00000000..59986be3 --- /dev/null +++ b/docs/src/fancydialogs/tutorials/tutorials.yml @@ -0,0 +1,2 @@ +order: 7 +icon: mortar-board \ No newline at end of file