Capsule

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.

by
338.0K Downloads
forgeneoforgeadventuregame-mechanicsutility
Rent Server with this Mod

Screenshots

Deploy and recapture

About this Mod

Capsule mod

Capsule Mod Logo

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".

empty, stone button, empty - wood plank, chest, wood plank - empty, wood slab, empty

"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.

Cobblestone - Glass Pane - Cobblestone Cobblestone - Compass - Cobblestone Cobblestone - Torch - Cobblesto

"Capture Base" recipe

Then you need an empty capsule (the top item is a stone button) :

Empty - Stone Button - Empty Iron - Ender Pearl - Iron Empty - Iron - Empty

"Iron Empty Capsule" recipe, default capture size : 3x3x3

Empty - Stone Button - Empty Gold - Ender Pearl - Gold Empty - Iron - Empty

"Gold Empty Capsule" recipe, default capture size : 5x5x5

Empty - Stone Button - Empty Diamond - Ender Pearl - Diamond Empty - Iron - Empty

"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.

Demo deploy / undeploy

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.

Demo deploy / undeploy

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

check the wiki at https://github.com/Lythom/capsule/wiki

Available Versions

Capsule mod v8.0.105- for mc 1.20.1release
MC 1.20.1forge
September 1, 2025
Capsule mod v3.4.76 - for mc 1.12.2release
MC 1.12.2forge
September 1, 2025
Capsule mod v5.0.94 - for mc 1.16.5release
MC 1.16.5forge
September 1, 2025
Capsule mod v6.0.99 - for mc 1.18.2release
MC 1.18.2forge
September 1, 2025
Capsule mod v7.0.98 - for mc 1.19.2release
MC 1.19.2forge
September 1, 2025

How to Install Capsule on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.21.1).

3

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

forgeneoforge

Minecraft Versions

1.21.1, 1.20.4, 1.20.1 (+4 more)

Server-side

Required

Recommended 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.

Rent Modded Server

Install Capsule with just one click on your server.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Required

Supported Versions

1.21.11.20.41.20.11.19.21.18.21.16.51.12.2