Game Opening For You

Game Opening For You

概述

专为你的整合包打造的游戏开场。

功能

使用这个模组，你可以为整合包自定义游戏开场欢迎消息：

1. 为欢迎消息设置时间限制。在此期间，除欢迎消息外的其他消息都会被屏蔽，让聊天框保持整洁，直到预设时间结束。

2. 不过别担心！这些消息并没有丢失，而是会在日志中以特殊标记 Game Opening For You - Missed Message Collector 记录下来，如下所示：

   [21:36:23] [Client thread/INFO] [Game Opening For You - Missed Message Collector]: Missed Message: Some message.
   

   如果需要，你可以轻松找到它们。

3. 本程序内置了几种特殊条件。当玩家满足这些条件时，游戏会向他们发送一条特殊消息！

   条件列在配置文件中（另请参阅：配置）。目前包括：

   1. hardcore_opening：玩家是否开启了极限模式。
   2. night_opening：当前时间是否晚于日落时间且早于白天开始时间。这些时间点都可以配置。
   3. late_opening：当前时间是否晚于深夜开始时间且早于白天开始时间。此条件会覆盖night_opening条件，并替换其对应的消息。这些时间点都可以配置。
   4. april_fools_day_opening：当天是否为愚人节。
   5. halloween_opening：当天是否为万圣节。
   6. spring_festival_opening：当天是否为中国春节。

   你可以轻松移除或注释掉不需要的条件，避免它们触发。

4. 每个条件都对应一个语言条目

   game_opening_for_you.<condition_name>.text
   

   因此，你只需修改 .lang 文件，即可本地化欢迎消息。我们已在模组中附带了默认的 en_us.lang，供你参考。

   此外，建议使用资源加载模组，例如 Resource Loader 或 Open Loader。

5. 我们让自定义欢迎消息变得非常简单！只需使用下方的占位符，并将它们直接写入 .lang 文件。程序会自动将占位符替换为你填写的文本。

   `player` -> Player's Name
   
   `hour`   -> Current time hours
   `min`    -> Current time minutes, will be formatted into 2 digits (8 -> 08 for example)
   `sec`    -> Current time seconds, will be formatted into 2 digits (8 -> 08 for example)
   
   `year`   -> Current date years 
   `month`  -> Current date months, will be formatted into 2 digits (8 -> 08 for example)
   `day`    -> Current date days, will be formatted into 2 digits (8 -> 08 for example)
   
   `br`     -> Break lines, just like press Enter key here 
   

配置

配置文件附有完整说明。

配置起来快捷又简单：

# 配置文件

general {
    # 显示调试日志。用于调试。
    B:DEBUG=true

    # 你认为白天开始的时间，使用 24 小时制。默认值为 8:00。
    I:daytimeBeginningHour=8

    # 你认为白天开始的时间，使用 24 小时制。默认值为 8:00。
    I:daytimeBeginningMinute=0

    # 你认为白天结束的时间，使用 24 小时制。默认值为 18:30。
    I:daytimeEndHour=18

    # 你认为白天结束的时间，使用 24 小时制。默认值为 18:30。
    I:daytimeEndMinute=30

    # 每一行对应一条开场问候语。
    # 你可以删除不需要的行，或在行首添加 # 将其注释掉，
    # 这样就不会发送对应行的开场问候语。
    S:gameOpeningMessageList <
        hardcore_opening
        night_opening
        late_opening
        april_fools_day_opening
        halloween_opening
        spring_festival_opening
     >

    # 游戏开场问候语的显示时长。
    # 在此期间，除游戏开场问候语外的聊天消息都将被拒绝并保存到日志中。
    # 你可以根据需要自行调整此值，
    # 以决定要屏蔽的消息数量，
    # 并兼顾玩家在游戏中发送消息时的体验。
    I:gameOpeningMilliseconds=1000

    # 是否将日期补齐为两位数。
    B:hourFixDigits=false

    # 你认为深夜开始的时间，使用 24 小时制。默认值为 23:30。
    I:lateNightBeginningHour=23

    # 你认为深夜开始的时间，使用 24 小时制。默认值为 23:30。
    I:lateNightBeginningMinute=30

    # 是否将分钟补齐为两位数。
    B:minuteFixDigits=true

    # 是否将月份补齐为两位数。
    B:monthFixDigits=false

    # 是否将小时补齐为两位数。
    B:secondFixDigits=true
}

许可证

本项目将沿用其依赖项 dromara/hutool 的许可证。

致谢

项目徽标中使用的文字艺术由以下工具制作：

字体生成器，由 https://www.textstudio.com/ 提供支持

谨以此献给助我入眠的魔法师——我最爱的 ASMR 创作者 Youtube@LatteASMR。