Cobblemon：口袋印记

✨ PokeMarks for Cobblemon ✨

🔍 这个模组是什么？

你是否曾觉得，仅凭闪光（Shiny）不足以体现某只宝可梦的 稀有度、 地位 以及 独一无二性？

现在，你可以将这一切提升到新的高度！PokeMarks 将《剑/盾》和《朱/紫》中的“证章”（Marks）系统引入你的游戏——为你的宝可梦增添更多光彩、个性与一丝神秘感。花更多时间狩猎宝可梦，并炫耀你的收藏吧！

每个证章都包含：

• 📝 称号： 显示在宝可梦上的个性化称号
• 🎨 颜色： 称号的特定颜色
• 🎲 概率： 一个百分比（0–100%），决定证章是否被应用
• ✨ 粒子效果： 可自定义的粒子效果，提供视觉上的闪光点

证章会根据游戏内条件（如天气、时间、生物群系等）进行应用。原版游戏中的几乎所有《剑/盾》和《朱/紫》证章都被收录，并保留了其原有的概率和条件，仅做了一些微调以更好地适应 Minecraft。仅有少数在 Minecraft/Cobblemon 中没有直接对应物的证章被省略（将在未来的更新中添加）。

✨ 证章展示

这里有一些不同证章与宝可梦的奇妙组合！以下是一些可能性的预览：

带有“骤雨之证”的水伊布	带有“繁茂之证”的闪光水伊布

你将发现哪些证章？ 数百种宝可梦与数十种证章组合搭配，每种证章都为你的收藏增添了独特的个性和视觉魅力。

你会找到一只带有“沙暴之证”的穿山鼠吗？或者是一只带有“首领之证”的喷火龙？可能性是无限的！

🌟 特性

完全可自定义的证章

• 通过简单的 JSON 配置添加、移除或修改证章
• 可按你的喜好配置称号、称号颜色、概率和粒子效果等属性

动态条件检查

• 证章根据游戏内事件和情境授予（例如，isRaining、isDayTime、isPokemonIVSum(>=145)）
• 支持多种条件，可精确控制证章出现的时间和地点

与 Cobblemon 无缝集成

• 专为完美融入 Cobblemon 而设计，不影响游戏玩法

对开发者友好的配置

• 开放且灵活的配置，便于轻松试验和自定义

🚀 计划中的功能

增强的界面集成

• 在 PC 和队伍界面中显示证章图标
• 在各种界面中为带有证章的宝可梦提供视觉指示器

扩展证章收藏

• 更多来自宝可梦游戏的证章
• 专属于 Minecraft 环境的自定义证章

可配置的音效系统

• 放出带有证章的宝可梦时播放特殊音效
• 与证章主题相匹配的环境音效

模组集成

• 与 Alpha 宝可梦模组兼容（确保只有 Alpha 宝可梦才能拥有 Alpha 证章）
• 与天气模组集成，支持沙暴、薄雾和暴风雪等天气条件
• 支持生物群系和维度模组，实现更多基于环境的证章

游戏内指令

• 轻松添加/删除/管理宝可梦上的证章
• 用于服务器管理的管理员指令
• 用于查看证章信息的玩家指令

统计追踪

• 追踪你收集的每种证章的数量
• 收集特定证章组合的成就

📋 可用证章条件

证章使用条件语句来决定是否应被应用。以下是完整的可用条件列表：

🌍 环境条件

• isThundering: 检查世界是否处于雷暴状态
• isSnowing: 检查是否在下雨且当前生物群系的降水类型为雪
• isRaining: 简单地检查世界是否在下雨
• isNight: 检查世界是否处于夜晚状态
• isDay: 检查世界是否处于白昼状态

⏰ 时间条件

• isMoonPhase: 将当前月相与指定条件进行比较（例如，isMoonPhase(<2)）
• isGameTime: 检查游戏时间（以 tick 为单位）是否等于指定值或在指定范围内（例如，isGameTime(>2005000)）
• isDayTime: 检查白天时间（以 tick 为单位）是否在特定范围内（例如，isDayTime(6000..7000)）。Minecraft 的昼夜循环持续时间为 0 到 24000 tick

📍 位置条件

• isPosition: 检查出生位置（x， y， z）是否符合指定条件（例如，isPosition(*, >=20,!=0)）
• isBiome: 检查当前生物群系是否匹配给定的生物群系 ID（例如，isBiome(minecraft:ocean, minecraft:desert)）
• isDesert: 检查当前生物群系是否为沙漠、恶地或被侵蚀的恶地

🐠 宝可梦条件

• isPokemonIVSum: 检查个体值（IV）总和是否满足条件（例如，isPokemonIVSum(>=145)）
• isFished: 检查宝可梦是否通过钓鱼生成

🧩 条件表达式语法

条件可以很简单，也可以借助这些强大的选项变得复杂：

数值运算符

• 支持 >、<、>=、<=、!= 以及范围运算符，如 .. 和 ..<

通配符

• 使用 * 作为通配符以匹配任何值

逻辑运算符

• ! 用于取反
• || 用于或运算
• && 用于与运算
• 使用 () 对条件进行分组

复杂条件的示例：

• !isDay || !(isBiome(minecraft:ocean, minecraft:desert) && !isPosition(*, >=20, !=0))

⚙️ 配置

该模组会在你的 minecraft/config 目录下自动生成一个 JSON 配置文件。
如果新版本的模组包含配置更改，只需删除旧版本的配置文件，模组将自动生成一个新文件！
无需编写任何代码即可个性化你的证章！

全局配置

• config_hot_reload_each_tick: 启用后无需重启即可即时应用配置更改（在生产环境中设置为 false 以获得更好的性能）

证章配置属性

• title: 显示在宝可梦上的自定义称号（例如，“前首领”）
• chance: 证章被应用的概率百分比（0-100）（例如，2.5 代表 2.5%）
• color: 称号的十六进制颜色代码（例如，"#FF1616"）
• condition: 定义何时应用证章的表达式（例如，"isPokemonIVSum(>=145)"）

粒子配置

• particle_type: 粒子效果的类型（可以是任何 Minecraft 或模组粒子，格式为 mod_id:particle_name）
• spawn_rate: 控制粒子生成的频率（1 = 每 tick 一次，20 = 每秒一次）
• spawn_count: 每次生成的粒子数量
• velocity_affected_by_rotation: 当设置为 true 时，粒子的运动方向将与宝可梦的旋转方向对齐，而非全局坐标轴
• velocity: 在 x、y 和 z 轴上的移动速度（可以是固定值或随机范围）
• offset: 相对于宝可梦的生成位置偏移量（可以是固定值或随机范围）

📝 配置示例

{
  "data": {
    "config_hot_reload_each_tick": true,
    "marks": {
      "Alpha Mark": {
        "title": "Former Alpha",
        "chance": 2.5,
        "color": "#FF1616",
        "particles": {
          "particle_type": "minecraft:small_flame",
          "spawn_rate": 1,
          "spawn_count": 2,
          "velocity_affected_by_rotation": false,
          "velocity": {
            "x": 0.0,
            "y": 0.0, 
            "z": 0.0
          },
          "offset": {
            "x": { 
              "min": 0.0, 
              "max": 1.5 
            },
            "y": { 
              "min": 0.0, 
              "max": 1.0 
            }
          }
        },
        "condition": "isPokemonIVSum(>=145)"
      }
    }
  }
}