Gravity Anchors

Placeable anchors that warp local gravity. Mark a block (or place the custom Gravity Anchor item) and it becomes a gravity well. Right-click it to cycle through three field modes, and nearby entities get pulled, pushed, or launched by a capped, TPS-friendly velocity field.

What it does

Every couple of ticks each anchor scans for entities inside its radius and applies a velocity based on its current mode:

• Attract pulls entities inward, with the strength falling off over distance. Good for item collection and mob funnels.
• Repel pushes entities away.
• Launch fires entities up and outward on a timer, so you can build launch pads and traps.

Anchors stick around across restarts. Every velocity is clamped so nothing flies off the map, and busy areas are rate-limited to keep the server smooth.

Creating and using anchors

Look at a block and run /gravityanchor to mark it as an anchor. It starts in Attract mode.

You can also run /gravityanchor item to get a placeable Gravity Anchor, which is a glowing lodestone. Place it to create an anchor. Breaking the block removes the anchor, and in survival it drops the item back.

Right-click any anchor block to cycle the mode from Attract to Repel to Launch. The new mode shows on your action bar with a sound cue.

Commands

All under /gravityanchor (aliases: /ga, /gravity, /anchor).

Command	Description
/gravityanchor	Mark the block you are looking at as an anchor.
/gravityanchor mode <attract|repel|launch>	Set the mode of the anchor you are looking at.
/gravityanchor tune <radius|strength> <value>	Tune the looked-at anchor (radius capped at 32, strength at 5).
/gravityanchor item	Give yourself a placeable Gravity Anchor item.
/gravityanchor list	List registered anchors (with distance, in your world).
/gravityanchor remove	Remove the anchor you are looking at.
/gravityanchor clear	Remove ALL anchors. (admin)
/gravityanchor reload	Reload config.yml. (admin)
/gravityanchor info	Plugin info and current settings.

Permissions

Permission	Default	Grants
gravity.use	op	Create, tune, cycle, list, and remove anchors; get the item.
gravity.admin	op	clear and reload (includes gravity.use).

gravity.use gates all anchor creation and tuning. gravity.admin is a second tier for the destructive and global commands.

Configuration (config.yml)

Key	Default	Meaning
affect-players	true	Whether anchor fields move players at all.
exempt-sneaking	true	Sneaking players are ignored by all fields.
max-velocity	2.5	Hard cap (blocks/tick) on field-applied speed.
task-period-ticks	2	How often the field engine runs.
max-entities-per-anchor	60	Max entities one anchor processes per run.
trace-particles	true	Draw the dust ring/field outline.
launch-interval-ticks	30	How often Launch mode fires its impulse.
modes.<mode>.radius / .strength	per mode	Defaults applied when an anchor is created or switched to that mode.

Per-anchor tune overrides stick until you switch that anchor's mode.

Compatibility

Works on Paper, Spigot, Bukkit, and Purpur for 1.21.1 through 1.21.11 and the 26.1.x line (verified on 26.1.2), Java 21. Built against the Spigot API only (no Paper-only classes) for portability.

---

Original concept, an internal test idea, not from a Reddit post.