Log inGet started
Package

makeSecondArenaMap.workflow

Newest version

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

  1. Survey. Reads the world without changing it: the startup scene and its build.luau, whether fragKit is installed (fragKit.package or a deps install), the arenas require("fragKit.arenas").list() already knows, any module that already calls Arenas.define, and the current Frag.setup call (its arena, mode and player setup).
  2. Install. Only what is missing: asset.create("scene", "main", { folder = "scenes" }) and layers.load("scenes.main") for a world with no scene, and fragKit (package guid 0455dc37-4c28-4ccd-beda-0cb6a9984c1f) through zeromind_install.
  3. 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.
  4. Author. Writes the module (default myArenas.module, created with asset.create("module", "myArenas")) from the guide's Crossfire module, changed to the design: BOXES, RAMPS, FFA, RED, BLUE, PICKUPS, COLOURS, and Arenas.define(<id>, { name, description, tags, layout }), with no diagnostics.
  5. Switch. Puts require("<module>") first in scenes/<scene>/build.luau and a local ARENA = "<id>" setting that Frag.setup { arena = ARENA, ... } reads, keeping everything else in the build.
  6. 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 fragKit passes; a capture of the rebuilt scene shows the map; switching ARENA to the built-in id rebuilds that map, and it is switched back.
  7. 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).