send mail command

Author: zefir-git

src/main/java/pro/cloudnode/smp/cloudnodemsg/CloudnodeMSG.java

@@ -5,11 +5,11 @@
 import org.bukkit.entity.Player;
 import org.bukkit.metadata.MetadataValue;
 import org.bukkit.plugin.java.JavaPlugin;
-import org.bukkit.scheduler.BukkitRunnable;
 import org.bukkit.scheduler.BukkitTask;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 import pro.cloudnode.smp.cloudnodemsg.command.IgnoreCommand;
+import pro.cloudnode.smp.cloudnodemsg.command.MailCommand;
 import pro.cloudnode.smp.cloudnodemsg.command.MainCommand;
 import pro.cloudnode.smp.cloudnodemsg.command.MessageCommand;
 import pro.cloudnode.smp.cloudnodemsg.command.ReplyCommand;
@@ -49,6 +49,7 @@ public void onEnable() {
         Objects.requireNonNull(getCommand("ignore")).setExecutor(new IgnoreCommand());
         Objects.requireNonNull(getCommand("unignore")).setExecutor(new UnIgnoreCommand());
         Objects.requireNonNull(getCommand("togglemsg")).setExecutor(new ToggleMessageCommand());
+        Objects.requireNonNull(getCommand("mail")).setExecutor(new MailCommand());
 
         getServer().getPluginManager().registerEvents(new AsyncChatListener(), this);
         getServer().getPluginManager().registerEvents(new PlayerJoinListener(), this);

src/main/java/pro/cloudnode/smp/cloudnodemsg/Message.java

@@ -72,6 +72,12 @@ public void send() throws InvalidPlayerError {
         return executor instanceof final @NotNull Player player ? player : console;
     }
 
+    public static @NotNull String name(final @NotNull OfflinePlayer player) {
+        if (player.getUniqueId().equals(console.getUniqueId())) return CloudnodeMSG.getInstance().config().consoleName();
+        final @NotNull Optional<@NotNull String> name = Optional.ofNullable(player.getName());
+        return name.orElse("Unknown Player");
+    }
+
     public static void sendMessage(final @NotNull OfflinePlayer recipient, final @NotNull Component message) {
         if (recipient.getUniqueId() == console.getUniqueId())
             CloudnodeMSG.getInstance().getServer().getConsoleSender().sendMessage(message);

src/main/java/pro/cloudnode/smp/cloudnodemsg/PluginConfig.java

@@ -2,6 +2,7 @@
 
 import net.kyori.adventure.text.Component;
 import net.kyori.adventure.text.minimessage.MiniMessage;
+import net.kyori.adventure.text.minimessage.tag.resolver.Formatter;
 import net.kyori.adventure.text.minimessage.tag.resolver.Placeholder;
 import org.bukkit.configuration.file.FileConfiguration;
 import org.jetbrains.annotations.NotNull;
@@ -283,6 +284,28 @@ public int mailNotifyInterval() {
         );
     }
 
+    /**
+     * Successfully sent mail
+     * <p>Placeholders:</p>
+     * <ul>
+     *     <li>{@code <sender>} - the username of the sender</li>
+     *     <li>{@code <recipient>} - the username of the recipient</li>
+     *     <li>{@code <message>} - the message</li>
+     *     <li>{@code <seen>} - whether the mail was read/opened by the recipient (see: <a href="https://docs.advntr.dev/minimessage/dynamic-replacements.html#insert-a-choice">Insert a choice</a>)</li>
+     *     <li>{@code <starred>} - whether the recipient has starred the mail (see: <a href="https://docs.advntr.dev/minimessage/dynamic-replacements.html#insert-a-choice">Insert a choice</a>)</li>
+     * </ul>
+     *
+     * @param mail the mail
+     */
+    public @NotNull Component mailSent(final @NotNull Mail mail) {
+        return MiniMessage.miniMessage().deserialize(Objects.requireNonNull(config.getString("mail.sent"))
+                .replace("<sender>", Message.name(mail.sender))
+                .replace("<recipient>", Message.name(mail.recipient)),
+                Formatter.booleanChoice("seen", mail.seen),
+                Formatter.booleanChoice("starred", mail.starred)
+        ).replaceText(configurer -> configurer.matchLiteral("<message>").replacement(Component.text(mail.message)));
+    }
+
     /**
      * No permission
      */

src/main/java/pro/cloudnode/smp/cloudnodemsg/command/MailCommand.java

@@ -0,0 +1,50 @@
+package pro.cloudnode.smp.cloudnodemsg.command;
+
+import org.bukkit.OfflinePlayer;
+import org.bukkit.command.CommandSender;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import pro.cloudnode.smp.cloudnodemsg.CloudnodeMSG;
+import pro.cloudnode.smp.cloudnodemsg.Mail;
+import pro.cloudnode.smp.cloudnodemsg.Message;
+import pro.cloudnode.smp.cloudnodemsg.Permission;
+
+import java.util.Arrays;
+import java.util.List;
+
+public final class MailCommand extends Command {
+
+    @Override
+    public boolean run(@NotNull CommandSender sender, @NotNull String label, @NotNull String[] args) {
+        if (!sender.hasPermission(Permission.MAIL)) return sendMessage(sender, CloudnodeMSG.getInstance().config().noPermission());
+        if (args.length == 0) return help(sender);
+        final @NotNull String @NotNull [] subCommandArgs = Arrays.copyOfRange(args, 1, args.length);
+        final @NotNull String subCommandLabel = label + " " + args[0];
+        return switch (args[0]) {
+            case "send", "new", "to" -> send(sender, subCommandLabel, subCommandArgs);
+            default -> help(sender);
+        };
+    }
+
+    public static boolean help(final @NotNull CommandSender sender) {
+        // TODO
+        return false;
+    }
+
+    public static boolean send(final @NotNull CommandSender sender, final @NotNull String label, final @NotNull String[] args) {
+        if (args.length == 0) return sendMessage(sender, CloudnodeMSG.getInstance().config().usage(label, "<recipient> <message>"));
+        if (args.length == 1) return sendMessage(sender, CloudnodeMSG.getInstance().config().usage(label, args[0] + " <message>"));
+        final @NotNull String message = String.join(" ", Arrays.copyOfRange(args, 1, args.length));
+        final @NotNull OfflinePlayer recipient = CloudnodeMSG.getInstance().getServer().getOfflinePlayer(args[0]);
+        if (!recipient.hasPlayedBefore()) return sendMessage(sender, CloudnodeMSG.getInstance().config().playerNotFound(args[0]));
+        final @NotNull Mail mail = new Mail(Message.offlinePlayer(sender), recipient, message);
+        mail.insert();
+        // TODO: notify recipient (if online)
+        return sendMessage(sender, CloudnodeMSG.getInstance().config().mailSent(mail));
+    }
+
+    @Override
+    public @Nullable List<String> onTabComplete(@NotNull CommandSender sender, org.bukkit.command.@NotNull Command command, @NotNull String label, @NotNull String[] args) {
+        return null;
+    }
+}

src/main/resources/config.yml

@@ -110,6 +110,15 @@ mail:
   #  <unread> - the number of unread mail messages
   notify: "<green>(!) You have <gray><unread></gray> unread messages.</green> <hover:show_text:'Click to view mail'><click:run_command:/mail read><gray>View mail</gray></click></hover>"
 
+  # Successfully sent mail
+  # Placeholders:
+  #  <sender> - the username of the sender
+  #  <recipient> - the username of the recipient
+  #  <message> - the message
+  #  <seen> - whether the mail was read/opened by the recipient (see: https://docs.advntr.dev/minimessage/dynamic-replacements.html#insert-a-choice)
+  #  <starred> - whether the recipient has starred the mail (see: https://docs.advntr.dev/minimessage/dynamic-replacements.html#insert-a-choice)
+  sent: "<green>(!) Successfully sent mail to <gray><recipient></gray>.</green>"
+
 # Error messages
 errors:
     # No permission

src/main/resources/plugin.yml

@@ -27,3 +27,7 @@ commands:
         description: Toggles private messages from a player
         usage: /<command> <player>
         aliases: [ "toggledms", "togglepms" ]
+    mail:
+        description: Send and receive offline messages
+        usage: /<command>
+        aliases: [ "post" ]