#bevy-plugin #ios #bevy #mobile #swift #gamedev

bevy_ios_gamecenter

Bevy Plugin and Swift Package to provide access to iOS native GameKit (Gamecenter) from inside Bevy Apps

10 releases

0.2.0 Jul 11, 2024
0.1.8 May 11, 2024

#209 in Game dev

Download history 35/week @ 2024-06-15 5/week @ 2024-06-22 11/week @ 2024-06-29 164/week @ 2024-07-06 11/week @ 2024-07-13 16/week @ 2024-07-27 1/week @ 2024-08-03 14/week @ 2024-08-24 29/week @ 2024-08-31 177/week @ 2024-09-07 69/week @ 2024-09-14 19/week @ 2024-09-21 61/week @ 2024-09-28

331 downloads per month

MIT license

34KB
608 lines

bevy_ios_gamecenter

crates.io docs.rs discord

Bevy Plugin and Swift Package to provide access to iOS native GameKit (Gamecenter) from inside Bevy Apps It uses Swift-Bridge to auto-generate the glue code and transport datatypes.

demo

Demo from our game using this crate: zoolitaire.com

See also bevy_ios_iap, bevy_ios_notifications, bevy_ios_alerts, bevy_ios_review & bevy_ios_impact

Features

  • authentication
  • save games (based on iCloud)
  • achievements
  • leaderboards

TODOs

  • challenges, matchmaking

Instructions

  1. Add to XCode: Add SPM (Swift Package Manager) dependency
  2. Add Rust dependency
  3. Setup Plugin

1. Add to XCode

  • Add GameKit framework: gamekit

  • Go to File -> Add Package Dependencies and paste https://github.com/rustunit/bevy_ios_gamecenter.git into the search bar on the top right: xcode

Note: The rust crate used must be exactly the same version as the Swift Package. I suggest using a specific version (like 0.2.0 in the screenshot) to make sure to always use binary matching versions!

2. Add Rust dependency

cargo add bevy_ios_gamecenter

or

# always pin to the same exact version you also of the Swift package
bevy_ios_gamecenter = { version = "=0.2.0" }

3. Setup Plugin

Initialize Bevy Plugin:

// request auth right on startup
app.add_plugins(IosGamecenterPlugin::new(true));
fn bevy_system() {
    bevy_ios_gamecenter::achievements_reset();
    
    // update achievement progress, 100 % will complete it
    bevy_ios_gamecenter::achievement_progress("id".into(),100.);

    bevy_ios_gamecenter::leaderboards_score(
        "raking id".into(),
        // score
        1,
        // context
        2,
    );

    // open gamecenter view (leaderboard)
    bevy_ios_gamecenter::trigger_view(view_states::LEADERBOARDS);

    // save arbitrary binary buffer as a savegame
    bevy_ios_gamecenter::save_game("test".into(), vec![1, 2, 3].as_slice());

    // request list of `IosGCSaveGame`
    bevy_ios_gamecenter::fetch_save_games();

    // based on result of above `fetch_save_games` request
    let save_game = IosGCSaveGame {..} 
    bevy_ios_gamecenter::load_game(save_game);
}

Process Response Events from iOS back to us in Rust:

fn process_gamecenter_events(
    mut events: EventReader<IosGamecenterEvents>,
) {
    for e in events.read() {
        match e {
            IosGamecenterEvents::SaveGames(response) => todo!(),
            IosGamecenterEvents::Player(player) => todo!(),
            IosGamecenterEvents::Authentication(response) => todo!(),
            IosGamecenterEvents::SavedGame(response) => todo!(),
            IosGamecenterEvents::LoadGame(response) => todo!(),
            IosGamecenterEvents::AchievementProgress(response) => todo!(),
            IosGamecenterEvents::AchievementsReset(response) => todo!(),
            IosGamecenterEvents::LeaderboardScoreSubmitted(response) => todo!(),
        }
    }
}

Bevy version support

bevy bevy_ios_gamecenter
0.14 0.2,main
0.13 0.1

License

All code in this repository is dual-licensed under either:

at your option. This means you can select the license you prefer.

Your contributions

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~27MB
~461K SLoC