Kettenkrad port (SDKFZ2)

BEFORE ANYTHING, YOU'LL HAVE TO INSTALL THE NEXT MODS SO YOU CAN BASICALLY RUN THIS MOD:

- Geckolib
- Embeddium
- Sodium Dynamic Lights

Please check the "relations" tab on this very page to download these dependencies.

I hope that most of the players nowday use embeddium. If not, i'll release a version that won't need embeddium as a requeriment, but i'll have to make my own dynamic light for the vehicle. 




## 📜 Credits & Acknowledgments


Special thanks to **@ivon852** for giving me permission to adapt and publish this amazing vehicle mod for Java Forge! 
Original MCBE Addon*: (https://mcpedl.com/sd-kfz-2-half-track-motorcycle-add-on/)




Kettenkrad (Sd.Kfz. 2) Half-Track Motorcycle

Welcome to the ultimate half-track vehicle experience for Minecraft Forge 1.20.1! This mod brings a highly detailed, mechanically advanced (SdKfz2) Kettenkrad to your world, combining the speed of a motorcycle with the terrain handling of a tracked vehicle. This isn't just a simple rideable mob—it features custom mechanics, an advanced HUD, dynamic seating, and modular storage expansions.





## ⚙️ Key Features *
- Realistic Mechanical System: Includes a functional gear system and realistic speed scaling. Perfect for scouting and exploring desolated terrain.
- Advanced Fuel HUD: Features a custom, immersive dynamic overlay tracking your speed, current gear, and fuel percentage.
Modular Upgrades (Inventory & Fuel):
 - Supply Crate: Attach a crate to expand your storage capacity. Need to remove it? Use a hoe to drop it back into an item while safely preserving its internal inventory, just like a Shulker Box! (you can only use while it is attached to the vehicle. Otherwise, it is impossible to open). 
- External Fuel Barrel: Need to go on long-distance journeys? Attach an external fuel barrel to increase your fuel capacity up to 200%, visually represented in the custom HUD.
- Dynamic AI & Passenger Support: Built-in compatibility for passengers and autonomous companion AIs. The vehicle intelligently shifts seating positions if a modular upgrade (like the crate) is blocking a seat!

 





Guide to use these in-game features - Crafting the SDKFZ2 and its modules:

In order to craft a SDKFZ2 and all the modules it relies on, follow the next recipes:

This new SDKFZ2 recipe will only work with the new recipe i'm working on for the 1.0.1 version. 

SDFKZ2:

x1 furnace
x3 iron blocks
x3 black concrete blocks




But now, we need to create the fuel for our vehicle to drive it:

OIL BUCKET

x6 coal
x1 water bucket




CRATE:

x6 iron ingots




Barrel:

x6 iron blocks
x3 iron ingots




First time using the Kettenkrad;

After crafting the motorcycle item, it's time to finally go for a ride!

just right-click the place where you want to spawn (avoid spawning it in closed or tight spaces) and behold!



It won't move without any fuel, so we'll have to refuel for the first time!

Equip your oil bucket item in your right hand, Shift towards the bike and then right click so you can begin to refuel your kettenkrad!

After holding Shift and clicking the vehicle, you can release both shift and click; the Kettenkrad's inventory will now be open. You can close it at any time using the Escape key. To keep refueling the vehicle, simply maintain your cursor's aim directly to it.

 

Driving the kettenkrad for the first time:



For these specifical versions of the mod (1.0/1.0.1) the kettenkrad will work like a boat. It won't be possible to choose the seat you want to sit on untill further updates. 



The kettenkrad has got different stats, such as gear, speed and fuel.


¿how do i drive it then?



You must first set your gear keys (by default V and B) and then, you must move forward or backward depeding on your gear and in your default W key to move. The S key will only work as a brake.




Kettenkrad Inventories:

The kettenkrad has 2 inventories, which are suitable for different situations.

by default, the kettenkrad will only have a single inventory with 18 slots. But later, you can attach a new 18 slots crate to the vehicle, so you can have 36 available slots. 

how do i open the inventory?

if you want to open the basic inventory, there are 2 ways to do it:

the first one is getting close to your motorcycle with the main hand empty, then hold shift and press right click and voila! 




anyway, if for any reason to need get access to it while driving, you can open the inventory with any key you want.



Installing/removing the crate and barrel

To set both barrel and crate into your motorcycle, just shift while holding the items in your main hand and they will set. 







now, if by any reason you want to deattach these updgrades or need to install them in another kettenkrad, you can remove them by using a hoe and crouching at the same time. (ONLY WORKS IN SURVIVAL MODE, DO NOT TRY IT IN CREATIVE MODE UNLESS YOU WANT TO LOOSE ALL YOUR ITEMS AND FUEL BARREL)




Now, how do we open the crate?

It is a mandatory thing to ride the vehicle to open the crate. there's no there option to open it. 
while riding the vehicle, just press the default or your preference key to get access to the crate:






and as i said, you can exchange the crates. they'll work as some sort of shulker box so its perfect to keep your items and even come up with different classes for your crates!




Refueling the fuel barrel.

To refuel the fuel barrel, the main kettenkrad which has got the barrel attached needs to be refueled first.

you'll know that your fuel barrel is full when the fuel percentage shows 200% and not 100% (100% corresponds to the average kettenkrad's fuel).

and in case that you need it, you can attach your fuel barrel to another kettenkrad with the complete amount of fuel you had poured earlier.





That's it for now, there's nothing else i have to explain for now.

Expect some bugs since i'm not a formal java developer, and this is my very first minecraft mod ever, and please, report any kind of issue you're having with the kettenkrad in the comments.


Planned updates for the future: 

- adding the possibility of self click detection for each seat.

- a new version that won't have dynamic light for those who might not be able to play with embeddium and Sodium dynamic lights.