Jump Circle

Jump Circle 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
• Mod Menu support
• Multi-language UI
• Multiple circle modes
• Object pooling and distance culling
• Safe config recovery
• Fail-soft behavior for missing world/player/config state

Circle Modes

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

Settings

Jump Circle includes a built-in settings screen.

General

• Enabled
• Circle Mode
• Animation Easing
• Lifetime

Shape

• Radius
• Thickness
• Opacity
• Segment Count

Colors

• Primary Color
• Gradient Color
• RGB Animation Speed

Performance

• Render Distance
• Ground Offset
• Maximum Active Effects

Settings are saved to:

config/jumpcircle.json

Supported Versions

Built jars are available for:

Minecraft
1.21
1.21.1
1.21.2
1.21.3
1.21.4
1.21.5
1.21.6
1.21.7
1.21.8
1.21.9
1.21.10
1.21.11
26.1
26.1.2
26.2

Minecraft 1.21 through 1.21.11 requires Java 21.
Minecraft 26.1, 26.1.2, and 26.2 require Java 25.

Installation

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

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

Optional: install Mod Menu to open the Jump Circle settings screen from the mods list.

Compatibility

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

Manual compatibility test targets:

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

These are manual test targets, not full compatibility certifications. Mods that heavily modify world rendering may require additional testing.

Performance

Jump Circle is designed for high-FPS gameplay.

Performance goals:

• High FPS
• Minimized allocations in Jump Circle's render path
• Object pooling
• Distance culling
• Efficient custom geometry rendering
• No vanilla particles
• No unnecessary world scanning

Localization

Included languages:

• English (en_us)
• German (de_de)
• Spanish (es_es)
• French (fr_fr)
• Japanese (ja_jp)
• Polish (pl_pl)
• Portuguese, Brazil (pt_br)
• Russian (ru_ru)
• Turkish (tr_tr)
• Ukrainian (uk_ua)
• Chinese Simplified (zh_cn)

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