[Machine Translation Note: Hello! My native language isn't English, so this is a machine-assisted translation. Please forgive any imperfections.]
Hello! Partner 【Companion Mod】
Author: Myself (the uploader)
The mod is currently in early development stages, primarily developed by me alone with partial AI assistance in programming. As a result, UI and art assets are temporarily lacking, and there may be numerous bugs. We welcome all suggestions and feedback!
[The default skin features a character I love. If this infringes any rights, please contact me and I'll modify it.]
Core Feature - Independent Companion Unit:
Summoning: Craft the summoning item by surrounding a diamond with eight gold ingots to call forth your companion.
The companion can wear all types of armor and use most melee weapons (e.g., swords, axes) [Theoretically functional - please report any bugs].
When health is low, the companion will automatically consume food from its inventory to recover HP, with restoration amount depending on the food's saturation.
Interaction Interface: Right-click the companion to open its unique UI, featuring a donkey-sized inventory for item storage or equipping gear/food.
Commands & Interactions:
Basic Commands: While holding a stick, crouch + right-click to cycle through three modes:
• Follow: Stays close behind you
• Stay/Sit: Remains stationary
• Patrol: Roams within a small area
Special Ability - Treasure Hunt: Holding a gold ingot, crouch + right-click to make the companion search for item containers (chests, trapped chests, etc.) within a 30-block diameter.
Audio/visual effects indicate activation, with ~5s casting time and 60s cooldown to prevent spam.
Marking Method: Found containers are marked by a glowing shulker that automatically disappears after duration.
[Implementation note: The shulker disappears via continuous damage with special NBT to prevent item drops (though player attacks yield XP).]
Personalized Dialogue:
Contextual voice lines for:
• Treasure hunting (start/finish/no results)
• Food shortage when healing needed
• Equipment damage (random selection from list)
• Death (random selection from list)
（2025.7.15）
Here's the updated translation, incorporating the new details:
English Translation:
Companions now join sprinting. The chest-finding function now works for most modded containers, including loot chests.
Fixed aggro issues; players and other friendly entities can no longer hurt companions when PvP is disabled.
Right-clicking a companion while sneaking with a diamond will now recall the companion into your inventory, appearing as an enchanted diamond.
Right-clicking a companion while sneaking with a Totem of Undying will grant the companion immunity to one death. After dying, the companion will return to the player's inventory as an enchanted diamond, retaining its items.
Patrolling will no longer teleport companions.
Known Issues & Potential Bugs:
• Treasure markers: Glowing shulker method may cause visual glitches or entity accumulation in multiplayer or special terrains.
• Compatibility: Not extensively tested with other mods - conflicts may occur.
• Early version limitations: Companion AI (pathfinding/combat) may exhibit unpolished behaviors like freezing or glitching.
Future Development:
• Auto-applied skins: Plan to implement name-based skin fetching from Minecraft accounts.【Completed】
• Customizable dialogue: Easier conversation editing for personalized companion lines.
• Expanded gear compatibility: Support for accessory slots (Curios API) and ranged weapons (bows/crossbows).
• UI/Art: Currently using vanilla assets as placeholders.
你好！伙伴【companionmod】
作者为上传者本人
目前模组尚处于早期开发阶段，由我一人负责，部分程序由ai辅助制作，因此UI和美术资源暂时欠缺，且程序可能存在不少Bug。欢迎大家提出建议和反馈！
【默认皮肤选用了我喜爱的角色如果造成侵权请联系 我将修改】
核心功能独立的伙伴单位:
召唤: 使用八个金锭环绕一颗钻石合成召唤物，即可召唤你的伙伴。
伙伴能够穿戴所有类型的盔甲，并能使用绝大多数带有近战攻击力的武器（例如：剑、斧）【理论上如此 如有bug请留言】
当生命值降低时，伙伴会主动消耗背包中的食物来恢复生命值，回复量取决于食物的饱食度。
交互界面: 对伙伴按下右键可以打开其独立的UI界面，内含一个与驴容量相当的背包，方便你存储物品或为其补充装备和食物。
指令与互动:
基础指令: 手持木棍，通过蹲下并右键点击伙伴，可以在三种模式间切换：
跟随: 伙伴会紧跟在你身后。
原地驻守/坐下: 伙伴会留在原地休息。
区域巡逻: 伙伴会在一个小的范围内自主巡逻。
特殊能力 - 寻宝: 手持金锭，蹲下并右键点击伙伴，他会开始在附近直径30格以内搜索存有物品的容器（如箱子、陷阱箱等）。
开始和吟唱期间会有音效与粒子提示，吟唱大约为5s，为防止刷屏cd为60s
标记方式: 为了标记找到的容器，伙伴会在其位置生成一个发光的潜影贝。这个潜影贝在一段时间后会自动消失。
【理论上如此 因为清除效果是附加持续伤害使潜影贝死亡，特殊nbt使潜影贝不会掉落物品但如果被玩家攻击会掉落经验】
个性化对话:
伙伴在特定情况下会有语言提示
寻找箱子: 在开始和结束寻找时，他会触发提示。分别会对应寻找开始，结束，什么都没找到。
食物不足: 当需要治疗但没有食物时，他会开始提示缺少食物。
装备损坏: 会随机触发列表中的对话开始提示
死亡: 在倒下时，会随机触发列表中的对话。
已知问题与潜在Bug
寻宝标记: 生成发光潜影贝来标记箱子的方式较为取巧，在某些情况下（例如多人生存、特殊地形）可能会导致意外的视觉问题或实体堆积。
兼容性: 目前尚未对大量其他Mod进行兼容性测试，可能会出现冲突。
（2025.7.15）
Bug: 由于是早期版本，伙伴的行为逻辑（如寻路、战斗AI）可能还不够完善，可能会出现发呆、卡住或行为异常的情况。
未来开发方向
皮肤自动应用: 计划实现根据伙伴的命名，自动抓取并应用对应Minecraft玩家的皮肤。【已完成】
对话自定义: 开放更便捷的对话修改功能，让玩家可以轻松定制自己伙伴的台词。
装备兼容性: 增加对饰品栏（如Curios API）和远程武器（如弓、弩）的支持，让伙伴的能力更加全面。
UI与美术: 根本没有所以基本采取了原版相关图片
The 你好！伙伴【companionmod】 Team
