Notifications You must be signed in to change notification settings Files Expand file tree File metadata and controls 适用构建：Minecraft 1.20.1、Forge 47.4.21 + Sinytra Connector，也适用于本仓库的原生 Fabric 1.20.1 构建。 NeedsOfNature ：性别、性欲、主动遭遇、体液、怀孕、污渍、破损皮肤、饰品、物品和 HUD。 Animation Director / Animation Framework ：读取动画定义，选择演员，定位模型，控制阶段、镜头、网络同步与 GeckoLib 渲染。 这是成人向模组。请只在符合法律、平台和服务器规则，且参与者均明确同意的环境中使用。 Forge + Connector 必需组件 Sinytra Connector（实测 1.0.0-beta.49+1.20.1 ） Connector 对应的 Forgified Fabric API GeckoLib Forge 4.8.4 Trinkets 3.7.2（穿戴防护器和隔膜时必需） 本项目的 animationdirector-1.20.1-1.3.1-port.1.jar 本项目的 needsofnature-1.20.1-1.3.1-port.1.jar 默认内容包不能只放进普通 resourcepacks 。模组会从 游戏版本目录/needsofnature/ 扫描 ZIP 或文件夹，并把同一个包同时加载为客户端资源与服务端数据。 正常启动后， logs/latest.log 应出现： both ：同时具有男性与女性标签 性别决定可匹配的动画、V/D 饰品槽是否可用、是否能怀孕以及部分模型。默认样例配置为女性。 空手按 M ：使用普通手动动画。 女性角色手持胡萝卜或金胡萝卜按 M ：优先使用胡萝卜专用动画，并把物品挂到右手道具骨骼。 若按键无反应，先确认玩家在地面、未骑乘、未处于其他动画中、当前性别有匹配定义，且日志显示加载了 38 个定义。 代码和配置中仍使用 energy ，中文界面将其解释为“性欲”。玩家和生物会随时间积累性欲；附近正在播放的动画、玩家性欲光环、破损阶段和饰品都会改变增长速度。 生物达到足够性欲且找到符合定义的演员、空间与方块后，会尝试进入主动遭遇或普通动画。性欲增幅剂、抑制剂和锁定器可永久改变某只生物的行为。 普通循环阶段：默认进度约 15 秒。 高潮阶段：默认进度约 7 秒。 收尾或不可高潮阶段：由定义中的 non_peak 、 use_stage 和 allow_join 控制。 动画开始后人物位置和身体朝向会被锁定，第三人称镜头仍可转动。受到伤害是否中止由 Animation Framework 的伤害策略决定。 高性欲生物可能主动接近并触发遭遇。HUD 出现挣脱条后，持续进行普通攻击操作可累计挣脱进度： 挣脱后有 3 秒无敌和动画保护时间。 创造模式玩家默认不会被主动攻击。 防护器会阻止对应 V/A 类型的插入动画，并消耗耐久。 玩家默认拥有 200 ml 的体内储槽。带 injector 标记的演员在高潮时会向接收者增加对应来源与颜色的体液。 M ：口部/其他定义使用的接收类型。 储槽超过 30%、50%、80% 时分别进入三个“被灌满”阶段，并按配置降低移动和跳跃能力。体液会按秒自然流失；潜行、泡水和饰品可能改变流失速度。 手持玻璃瓶使用可触发装瓶动画： 单一来源得到“某生物的精液瓶”。 多个来源混合后得到“混合精液瓶”。 精液瓶可用于药水、性欲调节剂和生物性欲锁定器。 pregnancyEnabled 为 true 。 玩家性别包含女性；仅男性不能怀孕。 玩家没有装备能阻止怀孕的避孕隔膜。 动画中存在非玩家生物，并且该演员带 injector: "V" 。 默认受孕概率为 5%，胎儿/后代来源取自完成阴道内射的生物。默认妊娠 3 分钟，结束后播放生产动画，按实体配置直接生成后代或产下待孵化的蛋。 易孕药水 I：受孕概率至少提高到 80%。 易孕药水 II：受孕概率至少提高到 95%。 精液蜂蜜饮剂：任意本模组精液瓶 + 蜂蜜瓶，无序合成。 易孕药水：精液蜂蜜饮剂在酿造台加入鸡蛋。 3 朵任意小型花无序合成。它只是合成材料，不能穿戴或直接对生物使用。 永久把该生物的性欲自然增长倍率增加 0.2。 若生物被锁定，会同时解除锁定。 无序配方：一瓶精液 + 蜂巢 + 糖 + 催情花粉混合物 + 绯红菌。 对生物右键，永久把增长倍率降低 0.2，最低为 0.4；非创造模式消耗一个。 配方与增幅剂相同，但使用诡异菌。 成品名称会显示绑定的生物，只能对同种生物使用。成功后把性欲压到 199 以下、清除攻击/愤怒目标并写入锁定标记。使用性欲增幅剂可解除。 催情药水：精液瓶 + 绯红菌。 性欲抑制药水：精液瓶 + 诡异菌。 萤石粉制作强效版，红石制作延长版。 可继续制成喷溅、滞留药水和药箭。 对方块表面使用，在命中位置放置收集实体。位置需要足够空间。它用于马相关收集动画，不是护甲，也不能放入饰品槽。 7. Trinkets 饰品与防护用品 打开物品栏中的 Trinkets 面板，将物品拖入对应槽： V ：阴道槽，仅性别包含女性时可用。 A ：肛门槽，所有允许性别均可用。 D ：男性器官槽，仅性别包含男性时可用。 阴道防护器：放 V 槽，阻止 V 类插入；8 点耐久。 肛门防护器：放 A 槽，阻止 A 类插入；8 点耐久。 阴道/肛门双重防护器：可从 V 或 A 槽装备，但同时占用 V+A，阻止两类插入；8 点耐久。 避孕隔膜：放 V 槽，阻止受孕；触发一次对应效果后损坏。 铁制肛塞：默认未显式填写 trinkets_slots ，当前加载器会回退为 V/A 两槽均可装备。它把体液自然流失降至 25%，但把玩家性欲增长提高到 3 倍。 防护器属于互斥组，不能同时穿戴多个；双重防护器也不能与单槽防护器叠加。 8. 污渍、破损皮肤和护甲脱落 动画可分别积累 V/A/M 三处体表污渍。 messSystemEnabled 控制系统总开关。 破损皮肤有 0–4 阶段。普通伤害默认有 10% 概率增加破损，破损越严重，对附近生物的性欲光环越强。 靠近织布机，打开物品栏并点击修复按钮。 开启 allowCraftingTableSkinRepair 后，工作台也能作为修复站。 destroyedSkinTintHex 可指定回退破损皮肤颜色，例如 "D8A078" ；空字符串表示自动取色。 使用 VS Code、Notepad++ 等纯文本编辑器，以 UTF-8 保存。 JSON 的字符串必须有双引号；布尔值只能写 true / false ；最后一项后不能多逗号。 修改后先用 JSON 校验器或编辑器检查语法。 重新启动游戏。服务端玩法配置由房主/服务器决定，连接远程服务器时客户端本地值可能被服务端同步覆盖。

