tallergen

Mod Overview

Tallergen implements food‑allergy mechanics. No new blocks, items or crafting recipes are added. Existing foods inherit allergen properties through crafting chains. Players receive permanent random allergies on their first world join. Consuming allergenic food triggers a full Latency‑Reaction‑Recovery cycle with escalating symptoms; maximum severity can be lethal. Track your allergy status via the top‑left HUD and avoid trigger foods.

Configuration

All mod behaviours are governed by files inside config/threxioncore/tallergen:

• allergens/: Custom allergen definitions
• cache/: Internal cache, do not edit manually
• example/: Official sample template folder. Copy these sample files to sibling directories as your base for custom configurations.
• reactions/: Allergy reaction effect definitions
• blacklist.json: Blacklist, blocks items from inheriting allergens
• option.json: Global probability & balance parameters
• player.json: Persistent per‑player allergy data
• whitelist.json: Force‑assign allergens to target items

⚠️Workflow tip: Copy sample files from example/ to the corresponding directory before modification. Always run /tallergen scan after edits, otherwise changes will not take effect in‑game.

Basic Gameplay

1. Allergy Assignment: Rolled one‑time on player’s first join. Default 5% roll chance, +5% chance for wheat allergen, maximum one assigned allergen. Allergies are permanent. Operators may assign or revoke allergies via commands.
2. Exposure & Phases: Eating trigger food accumulates Exposure Value. Reaction sequence: Latency → Reaction → Recovery. Latency produces no visible symptoms. Reaction phase applies custom effects. Further consumption during exposure raises severity and stacks remaining reaction time.
3. Death: Death clears active symptoms but preserves inherent allergies. Re‑consuming trigger food restarts the whole reaction cycle. Dimension travel and rejoining do not reset allergies.
4. HUD Status: Top‑left HUD displays allergens, exposure value, reaction phase and severity, toggleable via gamerule. Vanilla milk clears status effects but cannot terminate the allergy reaction cycle.

Operator Commands (OP required)

• /tallergen player <player> add <allergen>: Assign allergen to target player
• /tallergen player <player> remove <allergen>: Remove allergen; instantly clears active symptoms
• /tallergen player <player> list: List allergens assigned to player
• /tallergen inspect <item/allergen/player>: Query allergen‑related data
• /tallergen blacklist add <item>: Add item to blacklist, block allergen inheritance
• /tallergen blacklist remove <item>: Remove item from blacklist
• /tallergen whitelist add <item>: Add item to whitelist, force item to carry allergens
• /tallergen whitelist remove <item>: Remove item from whitelist
• /tallergen scan: **Reload all configs under config/threxioncore/tallergen **

===============================================================================

模组概述

Tallergen 目前加入了食物过敏机制，不新增方块、物品与合成配方。已有食物会沿合成链继承过敏原。玩家首次进入世界随机获得永久过敏体质；误食致敏食物将经历潜伏期‑发作期‑恢复期完整反应流程，症状逐级加重，最高严重度可致死。通过左上角 HUD 实时查看过敏状态，规避致敏食物。

配置说明

模组全部行为由 config/threxioncore/tallergen 下配置驱动：

• allergens/：自定义过敏原定义
• cache/：内部缓存，禁止手动编辑
• example/：官方示例模板文件夹，内含可直接参考复制的完整样例配置，新建自定义配置建议以此为蓝本修改
• reactions/：过敏反应效果定义
• blacklist.json：黑名单，阻止物品继承过敏原
• option.json：全局概率、数值参数
• player.json：持久存储玩家过敏数据
• whitelist.json：强制为物品指定过敏原

⚠️编辑配置：复制example内样例文件到对应同级目录进行修改。完成修改后务必运行 /tallergen scan，否则更改不会加载进游戏。

具体玩法

1. 过敏分配：玩家首次进世界一次性随机判定过敏。默认 15% 概率触发分配，过敏原本身添加 5% 分配概率，最多获得 1 种过敏，过敏属性永久生效。管理员可指令手动增删玩家过敏。
2. 暴露与阶段：食用致敏食物累积暴露值，流程依次为潜伏期→发作期→恢复期。潜伏期无可见症状；发作期触发自定义效果；恢复期症状逐步消退。发作期继续进食会提升暴露等级，叠加剩余发作时长。
3. 死亡：死亡清除当前发作症状，但过敏体质保留，复活误食将重新触发全套反应；跨维度、重登录不会重置过敏。
4. HUD 状态：左上角 HUD 展示过敏原、暴露值、反应阶段、严重度，支持游戏规则开关。原版牛奶仅清除状态效果，不会终止过敏反应流程。

管理员 OP 指令

• /tallergen player <玩家> add <过敏原>：为玩家添加过敏原
• /tallergen player <玩家> remove <过敏原>：移除玩家过敏原，立刻清除正在发作的症状
• /tallergen player <玩家> list：列出玩家已分配过敏原
• /tallergen inspect <物品/过敏原/玩家>：查询过敏原关联信息
• /tallergen blacklist add <物品>：将物品加入黑名单，阻止其继承过敏原
• /tallergen blacklist remove <物品>：从黑名单移除物品
• /tallergen whitelist add <物品>：将物品加入白名单，强制该物品携带过敏原
• /tallergen whitelist remove <物品>：从白名单移除物品
• /tallergen scan：重载 config/threxioncore/tallergen 全部配置文件