JumpCircle

JumpCircle is a lightweight client-only Fabric mod that adds polished animated jump circles under your player.

When you jump, the mod renders a custom world-space circle at the ground position where the jump started. The effect expands, fades, and stays fixed in the world. It uses custom geometry instead of vanilla particles.

Features

• Client-side only
• Custom rendered jump circles
• No vanilla particles
• Fixed world-space spawn position
• Smooth partial-tick animation
• In-game settings menu
• Multi-language UI
• Multiple circle modes
• Optimized for high-FPS gameplay
• Object pooling and distance culling
• Safe config recovery
• Fail-soft compatibility behavior

Circle Modes

• Classic – one clean expanding ring
• Double – inner and outer ring
• Shockwave – filled center that opens into a ring
• Gradient – blends between two configurable colors
• RGB – animated rainbow ring
• Glow – glow-style ring without shader dependencies
• Hexagon – animated hexagonal ring

Settings

JumpCircle includes a built-in settings screen.

General

• Enabled
• Circle Mode
• Animation Easing
• Lifetime

Shape

• Radius
• Thickness
• Opacity
• Segment Count

Colors

• Primary Color
• Secondary Color
• Gradient Color
• RGB Settings

Performance

• Render Distance
• Ground Offset
• Maximum Active Effects
• RGB Animation Speed

Settings are saved to:

config/jumpcircle.json

Supported Versions

Built jars are available for:

| Minecraft |
| --------- |
| 1.21.11 |

Some versions may require different Java versions depending on Minecraft requirements.

Compatibility

JumpCircle is built for Fabric and designed to work alongside common client-side mods.

Compatibility test targets:

• Sodium
• Iris
• Mod Menu
• Inventory Profiles Next
• Mouse Tweaks
• Shulker Box Tooltip
• ReplayMod

Mods that heavily modify world rendering may require additional testing.

Installation

1. Install Fabric Loader for your Minecraft version.
2. Install Fabric API for your Minecraft version.
3. Download the matching JumpCircle version.
4. Place the jar into your mods folder.
5. Launch Minecraft.

This is a client-only mod and is not required on servers.

Performance

JumpCircle is designed for competitive gameplay.

Performance goals:

• High FPS
• Minimal render allocations
• Object pooling
• Distance culling
• Efficient custom geometry rendering
• No vanilla particles
• No unnecessary world scanning

Localization

Included languages:

• English (en_us)
• German (de_de)
• Russian (ru_ru)
• Ukrainian (uk_ua)
• French (fr_fr)
• Spanish (es_es)
• Italian (it_it)
• Portuguese (pt_br)
• Polish (pl_pl)
• Turkish (tr_tr)
• Dutch (nl_nl)
• Czech (cs_cz)
• Hungarian (hu_hu)
• Chinese Simplified (zh_cn)
• Chinese Traditional (zh_tw)
• Japanese (ja_jp)
• Korean (ko_kr)

Manual Test Plan

1. Join a world.
2. Jump normally.
3. Sprint jump.
4. Spam jump repeatedly.
5. Switch circle modes.
6. Change colors.
7. Change GUI scale.
8. Switch dimensions.
9. Disconnect and reconnect.
10. Test with Sodium.
11. Test with Iris.
12. Verify FPS stability with many active effects.

Roadmap

Planned features:

• Astolfo Colors
• Advanced RGB Modes
• Trail Circles
• Rune Circles
• Water Ripple Effects
• Shader-Based Glow
• Texture Atlas Support
• Effect Presets
• Custom Circle Editor

License

MIT