transmute / core

The Transmute library

Find your next step.

Good places to start21 results
Getting startedInstall the engine and build your first game.GuidesArchitectureUnderstand the engine, managers, and game loop.GuidesExamplesStart with a working platformer, RPG, or hello world.GuidesHeadless testingVerify gameplay without opening a window.GuidesAPI overviewExplore the building blocks of the engine.APIGame lifecycleConfigure, initialize, update, and render your game.APIAssets and manifestsLoad sprites, fonts, and audio with GameSpec.APIWorlds and physicsBuild tile worlds, movement, and collision.APIHeadless harnessSimulate input and assert frames and audio.APIhello worldA hands-on walkthrough of hello world.Tutorialssprites and animationA hands-on walkthrough of sprites and animation.Tutorialsinput and movementA hands-on walkthrough of input and movement.Tutorialscollision detectionA hands-on walkthrough of collision detection.Tutorialsstate managementA hands-on walkthrough of state management.Tutorialsaudio systemA hands-on walkthrough of audio system.Tutorialslevel designA hands-on walkthrough of level design.TutorialsAuthoring gamesTurn a prompt and assets into a verified game.GuidesCookbookFind practical recipes for common game features.GuidesContributingSet up Flox and run the project checks.GuidesWebsite developmentDevelop, preview, and deploy this website.GuidesCLI distributionBuild and distribute the game scaffolding CLI.Guides
Your next game starts here.↑ ↓ Move ↵ Open esc Close
Browse documentation

Tutorial 7: Level Design

Author tile worlds with World + GameSpec world.* keys. Prefer this over legacy TiledLevel.

What you'll learn

  • World.grid / solids / actors
  • Declarative maps in gamespec.properties
  • Camera for maps larger than the view
  • Trigger for pickups and doors

GameSpec map

world.cols=40
world.rows=20
world.tile=16
world.border=true
world.solid=5,7;6,7;10,3
clear.r=20
clear.g=20
clear.b=30

World world = spec.createWorld();
world.solidColor(wallColor);
world.add(player); // World.Actor
world.addTrigger(new Trigger(x, y, tile, tile, actor -> collected++));

Camera

When the world is larger than the framebuffer (see examples/java/rpg):

Camera camera = new Camera(viewW, viewH);
// update:
camera.lookAt(player.getX() + player.getWidth() / 2f,
              player.getY() + player.getHeight() / 2f);
camera.clampToWorld(world.pixelWidth(), world.pixelHeight());
// render:
world.render(manager, renderer, camera);

Code-built map

World world = World.grid(20, 15, 16).clearColor(bg).solidColor(wall);
world.fillBorder(World.SOLID);
world.setTile(8, 4, World.SOLID);
World.Actor npc = World.Actor.colored(64, 64, 16, 16, color);
world.add(npc);

Verify

try (GameHarness harness = GameHarness.of(() -> new RpgGame(config, spec))) {
    harness.step(1);
    FrameAssert.assertPixel(harness.renderer(), px, py, Player.COLOR);
}

Walk scripts: Tutorial 3. Collect + audio: eval/fixtures/collect-coin.

Legacy

TransmuteCore.level.TiledLevel (PNG color-indexed maps) remains supported but is not the preferred path for new games. See AUTHORING.md.

What's next

Edit this page on GitHub