Release 1.5

- Add Questions forum related events.
- Add auto complete feature.
- Send "Oh boy 3 am" at underground channel at 3 am on every day.
- Add /transfer command.
- Add part of /minesweeper command (not complete yet).
- Add Raw Text message command.
- Add Reactions message command.
- Translate README.md to 4 languages.
- Tranlsate /lottery command.

Author: AlexCai2019

src/main/java/cartoland/Cartoland.java

@@ -33,8 +33,9 @@ public static void main(String[] args) throws InterruptedException
 						new AutoComplete(), //當指令需要自動補完
 						new ContextMenu(), //當有人使用右鍵功能
 						new GetRole(), //當有人獲得會員身分組
-						new JoinServer()/*, //當有人加入創聯
-						new OpenFormPost()*/) //當有人在Questions論壇發文
+						new JoinServer(), //當有人加入創聯
+						new OpenQuestionsForumPost(), //當有人在Questions論壇發文
+						new QuestionForumMessage()) //當有人在Questions論壇講話
 				.enableIntents(GatewayIntent.MESSAGE_CONTENT, GatewayIntent.GUILD_MEMBERS)
 				.setMemberCachePolicy(MemberCachePolicy.ALL)
 				.setActivity(Activity.playing("Use /help to check more information")) //正在玩

src/main/java/cartoland/events/AutoComplete.java

@@ -73,7 +73,7 @@ void completeProcess(CommandAutoCompleteInteractionEvent event)
 					.map(word -> new Command.Choice((String) word, (String) word))
 					.collect(Collectors.toList());
 
-			event.replyChoices((choices.size() <= CHOICES_LIMIT) ? choices : choices.subList(0, CHOICES_LIMIT)).queue();
+			event.replyChoices(choices.size() <= CHOICES_LIMIT ? choices : choices.subList(0, CHOICES_LIMIT)).queue();
 		}
 	}
 }

src/main/java/cartoland/events/BotOnline.java

@@ -6,7 +6,7 @@
 import org.jetbrains.annotations.NotNull;
 
 import java.time.Duration;
-import java.time.LocalTime;
+import java.time.LocalDateTime;
 import java.util.concurrent.Executors;
 import java.util.concurrent.TimeUnit;
 
@@ -35,6 +35,10 @@ public void onReady(@NotNull ReadyEvent event)
 		if (cartolandServer == null)
 			problemOccurred("Can't find Cartoland Server");
 
+		questionsChannel = cartolandServer.getForumChannelById(QUESTIONS_CHANNEL_ID);
+		if (questionsChannel == null)
+			problemOccurred("Can't find Questions Channel.");
+
 		lobbyChannel = cartolandServer.getTextChannelById(LOBBY_CHANNEL_ID); //創聯的大廳頻道
 		if (lobbyChannel == null)
 			problemOccurred("Can't find Lobby Channel.");
@@ -47,6 +51,14 @@ public void onReady(@NotNull ReadyEvent event)
 		if (undergroundChannel == null)
 			problemOccurred("Can't find Underground Channel.");
 
+		resolvedForumTag = questionsChannel.getAvailableTagById(RESOLVED_FORUM_TAG_ID);
+		if (resolvedForumTag == null)
+			problemOccurred("Can't find Resolved Forum Tag");
+
+		unresolvedForumTag = questionsChannel.getAvailableTagById(UNRESOLVED_FORUM_TAG_ID);
+		if (unresolvedForumTag == null)
+			problemOccurred("Can't find Unresolved Forum Tag");
+
 		memberRole = cartolandServer.getRoleById(MEMBER_ROLE_ID); //會員身分組
 		if (memberRole == null)
 			problemOccurred("Can't find Member Role.");
@@ -69,23 +81,25 @@ public void onReady(@NotNull ReadyEvent event)
 	 * When an error occurred, an entity is null.
 	 *
 	 * @param logString The content that will print to standard error stream and log file.
