欢迎界面

欢迎界面

一个Hytale服务器插件，可在玩家连接时自动显示一个可自定义的欢迎图形用户界面，其中包含服务器规则、命令和Discord链接。

实用

欢迎界面预览查看大图

Hytale Welcome GUI (English Version)

该项目是一个Hytale服务器插件，可在玩家加入服务器时自动显示一个自定义欢迎GUI。

当前为Tale Brasil服务器配置，显示规则、实用命令和交互按钮。

📋 功能

  • 自动打开： 玩家加入世界2秒后GUI自动打开。

  • 视觉信息： 显示欢迎文本、规则列表和基本命令（例如 /help、/ping）。

  • 交互性：

  • DISCORD 按钮：在聊天中发送一条可点击的消息，包含Discord邀请链接。

  • ENTENDI（已理解）按钮：关闭窗口。

  • 命令： 通过命令手动访问屏幕（默认：/modlist）。

🛠 如何修改欢迎屏幕

自定义分为两部分：视觉（文本/布局）和逻辑（按钮/链接）。

1. 更改文本和布局（视觉）

要更改显示的文本（规则、标题、命令），您必须编辑 .ui 界面文件。

  • 文件： src/main/resources/Common/UI/Custom/Pages/WelcomeGUI.ui

在此文件中，修改 Label 组件中的 Text 字段。 示例：

Label #WelcomeText {
    Style: (FontSize: 20, TextColor: #ffcc00, RenderBold: true);
    Text: "您的新标题在此！"; // <--- 更改此项
}

2. 更改链接和按钮行为（逻辑）

要更改Discord链接或按钮操作，您必须编辑Java类。

  • 文件： src/main/java/com/talebrasil/hy/wellcomegui/gui/WelcomePage.java

查找 handleDataEvent 方法。您可以在其中找到 #DiscordButton 的逻辑。 示例：

// Discord 按钮逻辑
if (data.discordClicked != null) {
    FormattedMessage msg = new FormattedMessage();
    // 更改以下消息和链接
    msg.rawText = "[Discord] 点击此处：[https://discord.gg/YOUR_NEW_LINK](https://discord.gg/YOUR_NEW_LINK)";
    msg.link = "[https://discord.gg/YOUR_NEW_LINK](https://discord.gg/YOUR_NEW_LINK)"; 
    player.sendMessage(new Message(msg));
}

3. 更改命令

默认情况下，在 WellcomeCommand.java 中注册的命令是 /modlist。要将其更改为 /rules 或 /welcome：

  • 文件： src/main/java/com/talebrasil/hy/wellcomegui/command/WellcomeCommand.java
  • 编辑： 将 super("modlist", "Shows the wellcome screen"); 改为您想要的命令名称。

🚀 如何构建

确保您已配置JDK（项目在 gradle.properties 中设置为Java 25，请根据您的环境进行调整）。

# Windows
gradlew.bat build

# Linux/Mac
./gradlew build

输出的 .jar 文件将位于 build/libs 文件夹中。

Hytale Welcome GUI (Tale Brasil)

该项目是一个用于Hytale服务器的插件（基于Hytale引擎），当玩家进入服务器时，会自动显示一个图形用户界面（GUI）欢迎界面。

当前为 Tale Brasil 服务器配置，显示规则、有用的命令和交互按钮。

📋 功能

  • 自动打开： 窗口在玩家连接到世界后2秒打开。
  • 视觉信息： 显示欢迎文本、规则列表和基本命令（/help、/ping 等）。
  • 交互性：
    • DISCORD 按钮：在聊天中发送一条可点击的消息，包含Discord链接。
    • ENTENDI（已理解）按钮：关闭窗口。
  • 命令： 通过配置的命令（默认：/modlist）手动访问屏幕。

🛠 如何修改欢迎屏幕

自定义分为两部分：视觉（文本/布局）和逻辑（按钮/链接）。

1. 更改文本和布局（视觉）

要更改屏幕上显示的内容（规则、标题、命令），您必须编辑 .ui 界面文件。

  • 文件： src/main/resources/Common/UI/Custom/Pages/WelcomeGUI.ui

在此文件中，您可以更改 Label 组件中的 Text 字段。 示例：

Label #WelcomeText {
    Style: (FontSize: 20, TextColor: #ffcc00, RenderBold: true);
    Text: "您的新标题在此！"; // <--- 在此更改
}

2. 更改链接和按钮行为（逻辑）

要更改Discord链接或点击按钮时发生的事件，您必须编辑Java类。

  • 文件： src/main/java/com/talebrasil/hy/wellcomegui/gui/WelcomePage.java

查找 handleDataEvent 方法。您可以在其中找到 #DiscordButton 按钮的逻辑。 示例：

// Discord 按钮逻辑
if (data.discordClicked != null) {
    FormattedMessage msg = new FormattedMessage();
    // 更改以下消息和链接
    msg.rawText = "[Discord] 点击此处：[https://discord.gg/SEU_NOVO_LINK](https://discord.gg/SEU_NOVO_LINK)";
    msg.link = "[https://discord.gg/SEU_NOVO_LINK](https://discord.gg/SEU_NOVO_LINK)"; 
    player.sendMessage(new Message(msg));
}

3. 更改命令

默认情况下，在 WellcomeCommand.java 文件中注册的命令是 /modlist。要将其更改为 /regras 或 /welcome：

  • 文件： src/main/java/com/talebrasil/hy/wellcomegui/command/WellcomeCommand.java
  • 编辑： 将 super("modlist", "Shows the wellcome screen"); 改为所需的名称。

🚀 如何编译

确保您已配置JDK（项目在 gradle.properties 中定义为Java 25，请根据您的环境进行调整）。

# Windows
gradlew.bat build

# Linux/Mac
./gradlew build

生成的 .jar 文件将位于 build/libs 文件夹中。