UPGRADE TO 1.1.0 POG

Merge `development` into `stable`

src/main/java/emu/grasscutter/server/dispatch/ClientLogHandler.java

+package emu.grasscutter.server.dispatch;
+
+import express.http.HttpContextHandler;
+import express.http.Request;
+import express.http.Response;
+
+import java.io.IOException;
+
+/**
+ * Used for processing crash dumps and logs generated by the game.
+ * Logs are in JSON, and are sent to the server for logging.
+ */
+public final class ClientLogHandler implements HttpContextHandler {
+    @Override
+    public void handle(Request request, Response response) throws IOException {
+        // TODO: Figure out how to dump request body and log to file.
+        response.send("{\"code\":0}");
+    }
+}

src/main/java/emu/grasscutter/server/dispatch/DispatchHttpJsonHandler.java

 package emu.grasscutter.server.dispatch;
 
 import java.io.IOException;
-import java.io.OutputStream;
-import java.util.Collections;
+import java.util.Arrays;
+import java.util.Objects;
 
-import com.sun.net.httpserver.HttpExchange;
-import com.sun.net.httpserver.HttpHandler;
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.Grasscutter.ServerDebugMode;
+import express.http.HttpContextHandler;
+import express.http.Request;
+import express.http.Response;
 
-public final class DispatchHttpJsonHandler implements HttpHandler {
+import static emu.grasscutter.utils.Language.translate;
+
+public final class DispatchHttpJsonHandler implements HttpContextHandler {
 	private final String response;
+	private final String[] missingRoutes = { // TODO: When http requests for theses routes are found please remove it from this list and update the route request type in the DispatchServer
+			"/common/hk4e_global/announcement/api/getAlertPic",
+			"/common/hk4e_global/announcement/api/getAlertAnn",
+			"/common/hk4e_global/announcement/api/getAnnList",
+			"/common/hk4e_global/announcement/api/getAnnContent",
+			"/hk4e_global/mdk/shopwindow/shopwindow/listPriceTier",
+			"/log/sdk/upload",
+			"/sdk/upload",
+			"/perf/config/verify",
+			"/log",
+			"/crash/dataUpload"
+	};
 	
 	public DispatchHttpJsonHandler(String response) {
 		this.response = response;
 	}
 
 	@Override
-	public void handle(HttpExchange t) throws IOException {
-        // Set the response header status and length
-        t.getResponseHeaders().put("Content-Type", Collections.singletonList("application/json"));
-        t.sendResponseHeaders(200, response.getBytes().length);
-        // Write the response string
-        OutputStream os = t.getResponseBody();
-        os.write(response.getBytes());
-        os.close();
+	public void handle(Request req, Response res) throws IOException {
+		// Checking for ALL here isn't required as when ALL is enabled enableDevLogging() gets enabled
+		if(Grasscutter.getConfig().DebugMode == ServerDebugMode.MISSING && Arrays.stream(missingRoutes).anyMatch(x -> Objects.equals(x, req.baseUrl()))) {
+			Grasscutter.getLogger().info(translate("messages.dispatch.request", req.ip(), req.method(), req.baseUrl()) + (Grasscutter.getConfig().DebugMode == ServerDebugMode.MISSING ? "(MISSING)" : ""));
+		}
+		res.send(response);
 	}
 }

src/main/java/emu/grasscutter/server/dispatch/DispatchServer.java

@@ -3,55 +3,68 @@ package emu.grasscutter.server.dispatch;
 import com.google.gson.Gson;
 import com.google.gson.GsonBuilder;
 import com.google.protobuf.ByteString;
-import com.sun.net.httpserver.HttpExchange;
-import com.sun.net.httpserver.HttpServer;
-import com.sun.net.httpserver.HttpsConfigurator;
-import com.sun.net.httpserver.HttpsServer;
 
 import emu.grasscutter.Config;
 import emu.grasscutter.Grasscutter;
+import emu.grasscutter.Grasscutter.ServerDebugMode;
+import emu.grasscutter.Grasscutter.ServerRunMode;
 import emu.grasscutter.database.DatabaseHelper;
 import emu.grasscutter.game.Account;
 import emu.grasscutter.net.proto.QueryCurrRegionHttpRspOuterClass.QueryCurrRegionHttpRsp;
 import emu.grasscutter.net.proto.QueryRegionListHttpRspOuterClass.QueryRegionListHttpRsp;
 import emu.grasscutter.net.proto.RegionInfoOuterClass.RegionInfo;
 import emu.grasscutter.net.proto.RegionSimpleInfoOuterClass.RegionSimpleInfo;
+import emu.grasscutter.server.dispatch.authentication.AuthenticationHandler;
+import emu.grasscutter.server.dispatch.authentication.DefaultAuthenticationHandler;
+import emu.grasscutter.server.dispatch.http.GachaRecordHandler;
 import emu.grasscutter.server.dispatch.json.*;
 import emu.grasscutter.server.dispatch.json.ComboTokenReqJson.LoginTokenData;
+import emu.grasscutter.server.event.dispatch.QueryAllRegionsEvent;
+import emu.grasscutter.server.event.dispatch.QueryCurrentRegionEvent;
+import emu.grasscutter.tools.Tools;
 import emu.grasscutter.utils.FileUtils;
 import emu.grasscutter.utils.Utils;
+import express.Express;
+import io.javalin.http.staticfiles.Location;
+import org.eclipse.jetty.server.Connector;
+import org.eclipse.jetty.server.Server;
+import org.eclipse.jetty.server.ServerConnector;
+import org.eclipse.jetty.util.ssl.SslContextFactory;
 
-import javax.net.ssl.KeyManagerFactory;
-import javax.net.ssl.SSLContext;
 import java.io.*;
-import java.net.InetSocketAddress;
-import java.net.URI;
 import java.net.URLDecoder;
-import java.security.KeyStore;
 import java.util.*;
 
+import static emu.grasscutter.utils.Language.translate;
+
 public final class DispatchServer {
 	public static String query_region_list = "";
 	public static String query_cur_region = "";
 
-	private final InetSocketAddress address;
 	private final Gson gson;
 	private final String defaultServerName = "os_usa";
 
 	public String regionListBase64;
-	public HashMap<String, RegionData> regions;
+	public Map<String, RegionData> regions;
+	private AuthenticationHandler authHandler;
+	private Express httpServer;
 
 	public DispatchServer() {
-		this.regions = new HashMap<String, RegionData>();
-		this.address = new InetSocketAddress(Grasscutter.getConfig().getDispatchOptions().Ip, Grasscutter.getConfig().getDispatchOptions().Port);
+		this.regions = new HashMap<>();
 		this.gson = new GsonBuilder().create();
 
 		this.loadQueries();
 		this.initRegion();
 	}
 
-	public InetSocketAddress getAddress() {
-		return address;
+	public Express getServer() {
+		return httpServer;
+	}
+
+	public void setHttpServer(Express httpServer) {
+		this.httpServer.stop();
+		this.httpServer = httpServer;
+		this.httpServer.listen(Grasscutter.getConfig().getDispatchOptions().Port);
 	}
 
 	public Gson getGsonFactory() {
@@ -60,7 +73,7 @@ public final class DispatchServer {
 
 	public QueryCurrRegionHttpRsp getCurrRegion() {
 		// Needs to be fixed by having the game servers connect to the dispatch server.
-		if(Grasscutter.getConfig().RunMode.equalsIgnoreCase("HYBRID")) {
+		if (Grasscutter.getConfig().RunMode == ServerRunMode.HYBRID) {
 			return regions.get(defaultServerName).parsedRegionQuery;
 		}
 
@@ -94,36 +107,54 @@ public final class DispatchServer {
 			byte[] decoded2 = Base64.getDecoder().decode(query_cur_region);
 			QueryCurrRegionHttpRsp regionQuery = QueryCurrRegionHttpRsp.parseFrom(decoded2);
 
-			List<RegionSimpleInfo> servers = new ArrayList<RegionSimpleInfo>();
-			List<String> usedNames = new ArrayList<String>(); // List to check for potential naming conflicts
-			if(Grasscutter.getConfig().RunMode.equalsIgnoreCase("HYBRID")) { // Automatically add the game server if in hybrid mode
+			List<RegionSimpleInfo> servers = new ArrayList<>();
+			List<String> usedNames = new ArrayList<>(); // List to check for potential naming conflicts
+			if (Grasscutter.getConfig().RunMode == ServerRunMode.HYBRID) { // Automatically add the game server if in
+																				// hybrid mode
 				RegionSimpleInfo server = RegionSimpleInfo.newBuilder()
 						.setName("os_usa")
 						.setTitle(Grasscutter.getConfig().getGameServerOptions().Name)
 						.setType("DEV_PUBLIC")
-						.setDispatchUrl("https://" + (Grasscutter.getConfig().getDispatchOptions().PublicIp.isEmpty() ? Grasscutter.getConfig().getDispatchOptions().Ip : Grasscutter.getConfig().getDispatchOptions().PublicIp) + ":" + getAddress().getPort() + "/query_cur_region_" + defaultServerName)
+						.setDispatchUrl(
+								"http" + (Grasscutter.getConfig().getDispatchOptions().FrontHTTPS ? "s" : "") + "://"
+										+ (Grasscutter.getConfig().getDispatchOptions().PublicIp.isEmpty()
+												? Grasscutter.getConfig().getDispatchOptions().Ip
+												: Grasscutter.getConfig().getDispatchOptions().PublicIp)
+										+ ":"
+										+ (Grasscutter.getConfig().getDispatchOptions().PublicPort != 0
+												? Grasscutter.getConfig().getDispatchOptions().PublicPort
+												: Grasscutter.getConfig().getDispatchOptions().Port)
+										+ "/query_cur_region/" + defaultServerName)
 						.build();
 				usedNames.add(defaultServerName);
 				servers.add(server);
 
 				RegionInfo serverRegion = regionQuery.getRegionInfo().toBuilder()
-						.setIp((Grasscutter.getConfig().getGameServerOptions().PublicIp.isEmpty() ? Grasscutter.getConfig().getGameServerOptions().Ip : Grasscutter.getConfig().getGameServerOptions().PublicIp))
-						.setPort(Grasscutter.getConfig().getGameServerOptions().Port)
-						.setSecretKey(ByteString.copyFrom(FileUtils.read(Grasscutter.getConfig().KEY_FOLDER + "dispatchSeed.bin")))
+						.setGateserverIp((Grasscutter.getConfig().getGameServerOptions().PublicIp.isEmpty()
+								? Grasscutter.getConfig().getGameServerOptions().Ip
+								: Grasscutter.getConfig().getGameServerOptions().PublicIp))
+						.setGateserverPort(Grasscutter.getConfig().getGameServerOptions().PublicPort != 0
+								? Grasscutter.getConfig().getGameServerOptions().PublicPort
+								: Grasscutter.getConfig().getGameServerOptions().Port)
+						.setSecretKey(ByteString
+								.copyFrom(FileUtils.read(Grasscutter.getConfig().KEY_FOLDER + "dispatchSeed.bin")))
 						.build();
 
 				QueryCurrRegionHttpRsp parsedRegionQuery = regionQuery.toBuilder().setRegionInfo(serverRegion).build();
-				regions.put(defaultServerName, new RegionData(parsedRegionQuery, Base64.getEncoder().encodeToString(parsedRegionQuery.toByteString().toByteArray())));
+				regions.put(defaultServerName, new RegionData(parsedRegionQuery,
+						Base64.getEncoder().encodeToString(parsedRegionQuery.toByteString().toByteArray())));
 
 			} else {
-				if(Grasscutter.getConfig().getDispatchOptions().getGameServers().length == 0) {
-					Grasscutter.getLogger().error("[Dispatch] There are no game servers available. Exiting due to unplayable state.");
+				if (Grasscutter.getConfig().getDispatchOptions().getGameServers().length == 0) {
+					Grasscutter.getLogger()
+							.error("[Dispatch] There are no game servers available. Exiting due to unplayable state.");
 					System.exit(1);
 				}
 			}
 
-			for (Config.DispatchServerOptions.RegionInfo regionInfo : Grasscutter.getConfig().getDispatchOptions().getGameServers()) {
-				if(usedNames.contains(regionInfo.Name)) {
+			for (Config.DispatchServerOptions.RegionInfo regionInfo : Grasscutter.getConfig().getDispatchOptions()
+					.getGameServers()) {
+				if (usedNames.contains(regionInfo.Name)) {
 					Grasscutter.getLogger().error("Region name already in use.");
 					continue;
 				}
@@ -131,23 +162,32 @@ public final class DispatchServer {
 						.setName(regionInfo.Name)
 						.setTitle(regionInfo.Title)
 						.setType("DEV_PUBLIC")
-						.setDispatchUrl("https://" + (Grasscutter.getConfig().getDispatchOptions().PublicIp.isEmpty() ? Grasscutter.getConfig().getDispatchOptions().Ip : Grasscutter.getConfig().getDispatchOptions().PublicIp) + ":" + getAddress().getPort() + "/query_cur_region_" + regionInfo.Name)
+						.setDispatchUrl(
+								"http" + (Grasscutter.getConfig().getDispatchOptions().FrontHTTPS ? "s" : "") + "://"
+										+ (Grasscutter.getConfig().getDispatchOptions().PublicIp.isEmpty()
+												? Grasscutter.getConfig().getDispatchOptions().Ip
+												: Grasscutter.getConfig().getDispatchOptions().PublicIp)
+										+ ":" + (Grasscutter.getConfig().getDispatchOptions().PublicPort != 0
+										? Grasscutter.getConfig().getDispatchOptions().PublicPort
+										: Grasscutter.getConfig().getDispatchOptions().Port) + "/query_cur_region/" + regionInfo.Name)
 						.build();
 				usedNames.add(regionInfo.Name);
 				servers.add(server);
 
 				RegionInfo serverRegion = regionQuery.getRegionInfo().toBuilder()
-						.setIp(regionInfo.Ip)
-						.setPort(regionInfo.Port)
-						.setSecretKey(ByteString.copyFrom(FileUtils.read(Grasscutter.getConfig().KEY_FOLDER + "dispatchSeed.bin")))
+						.setGateserverIp(regionInfo.Ip)
+						.setGateserverPort(regionInfo.Port)
+						.setSecretKey(ByteString
+								.copyFrom(FileUtils.read(Grasscutter.getConfig().KEY_FOLDER + "dispatchSeed.bin")))
 						.build();
 
 				QueryCurrRegionHttpRsp parsedRegionQuery = regionQuery.toBuilder().setRegionInfo(serverRegion).build();
-				regions.put(regionInfo.Name, new RegionData(parsedRegionQuery, Base64.getEncoder().encodeToString(parsedRegionQuery.toByteString().toByteArray())));
+				regions.put(regionInfo.Name, new RegionData(parsedRegionQuery,
+						Base64.getEncoder().encodeToString(parsedRegionQuery.toByteString().toByteArray())));
 			}
 
 			QueryRegionListHttpRsp regionList = QueryRegionListHttpRsp.newBuilder()
-				.addAllServers(servers)
+					.addAllRegionList(servers)
 					.setClientSecretKey(rl.getClientSecretKey())
 					.setClientCustomConfigEncrypted(rl.getClientCustomConfigEncrypted())
 					.setEnableLoginPc(true)
@@ -160,62 +200,113 @@ public final class DispatchServer {
 	}
 
 	public void start() throws Exception {
-		HttpServer server;
-		if (Grasscutter.getConfig().getDispatchOptions().UseSSL) {
-			HttpsServer httpsServer;
-			httpsServer = HttpsServer.create(getAddress(), 0);
-			SSLContext sslContext = SSLContext.getInstance("TLS");
-			try (FileInputStream fis = new FileInputStream(Grasscutter.getConfig().getDispatchOptions().KeystorePath)) {
-				char[] keystorePassword = Grasscutter.getConfig().getDispatchOptions().KeystorePassword.toCharArray();
-				KeyStore ks = KeyStore.getInstance("PKCS12");
-				ks.load(fis, keystorePassword);
-				KeyManagerFactory kmf = KeyManagerFactory.getInstance("SunX509");
-				kmf.init(ks, keystorePassword);
-				
-				sslContext.init(kmf.getKeyManagers(), null, null);
-				
-				httpsServer.setHttpsConfigurator(new HttpsConfigurator(sslContext));
-				server = httpsServer;
+		httpServer = new Express(config -> {
+			config.server(() -> {
+				Server server = new Server();
+				ServerConnector serverConnector;
+
+				if(Grasscutter.getConfig().getDispatchOptions().UseSSL) {
+					SslContextFactory.Server sslContextFactory = new SslContextFactory.Server();
+					File keystoreFile = new File(Grasscutter.getConfig().getDispatchOptions().KeystorePath);
+
+					if(keystoreFile.exists()) {
+						try {
+							sslContextFactory.setKeyStorePath(keystoreFile.getPath());
+							sslContextFactory.setKeyStorePassword(Grasscutter.getConfig().getDispatchOptions().KeystorePassword);
 						} catch (Exception e) {
-				Grasscutter.getLogger().warn("[Dispatch] No SSL cert found! Falling back to HTTP server.");
+							e.printStackTrace();
+							Grasscutter.getLogger().warn(translate("messages.dispatch.keystore.password_error"));
+
+							try {
+								sslContextFactory.setKeyStorePath(keystoreFile.getPath());
+								sslContextFactory.setKeyStorePassword("123456");
+								Grasscutter.getLogger().warn(translate("messages.dispatch.keystore.default_password"));
+							} catch (Exception e2) {
+								Grasscutter.getLogger().warn(translate("messages.dispatch.keystore.general_error"));
+								e2.printStackTrace();
+							}
+						}
+
+						serverConnector = new ServerConnector(server, sslContextFactory);
+					} else {
+						Grasscutter.getLogger().warn(translate("messages.dispatch.keystore.no_keystore_error"));
 						Grasscutter.getConfig().getDispatchOptions().UseSSL = false;
-				server = HttpServer.create(getAddress(), 0);
+
+						serverConnector = new ServerConnector(server);
 					}
 				} else {
-			server = HttpServer.create(getAddress(), 0);
+					serverConnector = new ServerConnector(server);
+				}
+
+				serverConnector.setPort(Grasscutter.getConfig().getDispatchOptions().Port);
+				server.setConnectors(new Connector[]{serverConnector});
+				return server;
+			});
+
+			config.enforceSsl = Grasscutter.getConfig().getDispatchOptions().UseSSL;
+			if(Grasscutter.getConfig().DebugMode == ServerDebugMode.ALL) {
+				config.enableDevLogging();
+			}
+			if (Grasscutter.getConfig().getDispatchOptions().CORS){
+				if (Grasscutter.getConfig().getDispatchOptions().CORSAllowedOrigins.length > 0) config.enableCorsForOrigin(Grasscutter.getConfig().getDispatchOptions().CORSAllowedOrigins);
+				else config.enableCorsForAllOrigins();
 			}
+		});
+		httpServer.get("/", (req, res) -> res.send(translate("messages.status.welcome")));
 
-		server.createContext("/", t -> responseHTML(t, "Hello"));
+		httpServer.raw().error(404, ctx -> {
+			if(Grasscutter.getConfig().DebugMode == ServerDebugMode.MISSING) {
+				Grasscutter.getLogger().info(translate("messages.dispatch.unhandled_request_error", ctx.method(), ctx.url()));
+			}
+			ctx.contentType("text/html");
+			ctx.result("<!doctype html><html lang=\"en\"><body><img src=\"https://http.cat/404\" /></body></html>"); // I'm like 70% sure this won't break anything.
+		});
+
+		// Authentication Handler
+		// These routes are so that authentication routes are always the same no matter what auth system is used.
+		httpServer.get("/authentication/type", (req, res) -> {
+			res.send(this.getAuthHandler().getClass().getName());
+		});
+
+		httpServer.post("/authentication/login", (req, res) -> this.getAuthHandler().handleLogin(req, res));
+		httpServer.post("/authentication/register", (req, res) -> this.getAuthHandler().handleRegister(req, res));
+		httpServer.post("/authentication/change_password", (req, res) -> this.getAuthHandler().handleChangePassword(req, res));
 
 		// Dispatch
-		server.createContext("/query_region_list", t -> {
+		httpServer.get("/query_region_list", (req, res) -> {
 			// Log
-			Grasscutter.getLogger().info(String.format("[Dispatch] Client %s request: query_region_list", t.getRemoteAddress()));
+			Grasscutter.getLogger().info(String.format("[Dispatch] Client %s request: query_region_list", req.ip()));
 
-			responseHTML(t, regionListBase64);
+			// Invoke event.
+			QueryAllRegionsEvent event = new QueryAllRegionsEvent(regionListBase64); event.call();
+			// Respond with event result.
+			res.send(event.getRegionList());
 		});
 
-		for (String regionName : regions.keySet()) {
-			server.createContext("/query_cur_region_" + regionName, t -> {
-				String regionCurrentBase64 = regions.get(regionName).Base64;
+		httpServer.get("/query_cur_region/:id", (req, res) -> {
+			String regionName = req.params("id");
 			// Log
-				Grasscutter.getLogger().info(String.format("Client %s request: query_cur_region_%s", t.getRemoteAddress(), regionName));
+			Grasscutter.getLogger().info(
+					String.format("Client %s request: query_cur_region/%s", req.ip(), regionName));
 			// Create a response form the request query parameters
-				URI uri = t.getRequestURI();
 			String response = "CAESGE5vdCBGb3VuZCB2ZXJzaW9uIGNvbmZpZw==";
-				if (uri.getQuery() != null && uri.getQuery().length() > 0) {
-					response = regionCurrentBase64;
+			if (req.query().values().size() > 0) {
+				response = regions.get(regionName).Base64;
 			}
-				responseHTML(t, response);
+
+			// Invoke event.
+			QueryCurrentRegionEvent event = new QueryCurrentRegionEvent(response); event.call();
+			// Respond with event result.
+			res.send(event.getRegionInfo());
 		});
-		}
 
-		// Login via account
-		server.createContext("/hk4e_global/mdk/shield/api/login", t -> {
+		// Login
+
+		httpServer.post("/hk4e_global/mdk/shield/api/login", (req, res) -> {
 			// Get post data
 			LoginAccountRequestJson requestData = null;
 			try {
-				String body = Utils.toString(t.getRequestBody());
+				String body = req.ctx().body();
 				requestData = getGsonFactory().fromJson(body, LoginAccountRequestJson.class);
 			} catch (Exception ignored) { }
 
@@ -223,66 +314,27 @@ public final class DispatchServer {
 			if (requestData == null) {
 				return;
 			}
-			LoginResultJson responseData = new LoginResultJson();
-
-			Grasscutter.getLogger().info(String.format("[Dispatch] Client %s is trying to log in", t.getRemoteAddress()));
-			
-			// Login
-			Account account = DatabaseHelper.getAccountByName(requestData.account);
-			
-			// Check if account exists, else create a new one.
-			if (account == null) {
-				// Account doesnt exist, so we can either auto create it if the config value is set
-				if (Grasscutter.getConfig().getDispatchOptions().AutomaticallyCreateAccounts) {
-					// This account has been created AUTOMATICALLY. There will be no permissions added.
-					account = DatabaseHelper.createAccountWithId(requestData.account, 0);
-
-					if (account != null) {
-						responseData.message = "OK";
-						responseData.data.account.uid = account.getId();
-						responseData.data.account.token = account.generateSessionKey();
-						responseData.data.account.email = account.getEmail();
+			Grasscutter.getLogger().info(translate("messages.dispatch.account.login_attempt", req.ip()));
 
-						Grasscutter.getLogger().info(String.format("[Dispatch] Client %s failed to log in: Account %s created", t.getRemoteAddress(), responseData.data.account.uid));
-					} else {
-						responseData.retcode = -201;
-						responseData.message = "Username not found, create failed.";
-
-						Grasscutter.getLogger().info(String.format("[Dispatch] Client %s failed to log in: Account create failed", t.getRemoteAddress()));
-					}
-				} else {
-					responseData.retcode = -201;
-					responseData.message = "Username not found.";
-
-					Grasscutter.getLogger().info(String.format("[Dispatch] Client %s failed to log in: Account no found", t.getRemoteAddress()));
-				} 
-			} else {
-				// Account was found, log the player in
-				responseData.message = "OK";
-				responseData.data.account.uid = account.getId();
-				responseData.data.account.token = account.generateSessionKey();
-				responseData.data.account.email = account.getEmail();
-
-				Grasscutter.getLogger().info(String.format("[Dispatch] Client %s logged in as %s", t.getRemoteAddress(), responseData.data.account.uid));
-			}
-
-			responseJSON(t, responseData);
+			res.send(this.getAuthHandler().handleGameLogin(req, requestData));
 		});
+
 		// Login via token
-		server.createContext("/hk4e_global/mdk/shield/api/verify", t -> {
+		httpServer.post("/hk4e_global/mdk/shield/api/verify", (req, res) -> {
 			// Get post data
 			LoginTokenRequestJson requestData = null;
 			try {
-				String body = Utils.toString(t.getRequestBody());
+				String body = req.ctx().body();
 				requestData = getGsonFactory().fromJson(body, LoginTokenRequestJson.class);
-			} catch (Exception ignored) { }
+			} catch (Exception ignored) {
+			}
 
 			// Create response json
 			if (requestData == null) {
 				return;
 			}
 			LoginResultJson responseData = new LoginResultJson();
-			Grasscutter.getLogger().info(String.format("[Dispatch] Client %s is trying to log in via token", t.getRemoteAddress()));
+			Grasscutter.getLogger().info(translate("messages.dispatch.account.login_token_attempt", req.ip()));
 
 			// Login
 			Account account = DatabaseHelper.getAccountById(requestData.uid);
@@ -290,34 +342,37 @@ public final class DispatchServer {
 			// Test
 			if (account == null || !account.getSessionKey().equals(requestData.token)) {
 				responseData.retcode = -111;
-				responseData.message = "Game account cache information error";
+				responseData.message = translate("messages.dispatch.account.account_cache_error");
 
-				Grasscutter.getLogger().info(String.format("[Dispatch] Client %s failed to log in via token", t.getRemoteAddress()));
+				Grasscutter.getLogger().info(translate("messages.dispatch.account.login_token_error", req.ip()));
 			} else {
 				responseData.message = "OK";
 				responseData.data.account.uid = requestData.uid;
 				responseData.data.account.token = requestData.token;
 				responseData.data.account.email = account.getEmail();
 
-				Grasscutter.getLogger().info(String.format("[Dispatch] Client %s logged in via token as %s", t.getRemoteAddress(), responseData.data.account.uid));
+				Grasscutter.getLogger().info(translate("messages.dispatch.account.login_token_success", req.ip(), requestData.uid));
 			}
 
-			responseJSON(t, responseData);
+			res.send(responseData);
 		});
+
 		// Exchange for combo token
-		server.createContext("/hk4e_global/combo/granter/login/v2/login", t -> {
+		httpServer.post("/hk4e_global/combo/granter/login/v2/login", (req, res) -> {
 			// Get post data
 			ComboTokenReqJson requestData = null;
 			try {
-				String body = Utils.toString(t.getRequestBody());
+				String body = req.ctx().body();
 				requestData = getGsonFactory().fromJson(body, ComboTokenReqJson.class);
-			} catch (Exception ignored) { }
+			} catch (Exception ignored) {
+			}
 
 			// Create response json
 			if (requestData == null || requestData.data == null) {
 				return;
 			}
-			LoginTokenData loginData = getGsonFactory().fromJson(requestData.data, LoginTokenData.class); // Get login data
+			LoginTokenData loginData = getGsonFactory().fromJson(requestData.data, LoginTokenData.class); // Get login
+			// data
 			ComboTokenResJson responseData = new ComboTokenResJson();
 
 			// Login
@@ -326,124 +381,89 @@ public final class DispatchServer {
 			// Test
 			if (account == null || !account.getSessionKey().equals(loginData.token)) {
 				responseData.retcode = -201;
-				responseData.message = "Wrong session key.";
+				responseData.message = translate("messages.dispatch.account.session_key_error");
 
-				Grasscutter.getLogger().info(String.format("[Dispatch] Client %s failed to exchange combo token", t.getRemoteAddress()));
+				Grasscutter.getLogger().info(translate("messages.dispatch.account.combo_token_error", req.ip()));
 			} else {
 				responseData.message = "OK";
 				responseData.data.open_id = loginData.uid;
 				responseData.data.combo_id = "157795300";
 				responseData.data.combo_token = account.generateLoginToken();
 
-				Grasscutter.getLogger().info(String.format("[Dispatch] Client %s succeed to exchange combo token", t.getRemoteAddress()));
+				Grasscutter.getLogger().info(translate("messages.dispatch.account.combo_token_success", req.ip()));
 			}
 
-			responseJSON(t, responseData);
+			res.send(responseData);
 		});
+
+		// TODO: There are some missing route request types here (You can tell if they are missing if they are .all and not anything else)
+		//  When http requests for theses routes are found please remove it from the list in DispatchHttpJsonHandler and update the route request types here
+
 		// Agreement and Protocol
-		server.createContext( // hk4e-sdk-os.hoyoverse.com
-				"/hk4e_global/mdk/agreement/api/getAgreementInfos", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"marketing_agreements\":[]}}")
-		);
-		server.createContext( // hk4e-sdk-os.hoyoverse.com
-				"/hk4e_global/combo/granter/api/compareProtocolVersion", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"modified\":true,\"protocol\":{\"id\":0,\"app_id\":4,\"language\":\"en\",\"user_proto\":\"\",\"priv_proto\":\"\",\"major\":7,\"minimum\":0,\"create_time\":\"0\",\"teenager_proto\":\"\",\"third_proto\":\"\"}}}")
-		);
+		// hk4e-sdk-os.hoyoverse.com
+		httpServer.get("/hk4e_global/mdk/agreement/api/getAgreementInfos", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"marketing_agreements\":[]}}"));
+		// hk4e-sdk-os.hoyoverse.com
+		// this could be either GET or POST based on the observation of different clients
+		httpServer.all("/hk4e_global/combo/granter/api/compareProtocolVersion", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"modified\":true,\"protocol\":{\"id\":0,\"app_id\":4,\"language\":\"en\",\"user_proto\":\"\",\"priv_proto\":\"\",\"major\":7,\"minimum\":0,\"create_time\":\"0\",\"teenager_proto\":\"\",\"third_proto\":\"\"}}}"));
+
 		// Game data
-		server.createContext( // hk4e-api-os.hoyoverse.com
-				"/common/hk4e_global/announcement/api/getAlertPic", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"total\":0,\"list\":[]}}")
-		);
-		server.createContext( // hk4e-api-os.hoyoverse.com
-				"/common/hk4e_global/announcement/api/getAlertAnn",
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"alert\":false,\"alert_id\":0,\"remind\":true}}")
-		);
-		server.createContext( // hk4e-api-os.hoyoverse.com
-				"/common/hk4e_global/announcement/api/getAnnList", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"list\":[],\"total\":0,\"type_list\":[],\"alert\":false,\"alert_id\":0,\"timezone\":0,\"t\":\"" + System.currentTimeMillis() + "\"}}")
-		);
-		server.createContext( // hk4e-api-os-static.hoyoverse.com
-				"/common/hk4e_global/announcement/api/getAnnContent", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"list\":[],\"total\":0}}")
-		);
-		server.createContext( // hk4e-sdk-os.hoyoverse.com
-				"/hk4e_global/mdk/shopwindow/shopwindow/listPriceTier", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"suggest_currency\":\"USD\",\"tiers\":[]}}")
-		);
+		// hk4e-api-os.hoyoverse.com
+		httpServer.all("/common/hk4e_global/announcement/api/getAlertPic", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"total\":0,\"list\":[]}}"));
+		// hk4e-api-os.hoyoverse.com
+		httpServer.all("/common/hk4e_global/announcement/api/getAlertAnn", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"alert\":false,\"alert_id\":0,\"remind\":true}}"));
+		// hk4e-api-os.hoyoverse.com
+		httpServer.all("/common/hk4e_global/announcement/api/getAnnList", new AnnouncementHandler());
+		// hk4e-api-os-static.hoyoverse.com
+		httpServer.all("/common/hk4e_global/announcement/api/getAnnContent", new AnnouncementHandler());
+		// hk4e-sdk-os.hoyoverse.com
+		httpServer.all("/hk4e_global/mdk/shopwindow/shopwindow/listPriceTier", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"suggest_currency\":\"USD\",\"tiers\":[]}}"));
+
 		// Captcha
-		server.createContext( // api-account-os.hoyoverse.com
-				"/account/risky/api/check", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"id\":\"c8820f246a5241ab9973f71df3ddd791\",\"action\":\"\",\"geetest\":{\"challenge\":\"\",\"gt\":\"\",\"new_captcha\":0,\"success\":1}}}")
-		);
+		// api-account-os.hoyoverse.com
+		httpServer.post("/account/risky/api/check", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"id\":\"none\",\"action\":\"ACTION_NONE\",\"geetest\":null}}"));
+
 		// Config
-		server.createContext( // sdk-os-static.hoyoverse.com
-				"/combo/box/api/config/sdk/combo", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"vals\":{\"disable_email_bind_skip\":\"false\",\"email_bind_remind_interval\":\"7\",\"email_bind_remind\":\"true\"}}}")
-		);
-		server.createContext( // hk4e-sdk-os-static.hoyoverse.com
-				"/hk4e_global/combo/granter/api/getConfig", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"protocol\":true,\"qr_enabled\":false,\"log_level\":\"INFO\",\"announce_url\":\"https://webstatic-sea.hoyoverse.com/hk4e/announcement/index.html?sdk_presentation_style=fullscreen\\u0026sdk_screen_transparent=true\\u0026game_biz=hk4e_global\\u0026auth_appid=announcement\\u0026game=hk4e#/\",\"push_alias_type\":2,\"disable_ysdk_guard\":false,\"enable_announce_pic_popup\":true}}")
-		);
-		server.createContext( // hk4e-sdk-os-static.hoyoverse.com
-				"/hk4e_global/mdk/shield/api/loadConfig", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"id\":6,\"game_key\":\"hk4e_global\",\"client\":\"PC\",\"identity\":\"I_IDENTITY\",\"guest\":false,\"ignore_versions\":\"\",\"scene\":\"S_NORMAL\",\"name\":\"原神海外\",\"disable_regist\":false,\"enable_email_captcha\":false,\"thirdparty\":[\"fb\",\"tw\"],\"disable_mmt\":false,\"server_guest\":false,\"thirdparty_ignore\":{\"tw\":\"\",\"fb\":\"\"},\"enable_ps_bind_account\":false,\"thirdparty_login_configs\":{\"tw\":{\"token_type\":\"TK_GAME_TOKEN\",\"game_token_expires_in\":604800},\"fb\":{\"token_type\":\"TK_GAME_TOKEN\",\"game_token_expires_in\":604800}}}}")
-		);
+		// sdk-os-static.hoyoverse.com
+		httpServer.get("/combo/box/api/config/sdk/combo", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"vals\":{\"disable_email_bind_skip\":\"false\",\"email_bind_remind_interval\":\"7\",\"email_bind_remind\":\"true\"}}}"));
+		// hk4e-sdk-os-static.hoyoverse.com
+		httpServer.get("/hk4e_global/combo/granter/api/getConfig", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"protocol\":true,\"qr_enabled\":false,\"log_level\":\"INFO\",\"announce_url\":\"https://webstatic-sea.hoyoverse.com/hk4e/announcement/index.html?sdk_presentation_style=fullscreen\\u0026sdk_screen_transparent=true\\u0026game_biz=hk4e_global\\u0026auth_appid=announcement\\u0026game=hk4e#/\",\"push_alias_type\":2,\"disable_ysdk_guard\":false,\"enable_announce_pic_popup\":true}}"));
+		// hk4e-sdk-os-static.hoyoverse.com
+		httpServer.get("/hk4e_global/mdk/shield/api/loadConfig", new DispatchHttpJsonHandler("{\"retcode\":0,\"message\":\"OK\",\"data\":{\"id\":6,\"game_key\":\"hk4e_global\",\"client\":\"PC\",\"identity\":\"I_IDENTITY\",\"guest\":false,\"ignore_versions\":\"\",\"scene\":\"S_NORMAL\",\"name\":\"原神海外\",\"disable_regist\":false,\"enable_email_captcha\":false,\"thirdparty\":[\"fb\",\"tw\"],\"disable_mmt\":false,\"server_guest\":false,\"thirdparty_ignore\":{\"tw\":\"\",\"fb\":\"\"},\"enable_ps_bind_account\":false,\"thirdparty_login_configs\":{\"tw\":{\"token_type\":\"TK_GAME_TOKEN\",\"game_token_expires_in\":604800},\"fb\":{\"token_type\":\"TK_GAME_TOKEN\",\"game_token_expires_in\":604800}}}}"));
 		// Test api?
-		server.createContext( // abtest-api-data-sg.hoyoverse.com
-				"/data_abtest_api/config/experiment/list", 
-				new DispatchHttpJsonHandler("{\"retcode\":0,\"success\":true,\"message\":\"\",\"data\":[{\"code\":1000,\"type\":2,\"config_id\":\"14\",\"period_id\":\"6036_99\",\"version\":\"1\",\"configs\":{\"cardType\":\"old\"}}]}")
-		);
-		// Log Server 
-		server.createContext( // log-upload-os.mihoyo.com
-				"/log/sdk/upload", 
-				new DispatchHttpJsonHandler("{\"code\":0}")
-		);
-		server.createContext( // log-upload-os.mihoyo.com
-				"/sdk/upload", 
-				new DispatchHttpJsonHandler("{\"code\":0}")
-		);
-		server.createContext( // /perf/config/verify?device_id=xxx&platform=x&name=xxx
-				"/perf/config/verify", 
-				new DispatchHttpJsonHandler("{\"code\":0}")
-		);
+		// abtest-api-data-sg.hoyoverse.com
+		httpServer.post("/data_abtest_api/config/experiment/list", new DispatchHttpJsonHandler("{\"retcode\":0,\"success\":true,\"message\":\"\",\"data\":[{\"code\":1000,\"type\":2,\"config_id\":\"14\",\"period_id\":\"6036_99\",\"version\":\"1\",\"configs\":{\"cardType\":\"old\"}}]}"));
+
+		// log-upload-os.mihoyo.com
+		httpServer.all("/log/sdk/upload", new DispatchHttpJsonHandler("{\"code\":0}"));
+		httpServer.all("/sdk/upload", new DispatchHttpJsonHandler("{\"code\":0}"));
+		httpServer.post("/sdk/dataUpload", new DispatchHttpJsonHandler("{\"code\":0}"));
+		// /perf/config/verify?device_id=xxx&platform=x&name=xxx
+		httpServer.all("/perf/config/verify", new DispatchHttpJsonHandler("{\"code\":0}"));
 
 		// Logging servers
-		server.createContext( // overseauspider.yuanshen.com
-				"/log",
-				new DispatchHttpJsonHandler("{\"code\":0}")
-		);
-
-		server.createContext( // log-upload-os.mihoyo.com
-				"/crash/dataUpload",
-				new DispatchHttpJsonHandler("{\"code\":0}")
-		);
-		server.createContext("/gacha", t -> responseHTML(t, "<!doctype html><html lang=\"en\"><head><title>Gacha</title></head><body></body></html>"));
-
-		// Start server
-		server.start();
-		Grasscutter.getLogger().info("[Dispatch] Dispatch server started on port " + getAddress().getPort());
-	}
-
-	private void responseJSON(HttpExchange t, Object data) throws IOException {
-		// Create a response
-		String response = getGsonFactory().toJson(data);
-		// Set the response header status and length
-		t.getResponseHeaders().put("Content-Type", Collections.singletonList("application/json"));
-		t.sendResponseHeaders(200, response.getBytes().length);
-		// Write the response string
-		OutputStream os = t.getResponseBody();
-		os.write(response.getBytes());
-		os.close();
-	}
-
-	private void responseHTML(HttpExchange t, String response) throws IOException {
-		// Set the response header status and length
-		t.getResponseHeaders().put("Content-Type", Collections.singletonList("text/html; charset=UTF-8"));
-		t.sendResponseHeaders(200, response.getBytes().length);
-		//Write the response string
-		OutputStream os = t.getResponseBody();
-		os.write(response.getBytes());
-		os.close();
+		// overseauspider.yuanshen.com
+		httpServer.all("/log", new ClientLogHandler());
+		// log-upload-os.mihoyo.com
+		httpServer.all("/crash/dataUpload", new ClientLogHandler());
+
+		// webstatic-sea.hoyoverse.com
+		httpServer.get("/admin/mi18n/plat_oversea/m202003048/m202003048-version.json", new DispatchHttpJsonHandler("{\"version\":51}"));
+
+		// gacha record.
+		String gachaMappingsPath = Utils.toFilePath(Grasscutter.getConfig().DATA_FOLDER + "/gacha_mappings.js");
+		// TODO: Only serve the html page and have a subsequent request to fetch the gacha data.
+		httpServer.get("/gacha", new GachaRecordHandler());
+		if(!(new File(gachaMappingsPath).exists())) {
+			Tools.createGachaMapping(gachaMappingsPath);
+		}
+
+		httpServer.raw().config.addSinglePageRoot("/gacha/mappings", gachaMappingsPath, Location.EXTERNAL);
+
+		// static file support for plugins
+		httpServer.raw().config.precompressStaticFiles = false; // If this isn't set to false, files such as images may appear corrupted when serving static files
+
+		httpServer.listen(Grasscutter.getConfig().getDispatchOptions().Port);
+		Grasscutter.getLogger().info(translate("messages.dispatch.port_bind", Integer.toString(httpServer.raw().port())));
 	}
 
 	private Map<String, String> parseQueryString(String qs) {
@@ -465,7 +485,8 @@ public final class DispatchServer {
 					if (eqPos < 0 || eqPos > next) {
 						result.put(URLDecoder.decode(qs.substring(last, next), "utf-8"), "");
 					} else {
-						result.put(URLDecoder.decode(qs.substring(last, eqPos), "utf-8"), URLDecoder.decode(qs.substring(eqPos + 1, next), "utf-8"));
+						result.put(URLDecoder.decode(qs.substring(last, eqPos), "utf-8"),
+								URLDecoder.decode(qs.substring(eqPos + 1, next), "utf-8"));
 					}
 				} catch (UnsupportedEncodingException e) {
 					throw new RuntimeException(e); // will never happen, utf-8 support is mandatory for java
@@ -476,8 +497,28 @@ public final class DispatchServer {
 		return result;
 	}
 
-	public static class RegionData {
+	public AuthenticationHandler getAuthHandler() {
+		if(authHandler == null) {
+			return new DefaultAuthenticationHandler();
+		}
+		return authHandler;
+	}
 
+	public boolean registerAuthHandler(AuthenticationHandler authHandler) {
+		if(this.authHandler != null) {
+			Grasscutter.getLogger().error(String.format("[Dispatch] Unable to register '%s' authentication handler. \n" +
+					"The '%s' authentication handler has already been registered", authHandler.getClass().getName(), this.authHandler.getClass().getName()));
+			return false;
+		}
+		this.authHandler = authHandler;
+		return true;
+	}
+
+	public void resetAuthHandler() {
+		this.authHandler = null;
+	}
+
+	public static class RegionData {
 		QueryCurrRegionHttpRsp parsedRegionQuery;
 		String Base64;
 
@@ -485,5 +526,13 @@ public final class DispatchServer {
 			this.parsedRegionQuery = prq;
 			this.Base64 = b64;
 		}
+
+		public QueryCurrRegionHttpRsp getParsedRegionQuery() {
+			return parsedRegionQuery;
+		}
+
+		public String getBase64() {
+			return Base64;
+		}
 	}
 }

src/main/java/emu/grasscutter/server/dispatch/authentication/AuthenticationHandler.java

+package emu.grasscutter.server.dispatch.authentication;
+
+import emu.grasscutter.server.dispatch.json.LoginAccountRequestJson;
+import emu.grasscutter.server.dispatch.json.LoginResultJson;
+import express.http.Request;
+import express.http.Response;
+
+public interface AuthenticationHandler {
+
+    // This is in case plugins also want some sort of authentication
+    void handleLogin(Request req, Response res);
+    void handleRegister(Request req, Response res);
+    void handleChangePassword(Request req, Response res);
+
+    LoginResultJson handleGameLogin(Request req, LoginAccountRequestJson requestData);
+}

src/main/java/emu/grasscutter/server/dispatch/authentication/DefaultAuthenticationHandler.java

+package emu.grasscutter.server.dispatch.authentication;
+
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.database.DatabaseHelper;
+import emu.grasscutter.game.Account;
+import emu.grasscutter.server.dispatch.json.LoginAccountRequestJson;
+import emu.grasscutter.server.dispatch.json.LoginResultJson;
+import express.http.Request;
+import express.http.Response;
+
+import static emu.grasscutter.utils.Language.translate;
+
+public class DefaultAuthenticationHandler implements AuthenticationHandler {
+
+    @Override
+    public void handleLogin(Request req, Response res) {
+        res.send("Authentication is not available with the default authentication method");
+    }
+
+    @Override
+    public void handleRegister(Request req, Response res) {
+        res.send("Authentication is not available with the default authentication method");
+    }
+
+    @Override
+    public void handleChangePassword(Request req, Response res) {
+        res.send("Authentication is not available with the default authentication method");
+    }
+
+    @Override
+    public LoginResultJson handleGameLogin(Request req, LoginAccountRequestJson requestData) {
+        LoginResultJson responseData = new LoginResultJson();
+
+        // Login
+        Account account = DatabaseHelper.getAccountByName(requestData.account);
+
+        // Check if account exists, else create a new one.
+        if (account == null) {
+            // Account doesn't exist, so we can either auto create it if the config value is set.
+            if (Grasscutter.getConfig().getDispatchOptions().AutomaticallyCreateAccounts) {
+                // This account has been created AUTOMATICALLY. There will be no permissions added.
+                account = DatabaseHelper.createAccountWithId(requestData.account, 0);
+
+                for (String permission : Grasscutter.getConfig().getDispatchOptions().defaultPermissions) {
+                    account.addPermission(permission);
+                }
+
+                if (account != null) {
+                    responseData.message = "OK";
+                    responseData.data.account.uid = account.getId();
+                    responseData.data.account.token = account.generateSessionKey();
+                    responseData.data.account.email = account.getEmail();
+
+                    Grasscutter.getLogger().info(translate("messages.dispatch.account.account_login_create_success", req.ip(), responseData.data.account.uid));
+                } else {
+                    responseData.retcode = -201;
+                    responseData.message = translate("messages.dispatch.account.username_create_error");
+
+                    Grasscutter.getLogger().info(translate("messages.dispatch.account.account_login_create_error", req.ip()));
+                }
+            } else {
+                responseData.retcode = -201;
+                responseData.message = translate("messages.dispatch.account.username_error");
+
+                Grasscutter.getLogger().info(translate("messages.dispatch.account.account_login_exist_error", req.ip()));
+            }
+        } else {
+            // Account was found, log the player in
+            responseData.message = "OK";
+            responseData.data.account.uid = account.getId();
+            responseData.data.account.token = account.generateSessionKey();
+            responseData.data.account.email = account.getEmail();
+
+            Grasscutter.getLogger().info(translate("messages.dispatch.account.login_success", req.ip(), responseData.data.account.uid));
+        }
+
+        return responseData;
+    }
+}

src/main/java/emu/grasscutter/server/dispatch/http/GachaRecordHandler.java

+package emu.grasscutter.server.dispatch.http;
+
+import java.io.File;
+import java.io.IOException;
+
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.database.DatabaseHelper;
+import emu.grasscutter.game.Account;
+import emu.grasscutter.utils.FileUtils;
+import emu.grasscutter.utils.Utils;
+import express.http.HttpContextHandler;
+import express.http.Request;
+import express.http.Response;
+
+public final class GachaRecordHandler implements HttpContextHandler {
+	String render_template;
+	public GachaRecordHandler() {
+		File template = new File(Utils.toFilePath(Grasscutter.getConfig().DATA_FOLDER + "/gacha_records.html"));
+		if (template.exists()) {
+			// Load from cache
+			render_template = new String(FileUtils.read(template));
+		} else {
+			render_template = "{{REPLACE_RECORD}}";
+		}
+	}
+
+	@Override
+	public void handle(Request req, Response res) throws IOException {
+		// Grasscutter.getLogger().info( req.query().toString() );
+		String sessionKey = req.query("s");
+		int page = 0;
+		int gachaType = 0;
+		if (req.query("p") != null) {
+			page = Integer.valueOf(req.query("p"));
+		}
+
+		if (req.query("gachaType") != null) {
+			gachaType = Integer.valueOf(req.query("gachaType"));
+		}
+
+		Account account = DatabaseHelper.getAccountBySessionKey(sessionKey);
+		if (account != null) {
+			String records = DatabaseHelper.getGachaRecords(account.getPlayerUid(), page, gachaType).toString();
+			// Grasscutter.getLogger().info(records);
+			String response = render_template.replace("{{REPLACE_RECORD}}", records)
+							.replace("{{REPLACE_MAXPAGE}}", String.valueOf(DatabaseHelper.getGachaRecordsMaxPage(account.getPlayerUid(), page, gachaType)));
+
+			res.send(response);
+		} else {
+			res.send("No account found.");
+		}
+	}
+}

src/main/java/emu/grasscutter/server/dispatch/json/LoginResultJson.java

@@ -16,7 +16,7 @@ public class LoginResultJson {
 	public static class VerifyAccountData {
 		public String uid;
 		public String name = "";
-		public String email;
+		public String email = "";
 		public String mobile = "";
 		public String is_email_verify = "0";
 		public String realname = "";

src/main/java/emu/grasscutter/server/event/Cancellable.java

+package emu.grasscutter.server.event;
+
+/**
+ * Implementing this interface marks an event as cancellable.
+ */
+public interface Cancellable {
+    void cancel();
+}

src/main/java/emu/grasscutter/server/event/Event.java

+package emu.grasscutter.server.event;
+
+import emu.grasscutter.Grasscutter;
+
+/**
+ * A generic server event.
+ */
+public abstract class Event {
+    private boolean cancelled = false;
+
+    /**
+     * Return the cancelled state of the event.
+     */
+    public boolean isCanceled() {
+        return this.cancelled;
+    }
+
+    /**
+     * Cancels the event if possible.
+     */
+    public void cancel() {
+        if(this instanceof Cancellable)
+            this.cancelled = true;
+    }
+
+    /**
+     * Pushes this event to all listeners.
+     */
+    public void call() {
+        Grasscutter.getPluginManager().invokeEvent(this);
+    }
+}

src/main/java/emu/grasscutter/server/event/EventHandler.java

+package emu.grasscutter.server.event;
+
+import emu.grasscutter.Grasscutter;
+import emu.grasscutter.utils.EventConsumer;
+
+public final class EventHandler<T extends Event> {
+    private final Class<T> eventClass;
+    private EventConsumer<T> listener;
+    private HandlerPriority priority;
+    private boolean handleCanceled;
+    
+    public EventHandler(Class<T> eventClass) {
+        this.eventClass = eventClass;
+    }
+
+    /**
+     * Gets which event this handler is handling.
+     * @return An event class.
+     */
+    public Class<T> handles() {
+        return this.eventClass;
+    }
+
+    /**
+     * Returns the callback for the handler.
+     * @return A consumer callback.
+     */
+    public EventConsumer<T> getCallback() {
+        return this.listener;
+    }
+
+    /**
+     * Returns the handler's priority.
+     * @return The priority of the handler.
+     */
+    public HandlerPriority getPriority() {
+        return this.priority;
+    }
+
+    /**
+     * Returns if the handler will ignore cancelled events.
+     * @return The ignore cancelled state.
+     */
+    public boolean ignoresCanceled() {
+        return this.handleCanceled;
+    }
+
+    /**
+     * Sets the callback method for when the event is invoked.
+     * @param listener An event handler method.
+     * @return Method chaining.
+     */
+    public EventHandler<T> listener(EventConsumer<T> listener) {
+        this.listener = listener; return this;
+    }
+
+    /**
+     * Changes the handler's priority in handling events.
+     * @param priority The priority of the handler.
+     * @return Method chaining.
+     */
+    public EventHandler<T> priority(HandlerPriority priority) {
+        this.priority = priority; return this;
+    }
+
+    /**
+     * Sets if the handler will ignore cancelled events.
+     * @param ignore If the handler should ignore cancelled events.
+     * @return Method chaining.
+     */
+    public EventHandler<T> ignore(boolean ignore) {
+        this.handleCanceled = ignore; return this;
+    }
+
+    /**
+     * Registers the handler into the PluginManager.
+     */
+    public void register() {
+        Grasscutter.getPluginManager().registerListener(this);
+    }
+}
\ No newline at end of file

src/main/java/emu/grasscutter/server/event/HandlerPriority.java

+package emu.grasscutter.server.event;
+
+public enum HandlerPriority {
+    /**
+     * The handler will be called before every other handler.
+     */
+    HIGH,
+
+    /**
+     * The handler will be called the same time as other handlers.
+     */
+    NORMAL,
+
+    /**
+     * The handler will be called after every other handler.
+     */
+    LOW
+}

src/main/java/emu/grasscutter/server/event/dispatch/QueryAllRegionsEvent.java

+package emu.grasscutter.server.event.dispatch;
+
+import emu.grasscutter.server.event.types.ServerEvent;
+
+public final class QueryAllRegionsEvent extends ServerEvent {
+    private String regionList;
+    
+    public QueryAllRegionsEvent(String regionList) {
+        super(Type.DISPATCH);
+        
+        this.regionList = regionList;
+    }
+    
+    public void setRegionList(String regionList) {
+        this.regionList = regionList;
+    }
+    
+    public String getRegionList() {
+        return this.regionList;
+    }
+}

src/main/java/emu/grasscutter/server/event/dispatch/QueryCurrentRegionEvent.java

+package emu.grasscutter.server.event.dispatch;
+
+import emu.grasscutter.server.event.types.ServerEvent;
+
+public final class QueryCurrentRegionEvent extends ServerEvent {
+    private String regionInfo;
+
+    public QueryCurrentRegionEvent(String regionInfo) {
+        super(Type.DISPATCH);
+
+        this.regionInfo = regionInfo;
+    }
+
+    public void setRegionInfo(String regionInfo) {
+        this.regionInfo = regionInfo;
+    }
+
+    public String getRegionInfo() {
+        return this.regionInfo;
+    }
+}

src/main/java/emu/grasscutter/server/event/game/PlayerCreationEvent.java

+package emu.grasscutter.server.event.game;
+
+import emu.grasscutter.game.player.Player;
+import emu.grasscutter.server.event.types.GameEvent;
+import emu.grasscutter.server.game.GameSession;
+
+public final class PlayerCreationEvent extends GameEvent {
+    private final GameSession session;
+    private Class<? extends Player> playerClass;
+    
+    public PlayerCreationEvent(GameSession session, Class<? extends Player> playerClass) {
+        this.session = session;
+        this.playerClass = playerClass;
+    }
+    
+    public GameSession getSession() {
+        return this.session;
+    }
+    
+    public void setPlayerClass(Class<? extends Player> playerClass) {
+        this.playerClass = playerClass;
+    }
+    
+    public Class<? extends Player> getPlayerClass() {
+        return this.playerClass;
+    }
+}

src/main/java/emu/grasscutter/server/event/game/ReceivePacketEvent.java

+package emu.grasscutter.server.event.game;
+
+import emu.grasscutter.server.event.Cancellable;
+import emu.grasscutter.server.event.types.ServerEvent;
+import emu.grasscutter.server.game.GameSession;
+
+public final class ReceivePacketEvent extends ServerEvent implements Cancellable {
+    private final GameSession gameSession;
+    private final int packetId;
+    private byte[] packetData;
+    
+    public ReceivePacketEvent(GameSession gameSession, int packetId, byte[] packetData) {
+        super(Type.GAME);
+        
+        this.gameSession = gameSession;
+        this.packetId = packetId;
+        this.packetData = packetData;
+    }
+    
+    public GameSession getGameSession() {
+        return this.gameSession;
+    }
+    
+    public int getPacketId() {
+        return this.packetId;
+    }
+    
+    public void setPacketData(byte[] packetData) {
+        this.packetData = packetData;
+    }
+    
+    public byte[] getPacketData() {
+        return this.packetData;
+    }
+}

src/main/java/emu/grasscutter/server/event/game/SendPacketEvent.java

+package emu.grasscutter.server.event.game;
+
+import emu.grasscutter.net.packet.BasePacket;
+import emu.grasscutter.server.event.Cancellable;
+import emu.grasscutter.server.event.types.ServerEvent;
+import emu.grasscutter.server.game.GameSession;
+
+public final class SendPacketEvent extends ServerEvent implements Cancellable {
+    private final GameSession gameSession;
+    private BasePacket packet;
+
+    public SendPacketEvent(GameSession gameSession, BasePacket packet) {
+        super(Type.GAME);
+
+        this.gameSession = gameSession;
+        this.packet = packet;
+    }
+
+    public GameSession getGameSession() {
+        return this.gameSession;
+    }
+
+    public void setPacket(BasePacket packet) {
+        this.packet = packet;
+    }
+
+    public BasePacket getPacket() {
+        return this.packet;
+    }
+}

src/main/java/emu/grasscutter/server/event/game/ServerTickEvent.java

+package emu.grasscutter.server.event.game;
+
+import emu.grasscutter.server.event.types.ServerEvent;
+
+public final class ServerTickEvent extends ServerEvent {
+    public ServerTickEvent() {
+        super(Type.GAME);
+    }
+}

src/main/java/emu/grasscutter/server/event/internal/ServerStartEvent.java

+package emu.grasscutter.server.event.internal;
+
+import emu.grasscutter.server.event.types.ServerEvent;
+
+import java.time.OffsetDateTime;
+
+public final class ServerStartEvent extends ServerEvent {
+    private final OffsetDateTime startTime;
+    
+    public ServerStartEvent(Type type, OffsetDateTime startTime) {
+        super(type);
+        
+        this.startTime = startTime;
+    }
+    
+    public OffsetDateTime getStartTime() {
+        return this.startTime;
+    }
+}

src/main/java/emu/grasscutter/server/event/internal/ServerStopEvent.java

+package emu.grasscutter.server.event.internal;
+
+import emu.grasscutter.server.event.types.ServerEvent;
+
+import java.time.OffsetDateTime;
+
+public final class ServerStopEvent extends ServerEvent {
+    private final OffsetDateTime stopTime;
+
+    public ServerStopEvent(Type type, OffsetDateTime stopTime) {
+        super(type);
+
+        this.stopTime = stopTime;
+    }
+
+    public OffsetDateTime getStopTime() {
+        return this.stopTime;
+    }
+}

src/main/java/emu/grasscutter/server/event/player/PlayerJoinEvent.java

+package emu.grasscutter.server.event.player;
+
+import emu.grasscutter.game.player.Player;
+import emu.grasscutter.server.event.Cancellable;
+import emu.grasscutter.server.event.types.PlayerEvent;
+
+public final class PlayerJoinEvent extends PlayerEvent implements Cancellable {
+    public PlayerJoinEvent(Player player) {
+        super(player);
+    }
+}