# \ud83d\udeb2 Bikes Are Pain<\/p>\n
<\/p>\n
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.<\/p>\n
## \u26a0\ufe0f Important Notice<\/p>\n
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.
\n2. **No Server Auto-Check**: The mod will not auto-disable if the server does not have the mod installed.
\n3. **Alpha State**: This mod is currently in alpha stage. Core functionalities are implemented, but further refinement, optimizations, and feature additions are needed.<\/p>\n
## \ud83d\udcd5 Features<\/p>\n
– Functional in-game bicycle
\n– Pedometer to keep track of biking data
\n– Dyeable bicycle parts
\n– Optional integration with real-world fitness bikes (through Arduino)<\/p>\n
## \ud83d\udccc Quick Start<\/p>\n
1. **Download** the latest `.jar` file. ## \ud83d\udea9 Known Issues<\/p>\n – **No server auto-checks**: Joining a server without the mod **won’t automatically disable the features**. ## \ud83c\udf3f Planned Features<\/p>\n – Unit tests for the codebase ## \ud83d\udc53 Dependencies <\/p>\n This mod requires the following libraries: <\/p>\n – **Geckolib** \u2013 For animations ## \ud83d\udcdd License<\/p>\n BikesArePain is licensed under the **MIT License**. See the LICENSE for details.<\/p>\n This mod uses **jSerialComm** for serial communication under the Apache 2.0 License. For other third-party software licenses, check THIRD_PARTY_LICENSES.<\/p>\n ## \u2699\ufe0f Support <\/p>\n Found a bug or have a suggestion? Please open an issue on the GitHub repository.<\/p>\n Enjoy the ride and stay fit!<\/p>\n","protected":false},"excerpt":{"rendered":" A Minecraft mod that links real-world exercise bikes to in-game bicycles<\/p>\n","protected":false},"featured_media":31019,"template":"","meta":{"_minecraft_slug":"bikes-are-pain","_minecraft_project_id":"J5maEpWu","_minecraft_author":"Kadmuffin","_minecraft_license":"MIT","_minecraft_downloads":2108,"_minecraft_follows":14,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bikes-are-pain.zip","_minecraft_size_bytes":7591941,"_minecraft_version_count":8,"_minecraft_updated_at":"2026-05-15T23:57:44.694176Z","_minecraft_date_created":"2024-09-26T00:28:29.832444Z","_minecraft_date_modified":"2024-11-28T23:09:52.958735Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bikes-are-pain","_minecraft_icon_attachment_id":31019,"_minecraft_imported_at":"2026-06-01T13:28:44+00:00","_minecraft_import_hash":"0255b0607cff999f9630ba75437909a1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,43,97,158,869],"mod_loader":[99],"minecraft_version":[62,37],"class_list":["post-31018","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-cursed","mod_category-fabric","mod_category-neoforge","mod_category-transportation","mod_loader-fabric","minecraft_version-1-21","minecraft_version-1-21-1"],"yoast_head":"\n
\n2. **Place** the `.jar` in your Minecraft `mods` folder.
\n3. **Install Dependencies**:
\n – Geckolib
\n – YetAnotherConfigLib
\n – ArchitecturyAPI
\n4. To use the fitness bike integration, modify the Arduino sketch to fit your setup (a guide is coming soon).
\n – Arduino Sketch
\n – Run the command `\/bikes open
\n– **Server traffic concerns**: Excessive packet traffic when using the fitness bike integration or certain features.
\n– **Pitch sync issues**: Bicycle pitch synchronization is one-way, from the client to the server.
\n– **Bad Accesiblity**: The Narrator isn’t currently used to communicate information.
\n– **Serial connection bugs**: Fitness bike linking is unstable. Auto-connect often fails or connections drop mid-session.
\n– **Model inconsistencies**: The in-game bike model has inconsistent part naming.
\n– **Bad Geckolib Usage**: Model animations and movement rely on a hacky implementation and require a rewrite.<\/p>\n
\n– Code refactoring for performance improvements
\n– Workout session visualization UI
\n– Configurable workout goals
\n– Advancements based on exercise achievements
\n– New bike types (e.g., mountain bike, motorbike)
\n– Server-side configuration options<\/p>\n
\n– **YetAnotherConfigLib** \u2013 For configuration
\n– **ArchitecturyAPI** \u2013 For cross-modloader support<\/p>\n