
Capsule
Bring your base! Capsules can capture a region containing any blocks or machines, then deploy and undeploy at will. Inspired by Dragon Ball capsules.
Screenshots

About this Mod
Capsule mod

Bring your base! Capsules can capture a region containing any blocks or machines, then deploy and undeploy at will. Inspired by Dragon Ball capsules.
Join us on Discord ! https://discord.gg/wZpBVdr
Detailed documentation on the wiki : https://github.com/Lythom/capsule/wiki
Biggest Features
- Move you base! An entire base packed in a 31x31x31 can be moved entirely including machines. You can be a real traveler now.
- Build faster with blueprints! Blueprint capsules can take materials from chests or other inventories to duplicate a structure. It supports rotation and mirror.
- Modpack making options, so that player can be rewarded with ready to deploy structures or loot them in chests.
- A ton of possibilities ! Capsules can be used as early backpack moving a chest, as portable ladder, to deploy protecting walls to recover during a fight, to move machines or multiblocks, and more… unleash your creativity !
Getting started
The first capsule you will have access to is made of wood. It's size is 1x1x1 which enables the "instant mode".
"Wooden capsule" recipe
It means you can capture any block (ie. a chest or a crafting table) by right clicking it, then deploy and undeploy it instantly by right clicking again with the capsule in hand.
If right click open a GUI, try to capture from a distance or while sneaking.
Getting bigger
To get to the big things, you first need a capture base. This is where you can initialize a capsule with it's first content. You'll be able to capture the region on top of it.
"Capture Base" recipe
Then you need an empty capsule (the top item is a stone button) :
"Iron Empty Capsule" recipe, default capture size : 3x3x3
"Gold Empty Capsule" recipe, default capture size : 5x5x5
"Diamond Empty Capsule" recipe, default capture size : 7x7x7
Obsidian (9x9x9) and Emerald (11x11x11) capsules also exists, check JEI !
Empty Capsule
Throw it near the capture base !
- Right click : activate
- Right click while activated : throw the capsule.
- Once the content is captured, the capsule can be deployed or undeployed at will.
Initial capture
Note that all the capsule can be dyed (affect the base color) and labeled (sneak + right click).
Linked capsule
- Deploy : Right click once to activate, right click again to throw at the preview positions (are ahead not aiming a block).
- Undeploy : Right click the "Deployed" capsule and the content will be stored again into the capsule, whereever it currently is.
- Label : Sneak + Right click to open the label editing screen.
Deploy / undeploy
Rotations
Linked capsules can be rotated and mirrored by players using left click / shift+left click while previewing deloyment. All vanilla blocks and non-living entities (minecarts,etc) are supported but modded blocks with specific behaviours (machines, etc.) will prevent a rotation by default to prevent messing with specific considerations with their orientation that capsule cannot know.
The "canRotate" state might need to be updated when you first acquire a standard capsule (blueprints will always rotate), if rotation is locked and you think it should work, deploy and undeploy the capsule to update it and be able to rotate. If it still can't: there is a special block in the content that does not support rotation.
As a modpack maker, if you want capsule to still try to rotate some specific modded block, you can whitelist them for blueprints and it will allow the block both to rotate in regular capsules and be used in blueprints. Checkout the [Blueprint whitelist section](https://github.com/Lythom/capsule/wiki/Modpack-making#whitelist).
Other features and modpack doc
Wiki
Available Versions
How to Install Capsule on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set forge Loader
In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Capsule". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1, 1.20.4, 1.20.1 (+4 more)
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Capsule server crashes on startup – what to do?
Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Capsule compatible with forge and neoforge?
Capsule officially supports forge, neoforge for Minecraft 1.21.1, 1.20.4, 1.20.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Capsule – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Capsule consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Capsule with just one click on your server.






