<!DOCTYPE html>

<a href="https://top.gg/bot/705373559299637278"> <img src="https://top.gg/api/widget/status/705373559299637278.svg" alt="AdābGuardian" /> </a> <a href="https://top.gg/bot/705373559299637278"> <img src="https://top.gg/api/widget/servers/705373559299637278.svg" alt="AdābGuardian" /> </a> <a href="https://top.gg/bot/705373559299637278"> <img src="https://top.gg/api/widget/upvotes/705373559299637278.svg" alt="AdābGuardian" /></a>


<center> 
 
 <h4>﷽</h4>
 <h1 style="text-align: center; color: #4f8a8b;">
 AdabGuardian - Manage your Adab!
 </h1>
 
 <h3>
 Another essential discord bot for a Muslim (as well as a non-Muslim!) server to make Good Behaviour shine through your conversations!
 </h3>
 
 The Adāb (أدب‎), refers to a Muslim behavior-code – refinement, good manners, morals, decorum, decency and humaneness. Muslims refer to Adab as ethics, good conduct, courtesy, respect, and appropriateness.
 
 
 Prophet Muhammad ﷺ used to teach people about good Akhlaq and moral values of which here are some hadiths:
 
 “The most beloved of you to Allah is the best of you in character” (Bukhari)
 
 “There is nothing weightier in the scales than good morals and manners.” (Abu Dawood)
 
 “Truly, the believer can reach, by means of good manners and morals, the degree of one who constantly fasts.” (Abu Dawood)
 
 <h5>
 AdabGuardian est également intégralement disponible en français, <a href="#french">cliquez ici pour atteindre la version française de cette page.</a>
 </h5>
 <hr size=4 width=30% >
</center>

<h2>
 A very-kind Discord Bot
</h2>

 The objective of this project is to raise awareness of the Adab concept and improve the behaviour of our Ummah (community). That's why it offers an Adab-Score management system with plenty of blaming or encouraging messages, as well as rankings and of course behaviour reminders to be applied immediately!



 The bot's base prefix is g-. The first command you should type is g-manage to change the basic configuration such as prefix and bot's language. Make sure the bot has the necessary permissions to Read and send a message on the channel, Embed file and Use external emoji. 

<center>
 
 <img src="https://i.imgur.com/MAhNDm7.png" alt="" />
 
 <table>
 <thead>
 <tr>
 <th>Feature</th>
 <th>Description</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td>[p]help</td>
 <td>List the available features.</td>
 </tr>
 <tr>
 <td>[p]manage</td>
 <td>Admin. and server's configuration part — Logs of Adâb transfers, details for a member, manually modify the Adab-score or re-configurate the principal settings.</td>
 </tr>
 <tr>
 <td>[p]levels</td>
 <td>Display the different Adab's degrees.</td>
 </tr>
 <tr>
 <td>[p]adab [member]</td>
 <td>Consult your Adab's level (or to mentionned member's one) with a reminder to apply — From various books on the subject.</td>
 </tr>
 <tr>
 <td>[p]top</td>
 <td>Displays the leaderboard of the server's best behaviors — [p]top worst to display the chaotics.</td>
 </tr>
 <tr>
 <td>[p]nafs [member]</td>
 <td>Send a a Nafs-Punch (ego reminded) to bring someone back down to earth!.</td>
 </tr>
 <tr>
 <td>[p]third</td>
 <td>Returns from your sunrise and sunset times (Sobh and Maghreb) the time of the last third of your night.</td>
 </tr>
 <tr>
 <td>[p]events</td>
 <td>Display the Events-Management module menu.</td>
 </tr>
 <tr>
 <td>[p]library</td>
 <td>Display the Communautary Islamic Library module menu.</td>
 </tr>
 </tbody>
 </table>
 
 
 
 	<img src="https://i.imgur.com/Z7KQppZ.png" alt="" />
 
 
 
 	<img src="https://i.imgur.com/PhDS8De.png" style="border-radius: 2rem;" alt="pic">
 
 <hr size=4 width=30% >
 </center>
 
 

<h2>Managing events&nbsp;-&nbsp;Meetings, courses, science sittings, readings...</h2>


<center>
 <h4>
 Creating an "event" allows a better managing of the different science courses and conferences by allowing to create an announcement, facilitate registration, notify members and keep a history of attendees.
 </h4>
 
 <img src="https://i.imgur.com/vHaIUrO.png" style="border-radius: 2rem;" alt="pic">
 
 <hr size=4 width=30% >
</center>

Display the detail of the events' manager commands
<pre><code>g-events</code></pre>