+	 * @throws NullPointerException always throw
 	 */
 	private void problemOccurred(String logString)
 	{
 		System.err.println(logString);
 		System.err.print('\u0007');
 		FileHandle.log(logString);
 		jda.shutdownNow();
+		throw new NullPointerException();
 	}
 
 	//https://stackoverflow.com/questions/65984126
 	private void ohBoy3AM()
 	{
-		LocalTime now = LocalTime.now();
-		LocalTime threeAM = now.withHour(3).withMinute(0).withSecond(0);
+		LocalDateTime now = LocalDateTime.now();
+		LocalDateTime threeAM = now.withHour(3).withMinute(0).withSecond(0);
 
 		if (now.compareTo(threeAM) > 0)
-			threeAM = threeAM.plusHours(24);
+			threeAM = threeAM.plusDays(1L);
 
 		long secondsUntil3AM = Duration.between(now, threeAM).getSeconds();
 

src/main/java/cartoland/events/ChannelMessage.java

@@ -141,8 +141,8 @@ public void onMessageReceived(@NotNull MessageReceivedEvent event)
 		if (Algorithm.chance(20) && rawMessage.contains("wow")) //20%
 			message.addReaction(wow).queue();
 
-		if ((categoryID == IDAndEntities.GENERAL_CATEGORY_ID || categoryID == IDAndEntities.TECH_TALK_CATEGORY_ID)
-				&& channel.getIdLong() != IDAndEntities.BOT_CHANNEL_ID) //在一般或技術討論區類別 且不是在機器人專區
+		//在一般、技術討論區或公眾區域類別 且不是在機器人專區
+		if (channel.getIdLong() != IDAndEntities.BOT_CHANNEL_ID && IDAndEntities.commandBlockCategories.contains(categoryID))
 			CommandBlocksHandle.addCommandBlocks(userID, rawMessage.length()); //說話加等級
 	}
 

src/main/java/cartoland/events/OpenFormPost.java

