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

Worlds and physics

Use World for tile-based top-down games and Body2D with Collision for gravity and jumping. These modules are exercised by the checked-in RPG and platformer examples.

Declare a world

world.cols=20
world.rows=15
world.tile=16
world.border=true
world.solid=5,7;6,7
spawn.player=2,2
spawn.player.color=100,150,255
trigger.coin=6,2
trigger.coin.audio=pickup

Coordinates in this manifest are tile coordinates. Declare audio.pickup if a trigger should play that sound.

GameSpec spec = GameSpec.loadClasspath("gamespec.properties");
World world = spec.createWorld();

World lives in TransmuteCore.world. Keep map data in the manifest and gameplay behavior in the game subclass.

Gravity and collisions

Body2D lives in TransmuteCore.physics. Advance it against the scene's solids with step(solids). Follow the platformer example for a complete jump, gravity, and collision setup; use the collision tutorial for the individual operations.

Verify the result

Check movement and trigger behavior using simulated input. The RPG example verifies collection, and the platformer verifies a jump. Both expose verifyHeadless.

Edit this page on GitHub