Example : Organizing a Tafsir course
<pre><code>g-evt new Tafsir al Mu`awwidatayn - 21h (Evening course)</code></pre>

<center>
 	<img src="https://i.imgur.com/9zhdTe1.png" style="border-radius: 2rem;" alt="pic">
</center>



<h2>Other commands</h2>

Calculate the last third of the night
<pre><code>g-third [maghreb] [sobh]</code></pre>
<center>
 	<img src="https://i.imgur.com/CCmPaZ4.png" style="border-radius: 2rem;" alt="pic">
</center>

Access to the Islamic Communautary Library
<pre><code>g-library</code></pre>
<center>
 	<img src="https://i.imgur.com/UAPfr2K.png" style="border-radius: 2rem;" alt="pic">
</center>

Access to the admin and managing options — Adâb transfers logs, details for a member, manually modify the Adab-score or re-configurate the principal settings
<pre><code>g-manage</code></pre>
<center>
 	<img src="https://i.imgur.com/8qY94ej.png" style="border-radius: 2rem;" alt="pic">
</center>


 
<h2>Settings</h2>

Change the bot's command prefix
<pre><code>g-prefix [prefix]</code></pre>

Change the language (English or French)
<pre><code>g-language</code></pre>
<hr size=4 width=30% >






<a name="french"></a>
<div>
 <center>
 <h4>﷽</h4>
 <h1 style="text-align: center; color: #4f8a8b;">AdabGuardian - Veilleur de l'Adab</h1>
 </center>
</div>


 


 
 <center>
 
 Ajoute le concept Islamique d'Adab &agrave; Discord ! Une sorte de score de "bonne conduite" qui peut augmenter ou diminuer selon le bon ou mauvais comportement de la communaut&eacute;.
 <img src="https://i.imgur.com/QD2de8N.png" alt="" />
 	
 <table>
 <thead>
 <tr>
 <th>Commande</th>
 <th>Description</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td>Help</td>
 <td>Affiche la liste des commandes disponibles.</td>
 </tr>
 <tr>
 <td>Config</td>
 <td>Configuration du serveur (Langue, prefixe...).</td>
 </tr>
 <tr>
 <td>Levels</td>
 <td>Affiche les différents degrés d'Adab.</td>
 </tr>
 <tr>
 <td>Adab @mention</td>
 <td>Affiche son niveau d'Adab (ou celui du membre mentionné) ainsi qu'un rappel à appliquer - Issus de différents ouvrages traitant du thème.</td>
 </tr>
 <tr>
 <td>Top</td>
 <td>Affiche le classement des plus beaux comportements du serveur.</td>
 </tr>
 <tr>
 <td>Nafs @mention</td>
 <td>Envoie un rappel / une attaque au Nafs de la personne mentionnée.</td>
 </tr>
 <tr>
 <td>Tiers</td>
 <td>Renvoie à partir de vos horaires de lever et coucher du soleil (Sobh et Maghreb) l'heure du dernier tiers de votre nuit.</td>
 </tr>
 <tr>
 <td>Events</td>
 <td>Affiche le menu de l'organisateur d'évènements.</td>
 </tr>
 <tr>
 <td>Library</td>
 <td>Affiche le menu de la bibliothèque communautaire du bot.</td>
 </tr>
 </tbody>
 </table>
 
 
	
 	
 <img src="https://i.imgur.com/btuHwqh.png" alt="" />
 	
 <hr size=4 width=30% >
 </center>
 


<h2>Organiser des évènements&nbsp;-&nbsp;Cours, assises de sciences, regroupements en vocal...</h2>


<center>
 <h4>
 Créer un « évènement » permet de mieux gérer les différents cours et assises de science en permettant de créer une annonce, faciliter l'inscription, notifier les membres et conserver un historique des présents. 
 </h4>
 
 <img src="https://i.imgur.com/vHaIUrO.png" style="border-radius: 2rem;" alt="pic">
 
 <hr size=4 width=30% >
</center>

Accéder au détail des commandes de gestion d'évènements
<pre><code>g-events</code></pre>

Exemple : Préparation d'un cours de Tafsir
<pre><code>g-evt new Tafsir al Mu`awwidatayn à 21h (Cours du soir)</code></pre>

<center>
 	<img src="https://i.imgur.com/9zhdTe1.png" style="border-radius: 2rem;" alt="pic">
</center>



<h2>Autres commandes</h2>

Calculer le dernier tiers de la nuit
<pre><code>g-tiers [maghreb] [sobh]</code></pre>
<center>
 	<img src="https://i.imgur.com/CCmPaZ4.png" style="border-radius: 2rem;" alt="pic">
</center>

Accéder à la Bibliothèque Islamique Communautaire
<pre><code>g-library</code></pre>
<center>
 	<img src="https://i.imgur.com/UAPfr2K.png" style="border-radius: 2rem;" alt="pic">
</center>

Accéder aux options d'administration (Logs, modification de score d'Adab, etc.)
<pre><code>g-admin</code></pre>
<center>
 	<img src="https://i.imgur.com/Du7GADh.png" style="border-radius: 2rem;" alt="pic">
</center>


 
<h2>Paramètres</h2>

Changer le préfixe de commande
<pre><code>g-set_prefix [prefixe]</code></pre>

Changer la langue (Français ou Anglais)
<pre><code>g-switch_language</code></pre>


<center>
 	<img src="https://i.imgur.com/DwE0065.png" style="border-radius: 2rem;" alt="pic">
</center>
 

</body>
</html>

AdabGuardian

Introduce the Islamic Adab's concept in Discord! A sort of "Behavior" score that can increase or decrease depending on your comportment. 

Stemmen voor AdabGuardian

Wil je ons ondersteunen?