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 6: Audio System

Load WAV clips via GameSpec, play with AudioPlayer, assert cues headless with AudioProbe.

What you'll learn

  • audio.* manifest keys
  • AudioPlayer.play / loop / stop
  • Mute + AudioProbe for CI (no sound device required)

Declare

audio.jump=sounds/jump.wav
audio.bgm=music/level.wav

GameSpec.loadClasspath("gamespec.properties").loadAssets(manager.getAssetManager());

Supported: WAV / AIFF / AU (Java Clip). Prefer WAV.

Play

AudioPlayer.play("jump");   // one-shot
AudioPlayer.loop("bgm");    // music
AudioPlayer.stop("bgm");
AudioPlayer.setMuted(true); // headless / user mute — probe still records

Headless assert

try (GameHarness harness = GameHarness.of(() -> new Game(headlessConfig));
     AudioProbe probe = AudioProbe.install()) {
    AudioPlayer.setMuted(true);
    SimulatedInput input = (SimulatedInput) harness.game().getManager().getInputHandler();
    input.pressKey(KeyEvent.VK_SPACE);
    harness.step(1);
    probe.assertPlayed("jump");
    probe.assertPlayCount("jump", 1);
}

AudioProbe records even when muted or when the clip asset is missing — call AudioPlayer.play("pickup") from game logic so agents can verify intent.

Eval fixture

See eval/fixtures/collect-coin for a full playtest that asserts AudioProbe.assertPlayed("pickup").

Next

Tutorial 7: Level Design

Edit this page on GitHub