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

• <namespace> 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

Argument	Example	Description
wait <n> tick	wait 5 tick	Waits n ticks before executing the next line
wait <n> second	wait 2 second	Waits n seconds (n × 20 ticks) before the next line
call <namespace:path>	call demo:intro.cpack	Runs another cpack/mcfunction file inline

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.

Command	Description
/cp	Shows the command list
/cp run <namespace:file>	Runs a cpack/mcfunction file
/cp stop <all|namespace:file>	Stops a running script (or all scripts) immediately
/cp list [page]	Lists all loaded files with their status
/cp disable <namespace:file>	Disables a file (prevents it from running)
/cp enable <namespace:file>	Re-enables a disabled file
/cp reload <all|namespace:file>	Reloads files from disk and re-parses them

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/<WorldName>/cpack/<namespace>/

---

License

MIT — do whatever you want with it.