Carried

<h1>Carried</h1> <p>&nbsp;</p> <p>Carry other players around: bridal, piggyback, firefighter, buddy carry, or hold hands. Each style has its own animations for both players and its own movement penalty.</p> <h2>Features</h2> <h3>Carry styles</h3> <ul> <li><strong>Bridal carry</strong> - one arm under the knees, one under the back <ul> <li>60% movespeed penalty<br /><br /></li> </ul> </li> </ul> <p><img src="https://i.imgur.com/Qjx7Jih.gif" alt="image" width="611" height="611" /></p> <ul> <li><strong>Piggyback</strong> - on the back, arms around the shoulders <ul> <li>45% movespeed penalty</li> </ul> </li> </ul> <p><br /><img src="https://i.imgur.com/2p1An6G.gif" alt="image" width="614" height="614" /></p> <ul> <li><strong>Firefighter carry</strong> - over the shoulder, head down <ul> <li>50% movespeed penalty</li> </ul> </li> </ul> <p><br /><img src="https://i.imgur.com/QC1P476.gif" alt="image" width="615" height="615" /></p> <ul> <li><strong>Buddy carry</strong> - side by side, arm over the shoulder<br /> <ul> <li>35% movespeed penalty<br /><br /></li> </ul> </li> </ul> <p><img src="https://i.imgur.com/0X8bM3B.gif" alt="image" width="618" height="618" /></p> <ul> <li><strong>Hold hands</strong> - walk next to each other. <ul> <li>Needs the initiator to have their left hand free and the other party to have their right hand free</li> <li>The initiator can sprint/crouch/sit, and the other party will follow along</li> <li>Both parties can give input for movement direction, but only the initiator can turn by looking</li> <li>40% movespeed penalty<br /><br /></li> </ul> </li> </ul> <p><img src="https://i.imgur.com/6osvsdZ.gif" alt="image" width="618" height="618" /></p> <h3>Picking someone up</h3> <ul> <li>Look at a player and hold <strong>Y</strong> to open the carry wheel, then move your mouse in the desired direction and release <strong>Y</strong></li> <li>The other player then gets a chat prompt to accept or refuse. Can be turned off by setting the <code>RequireConsent </code>config option</li> <li>Lifting takes 2 seconds (configurable), and movement cancels the timer</li> <li>Both your hands must be empty. Hold hands needs your left and their right hand free</li> <li>Open the wheel again while carrying to switch to another style</li> <li>You cannot attack, use items, or crouch while carrying someone. Taking something in a hand that should be empty ends the carry</li> <li>If you are under 15% max HP, you will drop whoever you are carrying.&nbsp;</li> </ul> <p>&nbsp;</p> <p><img src="https://i.imgur.com/QKTVpmr.png" alt="image" width="621" height="621" /></p> <h3>Putting down</h3> <ul> <li>Hold <strong>Shift + Y</strong> to put them down, or pick <strong>Let go</strong> in the wheel</li> <li>The carried player can use the same key to get off</li> <li>The carry also ends if you get too far apart, if the carrier starts swimming (configurable), if either of you dies, or if the carried player hits the carrier</li> </ul> <p>&nbsp;</p> <h3>Being carried</h3> <ul> <li>The camera view is about at the point where your head would be, but it's not rotated in any way</li> <li>Your view is limited to a cone around the direction the upper torso faces</li> <li>The visual head rotation angle has been increased to about 70 degrees (up from 45 degrees)</li> <li>While holding hands, you can walk to pull the carrier in your direction, so either player can lead. The camera turning is still only controlled by the initiator</li> <li>You cannot target the player you are attached to as the carrier</li> </ul> <p>&nbsp;</p> <h3>Carry editor</h3> <ul> <li>The mod comes with a built-in editor for authoring the pose changes as the size ratio changes</li> <li>It has some handy tools for adjusting the position and rotation of the shapes&nbsp;</li> <li>There is also a treadmill option to see it in action</li> <li>Access it with <code>.carryeditor</code> (requires you to be in Creative mode)</li> </ul> <p>&nbsp;</p> <p><img src="https://i.imgur.com/wPa2Vxf.png" alt="image" width="618" height="521" /></p> <h3>Different sizes</h3> <ul> <li>Poses are saved per size ratio and interpolated between, so a small player carried by a big one still properly sits</li> <li>A larger passenger slows the carrier down more, up to MaxSizePenaltyMultiplier, meaning at default values that if the carried person is 2x bigger, they will have 2x higher penalties&nbsp;</li> <li>MinWalkSpeed stops the penalty from making the carrier's movespeed 0</li> </ul> <p>&nbsp;</p> <p><img src="https://i.imgur.com/VqkTUrC.gif" alt="image" width="617" height="617" /></p> <p>&nbsp;</p> <h3>Adding your own styles</h3> <ul> <li>Carry styles are JSON files in <code>assets/carried/config/carrytypes/</code>, animations in <code>assets/carried/config/carryanimations/</code>. Any mod can add them without code</li> <li>The wheel icon is read from <code>textures/&lt;code&gt;.png</code> in your domain, the name from the lang key <code>type-&lt;code&gt;</code></li> <li>Styles can be built in-game with <code>.carryeditor</code> in creative mode</li> <li>If the server has a style your client does not, it is mentioned in the logs</li> </ul> <h2>Configuration</h2> <p>The config can be adjusted in <strong>carried.json</strong> or in-game via <a href="https://mods.vintagestory.at/configlib" target="_blank" rel="noopener">ConfigLib</a>.</p> <p>&nbsp;</p> <p><code>{</code><br /><code>&nbsp; "RequireConsent": true,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp;// Whether the other player has to accept the request first</code><br /><code>&nbsp; "CarryRange": 3,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; // Max distance in blocks to pick someone up</code><br /><code>&nbsp; "CarryMaxDistance": 6,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; // The carry ends by itself past this distance</code><br /><code>&nbsp; "PutDownHoldSeconds": 2,&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; // Seconds to hold Shif