Ping warned member in warning channel

5.0.1 -> 5.2.1

.idea/misc.xml

@@ -1,4 +1,3 @@
-<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="EntryPointsManager">
     <list size="1">

README.md

@@ -7,13 +7,14 @@
 <br>
 A multipurpose Discord bot written in Java.
 
-## Tested Environments
+## Required Environment
-- Java 21+ (May work on older versions but untested)
+- Java 17+ (May work on older versions but untested)
 - Maven
 
 ### Tested Operating Systems
-- macOS 14.4.1
+- macOS 14 & 15 (arm64)
-- Windows 10 (22H2)
+- Windows 10 22H2 (x86_64)
+- Debian 12 (x86_64)
 
 ---
 
@@ -21,7 +22,7 @@ A multipurpose Discord bot written in Java.
 ```json
 {
   "token": "your_token",
-  "prefix": "oki!"
+  "warningChannel": 0
 }
 ```
 
@@ -29,9 +30,12 @@ A multipurpose Discord bot written in Java.
 
 ## Commands
 
-| Command | Description                                                                  | Arguments                           | Aliases |
+| Command           | Description                                                                  | Arguments                                                 |
-|---------|------------------------------------------------------------------------------|-------------------------------------|---------|
+|-------------------|------------------------------------------------------------------------------|-----------------------------------------------------------|
-| `about` | Gets information about the bot                                               | None                                | None    |
+| `/ping`           | Gets the bot's gateway & rest ping                                           | None                                                      |
-| `ping`  | Gets the bot's gateway & rest ping                                           | None                                | None    |
+| `/whois`          | Gets information about the specified user (message author if none specified) | `[member]`                                                |
-| `whois` | Gets information about the specified user (message author if none specified) | `[user ping]`                       | None    |
+| `/timeout set`    | Times out a member for a specified amount of time                            | `[member]`, `[duration]`, `(reason)`                      |
-| `mute`  | Mutes a member for a specified amount of time                                | `[user ping]`, `[timeout duration]` | None    | 
+| `/timeout get`    | Gets the current timeout status of the specified member                      | `[member]`                                                |
+| `/timeout cancel` | Cancels the specified users timeout                                          | `[member]`, `(reason)`                                    |
+| `/poll`           | Creates a poll                                                               | `[title]`, `[duration]`, `[options]`, `(multiple-choice)` | 
+| `/warn`           | Warns a user                                                                 | `[member]`, `[reason]`                                    |

config.example.json

@@ -1,3 +1,4 @@
 {
-  "token": "CHANGEME"
+  "token": "CHANGEME",
+  "warningChannel": 0
 }

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>net.hypr</groupId>
     <artifactId>doki</artifactId>
-    <version>1.0.0</version>
+    <version>1.0.8</version>
 
     <properties>
         <maven.compiler.source>17</maven.compiler.source>
@@ -18,7 +18,7 @@
         <dependency>
             <groupId>net.dv8tion</groupId>
             <artifactId>JDA</artifactId>
-            <version>5.0.1</version>
+            <version>5.2.1</version>
         </dependency>
         <dependency>
             <groupId>io.github.freya022</groupId>
@@ -39,7 +39,7 @@
         <dependency>
             <groupId>ch.qos.logback</groupId>
             <artifactId>logback-classic</artifactId>
-            <version>1.5.6</version>
+            <version>1.5.13</version>
         </dependency>
         <dependency>
             <groupId>org.mariadb.jdbc</groupId>
@@ -56,5 +56,15 @@
             <artifactId>commons-dbutils</artifactId>
             <version>1.8.1</version>
         </dependency>
+        <dependency>
+            <groupId>ch.qos.logback</groupId>
+            <artifactId>logback-core</artifactId>
+            <version>1.5.13</version>
+        </dependency>
+        <dependency>
+            <groupId>com.google.protobuf</groupId>
+            <artifactId>protobuf-java</artifactId>
+            <version>4.28.2</version>
+        </dependency>
     </dependencies>
 </project>

src/main/java/net/hypr/doki/Config.java

