ProjectAsh：Cobblemon公告

Project Ash: 公告这一切！

Project Ash 是一个推动公告领域的 Minecraft 模组，不仅包含闪光、传说或完美个体值刷新，还包含战斗追踪与展示！

✨ 功能特性

📢 里程碑与刷新公告

• 闪光与完美个体值追踪： 即时标记并记录闪光刷新或完美 100% 个体值宝可梦的捕获/刷新。
• 稀有度标签： 使用内置标签格式化公告，适用于特定群体，如 传说、幻之宝可梦、究极异兽 和 悖谬宝可梦。
• 孵蛋通知： 当玩家成功孵化一个蛋时向社区公告。
• 实体加载捕获： 可选的 unknownspawns 追踪日志，记录直接从世界生成/区块加载中出现的实体。
• CatchEmAll 图鉴模式： 作为玩家，可选择启用 CatchEmAll，并在生成宝可梦有助于你的活体图鉴、形态图鉴、闪光图鉴等时触发通知。

⚔️ 战斗追踪与战争迷雾

• 游戏内开始标记： 战斗开始初始化时自动打印一条公告。
• Discord 对战摘要： 战斗结束时发送丰富的遥测数据，详述出战的宝可梦、其存活/濒死状态，以及自动生成的精灵缩略图。
• 战争迷雾保护： 将未看到或未战斗的对手槽位隐藏在 ??? 布局之后，防止战略侦察。

🃏 展示

• CobbleTCG 集成： 在聊天中展示你酷炫的卡牌，悬停卡牌名称即可查看卡牌。可通过手持物品按下展示键，或悬停物品栏中的物品来展示。
• 宝可梦公告集成： 当宝可梦生成的公告出现时，将与展示功能集成！悬停物种名称即可查看宝可梦精灵图。
• 坐标传送： 增强包含坐标的公告，这些坐标现在可点击并传送你过去。

🏆 支持的图鉴模式

启用 CatchEmAll 后，你可以选择一种图鉴类型进行后续操作，以下是支持的图鉴及其规则的列表。

LIVINGDEX（活体图鉴）

规则： 玩家必须在电脑或同行队伍中实际拥有每一种宝可梦物种的至少一份。 注意： 此模式不追踪闪光状态或特定地区形态——任何变体都算数。

SHINYDEX（闪光图鉴）

规则： 玩家必须在电脑或同行队伍中实际拥有该宝可梦物种的闪光变体才能获得计数。普通版本将被忽略。

EVERYDEX（全图鉴）

规则： 检查玩家的历史宝可梦图鉴数据。只要基础物种在其游戏生涯中被捕获过至少一次，就能获得计数——即使后来交易或放生了该宝可梦。

FORMDEX（形态图鉴）

规则： 一个进阶的活体图鉴挑战。玩家必须在电脑或同行队伍中实际拥有每一个地区和季节形态变体（例如，阿罗拉 vs. 关都，或不同季节的四季鹿）。 注意： 过于复杂的外观图案（如晃晃斑或彩粉蝶）被排除在外，以保持挑战的趣味性。

MASTERLIVINGDEX（大师活体图鉴）

规则： 终极收藏家挑战。要达到完整，玩家的电脑和同行队伍必须实际持有每个物种和形态变体的普通版本和闪光版本。

---

📦 安装

1. 下载最新版本的 Project Ash。
2. 将 .jar 文件放入服务器的 mods 文件夹和客户端 mods 文件夹。
3. 启动服务器。
4. 首次启动将自动生成配置文件： /config/ProjectAsh.conf

5. 在游戏内执行更新 webhook 命令以配置 Discord 服务器，无需重启！：)

🛠️ 命令导航与参考

无需强迫用户记住冗长的语法字符串或修改后端文件，所有配置都可以直接在 Minecraft 聊天窗口中通过交互式点击元素完全原生操作。

🖱️ 可点击 UI 路由图

运行基础命令 /projectash 会打开一个响应式文本向导。点击括号会自动填充并推进树中的下一个节点，直到你执行某个操作：

/projectash
 └── [服务器]    [玩家]
