makeSecondArenaMap.workflow
- .metadata248 B
- README.md2.9 KB
- workflow.js10.1 KB
- workflow.yaml2.6 KB
README.md
makeSecondArenaMap
Make a second arena map (a new deathmatch map, another level) for a fragKit first-person shooter, and switch between the built-in arena and the new one with one setting in the scene build. It is the guide How to make a second arena map for my deathmatch shooter (fragKit.package/guides/how-to-make-a-second-arena-map-for-my-deathmatch-shooter) as a run.
What it does
- Survey. Reads the world without changing it: the startup scene and its
build.luau, whether fragKit is installed (fragKit.packageor a deps install), the arenasrequire("fragKit.arenas").list()already knows, any module that already callsArenas.define, and the currentFrag.setupcall (its arena, mode and player setup). - Install. Only what is missing:
asset.create("scene", "main", { folder = "scenes" })andlayers.load("scenes.main")for a world with no scene, and fragKit (package guid0455dc37-4c28-4ccd-beda-0cb6a9984c1f) throughzeromind_install. - Design. Settles the new arena: an id, a display name, a look (colours per role) and a plan of the 50 x 50 m play area: cover, heights, ramps, sight lines, 8+ free-for-all spawns, 4+ red spawns on the -Z side and 4+ blue on the +Z side, the hill, pickups and the lobby balcony 9 m up outside the -Z wall.
- Author. Writes the module (default
myArenas.module, created withasset.create("module", "myArenas")) from the guide's Crossfire module, changed to the design:BOXES,RAMPS,FFA,RED,BLUE,PICKUPS,COLOURS, andArenas.define(<id>, { name, description, tags, layout }), with no diagnostics. - Switch. Puts
require("<module>")first inscenes/<scene>/build.luauand alocal ARENA = "<id>"setting thatFrag.setup { arena = ARENA, ... }reads, keeping everything else in the build. - Verify. Edit mode only: the layout has 8+ FFA, 4+ red and 4+ blue spawns, a lobby, a hill and a nav box; no collider within 0.32 m of any spawn or pickup at 0.45, 0.95 and 1.45 m above it;
zero tests run fragKitpasses; a capture of the rebuilt scene shows the map; switchingARENAto the built-in id rebuilds that map, and it is switched back. - Report. The arena id and name, the module and build paths, each check with its result, and the one line to edit to switch maps.
What it needs
A world (an empty one is fine). The run installs fragKit 1.0.7 or later when it is missing, which brings weaponsKit, SecondWind, MatchFlow, lobbyKit, aiKit with navKit and arenaBots. Nothing enters play mode: every check runs in edit mode.
Starting it
zero workflow start --name makeSecondArenaMap --args '{"arena":"crossfire","look":"a sandstone yard with a raised centre platform","first":"warehouse"}'
Every argument is optional: arena (the new id), look (the map in the asker's words), first (the built-in arena to switch back to) and module (the module that holds the arena, default myArenas).