Foggy Pale Garden - 雾白花园

⚠️ 本模组的后续开发将以基于 Polytone 的 Foggy Pale Garden 资源包 形式继续。

一个为苍白花园生物群系添加雾气的 Minecraft 模组。但你可以在任何你喜欢的地方自定义任何类型的雾气！

✨ 功能特性

😱 用雾气笼罩苍白花园

🕳️ 雾气不会填充苍白花园下方的洞穴

🪽 雾气不会妨碍飞越苍白花园

🎨 雾气预设功能允许你从预定义选项中选择、创建自定义预设，或让雾气根据游戏难度进行调整。

📦 资源包支持

你可以轻松地将雾气预设添加到你的资源包中！只需将其放置在路径 assets/foggypalegarden/preset.json 处。之后，你就可以在模组设置中选择它作为激活的雾气预设。

• 如果安装了多个包含雾气的资源包，它们各自的预设都将在设置中可用
• 如果 config/foggypalegarden 文件夹中的预设 code 与资源包中的 code 匹配，则配置文件夹中的预设将通过在其代码后添加 _BACKUP 来重命名

🧗‍♀️ 雾气形成的条件将允许在同一位置创建不同类型的雾气

你可以在 GitHub 上下载此示例

🔧 基于任意条件集创建不同类型的雾气

例如，此预设将在所有生物群系中晴朗天气时创建黎明前的雾气。

{
  "code": "PRE_DAWN_FOG",
  "bindings": [
    {
      "condition": {
        "and": [
          { "timeIn": { "start": 22500, "end": 23800 } },
          { "weatherIn": ["CLEAR"] }
        ]
      },
      "startDistance": 0.0,
      "skyLightStartLevel": 4,
      "endDistance": 15.0,
      "surfaceHeightEnd": 15.0,
      "opacity": 50.0,
      "encapsulationSpeed": 16.0,
      "brightness": {
        "mode": "BY_GAME_FOG"
      },
      "color": {
        "mode": "BY_GAME_FOG"
      }
    }
  ],
  "version": 2
}

要应用它，请在 config/foggypalegarden 文件夹中创建一个名为 PREDAWNFOG.json 的文件，内容如上，并在 config/foggypalegarden.json 中设置值 "preset": "PREDAWNFOG"。