10. NeedsOfNature 配置字段说明 下列默认值来自仓库的 Forge/Connector 实测样例。 两个对象内字段： breastSize 、 separation 、 height 、 depth 、 rotation 、 breastPhysics 、 dualPhysics 、 intensity 、 momentum 。 10.10 Buttplug.io / Intiface intifaceEnabled 默认为 false 。不使用外设时保持关闭即可，日志中的“integration is unavailable”不会影响游戏。 11. Animation Framework 配置 config/animationframework.json ： 只把这些字段改进现有文件，不要用片段覆盖整个 JSON。 needs_of_nature_default_packv1.3.0.zip 不是普通材质包。它包含： 本移植版把默认包需要的 GeckoLib 4 geo/ 与 animations/ 副本内置进 Animation Director JAR。默认 ZIP 必须保持原始字节结构，不要使用 PowerShell Compress-Archive 重新压缩；实测它会让 Connector 显示包已加载，但丢失饰品贴图或全部 AFW 定义。 复制默认 ZIP 作为备份，不要直接改唯一副本。 修改文件后使用 7-Zip 等工具打包，确保 pack.mcmeta 、 assets/ 、 data/ 位于 ZIP 根目录，而不是多套一层文件夹。 换一个文件名放入 游戏版本目录/needsofnature/ 。 为自制包设置唯一 animationframework.id 。 启动后检查加载数量和 setup warning。 允许一层包装目录，但正式发布时应把内容直接放在根目录。 14.2 pack.mcmeta 建议以默认包为模板，只改动画包元数据： id 必须是唯一的命名空间 ID，不能与默认包重复。 actors ：演员约束列表。 animation_tags ：功能标签，如 manualPeak 、 fillBottle 。 content_tags ：姿势/内容分类。 required_union_tags ：组合匹配要求。 weight ：同等候选中的随机权重。 block_requirements ：墙、台面、支撑或指定方块条件。 position_anchor_actor ：定位锚点演员。 manual_peak ：手持物触发规则。 liquid_gain_multiplier ：此动画体液量倍率。 entity_types ：允许的实体 ID。 entity_variant ：实体变体。 actor_tags / actor_tags_any ：性别等标签。 age ： adult 或 baby ；默认 adult 。 activity ： active 或 passive 。 injector ： V 、 A 、 M 或 false 。 receiver ：是否为体液接收者。 prop_left / prop_right ：默认左右手物品 ID。 stage ：从 1 开始的阶段号。 use_stage ：复用另一阶段的动画资源。 cycle_seconds ：作者动画循环长度，必须尽量匹配 GeckoLib 文件。 allow_join ：是否允许其他演员加入。 cycle_midpoint_offset_seconds ：循环中点偏移。 props ：按演员键覆盖左右手道具。 escapable ：此阶段能否挣脱。 non_peak ：此阶段不执行高潮结算。 定义 ID 由路径决定。例如： 定义 ID 为 mypack:example ，阶段资源 ID 为 mypack:example.p1 、 mypack:example.p2 。 本 1.20.1 移植使用 GeckoLib 4，实际运行资源必须提供： 原 1.21/GeckoLib 5 包的源布局是： 默认包能只保留后者，是因为本项目已把它的 GeckoLib 4 副本编进 JAR。新制作的外部包不能依赖这个默认包专用副本，必须自行提供 GeckoLib 4 的 assets/<命名空间>/animations/ 和 assets/<命名空间>/geo/ 资源；若还要兼容原版 1.21，可同时保留两套目录。 priority 越高越先匹配； prop_from_held_item 会把匹配到的物品发送给客户端，并挂到 propright 骨骼。 birth_mode 可为 direct 或 egg 。 color 可省略；颜色使用 6 位 RGB 十六进制。 饰品 ID 目前必须使用 needsofnature 命名空间。示例： 槽位可写 legs/v 、 legs/a 、 legs/d ，也可简写 v 、 a 、 d 。若完全省略 trinkets_slots ，当前加载器回退为 V 和 A 两槽。 可用效果包括体液流失、玩家性欲增长、容量、体液增加量、灌满惩罚、受孕概率/持续时间、污渍、破损伤害、挣脱难度和性欲光环等倍率。 15. 内容包加载、覆盖与禁用 外部 NoN 包优先于模组基础资源。 externalNoNPackLoadOrder 控制多个外部包的相对顺序。 disabledAnimationPacks 按 animationframework.id 禁用整个包。 disabledAnimations 按定义 ID 禁用单个动画。 修改服务端数据后最稳妥的方法是完全重启游戏； /reload 只适合纯数据修改，不能重新注册启动期饰品物品。 饰品定义属于启动期注册数据：新增或删除饰品后必须完全重启，且删除已经进入存档的注册物可能造成缺失映射，务必先备份世界。 玩家不在地面、正在骑乘或已有动画。 默认包位置错误，日志显示 Loaded 0 AFW definition(s) 。 模型或动画资源没进入 GeckoLib 4 缓存。检查 assets/<namespace>/geo/ 与 assets/<namespace>/animations/ 路径、文件名和 JSON 是否含 UTF-8 BOM。 确保使用包含 AfwBoneItemGeoLayer 的最新 Animation Director JAR，并删除旧 JAR；Forge/Connector 下还要让 .connector 缓存重建。 截图中的花粉、增幅剂、抑制剂、锁定器不是穿戴装备。 V 槽要求玩家性别包含女性，D 槽要求包含男性。 双重防护器会占用 V+A，已有单槽防护器时无法再装备。 确认 Trinkets 已加载，日志没有“Trinkets is not installed”。 默认包 ZIP 被错误重打包或资源根目录多套层级。恢复仓库中原始 ZIP。 修改了错误实例的 config 。 游戏仍在运行，退出时把旧值写回。 连接远程服务器，服务端配置覆盖客户端。 JSON 语法错误，模组回退默认值或重建文件。 日志出现 Buttplug.io 不可用 这是可选外设功能。 intifaceEnabled=false 时可忽略。 这是非官方 1.20.1 逆向移植。原作、模型、动画与默认资源的权利归原作者 L1Z0 、Incarnadine 及各自权利人所有。分享代码或构建时应保留原作者声明、原发布页链接和本项目的非官方说明： https://www.loverslab.com/files/file/49713-minecraft-needs-of-nature-nsfw-mod-data-driven-sex-animation-mod-for-minecraft-fabric-12111/ 不要把本指南当作重新授权；分发前仍需遵守原发布页许可、平台规则和当地法律。