RealityActions brings the popular Cocos2D-style action framework to Entities in RealityKit.

Browse the API Documentation.

To use, reference this module from SwiftPM:

https://github.com/migueldeicaza/RealityActions

To use the framework, you must first register the Action framework with RealityKit, at your program startup make sure you have something like this:

ActionManagerSystem.registerSystem()

Then, you can execute one of the many available actions on your entities, this is a snippet that moves an entity in a game:

class SmallPlate: Weapon {
    override var reloadDuration: Duration { .milliseconds(450) }
    override var damage: Int { 10 }

    override func fire (byPlayer: Bool) async {
        //let distance: Float = 10
        guard let parent = await entity.parent else {
            return
        }

        @Sendable func fire (to: SIMD3<Float>) async {
            let bullet = await createRigidBullet(byPlayer: byPlayer, size: size)
            await bullet.addChild(smallPlateEntity.clone(recursive: true))

            await parent.addChild(bullet)

            await bullet.run(MoveBy(duration: 3, delta: to))
            await bullet.removeAllActions()
            await bullet.removeFromParent()
        }
        await fire (to: [Float.random(in: -3...3), -2, 0])
    }
}

This one makes a small airplane rotate every 5 seconds:

        airplane.start (RepeatForever (
            DelayTime(duration: 5),
            EaseBackOut(
                RotateBy(duration: 1, deltaAngles: SIMD3<Float> (0, 0, 360)))))

History

The action framework originated sometime with Cocos2D. Cocos2D sprawled various different efforts, among those a port to .NET, which lead to CocosSharp, and later this was ported to the 3D engine UrhoSharp.

I ported the UrhoSharp codebase that added some 3D capabilities and added various neat features using Async to Swift and RealityKit.