在 [🛠️ 配置](#-配置) 部分阅读更多关于可用功能的信息。

👁️ 在可视化菜单中调整设置

💬 即使你不是管理员，也可以通过聊天更改设置！

可用命令：

• /fpg preset 将显示当前预设的名称
• /fpg preset FPGDIFFICULTYBASED 将预设切换到 FPGDIFFICULTYBASED（命令本身会建议可用预设列表）
• /fpg reloadConfig 重新从磁盘读取模组配置和可用的雾气预设文件

🌎 模组支持多种语言

支持的语言：

• 🇸🇦 阿拉伯语
• 🇧🇾 白俄罗斯语
• 🇨🇳 中文（简体）
• 🇺🇸 英语（美国）
• 🇫🇷 法语
• 🇬🇪 格鲁吉亚语
• 🇩🇪 德语
• 🇮🇹 意大利语
• 🇯🇵 日语
• 🇰🇿 哈萨克语
• 🇰🇷 韩语
• 🇧🇷 葡萄牙语（巴西）
• 🇷🇺 俄语
• 🇪🇸 西班牙语（墨西哥）
• 🇸🇪 瑞典语
• 🇺🇦 乌克兰语

你可以在 GitHub 上请求翻译成你的语言或报告翻译错误。

⛔️ 为特定游戏模式禁用雾气

在配置 config/foggypalegarden.json 中，设置了值 "noFogGameModes": ["SPECTATOR"]。

⏮️ 支持所有将苍白花园生物群系移植到旧游戏版本的模组

雾气会出现在任何名为 pale_garden 的生物群系中。

已测试的模组：

• Pale Garden Backport: The Garden Awakens
• EarlyUpdate: Pale Garden
• The Pale Garden
• Winter drop backport-Pale garden
• I want it earlier 1.21.4 (Pale Garden)
• Pale Garden and Creaking
• Pale Garden - Update
• DenizTK's Pale & Lively Update
• Bundles of Bravery (1.22)

📥 安装

• 为你的游戏版本安装 Fabric、Quilt、NeoForge 或 Forge
• Fabric 和 Quilt 需要安装 Fabric API！
• 安装 Cloth Config 以通过模组菜单更改设置
• 将模组放入 mods 文件夹
• 小心雾气中的怪物！

🛠️ 配置

雾气参数

• 雾气开始的距离
• 雾气结束的距离
• 雾气密度
• 雾气亮度
• 雾气颜色
• 进入或离开雾气时的消散速度
• 雾气形状（可用选项：SPHERE 和 CYLINDER）

雾气条件

得益于 AND、OR 和 NOT 条件，它们可以以任何组合使用

• 玩家所在的维度
• 玩家所在的生物群系
• 生物群系温度
• 天气
• 一天中的时间
• 世界难度等级
• 天空亮度（允许检测玩家是否在洞穴中）
• 玩家距离地表的高度
• 玩家在 Y 轴上的位置

完整配置

可用的配置选项

配置文件位于 config/foggypalegarden.json，允许你设置一个可用的雾气预设。

{
    // 激活的雾气预设
    "preset": "MY_PRESET",

    // (可选) 禁用雾气的游戏模式列表 ("SURVIVAL", "CREATIVE", "ADVENTURE", "SPECTATOR")
    "noFogGameModes": [""],
    
    // 配置架构版本（不要更改此值）
    "version": 3
}

预设文件位于 config/foggypalegarden 目录。每个文件包含游戏的完整雾气设置。

{
        
    // 预设代码（你需要在 config/foggypalegarden.json 中指定此值以应用预设）
    "code": "MY_PRESET",
    
    // 一组绑定，每个负责你配置的雾气外观，并根据指定条件应用
    "bindings": [
        
        {
            
            // 应用此绑定的条件
            // 具有树状结构（你可以在 and、or、not 内部放置其他条件）
            // 一个条件中只能同时填充一个字段
            // 正确示例 - { "and": [{ "biomeIdIn": ["minecraft:desert"] }, { "difficultyIn": ["HARD"] }] }
            // 错误示例 - { "biomeIdIn": ["minecraft:desert"], "difficultyIn": ["HARD"] }
            "condition": {

                // (可选) 应用此绑定的维度列表（例如，"minecraft:overworld"）
                // 你可以使用带星号 * 的通配符，例如 "minecraft:*" 将包括所有原版游戏维度，不包括模组维度
                "dimensionIn": [""],

                // (可选) 应用此绑定的生物群系列表（例如，"minecraft:desert"）
                // 你可以使用带星号 * 的通配符，例如 "minecraft:*" 将包括所有原版游戏生物群系，不包括模组生物群系
                "biomeIdIn": [""],
              
                // (可选) 应用此绑定的生物群系温度范围
                "biomeTemperature": {
                  
                  // (可选) 最低温度（包含）
                  "min": 0.0,
                  
                  // (可选) 最高温度（不包含）
                  "max": 0.0
                },
                
                // (可选) 应用此绑定的难度等级列表 ("PEACEFUL", "EASY", "NORMAL", "HARD")
                "difficultyIn": [""],
                
                // (可选) 应用此绑定的天气条件列表 ("CLEAR", "RAIN", "THUNDER")
                "weatherIn": [""],
                
                // (可选) 应用此绑定的时间范围（开始时间可以大于结束时间）
                "timeIn": { "start": 0, "end": 0 },
              
                // (可选) 天空光照等级 [0, 15]
                "skyLightLevel": { "min": 0, "max": 0 },

                // (可选) 玩家在 Y 轴上的位置
                "height": { "min": 0.0, "max": 0.0 },

                // (可选) 玩家距离地表的高度（不能为负数）
                "surfaceHeight": { "min": 0.0, "max": 0.0 },
                
                // (可选) 必须全部满足才能应用此绑定的条件组
                "and": [{}],
                // (可选) 至少满足一个条件即可应用此绑定的条件列表
                "or": [{}],
                
                // (可选) 必须不满足才能应用此绑定的条件
                "not": {}
            },
            
            // (可选) 雾气开始的距离（以方块为单位，不能为负数）
            "startDistance": 0.0,

            // (可选) 雾气结束的距离（以方块为单位，不能为负数）
            "endDistance": 0.0,

            // (可选) 雾气密度百分比 (0.0, 100.0]
            // 此参数在快照 24w40a 之前的 Minecraft 版本上不起作用
          "opacity": 0.0,
            
            // (可选) 进入或离开雾气时的扩散速度（以方块/秒为单位，不能小于或等于 0）
            "encapsulationSpeed": 0.0,
            
            // (可选) 雾气亮度设置
            "brightness": {
            
                // 雾气亮度计算模式
                // BY_GAME_FOG - 亮度基于游戏内雾气亮度计算
                // FIXED - 手动设置亮度
                "mode": "FIXED",
                
                // (FIXED 模式必需) 雾气亮度等级百分比 (0.0, 100.0]
                "fixedBrightness": 0.0,
              
                // (BY_GAME_FOG 模式可选) 亮度调整 [-1.0, 1.0]
                "adjustment": 0.0
            },
            
            // (可选) 雾气颜色设置
            "color": {
            
                // 雾气颜色计算模式
                // BY_GAME_FOG - 使用游戏内雾气颜色
                // FIXED - 手动设置雾气颜色
                "mode": "FIXED",
                
                // (FIXED 模式必需) 雾气颜色，HEX 格式（不带 #）
                "fixedHex": "f0f0f0"
            },
            
            // (可选) 雾气形状 ("SPHERE", "CYLINDER")
            "shape": "CYLINDER"
        },
        {
          // 另一个绑定
        }
    ],
    
    // 预设架构版本（不要更改此值）
    "version": 3
}

预设示例可以在 [GitHub 仓库](docs/presets) 中找到。

💥 与其他模组的兼容性

如果你遇到 Foggy Pale Garden 与其他模组之间的兼容性问题，请在 GitHub 上提交问题 或 在 Discord 上联系我们。

Sodium、Embeddium 和 Rubidium

你需要禁用 性能 - 使用雾气遮挡 设置，以便雾气后的方块继续渲染，不会在玩家靠近时突然出现。

🚀 计划

❓ 也许可以实现对 Iris Shaders 的支持？

🤗 整合包

你可以在整合包中使用此模组，无需请求许可。