

Modrinth · Fabric
Blackhole on your Minecraft server
Blackhole runs on Minecraft servers with Fabric. Order your server, set the loader in the panel and install the mod with one click in the mod browser.
A Server Side Blackhole Mod That Follows You
- Downloads
- 13.3K
- Author
- –
- Loader
- Fabric
- Minecraft
- 1.21 – 1.21.9
- Updated
- –
Screenshots
What Blackhole looks like
Images: Blackhole on Modrinth, published by the project team.
Setup
Install Blackhole on your server
The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.
- 01
Configure
4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.
- 02
Set the loader
In the panel, set the server software to Fabric and choose the matching Minecraft version, for example 1.21.9.
- 03
Install the mod
Search the mod browser for “Blackhole” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.
- 04
Connect
Blackhole is not needed on the client. Players connect using the server address from the panel.
- On the server
- Required
- On the client
- Not needed
- Loader
- Fabric
- Minecraft
- 1.21.9, 1.21.8, 1.21.7 +6 more
- License
- LicenseRef-All-Rights-Reserved
The panel
Install mods, find errors.
Real screenshots from the Mado panel. Both come with every Minecraft server.
Mod browser
Modrinth and CurseForge, right in the panel.
The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

AI crash analysis
When a mod crashes, the analyzer reads the log.
Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Releases
Published releases
Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.
Blackhole · ModrinthOriginal description by the project author
Black Hole Mod
A Minecraft mod that adds destructive, dynamic black holes to your world.
- Github: https://github.com/IDoTheHax/Blackhole
- Modrinth: https://modrinth.com/mod/blackhole
- Discord: https://discord.com/faPd8MQ3Ke
- Youtube:
Overview
The Black Hole mod introduces a new block that creates a simulated black hole in your Minecraft world. These black holes have realistic gravitational effects, pulling in nearby entities and blocks. They can grow over time, follow players, and cause destruction in their path.
PSA: DONT USE THIS IN YOUR WORLD WITHOUT MAKING A BACKUP!!
Features
- Realistic Physics: Black holes exert gravitational force on nearby entities and blocks based on configurable mass values
- Growing Black Holes: Black holes can expand over time, increasing their area of effect
- Player Tracking: Black holes can follow players within a configurable range
- Visual Effects: Features customizable particle effects for an immersive experience
- Fully Configurable: All aspects of black hole behavior can be adjusted via commands or configuration file
- Creative Mode Integration: Black hole item available in both custom creative tab and vanilla Redstone Blocks tab
Texture Pack
This mod uses Polymer for custom rendering and requires a texture pack for the black hole visuals. Use the /polymer generatepack command in-game to create a default texture pack, then drag the generated pack (named resource_pack in the polymer folder) into your resources folder or use a serverside resource pack. See the Polymer Documentation for more details.
Commands
All commands require operator permission level 2 or higher and begin with /blackhole:
Configuration Commands
| Command | Description |
|---|---|
getmaxscale / setmaxscale <value> |
Get/set maximum size a black hole can grow to |
getgravity / setgravity <value> |
Get/set gravitational constant |
getplayermass / setplayermass <value> |
Get/set mass value for players |
getblockmass / setblockmass <value> |
Get/set mass value for blocks |
getitementitymass / setitementitymass <value> |
Get/set mass value for item entities |
getanimalmass / setanimalmass <value> |
Get/set mass value for animal entities |
getchunkloadradius / setchunkloadradius <value> |
Get/set radius of chunks to force-load around a black hole |
getmaxblockspertick / setmaxblockspertick <value> |
Get/set maximum blocks processed per tick |
getmovementspeed / setmovementspeed <value> |
Get/set movement speed of following black holes |
getdefaultfollowrange / setdefaultfollowrange <value> |
Get/set default range for black holes to detect players |
getplayerdetectioninterval / setplayerdetectioninterval <value> |
Get/set ticks between player detection checks |
getgrowthrate / setgrowthrate <value> |
Get/set growth rate for black holes |
getparticles / toggleparticles |
Get/toggle particle effects on/off globally |
Black Hole Manipulation Commands
| Command | Description |
|---|---|
togglefollow |
Toggle whether the nearest black hole follows players |
togglegrowth |
Toggle whether the nearest black hole grows over time |
setfollowrange <range> |
Set the follow range for the nearest black hole |
kill |
Permanently remove the nearest black hole and its visuals (requires server-side 1.21.11+ features) |
Configuration
The mod creates a configuration file at config/black_hole.json with the following default values:
{
"maxScale": 40.0,
"gravity": 60.0,
"playerMass": 700.0,
"blockMass": 10.0,
"itemEntityMass": 0.1,
"animalMass": 50.0,
"chunkLoadRadius": 2,
"maxBlocksPerTick": 500,
"movementSpeed": 1.0,
"defaultFollowRange": 256.0,
"playerDetectionInterval": 60,
"growthRate": 0.04,
"particlesEnabled": true
}
Configuration Properties
| Property | Description | Default |
|---|---|---|
maxScale |
Maximum size a black hole can grow to | 40.0 |
gravity |
Gravitational constant affecting pull strength | 60.0 |
playerMass |
Mass value for players (affects how strongly they're pulled) | 700.0 |
blockMass |
Mass value for blocks | 10.0 |
itemEntityMass |
Mass value for item entities | 0.1 |
animalMass |
Mass value for animal entities | 50.0 |
chunkLoadRadius |
Radius of chunks to force-load around a black hole | 2 |
maxBlocksPerTick |
Maximum blocks processed per tick (performance setting) | 500 |
movementSpeed |
Movement speed when following players | 1.0 |
defaultFollowRange |
Default range for black holes to detect players | 256.0 |
playerDetectionInterval |
Ticks between player detection checks | 60 |
growthRate |
How quickly black holes grow in size | 0.04 |
particlesEnabled |
Whether particle effects are enabled globally | true |
Behavior Notes
- Black holes will consume any entity that gets too close to its center
- Creative mode players are immune to black hole effects
- Black holes can break most blocks but cannot break blocks with infinite hardness (like bedrock)
- Black holes can be configured to not follow players or to stop growing
- Black holes will create falling block entities from some destroyed blocks for visual effect
- Each black hole maintains its own settings for following and growth
- Particle effects can be toggled off for better performance on servers or lower-end systems
- The black hole item can be found in the custom "BlackHole" creative tab or in the vanilla Redstone Blocks tab
Technical Information
- Built with Fabric and Polymer for vanilla client compatibility
- Uses chunk force-loading to ensure black holes function even when players are distant
- Implements custom block entity with tick-based behavior
- Supports server-side resource packs for texture distribution
Known Issues
- Black Hole Rendering Issue: The black hole often looks like the circle is moving when the player changes their view, this is due to the display mode of the item display being set to billboard, advanced maths that i dont understand is required to fix this.
- Render Distance Issue: The black hole disappears when moving too far away, even within typical render distances, due to entity rendering limitations.
Any fixes found can be submitted through a Pull request on the Github: https://github.com/IDoTheHax/Blackhole
Don't Hesitate to add your fixes!!
Compatibility
This mod is built for Fabric and requires:
- Fabric API
- Polymer
License
All Rights Reserved - IDoTheHax 2025
Credits
Created by IDoTheHax
Blackhole server crashes on startup – what to do?
Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.
Which loader does Blackhole run on?
According to Modrinth, Blackhole supports Fabric for Minecraft 1.21.9, 1.21.8, 1.21.7.
How much RAM does a server with Blackhole need?
As guidance, 3–4 GB for a server with this mod. This is an estimate, not a measured minimum. More mods, many players and long view distances need more. The spark profiler shows whether a mod is costing tick time.
Similar mods
Popular mods in the same category
Server-ready
Xaero's Minimap
by thexaero
Displays a map of the nearby world terrain, players, mobs, entities in the corner of your screen. Lets you create waypoints which help you find the locations you've marked.
Server-ready
Xaero's World Map
by thexaero
Adds a full screen world map which shows you what you have explored in the world. Works great together with Xaero's Minimap.
Client only
Not Enough Animations
by tr7zw
Bringing first-person animations to the third-person
Client only
3D Skin Layers
by tr7zw
Render the player skin layer in 3d!
Ready for your server with Blackhole?
4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.