@@ -11,6 +11,7 @@ import java.nio.charset.StandardCharsets;
 //You will need a valid config.json in the resources folder for this to work
 public class Config {
     @SuppressWarnings("unused") private String token;
+    @SuppressWarnings("unused") private long warningChannel;
 
     /**
      * Returns the configuration object for this bot
@@ -33,4 +34,7 @@ public class Config {
     public String getToken() {
         return token;
     }
+    public long getWarningChannel() {
+        return warningChannel;
+    }
 }

src/main/java/net/hypr/doki/Doki.java

@@ -22,6 +22,10 @@ public class Doki {
     public static JDA getJDA() {
         return jda;
     }
+    public static Config getConfig() { return config; }
+    public static Logger getLogger() {
+        return log;
+    }
 
     public static void start() throws IOException, InterruptedException {
         config = Config.readConfig();

src/main/java/net/hypr/doki/commands/moderation/Warn.java

@@ -0,0 +1,55 @@
+package net.hypr.doki.commands.moderation;
+
+import com.freya02.botcommands.api.annotations.BotPermissions;
+import com.freya02.botcommands.api.annotations.CommandMarker;
+import com.freya02.botcommands.api.annotations.UserPermissions;
+import com.freya02.botcommands.api.application.ApplicationCommand;
+import com.freya02.botcommands.api.application.annotations.AppOption;
+import com.freya02.botcommands.api.application.slash.GuildSlashEvent;
+import com.freya02.botcommands.api.application.slash.annotations.JDASlashCommand;
+import net.dv8tion.jda.api.EmbedBuilder;
+import net.dv8tion.jda.api.Permission;
+import net.dv8tion.jda.api.entities.Member;
+import net.dv8tion.jda.api.entities.channel.concrete.TextChannel;
+import net.hypr.doki.Doki;
+import org.slf4j.Logger;
+
+import java.awt.*;
+
+@CommandMarker
+@BotPermissions(Permission.MODERATE_MEMBERS)
+@UserPermissions(Permission.MODERATE_MEMBERS)
+public class Warn extends ApplicationCommand {
+    @JDASlashCommand(
+            name = "warn",
+            description = "Warns a member"
+    )
+    public void warn(GuildSlashEvent event,
+                     @AppOption(name = "member", description = "The member to warn") Member member,
+                     @AppOption(name = "reason", description = "The reason for warning them") String reason) {
+        Logger log = Doki.getLogger();
+        Member actingMod = event.getMember();
+        EmbedBuilder warnEmbed = new EmbedBuilder()
+                .setTitle(String.format("You were warned in %s", event.getGuild().getName()))
+                .setDescription(String.format("**Reason:** %s", reason))
+                .setFooter(String.format("Warned by %s (%s)", actingMod.getEffectiveName(), actingMod.getId()), actingMod.getEffectiveAvatarUrl())
+                .setColor(new Color(239, 148, 60));
+        log.debug(String.format("%s", Doki.getConfig().getWarningChannel()));
+        TextChannel warningChannel = Doki.getJDA().getTextChannelById(Doki.getConfig().getWarningChannel());
+        member.getUser().openPrivateChannel().queue(
+                (dm) -> dm.sendMessageEmbeds(warnEmbed.build()).queue(
+                    success -> event.replyFormat("Warned %s for %s", member.getAsMention(), reason).setEphemeral(true).queue(),
+                    // User has blocked bot or disabled DMs
+                    error -> event.replyFormat("Warned %s for %s\n-# (Unable to DM user)", member.getAsMention(), reason).queue()
+                ),
+                error -> event.replyFormat("Warned %s for %s\n-# (Unable to DM user)", member.getAsMention(), reason).queue()
+        );
+        warnEmbed.setTitle(String.format("%s (%s) was warned", member.getEffectiveName(), member.getId()));
+        try {
+            assert warningChannel != null;
+            warningChannel.sendMessage(member.getAsMention()).addEmbeds(warnEmbed.build()).queue();
+        } catch (NullPointerException ex) {
+            log.warn("Failed to send message to warning log channel");
+        }
+    }
+}