🇺🇸 English

ContactQuests is a bridge mod that creates a deep integration between [Contact] (Logistics/Mail) and [FTB Quests].

Unlike traditional quests where items are instantly detected in your inventory, ContactQuests requires players to engage with the physical world of logistics. It transforms the abstract concept of "Quest Submission" into an immersive gameplay loop involving packaging, mailing, and waiting for deliveries.

🧩 Key Features

• Immersive Questing: Move beyond simple "checkmarks." Submit quest items by physically mailing packages to specific NPCs via Mailboxes.

• New Task Types:

• 📦 Parcel Task: Pack required items and send them to the target NPC.

• 📨 Postcard Task: Write and send postcards with specific content or styles.

• 🧧 Red Packet Task: Send currency or items via Red Packets.

• Postal Rewards: Rewards aren't just clicked; they arrive at your doorstep! Receive quest rewards as parcels delivered directly to your mailbox.

• Team Integration: Seamless support for FTB Teams. Use the Team Binding Card to ensure rewards are delivered to your team's shared mailbox.

• NPC Interaction System: Define custom responses when players send incorrect or extra items. Create NPCs with personality who can reject mail, confiscate items, or send easter egg replies.

📚 Documentation & Wiki

Detailed guides are available on our GitHub Wiki:

• Getting Started: How to bind mailboxes and complete your first delivery quest.
• Tasks & Rewards Mechanics: Detailed breakdown of new task types and reward configurations.
• Configuration Guide: Global settings and setting up delivery delays.
• NPC Interaction Config: How to configure npc_config.json for custom reply logic.
• Commands & Permissions: Usage of mod commands.
• Advanced Quest Logic: Configuring mutex tasks and tag requirements.
• KubeJS Integration: Scripting support for custom logistics events.

🇨🇳 中文介绍

ContactQuests 是一个旨在实现 [Contact] (邮件/物流) 与 [FTB Quests] (任务) 深度联动的模组。

本模组打破了传统任务“点击即完成”的抽象模式，将任务流程与物理物流紧密结合。它让玩家必须通过真实的打包、投递和等待收件来推进任务进度，为整合包带来更具沉浸感的“叙事”体验。

🧩 核心特性

• 沉浸式任务体验：告别单纯的物品检测。你需要将任务物品打包，并通过邮筒寄送给指定的 NPC 来完成任务。

• 全新的任务类型：

• 📦 邮递任务 (Parcel Task)：将所需物品打包并寄往指定收件人。

• 📨 明信片任务 (Postcard Task)：向 NPC 寄送特定内容或样式的明信片。

• 🧧 红包任务 (Red Packet Task)：通过红包寄送指定的物品。

• 物流奖励系统：奖励不再凭空出现！完成任务后，奖励将以包裹的形式由物流系统派送到你的邮箱中。

• 团队无缝协作：完美支持 FTB Teams 队伍系统。使用 团队绑定器 (Team Binding Card) 将邮箱与队伍绑定，确保以队伍为单位收到任务奖励。

• NPC 交互系统：高度可配置的 NPC 智能反馈。当玩家寄错物品时，NPC 可以根据配置做出拒收、没收甚至触发彩蛋回复等反应。

📚 文档与维基

详细的教程文档请查阅 GitHub Wiki：

• 快速入门：如何绑定队伍邮箱以及完成你的第一个物流任务。
• 任务与奖励详解：各种新任务类型（邮递、明信片、红包）的详细说明。
• 配置文件指南：通用设置与物流延迟机制的配置。
• NPC 交互配置：如何编写 npc_config.json 来自定义 NPC 的回信逻辑。
• 命令与权限：模组命令的使用说明。
• 进阶任务逻辑：配置互斥任务与 Tag 需求。
• KubeJS 联动：使用脚本自定义物流事件。

🔗 Links / 链接

• Source Code: GitHub
• Issue Tracker: Report Bugs / 反馈问题