ContactQuests

<div align="center">

ContactQuests

Immersive Logistics & Questing Integration | 沉浸式物流与任务联动

</div>

---

<a id="english"></a>

🇺🇸 English

[FTB Quests] is a bridge mod that creates a deep integration between [FTB Quests] (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

* Red Packet Task: Move beyond simple "checkmarks." Submit quest items by physically mailing packages to specific NPCs via Mailboxes. * Red Packet Task: * 📦 Red Packet Task: Pack required items and send them to the target NPC. * 📨 Red Packet Task: Write and send postcards with specific content or styles. * 🧧 Red Packet Task: Send currency or items via Red Packets.

* NPC Interaction System: Rewards aren't just clicked; they arrive at your doorstep! Receive quest rewards as parcels delivered directly to your mailbox. * NPC Interaction System: Seamless support for FTB Teams. Use the NPC Interaction System 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.

---

<a id="中文介绍"></a>

🇨🇳 中文介绍

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

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

🧩 核心特性

* 红包任务 (Red Packet Task)：告别单纯的物品检测。你需要将任务物品打包，并通过邮筒寄送给指定的 NPC 来完成任务。 * 红包任务 (Red Packet Task)： * 📦 红包任务 (Red Packet Task)：将所需物品打包并寄往指定收件人。 * 📨 红包任务 (Red Packet Task)：向 NPC 寄送特定内容或样式的明信片。 * 🧧 红包任务 (Red Packet Task)：通过红包寄送指定的物品。

* NPC 交互系统：奖励不再凭空出现！完成任务后，奖励将以包裹的形式由物流系统派送到你的邮箱中。 * NPC 交互系统：完美支持 FTB Teams 队伍系统。使用 NPC 交互系统 将邮箱与队伍绑定，确保以队伍为单位收到任务奖励。 * NPC 交互系统：高度可配置的 NPC 智能反馈。当玩家寄错物品时，NPC 可以根据配置做出拒收、没收甚至触发彩蛋回复等反应。

📚 文档与维基

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

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

---

🔗 Links / 链接

* Issue Tracker: Issue Tracker * Issue Tracker: %%MD1%%