CrateCinema

Give your ExcellentCrates crates an opening worth watching.

CrateCinema plays a short in-world show when a player opens a crate: a meteor strikes the crate, a hand of cards is shuffled and flipped, a portal tear swallows the reward pool. Keys, rewards, costs and the crate editor stay exactly as they are in ExcellentCrates. CrateCinema only adds the show, and ExcellentCrates still grants every reward.

Shows

• Starfall: a burning meteor streaks down and strikes the crate; the reward rises from the impact.
• Cards: five cards are shuffled; one steps forward, glows and flips over to show the reward.
• Orbit: rewards from the pool circle above the crate and narrow down to the winner.
• Rift: a portal tear swallows the pool and pushes the reward out towards the player.
• Simple: text, particles and sound only. Light, and visible to Bedrock players.

Why it is different

• Rarity tiers. Rarer rewards build up longer, glow in their rarity colour and end with a bigger fanfare, so players can tell a legendary pull before the name appears.
• Private shows. Only the player opening the crate sees their show, so a crowd can open the same crate at once without overlapping. Showing it to nearby players is one setting.
• Batch openings stay short. Opening ten keys plays one show for the best reward, then shows all ten together. Nobody waits through ten animations.
• Safe by design. If a player quits, teleports away, changes world or the server stops mid-show, the reward is granted immediately. After a death it is granted on respawn. Show entities are never saved, so nothing is left behind after a crash.
• Bedrock aware. With Floodgate, Bedrock players get a show their client can display.

Setup

1. Install ExcellentCrates (7.1.0+) and nightcore, then CrateCinema.
2. In plugins/CrateCinema/bindings.yml, bind a crate to a show: my_crate: starfall.
3. /cratecinema reload. Done.

Try any show at any tier with /cratecinema preview <show> [tier]. Every show has its own settings file (timings, materials, colours), and there are settings for audience, sound and particle volume, concurrency limits and Bedrock players. Full documentation: https://github.com/ryuka-dev/CrateCinema/blob/main/docs/configuration.md

Requirements

• Paper 1.21.9 or newer
• Java 25 (required by ExcellentCrates 7)
• ExcellentCrates 7.1.0+ with nightcore
• Optional: Floodgate (Bedrock players), packetevents (ExcellentCrates holograms)

Free and open source

GPL-3.0. Source, issues and documentation: https://github.com/ryuka-dev/CrateCinema

Help

Questions and ideas are welcome on Discord. Bugs are tracked in GitHub issues.