diff --git a/docs/da/source/en/SUMMARY.md b/docs/da/source/en/SUMMARY.md index 4184eef..e918c0f 100644 --- a/docs/da/source/en/SUMMARY.md +++ b/docs/da/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [AeroDesk Developer API Guide](addons-api/aerodesk-developer-api-guide/README.md) + - [Kom I Gang](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Base API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Nøgleord Ofte Stillede Spørgsmål Og Eskaleringsniveauer](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Database & Config Sync Methods](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Kategorier & Supportniveauer](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Side 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Side 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/da/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..8efaa3c --- /dev/null +++ b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# AeroDesk Udvikler API Guide + +[AeroDesk](../../discord-bots/aerodesk/) er et meget modulært Discord bot management system designet til udvidelse. Denne guide dækker hvordan man krog ind i systemet og kæde centrale metoder direkte. + +Tabel med indhold: + diff --git a/docs/da/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..63bb123 --- /dev/null +++ b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Base API + +For at tilslutte sig systemet, skal din hovedklasse udvide `AeroDeskAddon`. Her er en grundlæggende implementering, der viser de grundlæggende basismetoder i en flydende måde: + +```java +pakke com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +public class MyCustomAddon extenends AeroDeskAddon { + + @Override + public void onEnable() { + // Prints custom log messages prefixed with the addon's name + getLogger(). nfo("Addon aktiveret og hooked ind i AeroDesk! ); + + // Henter hele BotConfig objektet + getApi(). etConfig(); + + // En hurtig genvej inde i tilføjelsen for at få fat i config + getLogger(). nfo("Nuværende bot præfiks er: " + getConfig().prefix); + } +} +``` + +eller + +```java +pakke com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +public class HelloWorldMain2 extenends AeroDeskAddon { + + @Override + public void onEnable() { + System. ut.println ("==================================="); + System.out. rintln ("👋 HELLO WORLD ADDON ENABLED! 👋"); + + prøv { + if (getApi() ! null && getApi(). etConfig()!= null) { + String dbType = getApi(). etConfig().database.activeDatabase; + // dbType returnerer hvad der er valgt e. MySQL + System.out. rintln ("The bot is currently using database: " + dbType); + } ellers { + System. ut. rintln "Den bot API eller config var ikke klar endnu, men addon indlæst! ); + } + } Fangst (Undtagelse e) { + // Dette vil udskrive den nøjagtige grund, hvis noget går galt her + System. rr.println ("Fejl ved læsning af config i HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln ("==================================="); + } + + @Override + public void onDisable() { + System. ut.println ("🛑 Hej World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/da/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..8d66b40 --- /dev/null +++ b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Kategorier Og Supportniveauer + +Organiser support anmodninger og klassificere prioriterede niveauer problemfrit uden at erklære mellemliggende variabler. + +- Hent Kategori: `getApi().getConfig().tickets.categories.get("bug");` +- Tilføj kategori: `getApi().getConfig().tickets.categories.put("bug", ny TicketCategory("Fejlrapporter", "Velkommen besked her", "123456789"));` +- Rediger Kategori: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "Ny Embed Title";` +- Slet Kategori: `getApi().getConfig().tickets.categories.remove("bug");` +- Hent Tier: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Tilføj Niveau: `getApi().getConfig().tickets.ticketTiers.add(ny BotConfig.TicketTier ("VIP Support", "987654321"));` +- Rediger Niveau: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Basic Support";` +- Slet niveau: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support"));` diff --git a/docs/da/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..0124c6d --- /dev/null +++ b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Database & Config Sync Methods + +Administrer den aktive database forbindelse og synkronisere konfigurationsændringer på tværs af dit system med det samme. Husk at gemme din config efter at have foretaget direkte ændringer via API. + +- Kontroller Aktiv DB: `getApi().getBotConfig().database.activeDatabase;` _(Returnerer "MySQL", "SQLite", "MongoDB", etc.)_ +- Hent DB Vært: `getApi().getBotConfig().database.host;` +- Gem Config Ændringer: `getApi().saveConfig();` _(Herrer eventuelle redigeringer foretaget via API gemmes i databasen/YAML)_ +- Genindlæs konfiguration: `getApi().reloadConfig();` _(Kræver botten for at hente friske data fra databasen)_ diff --git a/docs/da/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..c9f5582 --- /dev/null +++ b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Kom I Gang + +For at få API til den bot, du har brug for at have i din `pom.xml` + +Inkludér dette i dit projekt: + +```xml + + + avenvault-discord + https://maven. lugins.avenvault. om/discord/ + + + + + + com. venvault. iscord + AeroDesk-API + 1.0. + leveret + + +``` + +Du kan finde den seneste udgivelse [here](https://maven.plugins.avenvault.com/) under AeroDesk-API diff --git a/docs/da/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..0abe82a --- /dev/null +++ b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Nøgleord Ofte Stillede Spørgsmål Og Eskaleringsniveauer + +Administrer nøgleords-udløst auto-svar og billet-eskalering kæder direkte via config ved hjælp af `getApi()` krog. + +- Tilføj FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Åbn venligst en billet for refunderinger");` +- Hent FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refund");` +- Rediger FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Den nye tilbagebetalingspolitik anvendes.");` +- Slet FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("refund");` +- Hent Opskalering: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Tilføj Eskalering: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager anmeldelse", "fakturering", "1122334455")));` +- Slet Eskalering: `getApi().getConfig().tickets.escalationLevels.removeIf(level -> level.levelName.equals("Manager anmeldelse"));` diff --git a/docs/da/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..0d25964 --- /dev/null +++ b/docs/da/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Side 4 + diff --git a/docs/da/source/en/addons-api/page-2.md b/docs/da/source/en/addons-api/page-2.md new file mode 100644 index 0000000..92727ee --- /dev/null +++ b/docs/da/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Side 2 + diff --git a/docs/de/source/en/SUMMARY.md b/docs/de/source/en/SUMMARY.md index 4184eef..efb8c38 100644 --- a/docs/de/source/en/SUMMARY.md +++ b/docs/de/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [AeroDesk-Entwickler-API-Anleitung](addons-api/aerodesk-developer-api-guide/README.md) + - [Erste Schritte](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Basis-API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Stichwort FAQs & Eskalation Levels](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Datenbank & Config Sync Methoden](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Kategorien & Support-Bereiche](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Seite 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Seite 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/de/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..5f9c00d --- /dev/null +++ b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# AeroDesk Entwickler-API-Guide + +[AeroDesk](../../discord-bots/aerodesk/) ist ein hochmodulares Discord Bot Management System für Erweiterbarkeit. In diesem Leitfaden wird beschrieben, wie man direkt in das System und die Kettenkernmethoden eingreift. + +Inhaltsverzeichnis: + diff --git a/docs/de/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..f0654c0 --- /dev/null +++ b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Basis-API + +Um in das System einzugreifen, muss Ihre Hauptklasse `AeroDeskAddon` erweitern. Hier ist eine grundlegende Implementierung, die die grundlegenden Basis-Methoden in flüssiger Weise demonstriert: + +```java +package com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +öffentliche Klasse MyCustomAddon erweitert AeroDeskAddon { + + @Override + public void onEnable() { + // Gibt benutzerdefinierte Logmeldungen aus, die mit dem Namen des Addons + getLogger(). nfo("Addon aktiviert und gehackt in AeroDesk! ); + + // Holt das gesamte BotConfig-Objekt + getApi(). etConfig(); + + // Eine Schnellverknüpfung innerhalb des Addons, um die Konfiguration + getLogger(). nfo("Aktueller Bot-Präfix ist: " + getConfig().prefix); + } +} +``` + +oder + +```java +package com.example.myaddon; + +import com.avenvault.discord.api.AeroDeskAddon; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System.out.println("================================="); + System.out.println("👋 HELLO WORLD ADDON ENABLED! 👋"); + + try { + if (getApi() != null && getApi().getConfig() != null) { + String dbType = getApi().getConfig().database.activeDatabase; + // dbType returns what is selected e.g MySQL + System.out.println("The bot is currently using database: " + dbType); + } else { + System.out.println("The bot API or config was not ready yet, but addon loaded!"); + } + } catch (Exception e) { + // This will print the exact reason if something goes wrong here + System.err.println("Error reading config in HelloWorld2:"); + e.printStackTrace(); + } + + System.out.println("================================="); + } + + @Override + public void onDisable() { + System.out.println("🛑 Hello World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/de/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..042ae32 --- /dev/null +++ b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Kategorien & Support-Stufen + +Organisieren Sie Supportanfragen und ordnen Sie Prioritätsebenen nahtlos ein, ohne Zwischenvariablen zu deklarieren. + +- Kategorie abrufen: `getApi().getConfig().tickets.categories.get("bug");` +- Kategorie hinzufügen: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("Bug Reports", "Welcome message here", "123456789");` +- Kategorie bearbeiten: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "Neuer Einbetttitel";` +- Kategorie löschen: `getApi().getConfig().tickets.categories.remove("bug");` +- Rufe Tier: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Füge Tier: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321");` +- Bearbeite Tier: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Basic Support";` +- Lösche Tier: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support");` diff --git a/docs/de/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..9c847a8 --- /dev/null +++ b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Datenbank & Konfigurationssynchronen + +Verwalten Sie die aktive Datenbankverbindung und synchronisieren Sie die Konfigurationsänderungen auf Ihrem System sofort. Denken Sie daran, Ihre Konfiguration zu speichern, nachdem Sie direkte Änderungen über die API vorgenommen haben. + +- Überprüfe Active DB: `getApi().getBotConfig().database.activeDatabase;` _(Returns "MySQL", "SQLite", "MongoDB", etc.)_ +- DB Host abrufen: `getApi().getBotConfig().database.host;` +- Konfigurationsänderungen speichern: `getApi().saveConfig();` _(sichert alle über die API gemachten Änderungen werden in der Datenbank/YAML)_ gespeichert +- Konfiguration neu laden: `getApi().reloadConfig();` _(zwingt den Bot, frische Daten aus der Datenbank zu ziehen)_ diff --git a/docs/de/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..418dbce --- /dev/null +++ b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Erste Schritte + +Um die API für den Bot zu erhalten, musst du in deiner `pom.xml` haben + +Fügen Sie dies in Ihr Projekt ein: + +```xml + + + avenvault-discord + https://maven.plugins.avenvault.com/discord/ + + + + + + com.avenvault.discord + AeroDesk-API + 1.0.3 + provided + + +``` + +Du findest die neueste Version [here](https://maven.plugins.avenvault.com/) unter AeroDesk-API diff --git a/docs/de/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..a283a25 --- /dev/null +++ b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Stichwort-FAQs & Eskalationsstufen + +Verwalten Sie Keyword-ausgelöste Auto-Antworten und Ticket-Eskalationsketten direkt über die Konfiguration mit dem Hook `getApi()`. + +- FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Bitte ein Ticket für Erstattungen öffnen.");` +- FAQ: `getApi().getConfig().tickets.keyword Faqs.get("refund");` +- FAQ bearbeiten: `getApi().getConfig().tickets.keyword Faqs.put("refund", "New refund policy applied.");` +- FAQ löschen: `getApi().getConfig().tickets.keyword Faqs.remove("refund");` +- Escalation: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Eskalation: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "Abrechnung", "1122334455");` +- Löschen Escalation: `getApi().getConfig().tickets.escalationLevels.removeIf(level -> level.levelName.equals("Manager Review"));` diff --git a/docs/de/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..c37a108 --- /dev/null +++ b/docs/de/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Seite 4 + diff --git a/docs/de/source/en/addons-api/page-2.md b/docs/de/source/en/addons-api/page-2.md new file mode 100644 index 0000000..f7b7e5f --- /dev/null +++ b/docs/de/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Seite 2 + diff --git a/docs/en/source/en/SUMMARY.md b/docs/en/source/en/SUMMARY.md index 4184eef..ad698c2 100644 --- a/docs/en/source/en/SUMMARY.md +++ b/docs/en/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [AeroDesk Developer API Guide](addons-api/aerodesk-developer-api-guide/README.md) + - [Getting Started](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Base API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Keyword FAQs & Escalation Levels](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Database & Config Sync Methods](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Categories & Support Tiers](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Page 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Page 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/en/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..6c08d50 --- /dev/null +++ b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# AeroDesk Developer API Guide + +[AeroDesk](../../discord-bots/aerodesk/) is a highly modular Discord bot management system designed for extensibility. This guide covers how to hook into the system and chain core methods directly. + +Table of contents: + diff --git a/docs/en/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..c9b8619 --- /dev/null +++ b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Base API + +To hook into the system, your main class must extend `AeroDeskAddon`. Here is a basic implementation demonstrating the core base methods in a fluid manner: + +```java +package com.example.myaddon; + +import com.avenvault.discord.api.AeroDeskAddon; + +public class MyCustomAddon extends AeroDeskAddon { + + @Override + public void onEnable() { + // Prints custom log messages prefixed with the addon's name + getLogger().info("Addon enabled and hooked into AeroDesk!"); + + // Fetches the entire BotConfig object + getApi().getConfig(); + + // A quick shortcut inside the addon to grab the config + getLogger().info("Current bot prefix is: " + getConfig().prefix); + } +} +``` + +or + +```java +package com.example.myaddon; + +import com.avenvault.discord.api.AeroDeskAddon; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System.out.println("================================="); + System.out.println("👋 HELLO WORLD ADDON ENABLED! 👋"); + + try { + if (getApi() != null && getApi().getConfig() != null) { + String dbType = getApi().getConfig().database.activeDatabase; + // dbType returns what is selected e.g MySQL + System.out.println("The bot is currently using database: " + dbType); + } else { + System.out.println("The bot API or config was not ready yet, but addon loaded!"); + } + } catch (Exception e) { + // This will print the exact reason if something goes wrong here + System.err.println("Error reading config in HelloWorld2:"); + e.printStackTrace(); + } + + System.out.println("================================="); + } + + @Override + public void onDisable() { + System.out.println("🛑 Hello World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/en/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..66778ae --- /dev/null +++ b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Categories & Support Tiers + +Organize support requests and classify priority levels seamlessly without declaring intermediate variables. + +- Retrieve Category: `getApi().getConfig().tickets.categories.get("bug");` +- Add Category: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("Bug Reports", "Welcome message here", "123456789"));` +- Edit Category: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "New Embed Title";` +- Delete Category: `getApi().getConfig().tickets.categories.remove("bug");` +- Retrieve Tier: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Add Tier: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321"));` +- Edit Tier: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Basic Support";` +- Delete Tier: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support"));` diff --git a/docs/en/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..520a6ba --- /dev/null +++ b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Database & Config Sync Methods + +Manage the active database connection and synchronize configuration changes across your system instantly. Remember to save your config after making direct modifications via the API. + +- Check Active DB: `getApi().getBotConfig().database.activeDatabase;` _(Returns "MySQL", "SQLite", "MongoDB", etc.)_ +- Retrieve DB Host: `getApi().getBotConfig().database.host;` +- Save Config Changes: `getApi().saveConfig();` _(Ensures any edits made via the API are saved to the database/YAML)_ +- Reload Config: `getApi().reloadConfig();` _(Forces the bot to pull fresh data from the database)_ diff --git a/docs/en/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..af29a88 --- /dev/null +++ b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Getting Started + +In order to get the API for the bot you need to have in your `pom.xml` + +Include this in your project: + +```xml + + + avenvault-discord + https://maven.plugins.avenvault.com/discord/ + + + + + + com.avenvault.discord + AeroDesk-API + 1.0.3 + provided + + +``` + +You can find the latest release [here](https://maven.plugins.avenvault.com/) under AeroDesk-API diff --git a/docs/en/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..cee753e --- /dev/null +++ b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Keyword FAQs & Escalation Levels + +Manage keyword-triggered auto-responses and ticket escalation chains directly via the config using the `getApi()` hook. + +- Add FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Please open a ticket for refunds.");` +- Retrieve FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refund");` +- Edit FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "New refund policy applied.");` +- Delete FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("refund");` +- Retrieve Escalation: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Add Escalation: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "billing", "1122334455"));` +- Delete Escalation: `getApi().getConfig().tickets.escalationLevels.removeIf(level -> level.levelName.equals("Manager Review"));` diff --git a/docs/en/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..e6b1a2c --- /dev/null +++ b/docs/en/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Page 4 + diff --git a/docs/en/source/en/addons-api/page-2.md b/docs/en/source/en/addons-api/page-2.md new file mode 100644 index 0000000..1dbccb1 --- /dev/null +++ b/docs/en/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Page 2 + diff --git a/docs/es/source/en/SUMMARY.md b/docs/es/source/en/SUMMARY.md index 4184eef..22b66a2 100644 --- a/docs/es/source/en/SUMMARY.md +++ b/docs/es/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [Guía API de desarrollador AeroDesk](addons-api/aerodesk-developer-api-guide/README.md) + - [Empezando](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [API base](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Preguntas frecuentes sobre palabras clave y niveles de escalación](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Base de datos y Config Sync Methods](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Categorías y niveles de soporte](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Página 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Página 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/es/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..f23c4e2 --- /dev/null +++ b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# Guía de API de Desarrollador de AeroDesk + +[AeroDesk](../../discord-bots/aerodesk/) es un sistema de gestión de bots altamente modular de Discord diseñado para la extensibilidad. Esta guía cubre cómo enganchar directamente los métodos del núcleo del sistema y de la cadena. + +Tabla de contenidos: + diff --git a/docs/es/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..92bfcd6 --- /dev/null +++ b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# API Base + +Para conectar con el sistema, su clase principal debe extender `AeroDeskAddon`. Aquí hay una implementación básica que demuestra los métodos básicos de una manera fluida: + +```java +paquete com.example.myaddon; + +importar com.avenvault.discord.api. eroDesk; + +public class MyCustomAddon extends AeroDeskAddon { + + @Override + public void onEnable() { + // Imprime mensajes de registro personalizados con el prefijo + getLogger(). nfo("¡Complemento activado y conectado al AeroDesk! ); + + // Obtiene todo el objeto BotConfig + getApi(). etConfig(); + + // Un atajo rápido dentro del complemento para obtener la configuración + getLogger(). nfo("Current bot prefix is: " + getConfig().prefix); + } +} +``` + +o + +```java +paquete com.example.myaddon; + +importar com.avenvault.discord.api. eroDesk; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System. ut.println("================================="); + System.out. rintln("👋 ¡HELLO WORLD ADDON ENABLADO! 👋"); + + prueba { + if (getApi() ! null && getApi(). etConfig() != null) { + String dbType = getApi(). etConfig().database.activeDatabase; + // dbType devuelve lo que es seleccionado e. MySQL + System.out. rintln("El bot está usando actualmente la base de datos: " + dbType); + } else { + System. ut. rintln("El bot API o configuración no estaba listo todavía, pero el addon cargado! ); + } + } catch (Exception e) { + // Esto imprimirá la razón exacta si algo sale mal aquí + System. rr.println("Error leyendo configuración en HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln("========================================="); + } + + @Override + public void onDisable() { + System. ut.println("🛑 Hola World2 Addon Cerrando hacia abajo!"); + } +} +``` + +### diff --git a/docs/es/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..d166c2f --- /dev/null +++ b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Categorías y niveles de soporte + +Organizar solicitudes de soporte y clasificar los niveles de prioridad sin tener que declarar variables intermedias. + +- Recuperar Categoría: `getApi().getConfig().tickets.categories.get("bug");` +- Añadir Categoría: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("informes de errores", "Mensaje de bienvenida aquí", "123456789"));` +- Editar Categoría: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "Nuevo título de inserción";` +- Eliminar Categoría: `getApi().getConfig().tickets.categories.remove("bug");` +- Recuperar Tier: `getApi().getConfig().tickets.tickets.ticketTiers.get(0);` +- Añadir nivel: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("Soporte VIP", "987654321"));` +- Editar nivel: `getApi().getConfig().tickets.tickets.ticketTiers.get(0).name = "Soporte Básico";` +- Eliminar nivel: `getApi().getConfig().tickets.tickets.removeIf(tier -> tier.name.equals("Soporte VIP"));` diff --git a/docs/es/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..08e7d44 --- /dev/null +++ b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Base de datos y Config Sync Methods + +Administre la conexión de base de datos activa y sincronice los cambios de configuración en su sistema al instante. Recuerde guardar su configuración después de hacer modificaciones directas a través de la API. + +- Revise Active DB: `getApi().getBotConfig().database.activeDatabase;` _(Returns "MySQL", "SQLite", "MongoDB", etc.)_ +- Recuperar host DB: `getApi().getBotConfig().database.host;` +- Guardar Cambios de Config: `getApi().saveConfig();` _(asegura que cualquier edición realizada a través de la API se guardan en la base de datos/YAML)_ +- Recargar Config: `getApi().reloadConfig();` _(Forza al bot a extraer datos nuevos de la base de datos)_ diff --git a/docs/es/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..f7fb5e7 --- /dev/null +++ b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Comenzando + +Para obtener la API para el bot necesitas tener en tu `pom.xml` + +Incluye esto en tu proyecto: + +```xml + + + avenvault-discord + https://maven.plugins.avenvault.com/discord/ + + + + + + com.avenvault.discord + AeroDesk-API + 1.0.3 + provided + + +``` + +Puede encontrar la última versión [here](https://maven.plugins.avenvault.com/) en AeroDesk-API diff --git a/docs/es/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..992f2f4 --- /dev/null +++ b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Preguntas frecuentes sobre palabras clave y niveles de escala + +Administrar auto-respuestas y cadenas de escalación de tickets activadas por palabras clave directamente a través del gancho `getApi()`. + +- Añadir preguntas frecuentes: `getApi().getConfig().tickets.keywordFaqs.put("reembolso", "Por favor, abra un ticket para reembolsos.");` +- Recuperar FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refund");` +- Editar FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Nueva política de reembolso aplicada.");` +- Eliminar FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("reembolso");` +- Recuperar Escalation: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Add Escalation: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "billing", "1122334455"));` +- Eliminar escalación: `getApi().getConfig().tickets.escalationLevels.removeIf(level -> level.levelName.equals("Manager Review"));` diff --git a/docs/es/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..521debb --- /dev/null +++ b/docs/es/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Página 4 + diff --git a/docs/es/source/en/addons-api/page-2.md b/docs/es/source/en/addons-api/page-2.md new file mode 100644 index 0000000..54470ed --- /dev/null +++ b/docs/es/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Página 2 + diff --git a/docs/fi/source/en/SUMMARY.md b/docs/fi/source/en/SUMMARY.md index 4184eef..b5413de 100644 --- a/docs/fi/source/en/SUMMARY.md +++ b/docs/fi/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [AeroDesk Kehittäjän API-opas](addons-api/aerodesk-developer-api-guide/README.md) + - [Getting Started](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Base API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Keyword FAQs & Escalation Levels](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Tietokanta & Konfigurointimenetelmät](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Kategoriat & Tukitasoitukset](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Page 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Page 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..bcf2dcb --- /dev/null +++ b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# AeroDesk Developer API -opas + +[AeroDesk](../../discord-bots/aerodesk/) on erittäin modulaarinen Discord-botin hallintajärjestelmä, joka on suunniteltu laajaperäisyyteen. Tämä opas kattaa miten koukku järjestelmään ja ketjun ydinmenetelmiä suoraan. + +Sisällön taulukko: + diff --git a/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..edde2ac --- /dev/null +++ b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Base API + +Koukkuaksesi järjestelmään pääluokan täytyy ulottaa `AeroDeskAddon`. Tässä on perustavanlaatuinen täytäntöönpano osoittaa ydin perusmenetelmiä nestemäisellä tavalla: + +```java +package com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +public class MyCustomAddon extends AeroDeskAddon { + + @Override + public void onEnable() { + // Tulostaa mukautettuja lokiviestejä etukäteen lisäosan nimellä + getLogger(). nfo("Addon käytössä ja koukussa AeroDeskiin! ); + + // Hae koko pullonConfig objekti + getApi(). etConfig(); + + // Pikakuvake lisäosan sisällä napataksesi config + getLogger(). nfo("Nykyinen botin etuliite on: " + getConfig().prefix); + } +} +``` + +tai + +```java +package com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System. ut.println("================================"); + System.out. rintln ("👋 HELLO WORLD ADDON ENABLED! 👋"); + + kokeile { + jos (getApi() ! null &getApi(). etConfig() != null) { + String dbType = getApi(). etConfig().database.activeDatabase; + // dbType palauttaa mitä on valittu e. MySQL + System.out. rintln("Botti käyttää tällä hetkellä tietokantaa: " + dbType); + } muu { + System. uut. rintln("Botti API tai config ei ollut vielä valmis, mutta lisäosa ladattu! ); + } + } saalis (Exception e) { + // Tämä tulostaa tarkan syyn jos jotain menee pieleen tässä + System. rr.println ("Virhe luettaessa config HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln ("====================================="); + } + + @Override + public void onDisable() { + System. ut.println ("🛑 Hei World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..94a24a0 --- /dev/null +++ b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Kategoriat & Tukitasot + +Järjestä tukipyynnöt ja luokitella prioriteettitasot saumattomasti ilmoittamatta välimuuttujia. + +- Hae kategoria: `getApi().getConfig().tickets.categories.get ("bug");` +- Lisää kategoria: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("Bug Reports", "Welcome message here", "123456789"));` +- Muokkaa kategoriaa: `getApi().getConfig().tickets.categories.get ("bug").embedTitle = "New Embed Title";` +- Poista kategoria: `getApi().getConfig().tickets.categories.remove("bug");` +- Nouda tasoitti: `getApi().getConfig().tickets.ticketTiers.get(0)` +- Lisää otsikko: `getApi().getConfig().ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321");` +- Muokkaa tasoa: `getApi().getConfig().tickets.ticketTiers.get(0).nimi = "Basic Support";` +- Poista taso: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support");` diff --git a/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..01e90b7 --- /dev/null +++ b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Tietokannan & Konfiguraation Synkronointimenetelmät + +Hallitse aktiivista tietokantayhteyttä ja synkronoi konfiguraation muutokset koko järjestelmässä välittömästi. Muista tallentaa config kun olet tehnyt suoria muutoksia API:n kautta. + +- Tarkista aktiivinen DB: `getApi().getBotConfig().database.activeDatabase;` _(Palauttaa "MySQL", "SQLite", "MongoDB", jne.)_ +- Hae DB Host: `getApi().getBotConfig().database.host;` +- Tallenna Config Muutokset: `getApi().saveConfig();` __(Takaa kaikki API:n kautta tehdyt muokkaukset tallennetaan tietokantaan/YAML)_ +- Lataa konfigurointi: `getApi().reloadConfig();` _(Pakottaa botin vetämään tuoreita tietoja tietokannasta)_ diff --git a/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..72216f7 --- /dev/null +++ b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Aloittaminen + +Saadaksesi API botti sinun täytyy olla sinun `pom.xml` -tilassa + +Sisällytä tämä projektiin: + +```xml + + + avenvault-discord + https://maven. lugins.avenvault. om/discord/ + + + + + + com. venvault. iscord + AeroDesk-API + 1.0. + + + +``` + +Uusin julkaisu [here](https://maven.plugins.avenvault.com/) on AeroDesk-API diff --git a/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..3d70eee --- /dev/null +++ b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Avainsana FAQs & Escalation Levels + +Hallitse avainsanoilla laukaistuja automaattisia vastauksia ja lippujen eskalointiketjuja suoraan configin kautta käyttäen `getApi()`-koukkua. + +- Lisää FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Avaa lippu hyvitystä varten.");` +- Hae FAQ: `getApi().getConfig().tickets.keywordFaqs.get ("refund");` +- Muokkaa FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Uusi palautuskäytäntö");` +- Poista FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("hyvitys");` +- Hae skaalaus: `getApi().getConfig().tickets.escalationLevels.get(0)` +- Lisää skaalaus: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "billing", "1122334455"));` +- Poista skaalaus: `getApi().getConfig().tickets.escalationLevels.removef (taso -> level.levelName.equals("Manager Review");` diff --git a/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..f1fa168 --- /dev/null +++ b/docs/fi/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Sivu 4 + diff --git a/docs/fi/source/en/addons-api/page-2.md b/docs/fi/source/en/addons-api/page-2.md new file mode 100644 index 0000000..166215e --- /dev/null +++ b/docs/fi/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Sivu 2 + diff --git a/docs/fr/source/en/SUMMARY.md b/docs/fr/source/en/SUMMARY.md index 4184eef..12e06b4 100644 --- a/docs/fr/source/en/SUMMARY.md +++ b/docs/fr/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [Guide de l'API du développeur AéroDesk](addons-api/aerodesk-developer-api-guide/README.md) + - [Pour commencer](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [API de base](addons-api/aerodesk-developer-api-guide/base-api.md) + - [FAQ des mots clés et niveaux d'escalade](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Base de données & Méthodes de synchronisation de configuration](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Catégories et Niveaux de Support](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Page 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Page 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..22505fc --- /dev/null +++ b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# Guide API du développeur AéroDesk + +[AeroDesk](../../discord-bots/aerodesk/) est un système de gestion de bot Discord hautement modulaire conçu pour l'extensibilité. Ce guide explique comment s'accrocher directement au système et à la chaîne. + +Table des matières : + diff --git a/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..4e37331 --- /dev/null +++ b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# API de base + +Pour vous connecter au système, votre classe principale doit étendre `AeroDeskAddon`. Voici une implémentation de base démontrant les méthodes de base principales de manière fluide : + +```java +paquet com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +la classe publique MyCustomAddon extends AeroDeskAddon { + + @Override + public void onEnable() { + // Affiche les messages de log personnalisés préfixés par le nom de l'extension + getLogger(). nfo("Addon activé et branché sur AeroDesk! ); + + // Récupère l'ensemble de l'objet BotConfig + getApi(). et(); + + // Un raccourci rapide dans l'addon pour récupérer la configuration + getLogger(). nfo("Préfixe de bot actuel est: " + getConfig().prefix); + } +} +``` + +ou + +```java +paquet com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +la classe publique HelloWorldMain2 étend AeroDeskAddon { + + @Override + public void onEnable() { + System. ut.println("========================================="); + System.out. rintln("👋 ADDON HELLO WORLD ACTIVÉ ! 👋"); + + essayer { + if (getApi() ! null && getApi(). etConfig() != null) { + String dbType = getApi(). etConfig().database.activeDatabase; + // dbType retourne ce qui est sélectionné. MySQL + System.out. rintln("Le bot utilise actuellement la base de données: " + dbType); + } else { + System. ut. rintln("The bot API or config was not ready yet, but addon loaded! ); + } + } catch (Exception e) { + // Ceci affichera la raison exacte si quelque chose ne va pas ici + System. rr.println("Erreur de lecture de la configuration dans HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln ("========================================="); + } + + @Override + public void onDisable() { + System. ut.println("🛑 Hello World2 Addon Shutting Down!"); + } + +``` + +### diff --git a/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..93a557f --- /dev/null +++ b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Catégories et paliers de soutien + +Organiser les demandes de support et classer les niveaux de priorité de façon transparente sans déclarer les variables intermédiaires. + +- Récupérer la catégorie: `getApi().getConfig().tickets.categories.get("bug");` +- Ajouter une catégorie: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("Bug Reports", "Welcome message here", "123456789"));` +- Modifier la catégorie: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "New Embed Title";` +- Supprimer la catégorie: `getApi().getConfig().tickets.categories.remove("bug");` +- Récupérer le niveau : `getApi().getConfig().tickets.ticketTiers.get(0);` +- Ajouter un niveau : `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321"));` +- Modifier le niveau : `getApi().getConfig().tickets.ticketTiers.get(0).name = "Support de base";` +- Supprimer le niveau : `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("Support VIP"));` diff --git a/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..61d99e9 --- /dev/null +++ b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Méthodes de synchronisation de base de données et de configuration + +Gérez la connexion à la base de données active et synchronisez instantanément les changements de configuration sur votre système. N'oubliez pas de sauvegarder votre configuration après avoir fait des modifications directes via l'API. + +- Vérifier la base de données active: `getApi().getBotConfig().database.activeDatabase;` _(Retourne "MySQL", "SQLite", "MongoDB", etc.)_ +- Récupérer l'hôte DB : `getApi().getBotConfig().database.host;` +- Enregistrer les modifications de configuration : `getApi().saveConfig();` _(assure que toutes les modifications faites via l'API sont enregistrées dans la base de données/YAML)_ +- Recharger la configuration : `getApi().reloadConfig();` _(Force le bot à extraire les données de la base de données)_ diff --git a/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..b6e63e7 --- /dev/null +++ b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Commencer + +Afin d'obtenir l'API pour le bot vous devez avoir dans votre `pom.xml` + +Inclure ceci dans votre projet : + +```xml + + + avenvault-discord + https://maven. Lugins.avenvault. om/discord/ + + + + + + com. « venez. » iscord + AeroDesk-API + 1.0. + + + +``` + +Vous pouvez trouver la dernière version [here](https://maven.plugins.avenvault.com/) sous AéroDesk-API diff --git a/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..ef47cc0 --- /dev/null +++ b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Questions fréquentes et niveaux d'escalade + +Gérez les réponses automatiques déclenchées par les mots clés et les chaînes d'escalade de tickets directement via la configuration en utilisant le crochet `getApi()`. + +- Ajouter FAQ: `getApi().getConfig().tickets.keywordFaqs.put("remboursement", "Veuillez ouvrir un ticket pour les remboursements.");` +- Récupérer FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refund");` +- Modifier FAQ: `getApi().getConfig().tickets.keywordFaqs.put("remboursement", "Nouvelle politique de remboursement appliqué.");` +- Supprimer FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("refund");` +- Récupérer l'escalade: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Ajouter Escalade: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevels.add("Manager Review", "billing", "1122334455"));` +- Supprimer l'escalade : `getApi().getConfig().tickets.escalationLevels.removeIf(niveau -> level.levelName.equals("Manager Review"));` diff --git a/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..e6b1a2c --- /dev/null +++ b/docs/fr/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Page 4 + diff --git a/docs/fr/source/en/addons-api/page-2.md b/docs/fr/source/en/addons-api/page-2.md new file mode 100644 index 0000000..1dbccb1 --- /dev/null +++ b/docs/fr/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Page 2 + diff --git a/docs/no/source/en/README.md b/docs/no/source/en/README.md index 6df5812..3f714f3 100644 --- a/docs/no/source/en/README.md +++ b/docs/no/source/en/README.md @@ -42,5 +42,5 @@ If you require further technical assistance beyond these guides, please reach ou - Email Support: [Contact Us](https://plugins.avenvault.com/contact) - **Support Discord:** Soon! -- **Ticket Portal:** Open a ticket in `#support-tickets` after you have verified your license with /verify-license. +- **Billettportal:** Opprett en sak i `#support-tickets` etter at du har verifisert lisensen din med `/verify-license`. diff --git a/docs/no/source/en/SUMMARY.md b/docs/no/source/en/SUMMARY.md index 4184eef..1ac012f 100644 --- a/docs/no/source/en/SUMMARY.md +++ b/docs/no/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [AeroDesk Developer API-guid](addons-api/aerodesk-developer-api-guide/README.md) + - [komme i gang](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Base API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Keyword FAQs & Escalation Levels] (addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Database & Config Sync Methods](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Kategorier og støtte Tiers](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Page 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Page 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/no/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..bfffee4 --- /dev/null +++ b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# AeroDesk Developer API Guide + +[AeroDesk](../../discord-bots/aerodesk/) er et svært modular Discord bot styringssystem designet for utvidelse. Denne veiledningen dekker hvordan man hekker sammen i systemet og kjeder kjernemetoder direkte. + +Tabell over innhold: + diff --git a/docs/no/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..fe8bd93 --- /dev/null +++ b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Base API + +For å hekke inn i systemet må din hovedklasse utvide `AeroDeskAddon`. Her er en grunnleggende gjennomføring som demonstrerer kjernebasemetodene på en væskemetode: + +```java +pakke com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +offentlig klasse MyCustomAddon utvider AeroDeskAddon { + + @Override + offentlig void onEnable() { + // Prints custom log messages prefikset med addon's navn + getLogger(). nfo("Tillegg aktivert og koblet til AeroDesk! ); + + // Henter hele BotKonfigurasjon-objektet + getApi(). etConfig(); + + / En hurtigsnarvei i addonen for å gripe config + getLogger(). nfo(«Nåværende bot prefix er: » + getConfig().prefiks); + } +} +``` + +eller + +```java +package com.example.myaddon; + +import com.avenvault.discord.api.AeroDeskAddon; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System.out.println("================================="); + System.out.println("👋 HELLO WORLD ADDON ENABLED! 👋"); + + try { + if (getApi() != null && getApi().getConfig() != null) { + String dbType = getApi().getConfig().database.activeDatabase; + // dbType returns what is selected e.g MySQL + System.out.println("The bot is currently using database: " + dbType); + } else { + System.out.println("The bot API or config was not ready yet, but addon loaded!"); + } + } catch (Exception e) { + // This will print the exact reason if something goes wrong here + System.err.println("Error reading config in HelloWorld2:"); + e.printStackTrace(); + } + + System.out.println("================================="); + } + + @Override + public void onDisable() { + System.out.println("🛑 Hello World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/no/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..7b5f6e0 --- /dev/null +++ b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Kategorier og støtte erfaringer + +Organiser forespørsler og klassifisere prioritetsnivåer sømløst uten å deklarere mellomvariabler. + +- Hent kategori: `getApi().getConfig().tickets.categories.get("bug");` +- Legg til kategori: `getApi().getConfig().tickets.categories.put("bug", nye TicketCategory("Bug Reports", "Velkommen melding her", "123456789"));` +- Redigere kategori: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "New Embed Title";` +- Slett kategori: `getApi().getConfig().tickets.categories.remove("bug");` +- Hent Tier: `getApi().getConfig().).tickets.ticketTiers.get(0);` +- Legg til Tier: `getApi().getConfig().tickets.ticketTiers.add(ny BotConfig.TicketTier("VIP Support", "987654321"));` +- Rediger Tier: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Basic Support";` +- Slette Tier: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support");` diff --git a/docs/no/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..a406eeb --- /dev/null +++ b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Synk. av database & Konfigurasjon + +Administrer den aktive databasekoblingen og synkroniser konfigurasjonsendringene på tvers av systemet umiddelbart. Husk å lagre konfigurasjonen etter å ha gjort direkte endringer via API. + +- Sjekk Active DB: `getApi().getBotConfig().database.activeDatabase;` _(Returns "MySQL", "SQLite", "MongoDB", etc.)_ +- Hent DB Vert: `getApi().getBotConfig().database.host;` +- Lagre Konfigurasjonsendringer: `getApi().saveConfig();` _(Sikrer alle endringer som er gjort via API-et, lagres i databasen/YAML)_ +- Last inn konfigurasjon: `getApi().reloadConfig();` _(tvinger botten til å hente nye data fra databasen)_ diff --git a/docs/no/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..e683783 --- /dev/null +++ b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Komme i gang + +For å få API for boten må du ha i din `pom.xml` + +Inkluder dette i prosjektet ditt: + +```xml + + + avenvault-discord + https://maven.plugins.avenvault.com/discord/ + + + + + + com.avenvault.discord + AeroDesk-API + 1.0.3 + provided + + +``` + +Du finner den siste utgivelsen [here](https://maven.plugins.avenvault.com/) under AeroDesk-API diff --git a/docs/no/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..b154b9d --- /dev/null +++ b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Nøkkelord FAQs & skaleringsnivåer + +Behandle nøkkelord-utløste autosvar og billetteskaleringskjeder direkte via konfigurasjonen med `getApi()`-kroken. + +- Legg til FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Vennligst åpne en billett for refusjon.");` +- Hent FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refunder");` +- Rediger FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refundert", "Ny refusjonspolicy benyttet.");` +- Slett FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("refundert);` +- Hente Eskalering: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Legg til Eskalering: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "fakturering", "1122334455"));` +- Slett Eskalering: `getApi().getConfig().tickets.escalationLevels.removeIf(level -> level.levelName.equals("Manager Review"));` diff --git a/docs/no/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..0d25964 --- /dev/null +++ b/docs/no/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Side 4 + diff --git a/docs/no/source/en/addons-api/page-2.md b/docs/no/source/en/addons-api/page-2.md new file mode 100644 index 0000000..92727ee --- /dev/null +++ b/docs/no/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Side 2 + diff --git a/docs/no/source/en/network-and-firewall-guides/allowing-port-443.md b/docs/no/source/en/network-and-firewall-guides/allowing-port-443.md index 95d26aa..ddf6180 100644 --- a/docs/no/source/en/network-and-firewall-guides/allowing-port-443.md +++ b/docs/no/source/en/network-and-firewall-guides/allowing-port-443.md @@ -1,107 +1,107 @@ -# Allowing Port 443 +# Tillate port 443 -Our plugins licensing system requires active communication over Port 443 (HTTPS) to authenticate your license with our web servers. If your system firewall, cloud security group, or host blocks outbound connections on Port 443, the plugin will fail to load. +Lisensieringssystemet for våre utvidelser krever aktiv kommunikasjon via port 443 (HTTPS) for å autentisere lisensen din mot våre webservere. Hvis systemets brannmur, skysikkerhetsgruppe eller vert blokkerer utgående tilkoblinger på port 443, vil ikke plugin-modulen kunne lastes inn. -This guide provides step-by-step instructions to ensure Port 443 is unblocked on your host server. +Denne veiledningen gir trinnvise instruksjoner for å sikre at port 443 er åpnet på vertsserveren din. ### Windows Server / Windows OS -On Windows, Port 443 outbound traffic is usually open by default, but local firewall policies or anti-virus software can sometimes block it. +I Windows er utgående trafikk på port 443 vanligvis åpen som standard, men lokale brannmurregler eller antivirusprogramvare kan noen ganger blokkere den. -#### Method 1: Windows Defender Firewall (GUI) +#### Metode 1: Windows Defender-brannmur (GUI) -1. Press `Win + R`, type `wf.msc`, and press Enter to open Windows Defender Firewall with Advanced Security. -2. Click on Outbound Rules in the left panel. -3. In the right panel, click New Rule... -4. Select Port and click Next. -5. Choose TCP, select Specific remote ports, and type `443`. Click Next. -6. Select Allow the connection and click Next. -7. Keep all profiles checked (Domain, Private, Public) and click Next. -8. Name the rule (e.g., `BedwarsRestrictions - Port 443 Outbound`) and click Finish. +1. Trykk på `Win + R`, skriv inn `wf.msc` og trykk på Enter for å åpne Windows Defender-brannmur med avansert sikkerhet. +2. Klikk på Utgående regler i panelet til venstre. +3. Klikk på Ny regel... i panelet til høyre. +4. Velg port og klikk på Neste. +5. Velg TCP, velg spesifikke eksterne porter, og skriv inn `443`. Klikk på Neste. +6. Velg «Tillat tilkoblingen» og klikk på «Neste». +7. La alle profiler være valgt (Domene, Privat, Offentlig) og klikk på Neste. +8. Gi regelen et navn (f.eks. `Plugin - Port 443 Outbound`) og klikk på Fullfør. -#### Method 2: PowerShell (Administrator) +#### Metode 2: PowerShell (administrator) -Open PowerShell as Administrator and run the following command to automatically create the outbound rule: +Åpne PowerShell som administrator og kjør følgende kommando for å opprette utgående regel automatisk: ``` -New-NetFirewallRule -DisplayName "Allow Outbound HTTPS 443" -Direction Outbound -Action Allow -Protocol TCP -RemotePort 443 +New-NetFirewallRule -DisplayName "Tillat utgående HTTPS 443" -Retning utgående -Handling Tillat -Protokoll TCP -Eksternport 443 ``` ### Linux (Ubuntu, Debian, CentOS, RHEL) -Most Linux dedicated servers or VPS instances utilize local firewalls such as `UFW` or `firewalld`. +De fleste dedikerte Linux-servere eller VPS-instanser benytter lokale brannmurer som `UFW` eller `firewalld`. #### 1. Ubuntu / Debian (`ufw`) -Check your current UFW status and allow outbound/inbound HTTPS traffic: +Sjekk gjeldende UFW-status og tillat utgående/innkommende HTTPS-trafikk: ``` -# Check UFW status +# Sjekk UFW-status sudo ufw status -# Allow HTTPS (Port 443) traffic +# Tillat HTTPS-trafikk (port 443) sudo ufw allow 443/tcp sudo ufw allow out 443/tcp -# Reload firewall rules +# Last inn brannmurregler på nytt sudo ufw reload ``` #### 2. CentOS / RHEL / AlmaLinux (`firewalld`) -If your system uses `firewalld`: +Hvis systemet ditt bruker `firewalld`: ``` -# Allow HTTPS service permanently +# Tillat HTTPS-tjeneste permanent sudo firewall-cmd --permanent --add-service=https -# Allow Port 443 TCP explicitly +# Tillat port 443 TCP eksplisitt sudo firewall-cmd --permanent --add-port=443/tcp -# Reload firewall settings +# Last inn brannmurinnstillinger på nytt sudo firewall-cmd --reload ``` -#### 3. Native `iptables` +#### 3. Innebygd `iptables` -If you manage raw `iptables` rules directly: +Hvis du administrerer rå `iptables`-regler direkte: ``` -# Allow outbound TCP traffic on port 443 +# Tillat utgående TCP-trafikk på port 443 sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT -# Save rules (varies by OS distribution) +# Lagre regler (varierer avhengig av OS-distribusjon) sudo service iptables save ``` ### macOS Server / macOS -If you are running a local test server on macOS, traffic can be allowed via System Settings or the Packet Filter (`pf`) tool. +Hvis du kjører en lokal testserver på macOS, kan trafikk tillates via Systeminnstillinger eller verktøyet Packet Filter (`pf`). -#### Method 1: System Settings (GUI) +#### Metode 1: Systeminnstillinger (GUI) -1. Open System Settings > Network > Firewall. -2. Click Options... -3. Ensure Block all incoming connections is OFF. -4. Ensure your Java binary (or Minecraft server terminal) is set to Allow incoming connections. +1. Åpne Systeminnstillinger > Nettverk > Brannmur. +2. Klikk på Alternativer... +3. Sørg for at «Blokker alle innkommende tilkoblinger» er slått av. +4. Sørg for at Java-kjørefilen (eller terminalen for Minecraft-serveren) er innstilt til å tillate innkommende tilkoblinger. -#### Method 2: Terminal (`pfctl`) +#### Metode 2: Terminal (`pfctl`) -To allow traffic through the built-in macOS packet filter: +For å tillate trafikk gjennom det innebygde pakkefilteret i macOS: -1. Open Terminal. -2. Check if `pf` is running: +1. Åpne Terminal. +2. Sjekk om `pf` kjører: ``` sudo pfctl -s info ``` -3. To add a temporary pass rule for port 443: +3. For å legge til en midlertidig tillatelsesregel for port 443: ``` - echo "pass out proto tcp to any port 443" | sudo pfctl -a custom -f - + echo "send proto tcp til hvilken som helst port 443" | sudo pfctl -a custom -f - ``` -### Cloud Hosting / VPS Providers +### Leverandører av skyhosting / VPS If you host your server on cloud providers (such as AWS, DigitalOcean, Linode, or Google Cloud), operating system firewalls are often supplemented by External Cloud Firewalls / Security Groups although normally its enabled by default or asks on creation of instance. @@ -152,7 +152,7 @@ If you host your server on cloud providers (such as AWS, DigitalOcean, Linode, o #### **Game Panel Hosts (Pterodactyl / Apex / Bisect)** -Most shared Minecraft hosts leave outbound Port 443 open by default. If you still encounter connection errors, contact your hosting provider's support team to verify that outbound HTTPS requests are not restricted by network proxies or panel firewalls. +De fleste leverandører av delt Minecraft-hosting lar utgående port 443 være åpen som standard. Hvis du fortsatt opplever tilkoblingsfeil, bør du kontakte kundestøtten hos leverandøren av webhotell for å bekrefte at utgående HTTPS-forespørsler ikke blokkeres av nettverksproxyer eller brannmurer i kontrollpanelet. ### How to Test Port 443 Connectivity diff --git a/docs/pl/source/en/SUMMARY.md b/docs/pl/source/en/SUMMARY.md index 4184eef..bb23d7a 100644 --- a/docs/pl/source/en/SUMMARY.md +++ b/docs/pl/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [Przewodnik dla programistów AeroDesk API](addons-api/aerodesk-developer-api-guide/README.md) + - [Pierwsze kroki](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Podstawowy API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Słowo kluczowe FAQ i poziomy eskalacji](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Baza danych i metody synchronizacji konfiguracji](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Kategorie i grupy wsparcia](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Strona 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Strona 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..13e2df6 --- /dev/null +++ b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# Przewodnik dla programistów AeroDesk + +[AeroDesk](../../discord-bots/aerodesk/) jest wysoce modułowym systemem zarządzania botami Discorda zaprojektowanym z myślą o rozszerzeniu. Przewodnik ten dotyczy bezpośredniego zaczepienia się do systemu i podstawowych metod łańcuchowych. + +Spis treści: + diff --git a/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..b680055 --- /dev/null +++ b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Podstawowe API + +Aby zaczepić do systemu, Twoja główna klasa musi rozszerzać `AeroDeskAddon`. Oto podstawowa implementacja pokazująca podstawowe metody bazowe w sposób płynny: + +```java +pakiet com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +klasa publiczna MyCustomAddon rozszerza AeroDeskAddon { + + @Override + public void onEnable() { + // Drukuje niestandardowe komunikaty dziennika poprzedzone nazwą dodatku + getLogger(). nfo("Dodatek włączony i zaczepiony do AeroDesk! ); + + // pobiera cały obiekt BotConfig + getApi(). etConfig(); + + // Szybki skrót wewnątrz dodatku do przechwytywania config + getLogger(). nfo("Bieżący prefiks bota to: " + getConfig().prefiks; + } +} +``` + +lub + +```java +pakiet com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +klasa publiczna HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System. ut.println("======================================"); + System.out. rintln("👋 ŚWIATA HELLO WŁĄCZONE! 👋"); + + spróbuj { + jeśli (getApi()! null && getApi(). etConfig() != null) { + String dbType = getApi(). etConfig().database.activeDatabase; + // dbType zwraca to, co jest zaznaczone. MySQL + System.out. rintln("Bot obecnie używa bazy danych: " + dbType); + } else { + System. ob rintln("API bota lub konfiguracja nie były jeszcze gotowe, ale dodatek załadowany! ); + } + } chwyt (Exception e) { + // To wydrukuje dokładny powód, jeśli coś pójdzie nie tak tutaj + System. rr.println("Błąd odczytu konfiguracji w HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln("======================================"); + } + + @Override + public void onDisable() { + System. ut.println("🛑 Hello World2 Addon Shutting down!"); + } +} +``` + +### diff --git a/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..8c059cf --- /dev/null +++ b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Kategorie i poziomy wsparcia + +Organizowanie wniosków o wsparcie i bezproblemowe klasyfikowanie poziomów priorytetów, bez deklarowania zmiennych pośrednich. + +- Pobierz kategorię: `getApi().getConfig().tickets.categories.get("bug");` +- Dodaj kategorię: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("Raporty błędów", "Welcome message here", "123456789"));` +- Edytuj kategorię: `getApi().getConfig().tickets.categories.get("bug").embedTytuł = "New Embed Title";` +- Usuń kategorię: `getApi().getConfig().tickets.categories.remove("bug");` +- Pobierz Tier: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Dodaj Tier: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321"));` +- Edytuj Tier: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Basic Support";` +- Usuń Tier: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support"));` diff --git a/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..2470c3a --- /dev/null +++ b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Metody synchronizacji bazy danych i konfiguracji + +Zarządzaj aktywnym połączeniem z bazą danych i natychmiast synchronizuj zmiany konfiguracji w systemie. Pamiętaj, aby zapisać konfigurację po dokonaniu bezpośrednich modyfikacji przez API. + +- Sprawdź aktywny DB: `getApi().getBotConfig().database.activeDatabase;` _(Returns "MySQL", "SQLite", "MongoDB" itp.)_ +- Pobierz DB Host: `getApi().getBotConfig().database.host;` +- Zapisz zmiany konfiguracji: `getApi().saveConfig();` _(Wymaguje wszelkie zmiany dokonane przez API są zapisywane w bazie danych/YAML)_ +- Przeładuj konfigurację: `getApi().reloadConfig();` _(Zmusza bota do wyciągnięcia świeżych danych z bazy danych)_ diff --git a/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..59eeaaa --- /dev/null +++ b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Rozpoczęcie + +Aby uzyskać API dla bota, musisz mieć w swoim `pom.xml` + +Dołącz to do swojego projektu: + +```xml + + + avenvault-discord + https://maven.plugins.avenvault.com/discord/ + + + + + + com.avenvault.discord + AeroDesk-API + 1.0.3 + provided + + +``` + +Najnowsze wydanie [here](https://maven.plugins.avenvault.com/) można znaleźć w AeroDesk-API diff --git a/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..7634cfc --- /dev/null +++ b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Słowo kluczowe FAQ i poziomy eskalacji + +Zarządzaj automatycznymi odpowiedziami i sieciami eskalacji zgłoszeń wyzwalanymi przez słowo kluczowe bezpośrednio za pomocą konfiguracji za pomocą zaczepu `getApi()`. + +- Dodaj FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Please open a ticket for refunds.");` +- Pobierz FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refund");` +- Edytuj FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "New refund policy applied ied.");` +- Usuń FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("refund");` +- Pobierz Eskalation: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Dodaj skalowanie: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "billing", "1122334455"));` +- Usuń skalowanie: `getApi().getConfig().tickets.escalationLevels.removeIf(poziom -> poziom.levelName.equals("Manager Review"));` diff --git a/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..6404a00 --- /dev/null +++ b/docs/pl/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Strona 4 + diff --git a/docs/pl/source/en/addons-api/page-2.md b/docs/pl/source/en/addons-api/page-2.md new file mode 100644 index 0000000..a7b622a --- /dev/null +++ b/docs/pl/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Strona 2 + diff --git a/docs/pt/source/en/SUMMARY.md b/docs/pt/source/en/SUMMARY.md index 4184eef..2448187 100644 --- a/docs/pt/source/en/SUMMARY.md +++ b/docs/pt/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [Guia de API para Desenvolvedores AeroDesk](addons-api/aerodesk-developer-api-guide/README.md) + - [Primeiros passos](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [API básica](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Keyword FAQs & Níveis de Escala](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Database & Config Sync Methods](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Categorias e níveis de suporte](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Página 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Página 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..b1dce0c --- /dev/null +++ b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# Guia de API do desenvolvedor AeroDesk + +[AeroDesk](../../discord-bots/aerodesk/) é um sistema altamente modular de gerenciamento de bots do Discord projetado para extensibilidade. Este guia cobre como ligar o sistema e encadear os métodos do núcleo diretamente. + +Tabela de conteúdo: + diff --git a/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..9613218 --- /dev/null +++ b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# API Base + +Para ligar ao sistema, sua classe principal deve estender `AeroDeskAddon`. Aqui está uma implementação básica que demonstra os métodos base básicos de forma fluida: + +```java +package com.exemplo.myaddon; + +importe com.avenvault.discord.api. eroDeskAddon; + +classe pública MyCustomAddon estende AeroDeskAddon { + + @Override + public void onEnable() { + // Imprime mensagens de log personalizadas prefixadas com o nome do addon's + getLogger(). nfo("Addon habilitado e ligado na AeroDesk! ); + + // Busca todo o objeto BotConfig + getApi(). etConfig(); + + // Um atalho rápido dentro da extensão para pegar a configuração + getLogger(). nfo("Prefixo do bot atual é: " + getConfig().prefix); + } +} +``` + +ou + +```java +package com.exemplo.myaddon; + +importe com.avenvault.discord.api. eroDeskAddon; + +classe pública HelloWorldMain2 estende AeroDeskAddon { + + @Override + public void onEnable() { + System. ut.println("================================="); + System.out. rintln("👋 HELLO WORLD ADICIONADO HABILITADO! 👋"); + + tente { + if (getApi() ! null && getApi(). etConfig() != null) { + String dbType = getApi(). etConfig().database.activeDatabase; + // dbType retorna o que está selecionado. MySQL + System.out. rintln("O bot está usando o banco de dados: " + dbType); + } else { + System. vrs. rintln("A API ou configuração do bot ainda não estavam prontas, mas adicione-se! ); + } + } catch (Exceção e) { + // Isto irá imprimir a razão exata se algo der errado aqui Sistema + . r.println("Erro lendo a configuração em HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln("================================); + } + + @Override + public void onDisable() { + System. ut.println("🛑 Olá World2 Addon Fechando para baixo!"); + } +} +``` + +### diff --git a/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..0f20a1c --- /dev/null +++ b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Categorias e Assistência Níveis + +Organizar pedidos de apoio e classificar os níveis prioritários de forma harmoniosa sem a declaração de variáveis intermediárias. + +- Recuperar Categoria: `getApi().getConfig().tickets.categories.get("bug");` +- Adicionar Categoria: `getApi().getConfig().tickets.categories.put("bug", new Ticket Category("Bug Reports", "Bem-vindo mensagem aqui", "123456789"));` +- Editar Categoria: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "Novo Título de Incorporação";` +- Excluir Categoria: `getApi().getConfig().tickets.categories.remove("bug");` +- Recuperar o Tier: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Adicionar Nível: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("Suporte VIP", "987654321"));` +- Editar Tier: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Suporte Básico";` +- Excluir Tier: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("Suporte VIP"));` diff --git a/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..1f31822 --- /dev/null +++ b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Banco de Dados e Métodos de Sincronização Config + +Gerencie a conexão da base de dados ativa e sincronize as alterações de configuração em seu sistema instantaneamente. Lembre-se de salvar sua configuração após fazer modificações diretas através da API. + +- Verifique Active DB: `getApi().getBotConfig().database.activeDatabase;` _(Retorna "MySQL", "SQLite", "MongoDB", etc.)_ +- Recuperar DB Host: `getApi().getBotConfig().database.host;` +- Salvar Configurações Alterações: `getApi().saveConfig();` _(Garante qualquer edição feita via API são salvas no banco de dados/YAML)_ +- Recarregar configuração: `getApi().reloadConfig();` _(Força o bot a puxar dados frescos do banco de dados)_ diff --git a/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..44ee829 --- /dev/null +++ b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Primeiros passos + +Para obter a API do bot você precisa ter no seu arquivo `pom.xml` + +Inclua isto em seu projeto: + +```xml + + + avenvault-discord + https://maven. lugins.avenvault. om/discord/ + + + + + + com. venvault. iscord + AeroDesk-API + 1.0. + fornecido + + +``` + +Você pode encontrar a última versão [here](https://maven.plugins.avenvault.com/) sob AeroDesk-API diff --git a/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..dcc8420 --- /dev/null +++ b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# FAQs & Níveis de Escalação de Palavra-Chave + +Gerenciar respostas automáticas acionadas por palavra-chave e combinações de escalonamento de tickets diretamente através da configuração usando o `getApi()` hook. + +- Adicionar FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Por favor, abra um ticket para reembolsos.");` +- Recuperar FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refund");` +- Editar FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Nova política de reembolso aplicada.");` +- Delete FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("refund");` +- Recuperar Escalonamento: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Adicionar Escalonamento: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Revisão do Gestor", "billing", "1122334455"));` +- Excluir Escalação: `getApi().getConfig().tickets.escalationLevels.removeIf(nível -> level.levelName.equals("Revisão do Gestor"));` diff --git a/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..521debb --- /dev/null +++ b/docs/pt/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Página 4 + diff --git a/docs/pt/source/en/addons-api/page-2.md b/docs/pt/source/en/addons-api/page-2.md new file mode 100644 index 0000000..54470ed --- /dev/null +++ b/docs/pt/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Página 2 + diff --git a/docs/ru/source/en/SUMMARY.md b/docs/ru/source/en/SUMMARY.md index 4184eef..f7c75e3 100644 --- a/docs/ru/source/en/SUMMARY.md +++ b/docs/ru/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [Руководство по API для разработчиков AeroDesk](addons-api/aerodesk-developer-api-guide/README.md) + - [Начало работы](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Base API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Часто задаваемые вопросы и уровни эскалации](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [База данных и параметры синхронизации](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Категории и Уровни поддержки](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Страница 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Страница 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..af3c0eb --- /dev/null +++ b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# Руководство по API для разработчиков AeroDesk + +[AeroDesk](../../discord-bots/aerodesk/) — очень модульная система управления ботами Discord, предназначенная для расширения. В этом руководстве описывается, как напрямую подключаться к системе и базовым методам цепочки. + +Содержание доклада: + diff --git a/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..65dcf0b --- /dev/null +++ b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Базовый API + +Чтобы встать в систему, ваш главный класс должен расширить `AeroDeskAddon`. Ниже приводится базовая практика, свидетельствующая о том, что базовые методы являются гибкими: + +```java +package com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +public class MyCustomAddon extends AeroDeskAddon { + + @Override + public void onEnable() { + // Выводит пользовательские журнальные сообщения, префиксные с именем аддона + getLogger(). nfo("Дополнение включено и подключено к AeroDesk! ); + + // Извлекает весь объект BotConfig + getApi(). etConfig(); + + // Быстрый ярлык внутри аддона, чтобы захватить конфигурацию + getLogger(). nfo("Текущий префикс бота: " + getConfig().prefix); + } +} +``` + +или + +```java +package com.example.myaddon; + +import com.avenvault.discord.api. eroDeskAddon; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System. ut.println("==================================="); + Система.out. rintln("👋 HELLO WORLD ADDON ENABLED! 👋"); + + try { + if (getApi() ! null && getApi(). etConfig() != null) { + String dbType = getApi(). etConfig().database.activeDatabase; + // Возвращает то, что выбрано. MySQL + System.out. rintln("Бот использует базу данных: " + dbType); + } else { + System. ut. rintln("Бот API или конфигурация еще не готовы, но аддон загружен! ); + } + } catch (Exception e) { + // Это выведет точную причину, если что-то пойдет не так здесь + Система. rr.println("Ошибка чтения конфигурации в HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln("======================================="); + } + + @Override + public void onDisable() { + System. ut.println("🛑 Hello World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..4a285e6 --- /dev/null +++ b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Категории и Уровни поддержки + +Организуйте запросы поддержки и классифицируйте уровни приоритетов, не объявляя промежуточных переменных. + +- Получить категорию: `getApi().getConfig().tickets.categories.get("bug");` +- Добавить категорию: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("Сообщения об ошибках", "Приветственное сообщение здесь", "123456789");` +- Редактировать категорию: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "New Embed Title";` +- Удалить категорию: `getApi().getConfig().tickets.categories.remove("bug");` +- Получить уровень: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Добавить Тик: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321");` +- Редактировать уровень: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Базовая поддержка";` +- Удалить Тик: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support");` diff --git a/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..62662d6 --- /dev/null +++ b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Методы синхронизации базы данных и настроек + +Управляйте подключением к активной базе данных и синхронизируйте изменения конфигурации в вашей системе мгновенно. Не забудьте сохранить конфигурацию после внесения прямых изменений через API. + +- Проверьте активную DB: `getApi().getBotConfig().database.activeDatabase;` _(Returns "MySQL", "SQLite", "MongoDB", и т.д.)_ +- Получить БД Хост: `getApi().getBotConfig().database.host;` +- Сохранить изменения конфигурации: `getApi().saveConfig();` _(Проверяет все изменения, сделанные через API, сохраняются в базу данных/YAML)_ +- Перезагрузите конфигурацию: `getApi().reloadConfig();` _(Заставить бота получить свежие данные из базы данных)_ diff --git a/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..2cf1680 --- /dev/null +++ b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Начало работы + +Чтобы получить API для бота, вам нужно иметь в своём `pom.xml` + +Включить это в ваш проект: + +```xml + + + avenvault-discord + https://maven. lugins.avenvault. om/discord/ + + + + + + com. venvault. iscord + AeroDesk-API + 1.0. + предоставлено + + +``` + +Вы можете найти последнюю версию [here](https://maven.plugins.avenvault.com/) под AeroDesk-API diff --git a/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..4ea93fb --- /dev/null +++ b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Часто задаваемые вопросы и уровни эскалации + +Управление автоответчиками ключевого слова и цепочками эскалации заявок напрямую через конфигурацию, используя `getApi()` хук. + +- Добавить FAQ: `getApi().getConfig().tickets.keywordFaqs.put("Возвращайте", "Пожалуйста, откройте заявку для возврата средств.");` +- Получить FAQ: `getApi().getConfig().tickets.keywordFaqs.get("возмещение");` +- Редактировать FAQ: `getApi().getConfig().tickets.keywordFaqs.put("возмещение", "Новая политика возврата средств.");` +- Удалить FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("возмещение");` +- Получение эскалации: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Добавить Escalation: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Обзор менеджера", "billing", "1122334455");` +- Удалить эскалацию: `getApi().getConfig().tickets.escalationLevels.removeIf(уровень -> level.levelName.equals("Обзор менеджера");` diff --git a/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..c387d2d --- /dev/null +++ b/docs/ru/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Стр. 4 + diff --git a/docs/ru/source/en/addons-api/page-2.md b/docs/ru/source/en/addons-api/page-2.md new file mode 100644 index 0000000..5c6a841 --- /dev/null +++ b/docs/ru/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Стр. 2 + diff --git a/docs/sv/source/en/SUMMARY.md b/docs/sv/source/en/SUMMARY.md index 4184eef..85cae02 100644 --- a/docs/sv/source/en/SUMMARY.md +++ b/docs/sv/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [AeroDesk Developer API Guide](addons-api/aerodesk-developer-api-guide/README.md) + - [Komma igång](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Base API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Vanliga frågor om nyckelord och skalningsnivåer](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Databas & Konfigurationssynkroniseringsmetoder](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Kategorier & Stöd Tiers](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Sida 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Sida 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..f2c1a50 --- /dev/null +++ b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# AeroDesk API-guide för utvecklare + +[AeroDesk](../../discord-bots/aerodesk/) är ett mycket modulärt Discord bot hanteringssystem som är utformat för utbyggbarhet. Denna guide behandlar hur man direkt kan kroka in i systemet och kedjans kärnmetoder. + +Innehållsförteckning: + diff --git a/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..7612e19 --- /dev/null +++ b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Grundläggande API + +För att kroka in i systemet måste din huvudklass förlänga `AeroDeskAddon`. Här är en grundläggande implementering som visar de grundläggande basmetoderna på ett flytande sätt: + +```java +paket com.example.myaddon; + +importera com.avenvault.discord.api. eroDeskAddon; + +public class MyCustomAddon förlänger AeroDeskAddon { + + @Åsidosätt + public void onEnable() { + // Skriver ut anpassade loggmeddelanden prefixade med tilläggens namn + getLogger(). nfo("Addon aktiverad och ansluten till AeroDesk! ); + + // Hämtar hela BotConfig objektet + getApi(). etConfig() + + // En snabb genväg inuti tillägget för att ta tag i konfigurationen + getLogger(). nfo("Nuvarande bot prefix är: " + getConfig().prefix); + } +} +``` + +eller + +```java +paket com.example.myaddon; + +importera com.avenvault.discord.api. eroDeskAddon; + +public class HelloWorldMain2 förlänger AeroDeskAddon { + + @Åsidosätt + public void onEnable() { + System. Utskrift.Utskrift("======================================); + Utskrift. rintln ("👋 HELLO WORLD ADDON ENABLED! 👋"); + + Prova { + om (getApi() ! noll && getApi(). etConfig() != noll) { + Sträng dbType = getApi(). etConfig().database.activeDatabase; + // dbType returnerar vad som är valt e. MySQL + System.out. rintln("Boten använder för närvarande databasen: " + dbType) + } else { + System. Ö. rintln ("bot API eller config var inte redo ännu, men addon laddad! ); + } + } catch (Undantag e) { + // Detta kommer att skriva ut den exakta anledningen om något går fel här + System. rr.println("Fel vid läsning av konfigurationen i HelloWorld2:"); + e. rintStackTrace(); + } + + System.out. rintln("====================================="); + } + + @Åsidosätt + public void onDisable() { + System. ut.println("🛑 Hello World2 Addon stängs av!"); + } +} +``` + +### diff --git a/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..3981302 --- /dev/null +++ b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Kategorier & Support Tiers + +Organisera supportförfrågningar och klassificera prioriterade nivåer sömlöst utan att deklarera mellanliggande variabler. + +- Hämta Kategori: `getApi().getConfig().tickets.categories.get("bug");` +- Lägg till Kategori: `getApi().getConfig().tickets.categories.put("bug", ny TicketCategory("Bug Reports", "Välkommen meddelande här", "123456789"));` +- Redigera kategori: `getApi().getConfig().tickets.categories.get("bug").embedTitle = "New Embed Title";` +- Ta bort Kategori: `getApi().getConfig().tickets.categories.remove("bug");` +- Hämta Tier: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Lägg till Tier: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321");` +- Redigera Tier: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Basic Support";` +- Ta bort Tier: `getApi().getConfig().tickets.ticketTiers.removeIf(tier -> tier.name.equals("VIP Support");` diff --git a/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..dcbc59d --- /dev/null +++ b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Databas och konfiguration synkroniseringsmetoder + +Hantera den aktiva databasanslutningen och synkronisera konfigurationsändringarna i ditt system omedelbart. Kom ihåg att spara din konfiguration efter direkta ändringar via API:et. + +- Kontrollera aktiv DB: `getApi().getBotConfig().database.activeDatabase;` _(Returnerar "MySQL", "SQLite", "MongoDB", etc.)_ +- Hämta DB Host: `getApi().getBotConfig().database.host;` +- Spara konfigurationsändringar: `getApi().saveConfig();` _(Säkerställer att eventuella ändringar som görs via API:et sparas i databasen/YAML)_ +- Ladda om konfiguration: `getApi().reloadConfig();` _(Tvingar boten att dra färska data från databasen)_ diff --git a/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..52efa5e --- /dev/null +++ b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# Kom igång + +För att få API:et för roboten måste du ha i din `pom.xml` + +Inkludera detta i ditt projekt: + +```xml + + + avenvault-discord + https://maven. lugins.avenvault. om/discord/ + + + + + + com. venvault. iscord + AeroDesk-API + 1.0. + tillhandahålls + + +``` + +Du hittar den senaste versionen [here](https://maven.plugins.avenvault.com/) under AeroDesk-API diff --git a/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..435520a --- /dev/null +++ b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Nyckelord Vanliga frågor och skalningsnivåer + +Hantera nyckelordsutlösta automatiska svar och ärendeeskaleringskedjor direkt via konfigurationen med `getApi()` hook. + +- Lägg till vanliga frågor: `getApi().getConfig().tickets.keywordFaqs.put("återbetalning", "Vänligen öppna en biljett för återbetalningar");` +- Hämta FAQ: `getApi().getConfig().tickets.keywordFaqs.get("återbetalning");` +- Redigera FAQ: `getApi().getConfig().tickets.keywordFaqs.put("återbetalning", "Ny återbetalningspolicy tillämpad.");` +- Ta bort FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("återbetalning");` +- Hämta Escalation: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Lägg till Escalation: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "fakturering", "1122334455"));` +- Ta bort Escalation: `getApi().getConfig().tickets.escalationLevels.removeIf(nivå -> level.levelName.equals("Manager Review");` diff --git a/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..2e62bf9 --- /dev/null +++ b/docs/sv/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Sida 4 + diff --git a/docs/sv/source/en/addons-api/page-2.md b/docs/sv/source/en/addons-api/page-2.md new file mode 100644 index 0000000..3d749db --- /dev/null +++ b/docs/sv/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Sida 2 + diff --git a/docs/uk/source/en/SUMMARY.md b/docs/uk/source/en/SUMMARY.md index 4184eef..bb29a48 100644 --- a/docs/uk/source/en/SUMMARY.md +++ b/docs/uk/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [Посібник розробника API AeroDesk](addons-api/aerodesk-developer-api-guide/README.md) + - [Почив](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Базовий API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Ключові слова FAQs і рівень масштабування](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [Метод синхронізації бази даних і конфігурації](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [Categories & Support Tiers](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [Сторінка 4](addons-api/aerodesk-developer-api-guide/page-4.md) +- [Page 2](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..0bbb996 --- /dev/null +++ b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# Довідник по розробникові API AeroDesk + +[AeroDesk](../../discord-bots/aerodesk/) є високомодульною системою управління ботами Discord, розробленою для розширення. Це керівництво охоплює спосіб прив'язки до системи та основних способів зв'язку. + +Зміст: + diff --git a/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..ddecc21 --- /dev/null +++ b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# Базовий API + +Щоб під'єднатися до системи, основний клас повинен розширити `AeroDeskAddon`. Ось базова реалізація, яка демонструє основні основні методи обробки рідин: + +```java +пакет com.example.myaddon; + +імпортувати com.avenvault.discord.api. eroDeskAddon; + +публічний клас MyCustomAddon подовжує AeroDeskAddon { + + @Override + публічне анулювання onEnable() { + // Друкує користувальницькі повідомлення журналу, попередньо закріплені за назвою addon's name, + getLogger(). nfo("Аддон підключений та зачепився в Аеродеск! ); + + // Оновлює весь об'єкт BotConfig + getApi(). etConfig(); + + // Швидкий ярлик всередині додатку, щоб захопити конфігурацію + getLogger(). nfo("Префікс поточного бота: " + getConfig().prefix); + } +} +``` + +або + +```java +package com.example.myaddon; + +import com.avenvault.discord.api.AeroDeskAddon; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System.out.println("================================="); + System.out.println("👋 HELLO WORLD ADDON ENABLED! 👋"); + + try { + if (getApi() != null && getApi().getConfig() != null) { + String dbType = getApi().getConfig().database.activeDatabase; + // dbType returns what is selected e.g MySQL + System.out.println("The bot is currently using database: " + dbType); + } else { + System.out.println("The bot API or config was not ready yet, but addon loaded!"); + } + } catch (Exception e) { + // This will print the exact reason if something goes wrong here + System.err.println("Error reading config in HelloWorld2:"); + e.printStackTrace(); + } + + System.out.println("================================="); + } + + @Override + public void onDisable() { + System.out.println("🛑 Hello World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..3d28c6a --- /dev/null +++ b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# Категорії та Рівні підтримки + +Організовуйте запити підтримки та класифікуйте пріоритетні рівні безшовно без оголошення проміжних змінних. + +- Отримати категорію: `getApi().getConfig().tickets.categories.get("bug");` +- Додати категорію: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory("Звіти про помилку", "Привітальне повідомлення тут", "123456789");` +- Редагувати категорію: `getApi().getConfig().tickets.categories.get("bug").embedbed Title";` +- Видалити категорію: `getApi().getConfig().tickets.categories.remove("bug");` +- Отримати Tier: `getApi().getConfig().tickets.ticketTiers.get(0);` +- Додати Tier: `getApi().getConfig().tickets.ticketTiers.add(new BotConfig.TicketTier("VIP підтримка", "987654321");` +- Редагувати Tier: `getApi().getConfig().tickets.ticketTiers.get(0).name = "Базова підтримка";` +- Видалити Tier: `getApi().getConfig().tickets.removeIf(tier -> tier.name.equals("VIP Support");` diff --git a/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..c721b4f --- /dev/null +++ b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# Методи синхронізації бази даних та конфігурації + +Керуйте активним підключенням бази даних та синхронізуйте зміни конфігурації у вашій системі миттєво. Не забудьте зберегти конфігурацію після внесення прямих змін через API. + +- Перевірте Активний DB: `getApi().getBotConfig().database.activeDatabase;` _(Повертає "MySQL", "SQLite", "MongoDB", тощо)_ +- Отримати вузол бази даних: `getApi().getBotConfig().database.host;` +- Зберегти налаштування конфігурації: `getApi().saveConfig();` _(Включає всі зміни, що виконуються через API, зберігаються в базі даних та YAML)_ +- Перезавантажити конфігурацію: `getApi().reloadConfig();` _(примушує бота отримувати свіжі дані з бази даних)_ diff --git a/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..5efc7aa --- /dev/null +++ b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# З чого почати + +Щоб отримати API для бота, вам необхідно мати в вашому `pom.xml` + +Включити це до вашого проекту: + +```xml + + + avenvault-discord + https://maven.plugins.avenvault.com/discord/ + + + + + + com.avenvault.discord + AeroDesk-API + 1.0.3 + provided + + +``` + +Ви можете знайти останній випуск [here](https://maven.plugins.avenvault.com/) під AeroDesk-API diff --git a/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..6892e65 --- /dev/null +++ b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# Ключові питання та рівні масштабів + +Керуйте ключовим словом авто-відповіді та ланцюжками ескалації тікетів безпосередньо через конфігурацію, використовуючи гак "getApi()". + +- Додати FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Будь ласка, відкрийте заявку для повернення коштів.");` +- Отримати FAQ: `getApi().getConfig().tickets.keywordFaqs.get("refund");` +- Редагувати FAQ: `getApi().getConfig().tickets.keywordFaqs.put("refund", "Застосовано нову політику повернення коштів.");` +- Видалити FAQ: `getApi().getConfig().tickets.keywordFaqs.remove("refund");` +- Отримати ескалацію: `getApi().getConfig().tickets.escalationLevels.get(0);` +- Додати Escalation: `getApi().getConfig().tickets.escalationLevels.add(new EscalationLevel("Manager Review", "billing", "billing", "1122334455"));` +- Видалити Escalation: `getApi().getConfig().tickets.escalationLevels.removeIf(рівень -> level.levelName.equals("Manager Review");` diff --git a/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..b5e1baf --- /dev/null +++ b/docs/uk/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# Сторінка 4 + diff --git a/docs/uk/source/en/addons-api/page-2.md b/docs/uk/source/en/addons-api/page-2.md new file mode 100644 index 0000000..ede1979 --- /dev/null +++ b/docs/uk/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# Сторінка 2 + diff --git a/docs/zh/source/en/SUMMARY.md b/docs/zh/source/en/SUMMARY.md index 4184eef..236ac2b 100644 --- a/docs/zh/source/en/SUMMARY.md +++ b/docs/zh/source/en/SUMMARY.md @@ -1,6 +1,20 @@ # Table of contents - [Docs](README.md) + +## addons-api + +- [AeroDesk 开发者 API 指南](addons-api/aerodesk-developer-api-guide/README.md) + - [正在开始](addons-api/aerodesk-developer-api-guide/getting-started.md) + - [Base API](addons-api/aerodesk-developer-api-guide/base-api.md) + - [Keyword FAQs & Escalation Levels](addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md) + - [数据库和配置同步方法](addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md) + - [类别和支持层](addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md) + - [第4页](addons-api/aerodesk-developer-api-guide/page-4.md) +- [第2页](addons-api/page-2.md) + +*** + - [Discord bots table](discord-bots-table.md) - [Minecraft plugins table](minecraft-plugins-table.md) diff --git a/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/README.md b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/README.md new file mode 100644 index 0000000..6e9ceb9 --- /dev/null +++ b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/README.md @@ -0,0 +1,6 @@ +# AeroDesk 开发者 API 指南 + +[AeroDesk](../../discord-bots/aerodesk/) 是一个高模块化Discord机器人管理系统,用于扩展。 本指南涵盖如何直接绑定到系统和链式核心方法。 + +目录: + diff --git a/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/base-api.md b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/base-api.md new file mode 100644 index 0000000..0e8431e --- /dev/null +++ b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/base-api.md @@ -0,0 +1,64 @@ +# 基础 API + +要连接到系统中,您的主类必须扩展 "AeroDeskAddon" 。 以下是基本的实施,以流畅的方式展示核心基本方法: + +```java +包 com.example.myaddon; + +导入 com.avenvault.discord.api。 演示文稿; + +公共类 MyCustomAddon extends Aeroon AeroDeskAddon Advanced + + @Override + public invent onEnable() public invent + // 打印预置于addon名称 + getLogger() nfo("启用附加组件并将其绑定到AeroDesk! ); + + // 获取整个BotConfig 对象 + getApi(). etConfig(); + + // 插件内快速快捷键来抓取配置 + getLogger()。 nfo("当前机器人前缀为:" + getConfig().prefix); + } +} +``` + +或 + +```java +package com.example.myaddon; + +import com.avenvault.discord.api.AeroDeskAddon; + +public class HelloWorldMain2 extends AeroDeskAddon { + + @Override + public void onEnable() { + System.out.println("================================="); + System.out.println("👋 HELLO WORLD ADDON ENABLED! 👋"); + + try { + if (getApi() != null && getApi().getConfig() != null) { + String dbType = getApi().getConfig().database.activeDatabase; + // dbType returns what is selected e.g MySQL + System.out.println("The bot is currently using database: " + dbType); + } else { + System.out.println("The bot API or config was not ready yet, but addon loaded!"); + } + } catch (Exception e) { + // This will print the exact reason if something goes wrong here + System.err.println("Error reading config in HelloWorld2:"); + e.printStackTrace(); + } + + System.out.println("================================="); + } + + @Override + public void onDisable() { + System.out.println("🛑 Hello World2 Addon Shutting Down!"); + } +} +``` + +### diff --git a/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md new file mode 100644 index 0000000..2347280 --- /dev/null +++ b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/categories-and-support-tiers.md @@ -0,0 +1,12 @@ +# 类别和支持级别 + +组织支持请求并无缝分类优先级,而不申报中间变量。 + +- 获取类别: `getApi().getConfig().tickets.categories.get("bug");` +- 添加类别: `getApi().getConfig().tickets.categories.put("bug", new TicketCategory", "Bug Reports", "Welcome message here", "123456789");` +- 编辑类别: \`getApi().getConfig().tickets.categories.get("bug").embedTitle = "新嵌入标题";" +- 删除类别: `getApi().getConfig().tickets.categories.remove("bug");` +- 获取层级: `getApi().getConfig().ticketTiers.get(0);` +- 添加层级: `getApi().getConfig().ticketTiers.add(new BotConfig.TicketTier("VIP Support", "987654321");` +- 编辑层级: `getApi().getConfig().ticketTiers.get(0).name = "基本支持";` +- 删除层级: `getApi().getConfig().ticketTiers.removeIf(阶级-> tier.name.equals("VIP Support"));` diff --git a/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md new file mode 100644 index 0000000..9552c48 --- /dev/null +++ b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/database-and-config-sync-methods.md @@ -0,0 +1,8 @@ +# 数据库和配置同步方法 + +管理活跃的数据库连接并同步您整个系统的配置变化。 通过API直接修改后,记住保存您的配置。 + +- 检查Active DB: `getApi().getBotConfig().database.activeDatabase;` _(返回 "MySQL", "SQLite", "MongoDB"等)_ +- 检索DB 主机: `getApi().getBotConfig().database.host;` +- 保存配置更改: `getApi().saveConfig();` _(确保任何通过 API 做的编辑都保存在数据库/YAML)_ +- 重新加载配置: `getApi().reloadConfig();` _(强制机器人从数据库中拉新数据)_ diff --git a/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md new file mode 100644 index 0000000..02f8714 --- /dev/null +++ b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/getting-started.md @@ -0,0 +1,25 @@ +# 正在开始 + +为了获取机器人的 API,您需要在 `pom.xml` 中 + +在您的项目中包含这个内容: + +```xml + + + avenvault-discord + https://maven. lugins.avenvault om/discord/ + + + + + + com。 冒险库。 + AeroDesk-API + 1.0。 <! - 更新可用时更改为最新版本 --> + 提供的 + + +``` + +您可以在 AeroDesk-API 下找到最新版本的 [here](https://maven.plugins.avenvault.com/) diff --git a/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md new file mode 100644 index 0000000..8bff46f --- /dev/null +++ b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/keyword-faqs-and-escalation-levels.md @@ -0,0 +1,11 @@ +# 关键字常见问题和升级级别 + +使用 `getApi()` 钩直接通过配置管理关键字触发的自动响应和服务单升级链。 + +- 添加常见问题: `getApi().getConfig().tickets.keywordFaqs.put("退款", 请打开工单以退款。");` +- 获取常见问题: `getApi().getConfig().tickets.keywordFaqs.get("退款");` +- 编辑常见问题: `getApi().getConfig().tickets.keywordFaqs.put("退款", "新退款政策应用");` +- 删除常见问题: `getApi().getConfig().tickets.keywordFaqs.remove("退款");` +- 检索升级: `getApi().getConfig().tickets.scripationLevels.get(0);` +- 添加升级: `getApi().getConfig().tickets.scrapationLevels.add(new EscalationLevel("Manager Review", "billing", "1122334455");` +- 删除升级: `getApi().getConfig().tickets.scrapationLevels.removeIf(level -> level.levelName.equals("Manager Review"));` diff --git a/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/page-4.md b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/page-4.md new file mode 100644 index 0000000..1c5b303 --- /dev/null +++ b/docs/zh/source/en/addons-api/aerodesk-developer-api-guide/page-4.md @@ -0,0 +1,2 @@ +# 第4页 + diff --git a/docs/zh/source/en/addons-api/page-2.md b/docs/zh/source/en/addons-api/page-2.md new file mode 100644 index 0000000..5a8b9d8 --- /dev/null +++ b/docs/zh/source/en/addons-api/page-2.md @@ -0,0 +1,2 @@ +# 第2页 +