@@ -0,0 +1,66 @@
+package cartoland.events;
+
+import cartoland.utilities.IDAndEntities;
+import net.dv8tion.jda.api.EmbedBuilder;
+import net.dv8tion.jda.api.entities.MessageEmbed;
+import net.dv8tion.jda.api.entities.channel.concrete.ThreadChannel;
+import net.dv8tion.jda.api.entities.channel.forums.ForumTag;
+import net.dv8tion.jda.api.events.channel.ChannelCreateEvent;
+import net.dv8tion.jda.api.hooks.ListenerAdapter;
+import org.jetbrains.annotations.NotNull;
+
+import java.awt.Color;
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * {@code OpenQuestionsForumPost} is a listener that triggers when a user create a forum post. This class was
+ * registered in {@link cartoland.Cartoland#main}, with the build of JDA.
+ *
+ * @since 1.5
+ * @author Alex Cai
+ */
+public class OpenQuestionsForumPost extends ListenerAdapter
+{
+	private final MessageEmbed startEmbed = new EmbedBuilder()
+			.setTitle("**-=發問指南=-**", null)
+			.setDescription("""
+							-=發問指南=-
+														
+							• 請清楚說明你想做什麼，並想要什麼結果
+							• 請提及你正在使用的Minecraft版本，以及是否正在使用任何模組
+							• 討論完成後，使用✅表情符號關閉貼文
+														
+							-=Guidelines=-
+							       
+							• Ask your question straight and clearly, tell us what you are trying to do.
+							• Mention which Minecraft version you are using and any mods.
+							• Remember to use ✅ to close the post after resolved.
+							""")
+			.setColor(new Color(133, 201, 103))
+			.build();
+
+	@Override
+	public void onChannelCreate(@NotNull ChannelCreateEvent event)
+	{
+		if (!event.getChannelType().isThread())
+			return;
+
+		ThreadChannel forumPost = event.getChannel().asThreadChannel();
+		if (forumPost.getParentChannel().getIdLong() != IDAndEntities.QUESTIONS_CHANNEL_ID)
+			return;
+
+		forumPost.addThreadMember(IDAndEntities.botItself).queue();
+		forumPost.sendMessageEmbeds(startEmbed).queue();
+
+		List<ForumTag> tags = new ArrayList<>(forumPost.getAppliedTags());
+		tags.remove(IDAndEntities.resolvedForumTag);
+		if (!tags.contains(IDAndEntities.unresolvedForumTag))
+		{
+			if (tags.size() == 5) //不可以超過5個tag
+				tags.remove(4);
+			tags.add(IDAndEntities.unresolvedForumTag);
+		}
+		forumPost.getManager().setAppliedTags(tags).queue();
+	}
+}

src/main/java/cartoland/events/OpenQuestionsForumPost.java

@@ -0,0 +1,53 @@
+package cartoland.events;
+
+import cartoland.utilities.IDAndEntities;
+import net.dv8tion.jda.api.entities.User;
+import net.dv8tion.jda.api.entities.channel.concrete.ThreadChannel;
+import net.dv8tion.jda.api.entities.channel.forums.ForumTag;
+import net.dv8tion.jda.api.events.message.MessageReceivedEvent;
+import net.dv8tion.jda.api.hooks.ListenerAdapter;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * {@code QuestionForumMessage} is a listener that triggers when a user types anything in any forum post in
+ * Questions forum channel. This class was registered in {@link cartoland.Cartoland#main}, with the build of JDA.
+ *
+ * @since 1.5
+ * @author Alex Cai
+ */
+public class QuestionForumMessage extends ListenerAdapter
+{
+	@Override
+	public void onMessageReceived(@NotNull MessageReceivedEvent event)
+	{
+		if (!event.getChannelType().isThread()) //不是討論串 or 論壇貼文
+			return;
+
+		User author = event.getAuthor();
+		if (author.isBot() || author.isSystem()) //是機器人或系統
+			return;
+
+		ThreadChannel forumPost = event.getChannel().asThreadChannel();
+		if (forumPost.getParentChannel().getIdLong() != IDAndEntities.QUESTIONS_CHANNEL_ID) //不在問題論壇
+			return;
+
+		List<ForumTag> tags = forumPost.getAppliedTags();
+		if (!forumPost.isArchived() && event.getMessage().getContentRaw().equals("✅"))
+		{
+			tags = new ArrayList<>(tags);
+			tags.remove(IDAndEntities.unresolvedForumTag);
+			tags.add(IDAndEntities.resolvedForumTag);
+			forumPost.getManager().setAppliedTags(tags).setArchived(true).queue(); //關閉貼文
+		}
+		else if (forumPost.isArchived() && tags.contains(IDAndEntities.resolvedForumTag))
+		{
+			tags = new ArrayList<>(tags);
+			tags.remove(IDAndEntities.resolvedForumTag);
+			tags.add(IDAndEntities.unresolvedForumTag);
+			forumPost.getManager().setAppliedTags(tags).queue(); //打開貼文
+		}
+	}
+}

src/main/java/cartoland/events/QuestionForumMessage.java

@@ -4,9 +4,12 @@
 import net.dv8tion.jda.api.entities.Guild;
 import net.dv8tion.jda.api.entities.Role;
 import net.dv8tion.jda.api.entities.User;
+import net.dv8tion.jda.api.entities.channel.concrete.ForumChannel;
 import net.dv8tion.jda.api.entities.channel.concrete.TextChannel;
+import net.dv8tion.jda.api.entities.channel.forums.ForumTag;
 
-import java.util.concurrent.Executors;
+import java.util.ArrayList;
+import java.util.List;
 import java.util.concurrent.ScheduledExecutorService;
 import java.util.concurrent.ScheduledFuture;
 
@@ -25,21 +28,35 @@ private IDAndEntities()
 	}
 
 	public static final long CARTOLAND_SERVER_ID = 886936474723950603L; //創聯
-	public static final long QUESTIONS_CHANNEL_ID = 1079073022624940044L; //問題諮詢
+	public static final long GENERAL_CATEGORY_ID = 886936474723950608L; //創聯的一般類別
+	public static final long TECH_TALK_CATEGORY_ID = 974224793727537182L; //創聯的技術討論區類別
+	public static final long PUBLIC_AREA_CATEGORY_ID = 922892242459459657L; //創聯的公眾區域類別
+	public static final long QUESTIONS_CHANNEL_ID = 1079073022624940044L; //創聯的問題諮詢頻道
 	public static final long LOBBY_CHANNEL_ID = 886936474723950611L; //創聯的大廳頻道
 	public static final long BOT_CHANNEL_ID = 891703579289718814L; //創聯的機器人頻道
 	public static final long UNDERGROUND_CHANNEL_ID = 962688156942073887L; //創聯的地下頻道
-	public static final long GENERAL_CATEGORY_ID = 886936474723950608L; //創聯的一般類別
-	public static final long TECH_TALK_CATEGORY_ID = 974224793727537182L; //創聯的技術討論區類別
+	public static final long RESOLVED_FORUM_TAG_ID = 1079074167468605490L; //已解決的tag
+	public static final long UNRESOLVED_FORUM_TAG_ID = 1079074098493280347L; //未解決的tag
 	public static final long MEMBER_ROLE_ID = 892415577002504272L; //會員身分組
 	public static final long NSFW_ROLE_ID = 919700598612426814L; //地下身分組
 	public static final long AC_ID = 355953951469731842L;
 
+	public static final List<Long> commandBlockCategories = new ArrayList<>(3);
+	static
+	{
+		commandBlockCategories.add(GENERAL_CATEGORY_ID);
+		commandBlockCategories.add(TECH_TALK_CATEGORY_ID);
+		commandBlockCategories.add(PUBLIC_AREA_CATEGORY_ID);
+	}
+
 	public static JDA jda;
 	public static Guild cartolandServer;
+	public static ForumChannel questionsChannel;
 	public static TextChannel lobbyChannel;
 	public static TextChannel botChannel;
 	public static TextChannel undergroundChannel;
+	public static ForumTag resolvedForumTag;
+	public static ForumTag unresolvedForumTag;
 	public static Role memberRole;
 	public static Role nsfwRole;
 	public static User botItself;