ElytraPlus - Enhanced Elytra Flight for Minecraft 1.20.1

ElytraPlus is a Forge mod that enhances the Elytra flight experience in Minecraft 1.20.1, inspired by popular anarchy client implementations.

Features

• Infinite Flight: Fly indefinitely without rockets
• Speed Boost: Configurable flight speed multiplier (up to 10x)
• Better Control: Enhanced control and stability
• Configurable: All features can be toggled and configured
• Keybinds: Quick toggle features with customizable keybinds
• Commands: Server-side commands for configuration
• Visual Feedback: Optional flight status display
• Custom Elytra Support: Add support for elytra items from other mods via config

Installation

1. Download and install Minecraft Forge 1.20.1 (version 47.2.0 or later)
2. Download the ElytraPlus mod JAR file
3. Place the JAR file in your mods folder
4. Launch Minecraft with the Forge profile

Configuration

In-Game Commands

All commands require OP level 2:

• /elytraplus toggle infinite [true/false] - Toggle infinite flight
• /elytraplus toggle speed [multiplier] - Set flight speed (0.1-10.0)
• /elytraplus toggle control [true/false] - Toggle better control
• /elytraplus toggle status [true/false] - Toggle status display
• /elytraplus config - Show current configuration
• /elytraplus help - Show help message

Keybinds (Default)

• F - Toggle Infinite Flight
• G - Cycle Speed Boost (1.0x → 1.5x → 2.0x → 2.5x → 3.0x → 1.0x)
• H - Toggle Better Control
• J - Toggle Flight Status Display

Config File

The mod creates a config file at config/elytraplus-client.toml with the following options:

# Flight Settings
infiniteFlightEnabled = true
flightSpeedMultiplier = 2.0
betterControlEnabled = true
controlSensitivity = 1.5

# Visual Settings
showFlightStatus = true
particleEffects = false

# Safety Settings
autoLandOnDamage = false
maxFlightHeight = 0.0

# Custom Elytra Support
# A list of item IDs for other elytra items to be supported by the mod.
# Example: elytraItems = ["modid:elytra_item_name", "anothermodid:another_elytra"]
elytraItems = []

Compilation Guide

Prerequisites

1. Java Development Kit (JDK) 17 or later
2. Git (for version control)
3. Gradle (will be downloaded automatically)

Step-by-Step Compilation

1. Clone or Download the Project

   git clone <your-repo-url>
   cd ElytraPlus

2. Verify Java Version

   java -version

   Make sure you have JDK 17 or later installed.

3. Build the Mod

   ./gradlew build

   On Windows:

   gradlew.bat build

4. Find the Compiled JAR The compiled mod will be located at:

   build/libs/elytraplus-1.0.0.jar
   

5. Install the Mod Copy the JAR file to your Minecraft mods folder:

   %appdata%\.minecraft\mods\  (Windows)
   ~/.minecraft/mods/          (Linux/Mac)
   

Development Setup

If you want to modify the code:

1. Import into IDE

   • IntelliJ IDEA: Open the project folder
   • Eclipse: Import as Gradle project
   • VS Code: Install Java extension pack

2. Run in Development

   ./gradlew runClient

3. Generate IDE Files

   ./gradlew genEclipseRuns  # For Eclipse
   ./gradlew genIntellijRuns # For IntelliJ

Troubleshooting

Build Fails with Java Version Error:

• Ensure you have JDK 17+ installed
• Set JAVA_HOME environment variable
• Use ./gradlew build --info for detailed error messages

Mod Doesn't Load:

• Check Minecraft Forge version compatibility
• Verify the mod is in the correct mods folder
• Check the logs for error messages

Keybinds Not Working:

• Go to Options → Controls → ElytraPlus category
• Reassign keybinds if needed
• Ensure no conflicts with other mods

Technical Details

• Minecraft Version: 1.20.1
• Forge Version: 47.2.0+
• Java Version: 17+
• Mod ID: elytraplus

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

Support

For issues and support:

1. Check the troubleshooting section
2. Search existing issues
3. Create a new issue with detailed information

Disclaimer

This mod is for educational and entertainment purposes. Use responsibly and in accordance with server rules and Minecraft's Terms of Service.