?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
Bikes Are Pain

Bikes Are Pain

A Minecraft mod that links real-world exercise bikes to in-game bicycles

584
9

Compatibility

Minecraft: Java Edition

1.21–1.21.1

Platforms

Supported environments

Client and server

75% of ad revenue goes to creators

Support creators and Modrinth ad-free with Modrinth+

Links

Report issues View source
Buy Me a Coffee

Creators

Kadmuffin
Kadmuffin Member

Details

Licensed MIT
Published 7 months ago
Updated 5 months ago

🚲 Bikes Are Pain

There is a pink bicycle in the foreground and the wheel of a green bicycle on the right-side peeking into the image. The bicycles are in a grassy area with a village in the background. Beyond the village, there is a large, tree-covered mountain under a clear blue sky with scattered clouds.

This mod allows you to control an in-game bicycle through real-world pedaling when linked to a fitness bike, combining gameplay with exercise. Without the fitness bike integration, it functions as a regular bicycle mod.

⚠️ Important Notice

  1. Server Compatibility: At this time, BikesArePain is not recommended for server use due to heavy packet traffic when using the real-world fitness bike integration (due to a lack of optimization). This may lead to performance issues or unstable gameplay.
  2. No Server Auto-Check: The mod will not auto-disable if the server does not have the mod installed.
  3. Alpha State: This mod is currently in alpha stage. Core functionalities are implemented, but further refinement, optimizations, and feature additions are needed.

📕 Features

  • Functional in-game bicycle
  • Pedometer to keep track of biking data
  • Dyeable bicycle parts
  • Optional integration with real-world fitness bikes (through Arduino)

📌 Quick Start

  1. Download the latest .jar file.
  2. Place the .jar in your Minecraft mods folder.
  3. Install Dependencies:
  4. To use the fitness bike integration, modify the Arduino sketch to fit your setup (a guide is coming soon).

🚩 Known Issues

  • No server auto-checks: Joining a server without the mod won't automatically disable the features.
  • Server traffic concerns: Excessive packet traffic when using the fitness bike integration or certain features.
  • Pitch sync issues: Bicycle pitch synchronization is one-way, from the client to the server.
  • Bad Accesiblity: The Narrator isn't currently used to communicate information.
  • Serial connection bugs: Fitness bike linking is unstable. Auto-connect often fails or connections drop mid-session.
  • Model inconsistencies: The in-game bike model has inconsistent part naming.
  • Bad Geckolib Usage: Model animations and movement rely on a hacky implementation and require a rewrite.

🌿 Planned Features

  • Unit tests for the codebase
  • Code refactoring for performance improvements
  • Workout session visualization UI
  • Configurable workout goals
  • Advancements based on exercise achievements
  • New bike types (e.g., mountain bike, motorbike)
  • Server-side configuration options

👓 Dependencies

This mod requires the following libraries:

📝 License

BikesArePain is licensed under the MIT License. See the LICENSE for details.

This mod uses jSerialComm for serial communication under the Apache 2.0 License. For other third-party software licenses, check THIRD_PARTY_LICENSES.

⚙️ Support

Found a bug or have a suggestion? Please open an issue on the GitHub repository.

Enjoy the ride and stay fit!