Dynamic GameRules & Configuration — MC 26.3

This page provides the exhaustive configuration reference, GameRule commands, permissions, and client GUI integration for Max Elytra Fly Speed (MC 26.3).

📋 Subsystem Infobox

Parameter	Technical Details
Configuration Engine	Namespaced Dynamic GameRules via `DynamicGameRuleManager` (DasikLibrary)
GameRule Category	`max-elytra-fly-speed:max-elytra-fly-speed`
Storage Mechanism	World Save Data (`level.dat` / vanilla GameRules system)
Dedicated Server Dependency	Zero external config libraries required on servers
Optional Client GUI	ModMenu (`>=0.19.3`) + Cloth Config (`me.shedaniel.clothconfig2`)
Permission Requirement	Operator Level 2 (`requires(source -> source.hasPermission(2))`)

🎮 Administrator Workflow & Commands

All settings are configured natively in-game or via server console using standard vanilla /gamerule commands. Changes take effect instantly without restarting the server or reconnecting players.

1. View Current GameRule Values

mcfunction

/gamerule max-elytra-fly-speed:max_elytra_fly_speed
/gamerule max-elytra-fly-speed:elytra_initial_boost_speed
/gamerule max-elytra-fly-speed:elytra_high_speed_acceleration

2. Set Custom Flight Speed Limits

mcfunction

# Set maximum Elytra flight speed ceiling to 150 Blocks/Second
/gamerule max-elytra-fly-speed:max_elytra_fly_speed 150

# Set initial snappy rocket boost speed to 40 Blocks/Second
/gamerule max-elytra-fly-speed:elytra_initial_boost_speed 40

# Set high-speed rocket acceleration rate to 25% per tick
/gamerule max-elytra-fly-speed:elytra_high_speed_acceleration 25

📑 Exhaustive GameRules Reference Table

GameRule Identifier	Data Type	Default Value	Valid Range	Localized Name	Functional Description
`max-elytra-fly-speed:max_elytra_fly_speed`	`Integer`	`50`	`1` to `2147483647`	Max Speed (Blocks/Sec)	Hard ceiling for Elytra fall-flying velocity in Blocks/Second. Relaxed aerodynamic drag scaling applies above 50 BPS.
`max-elytra-fly-speed:elytra_initial_boost_speed`	`Integer`	`30`	`1` to `2147483647`	Initial Boost Speed	Velocity threshold (Blocks/Second) up to which snappy vanilla rocket boost ($50%$ convergence) is applied.
`max-elytra-fly-speed:elytra_high_speed_acceleration`	`Integer`	`15`	`1` to `1000`	High Speed Acceleration	High-speed rocket acceleration percentage ($15 \implies 15%\text{ per tick}$) applied above the initial boost speed.

📊 Visual Configuration Architecture

                    [ DEDICATED SERVER / WORLD HOST ]
                                    |
            +-----------------------+-----------------------+
            |                                               |
   [ Vanilla /gamerule CLI ]                     [ DynamicGameRuleManager ]
            |                                               |
            v                                               v
  [ level.dat GameRules ] <===============> [ World Save & Fast Access Cache ]
                                                            |
                                    +-----------------------+-----------------------+
                                    |                                               |
                                    v                                               v
                        [ LivingEntityMixin ]                          [ FireworkRocketEntityMixin ]
                        • Dynamic Drag Scaling                         • Two-Tier Propulsion Boost
                        • Velocity Clamping                            • Vector Convergence

🖥️ Optional Client GUI Integration

When playing in Singleplayer or LAN worlds with client configuration mods installed:

ModMenu Integration: Max Elytra Fly Speed implements ModMenuApi in net.instantgratification.maxelytraflyspeed.config.ModMenuIntegration.
Cloth Config Builder: If cloth-config is present in the mods folder, clicking Configure in ModMenu opens the configuration screen constructed by ClothConfigScreenHelper.java.
Headless Server Safety: If Cloth Config is absent, the mod cleanly falls back without classloading errors or crashes on dedicated servers.

🌐 Complete Localization Keys (`en_us.json`)

json

{
  "gamerule.category.max-elytra-fly-speed.max-elytra-fly-speed": "Max Elytra Fly Speed",
  "gamerule.max-elytra-fly-speed.max_elytra_fly_speed": "Max Speed (Blocks/Sec)",
  "gamerule.max-elytra-fly-speed.max_elytra_fly_speed.description": "Maximum velocity of Elytra flight in Blocks/Second. Default: 50 blocks/sec.",
  "gamerule.max-elytra-fly-speed.elytra_initial_boost_speed": "Initial Boost Speed",
  "gamerule.max-elytra-fly-speed.elytra_initial_boost_speed.description": "Speed threshold (Blocks/Second) up to which snappy vanilla rocket boost is applied. Default is 30.",
  "gamerule.max-elytra-fly-speed.elytra_high_speed_acceleration": "High Speed Acceleration",
  "gamerule.max-elytra-fly-speed.elytra_high_speed_acceleration.description": "High-speed acceleration rate percentage above initial boost speed. Default is 15 (15% per tick)."
}

💻 Developer & Addon Extension Hooks

To query GameRule values programmatically from addons or custom server plugins:

java

import net.dasik.social.api.gamerule.DynamicGameRuleManager;
import net.instantgratification.maxelytraflyspeed.MaxElytraFlySpeedFabric;
import net.minecraft.world.level.Level;

public class FlightDiagnostics {
    public static void logConfiguredCeiling(Level level) {
        int maxSpeedBps = DynamicGameRuleManager.getInt(level, MaxElytraFlySpeedFabric.MAX_ELYTRA_FLY_SPEED);
        double maxSpeedTicks = maxSpeedBps / 20.0;
        System.out.println("Current flight ceiling: " + maxSpeedBps + " BPS (" + maxSpeedTicks + " blocks/tick)");
    }
}

Dynamic GameRules & Configuration — MC 26.3 ​

📋 Subsystem Infobox ​

🎮 Administrator Workflow & Commands ​

1. View Current GameRule Values ​

2. Set Custom Flight Speed Limits ​

📑 Exhaustive GameRules Reference Table ​

📊 Visual Configuration Architecture ​

🖥️ Optional Client GUI Integration ​

🌐 Complete Localization Keys (en_us.json) ​

💻 Developer & Addon Extension Hooks ​

🧭 Navigation ​