Skyhook Race Kit
Everything you need to put a co-op sky-island race in your own game, as one installable package: skyhookRace. It is the complete game the Skyhook world plays (rules, team collectibles, route bells, chasing storm, finish and results), exposed as a layout and a tuning table you change instead of code.
What you get
- A full race loop in one call: lobby, 3-2-1-GO countdown, checkpoints on every island, falls respawn at your checkpoint, a race clock that is the storm's own (0:00 is the storm swallowing the finish), finish order and a results table. Works for 1 to 4 players online; late joiners see the same bells, fruit count and storm.
- Team collectibles: starfruit with one shared team count, restored for every race.
- Bells that open routes: ring a bell and its islets rise out of the clouds for everyone; one bell can seal the finish until it rings. The objective guides each player to the next bell.
- A storm that chases the runners: it swallows the islands behind them, rescues anyone it catches to their last safe checkpoint, and reaches the finish exactly when the race clock hits 0:00. Every runner gets their own finish: the race goes on for anyone still flying after the first runner crosses, and the results show each runner's time or "Caught by the storm".
- Movement: grappling hook, zip lines, slingshots, wingsuit and gliders, updrafts and boost rings, and momentum that carries between them (grappleKit, glideKit, airMotor).
- Islands in any style: every island is grown by floatingIslands, with 12 looks (meadow, waterfall, farmland, crystal, fortress, marble, snowy, autumn, mesa, volcanic, low-poly, pixel) and 14 shapes.
- Progression and feel: per-player score (fruit, checkpoints, bells, finish and time bonus), XP and levels, unlockable hook and glider styles, best times, controls on keyboard + mouse, gamepad and touch from a controlsKit scheme (every player remaps jump, boost, hook, reel and wingsuit on keys and pad and moves their touch buttons, kept between visits), music, sound and screen effects.
- A default course, Sunset Isles: six islands from Launch Meadow to the Bell Spire, each in its own colours, ready to play or to copy.
Use it in your game
- Install the package: search ZeroMind for skyhookRace, or in the engine shell run
zero zeromind installAsset b129e4fa-6753-4be9-a147-9d48fc887711. It brings the kits it builds on. - Make a race scene:
zero scene create --startup race empty, then put this inscenes/race.scene/build.luau:
function content()
require("skyhookRace.race").build()
end
- Run
zero scene player spawnsand press Play.
Make it yours
Pass your own course and any tuning you want to change:
function content()
require("skyhookRace.race").build({
layout = require("myCourse"), -- copy skyhookRace.layouts.sunsetIsles
tuning = { storm = { maxSpeed = 8, arriveBy = 290 }, glide = { style = "paraglider" } },
})
end
- Tuning groups: race, bells, fruit, hook, glide, storm, progression, world and score, each with defaults.
storm = { enabled = false }races without the storm;world = { dressing = false }drops the default props so you can dress the islands yourself. - Layouts: islands with a role, a floatingIslands look and shape, bells and the islets they raise, air currents, anchors, zip lines, slingshots and crumbling stones.
Guides in the package: how-skyhook-is-built-and-how-to-change-it and example-make-your-own-sky-island-race-level.
In this world
The package source (race/skyhookRace.package) and a demo scene that plays the default course. Current version: skyhookRace 1.5.0 (the version the Skyhook world plays). Want to just play? Open the Skyhook world.
New in 1.5.0: the ring to aim at next is lit for each runner and the gap rings are halo rings of cool light (grappleKit 1.0.14); the cloud wisps are soft cloudburst 1.5.3 clouds; world.mood (sunset, dawn, noon, night, storm), world.islandStyle (winter, autumn, volcanic, meadow, lowpoly, pixel) and bells.style (bronze, gold, crystal, amethyst) restyle a race in one line each; the sun is placed by worldClockKit 1.7.7's own settings; a fresh course gets a clock from its own length and a launch ring within hook reach; starfruit come back through pickupsKit 2.3.14 and score through scoreKit 1.4.10; Trapline 1.5.8 runs one health stack; the README and example guide go step by step, saying what you should see after each step.
New in 1.4.9: your own course keeps the sunset with world.dressing = false; one "Next" toast per bell; a fall respawns you at your own checkpoint (the storm rescue steps in only when that spot is swallowed); flying high over the finish no longer finishes (race.finishHeight); smaller courses get launch rings you can aim at from the run-up (mid-gap, 11 m) while Sunset Isles keeps its tuned rings (a layout can carry its own tuning); custom courses keep their lanes, checkpoints and bells clear of props (floatingIslands 1.0.10); hooking a bell from the ground rings it and leaves you standing, in the air the swing stays. Sent in by a player who built their own course; reviewed and released here.
New in 1.4.8: takes stormFrontKit 1.0.10, whose guides now say which version they describe; the README and both guides name it.
New in 1.4.7: installs match the release file for file: eleven preview pictures that every installing world kept redrawing are re-rendered and current; takes floatingIslands 1.0.9.
New in 1.4.6: a hook or glider style unlocked mid-race goes on once you land (a mid-air swap cut a 25 m/s glide to 11); your own courses build without Sunset Isles' waterfall island; starfruit no longer flash a big pale ball (juiceKit 1.2.12); the README names every part and version it brings and gives a three-island course to start from.
New in 1.4.5: runners read as lit, solid characters from every angle (a local key light that lights runners only, deeper suit colours); crystals show shaded facets; the camera never loses the runner behind a bush, rock or crystal; even island rock; brings grappleKit 1.0.13, glideKit 1.0.15, airMotor 1.0.8 and floatingIslands 1.0.8.
New in 1.4.4: runners read as lit characters in the sunset light: each fabric suit carries a fine grain, so light and shadow show across the body (1.4.3's smooth single-colour suits still looked flat).
New in 1.4.3: the wingsuit glide carries a swing's speed (about 50 m/s instead of bleeding to 15-20), every island has its own silhouette (a stepped mesa, a crescent with a crag, farm terraces, crystal fangs, a bastion, a star-pointed spire), the camera never sits inside a bush or crystal, the cave ceiling has no streaks, runners wear lit fabric suits, name tags show only over runners in the race, and a storm rescue no longer flashes a black frame. It brings grappleKit 1.0.12, glideKit 1.0.14, airMotor 1.0.7, floatingIslands 1.0.7, MatchFlow 1.4.3, pickupsKit 2.3.13 and saveKit 1.3.15.
New in 1.4.2: a fresh install builds the race. 1.4.0 and 1.4.1 recorded dependency versions only this world held, so a new world got an empty storm kit. Checked by installing into a brand-new world from the README and racing to the finish. 1.4.1 also fixes the navUiKit pin (1.3.14) and stale lines in the README and guides.
New in 1.4.0: every runner gets their own finish. The race used to end for everyone a few seconds after the first runner crossed, because the storm's route stopped one island short of the finish. Now the storm runs to the finish, the race clock is the storm's own (storm.startDelay + storm.arriveBy, 4:00 by default), and the results show each runner's time or "Caught by the storm". It brings stormFrontKit 1.0.9 (arriveBy) and MatchFlow 1.4.2 (setStatus, DNF).
New in 1.3.9: the hook goes for the course anchors and never pins you to the ground just ahead, races with the storm log no errors, and a step-by-step workflow ships in the package, build-a-sky-island-race-course (survey, design the islands and bells, build the layout, tune the storm, race it solo and with two players until clean). It brings grappleKit 1.0.11, glideKit 1.0.12, stormFrontKit 1.0.8 and floatingIslands 1.0.6, each with its own workflow.
New in 1.3.8: the guides give the real controls (Space again in the air or G opens the wingsuit, Left Shift is Boost) and say to let go of the hook on the upswing; it brings grappleKit 1.0.10 and glideKit 1.0.11 (one airMotor 1.0.6, and a paraglider harness of straps and a seat pod).
New in 1.3.7: after a fall or a storm rescue you respawn beside the checkpoint campfire, not behind it with the camera looking through the fire.
New in 1.3.6: when the storm catches you, your checkpoint now really moves to the nearest safe island, so a later fall never drops you back onto a sunken one.
New in 1.3.3: touch screens show full button labels (Hook, Jump, Wings, Reel, Boost, Remap), the Remap button keeps clear of the Menu button, and race messages stack below the race timer.
New in 1.3.2: Skyhook's own grappling hook and wingsuit feels (a snappier shot, faster swings, a bigger release fling, a quicker wingsuit), a sandstone launch plaza and a stone fortress courtyard so every island reads as its own place, islands that are solid from below, one standings row per player after a rejoin, and touch screens where the standings and messages keep clear of the thumbs.
Comments · 0
Open discussion, no rating attached. Ask questions, swap notes, follow threads.
Documented parts · 13
- build-a-sky-island-race-courseworkflow
- controlsmodule
- cs_cloudshader
- fx_noise.shaderModuleshadermodule
- islandsmodule
- moodsmodule
- racemodule
- skyhookRacepackage
- tuningmodule
- wf_poolshader
- wf_river_matmaterial
- wf_sheetshader
- wf_sheet_mainmaterial