Verticality

Ever wanted a few more traversal options when you're out exploring? Want the ability to vault fences? Want to crawl through tight caves? Did you play Minecraft with Smart Moving and now you stare longingly at it and hope that one day it will be updated? Well, this mod may or may not be for you! 

This mod adds a number of new movement options. That number is now 3. Huzzah!

Current Moves

Climbing

To climb, just hold the climb button (R by default, rebindable in the options) and walk into a wall. If you move towards the wall you'll climb up, and away you'll climb down. 

But wait, it's a little more complicated that that. You can't just scale sheer faces like Spiderman: to be able to climb there has to be a ledge somewhere in range for you to grab onto. This range is from around roughly knee height to about half a block above your head. 

Pretty much any depression or indent in the face of a block will do. This includes chiselled-out sections: try chiselling ladders into your walls!

You can climb up to 2 block high faces from standing, or 3 blocks with a jump. If you want to push that just a little bit higher, however, you could try a charged jump (see below), which will get you up 4 blocks. 

You can also shimmy along ledges, although note that you must be looking towards ledge you want to move along. 

If you press jump while climbing, you'll jump off and away from the surface you're currently climbing on. Note that performing this move will prevent you from climbing for 1 second, unless you release and re-press the climb key!

Charged Jumping

Charged jumping allows you to jump about 25% higher than the standard jump. This may not sound like much, but with a bit of dexterity it lets you grab and climb up 4 blocks high, as well as neatly hop fences. 

To perform a charged jump, hold sneak and jump together for half a second, then release the jump key. Make sure you charge it for long enough; if you don't, you'll get a smaller jump. 

Crawling

There are several different ways to start crawling, all of which can be adjusted in the client config. The default method is to press your sneak and climb keys together to toggle sneaking. Additionally, if you press jump while sneaking, you'll stand up again. 

Client config options allow you to change the controls to a dedicated button, or a double-tap of sneak. You can also set it to be a hold rather than a toggle, though note that if you're using the options where you hold sneak with it you'll also be permanently sneak-crawling. You can combine these control options to your preference. 

When crawling, you can fit through smaller gaps (nominally 1-block high, though it can go a little bit tighter). 

Note that you can still climb while crawling! You can also sprint-crawl and sneak-crawl to go faster and slower respectively. 

Future Moves

(a.k.a. the todo list, or roadmap, or whatever)

• Climbing improvements
  • Animations
  • Adjust climb speed with move speed
  • Allow climb-jump to be performed at an angle, instead of always away from the block face
  • Make it so that soil/gravel/etc. can fall when grabbing
  • Make certain blocks always climbable, maybe (e.g. fences)
  • Food consumption
  • Further improvements to the ledge detection & grab logic
    
    • Still some edge (hah) cases to patch over, in which it either fails to detect a ledge or detects ledges where it shouldn't
• Crawling improvements
  • More restrictions
    • Tool/weapon use 
  • Animation improvements
    • Detect if feet are poking into another block and tuck them in
    • Animation for crawling while climbing?
  • Fixes
    • jump restriction may be stuck on sometimes. Workaround: crawl and then stand again. 
    • crawl animations for other players don't play the "moving" animation
    • slight delay on starting/stopping crawling
    • some weird collision issues after standing up?
• Handbook entry for all this
• Ropes
  • Just patch the vanilla rope physics so that you can adjust the length with a quick keybind
• Sliding & Diving
  • Dive into crawl if you start crawling while sprinting
  • Maybe also a cool baseball slide or something if you go from sprinting to sneaking
• Some kinda walljump/wallclimb thing, ideally with a bit of finesse needed to pull it off properly
• Some kind of quick-vault for getting onto/over waist-high obstacles while sprinting
• Probably a whole bunch more: I keep having ideas and then forgetting them ;-;

Configuration

There are several settings that can be configured. See the below for default settings and a brief explanation, although they are mostly fairly self-explanatory. 

{
  "climbMaxHeight": 0.7,
  "climbMinHeight": 0.5,

  "climbGrabDistance": 0.5,

  "climbJumpHForce": 5.0,
  "climbJumpVForce": 6.0,

  "climbSpeed": 1.5,

  "chargedJumpChargeTime": 0.5,
  "chargedJumpAddForce": 1.9

  "crawlSpeedReduction": -0.8
}

There is also a client config, primarily for changing controls options:-

{
  "showDebugParticles": false,

  "dedicatedCrawlKey": false,
  "combinationCrawlKeys": true,

  "standOnJump": true,

  "doubleTapSneakToCrawl": false,
  "doubleTapSpeed": 500,

  "holdCrawl": false
}