示例：修改闪光生成
 👤 点击 [服务器] 
    └── [返回] [Discord] [展示] [游戏内] [完美] [闪光] [未知生成] [标签] [特殊] [黑名单]
 👤 点击 [闪光]
    └── [返回] [检查] [启用] [禁用]
 👤 点击 [启用]
    └── 💬 输出: "[Project Ash] 闪光检查: 已启用"

👤 玩家命令

这些属性仅控制游戏内公告，对所有在线玩家开放。

功能 / 子功能	描述	命令基础	可用操作 / 参数
special（特殊）	玩家自定义的个人目标物种白名单，用于为自己追踪。	/ash player special	check、enable、disable、add <物种> [闪光标记]、remove <物种>、clear
catchemall（宝可梦全收集）	追踪形态指标，当生成物匹配其特定形态/闪光图鉴中的缺失条目时提醒玩家。	/ash player catchemall	check、update
catchemall / localspawnsonly（仅本地生成）	通过仅在你是驱动该生成半径的最近玩家时触发"宝可梦全收集"日志来保护追踪。	/ash player catchemall localspawnsonly	check、enable、disable

👑 服务器管理员命令

这些属性处理全局服务器级组件和 Discord 管道。需要 服务器管理员 (server op) 权限。

功能 / 子功能	描述	命令基础	可用操作 / 参数
discord	全局系统开关，用于开启或关闭 Discord webhook 派发系统。	/ash server discord	check、enable、disable
discord / webhook	查看或更新你的 Discord 频道的操作端点目标字符串。	/ash server discord webhook	check、add <url>、remove
discord / thumbnails	切换是否将视觉资源（例如自定义宝可梦精灵图）渲染到 webhook 嵌入消息中。	/ash server discord thumbnails	check、enable、disable
ingame（游戏内）	控制所有全局游戏内聊天公告元素的主开关。	/ash server ingame	check、enable、disable
showcase（展示）	运行一次高级状态检查，同时评估所有下游物品展示模块。	/ash server showcase	check
showcase / cobbletcg	调整有关玩家快捷键卡牌/卡包展示的授权规则。	/ash server showcase cobbletcg	check、enable、disable
perfect（完美）	管理服务器范围的最大 100% 个体值生成警报公告。	/ash server perfect	check、enable、disable
shiny（闪光）	管理服务器范围的标准闪光野外生成公告。	/ash server shiny	check、enable、disable
unknownspawns（未知生成）	切换是否过滤因实体或区块重载周期而产生的物种通知。	/ash server unknownspawns	check、enable、disable
label（标签）	指定由公告引擎评估的自定义字符串标签（例如，悖谬、幻之宝可梦）。	/ash server label	check、add <标签>、remove <标签>、clear
special（特殊）	核心主白名单。匹配的目标会在本地聊天频道和 Discord 频道同时触发。	/ash server special	check、add <物种> [闪光标记]、remove <物种>、clear
blacklist（黑名单）	抑制特定物种的全局追踪。（注意：这不能覆盖单个玩家的列表。）	/ash server blacklist	check、add <物种> [闪光标记]、remove <物种>、clear

💡 标记约束与语法示例

使用白名单或黑名单修改命令（add）时，你可以附加一个可选的 [闪光标记] 条件修饰符：

• INCLUDE（包含） （默认） — 将过滤行为同等地应用于普通和闪光变体。
• EXCLUDE（排除） — 明确将该过滤规则范围内的闪光变体排除在外。
• ONLY（仅限） — 命令过滤规则仅在目标实体生成为闪光时专门应用。

/ProjectAsh player special add shuckle ONLY
/ProjectAsh server blacklist add pidgey INCLUDE
/ProjectAsh server label add "究极异兽"
/ProjectAsh player catchemall localspawnsonly enable

---

🤝 致谢

本项目自豪地作为 Cobblemon 的扩展而构建。我们非常感谢 Cobblemon 的作者、美术师和开发人员，他们的辛勤工作和开源 API 使这一增强功能成为可能。

注意： Project Ash 是一个非官方的粉丝自制附加组件，与官方 Cobblemon 团队无关，也未获得其认可。