Cpack

Cpack

A Fabric mod for Minecraft 1.21.11+ that lets you run .cpack and .mcfunction files as scripted command sequences — with wait, call, and full tab-completion support.

Made by Westires

What is Cpack?

Cpack works just like .mcfunction files, but stored per-world and with extra arguments (wait, call). You write plain command scripts, load them into your world, and run them with /cp run. All files are pre-parsed on world load — zero overhead at runtime.

File Location

Scripts are stored inside your world folder, not the global config:

saves/<WorldName>/cpack/<namespace>/<your_script>.cpack
saves/<WorldName>/cpack/<namespace>/subfolder/<your_script>.mcfunction

• `is any folder name you choose (e.g.myproject, demo`)
• Subfolders are supported at any depth
• Both .cpack and .mcfunction extensions are supported

Script Format

Identical to .mcfunction — one command per line. Comment lines starting with # are ignored.

# This is a comment
say Hello!
particle minecraft:end_rod ~ ~ ~ 0.5 0.5 0.5 0.1 20 normal
wait 10 tick
say 10 ticks later!
wait 2 second
call myproject:effects/firework.cpack

Extra Arguments

Note: wait suspends only the current script — the server keeps running normally. Multiple scripts can run in parallel.

Commands

All commands require operator level 2 (gamemaster) except /cp list.

All arguments support tab completion — loaded file names appear automatically.

Using inside /execute

/execute positioned ~ ~1 ~ run cp run demo:frames/frame_000.cpack

Example

File: saves/MyWorld/cpack/demo/fireworks.cpack

# Launch 3 firework bursts with delays
particle minecraft:firework_rocket ~ ~1 ~ 0.5 0.5 0.5 0.05 30 normal
wait 10 tick
particle minecraft:firework_rocket ~ ~1 ~ 0.5 0.5 0.5 0.05 30 normal
wait 10 tick
particle minecraft:firework_rocket ~ ~1 ~ 0.5 0.5 0.5 0.05 30 normal
say Fireworks done!

Run it:

/cp run demo:fireworks.cpack

Performance

• All files are pre-parsed on world load using Brigadier's parser — just like vanilla .mcfunction
• At runtime, only dispatcher.execute() is called — no re-parsing
• Command feedback (chat messages from commands like particle) is suppressed by default, matching mcfunction behavior
• Multiple scripts run in parallel with no artificial limits

Requirements

• Minecraft 1.21.11
• Fabric Loader 0.18.1+
• Fabric API 0.141.2+1.21.11

Installation

1. Install Fabric
2. Download Fabric API for 1.21.11
3. Drop cpack-1.0.0.jar into your .minecraft/mods/ folder
4. Launch the game and open a world
5. Create scripts in `saves//cpack//`

License

MIT — do whatever you want with it.