[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-5805":3},{"id":4,"name":5,"fullName":6,"owner":5,"repo":5,"description":7,"homepage":8,"htmlUrl":9,"language":10,"languages":9,"totalLinesOfCode":9,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":15,"stars7d":16,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":15,"compositeScore":18,"rankGlobal":9,"rankLanguage":9,"license":19,"archived":20,"fork":20,"defaultBranch":21,"hasWiki":22,"hasPages":20,"topics":23,"createdAt":9,"pushedAt":9,"updatedAt":32,"readmeContent":33,"aiSummary":34,"trendingCount":15,"starSnapshotCount":15,"syncStatus":35,"lastSyncTime":36,"discoverSource":37},5805,"ggez","ggez\u002Fggez","Rust library to create a Good Game Easily","http:\u002F\u002Fggez.rs",null,"Rust",4636,439,53,57,0,1,19,29.93,"MIT License",false,"master",true,[24,25,26,27,28,29,30,31],"crates","engine","game","game-development","game-engine","game-frameworks","gameengine","rust","2026-06-12 02:01:15","# ggez\n\n[![ggez logo](docs\u002Fggez-logo-maroon-full.svg)](http:\u002F\u002Fggez.rs\u002F)\n\n## What is this?\n\n![Build status](https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez\u002Fworkflows\u002FCI\u002Fbadge.svg)\n[![Docs Status](https:\u002F\u002Fdocs.rs\u002Fggez\u002Fbadge.svg)](https:\u002F\u002Fdocs.rs\u002Fggez)\n[![license](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-blue.svg)](https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez\u002Fblob\u002Fmaster\u002FLICENSE)\n[![Crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fv\u002Fggez.svg)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fggez)\n[![Crates.io](https:\u002F\u002Fimg.shields.io\u002Fcrates\u002Fd\u002Fggez.svg)](https:\u002F\u002Fcrates.io\u002Fcrates\u002Fggez)\n[![Discord chat](https:\u002F\u002Fimg.shields.io\u002Fdiscord\u002F1031224392174293002.svg?label=discord%20chat)](https:\u002F\u002Fdiscord.gg\u002F48VycPe2ZX)\n\n\nggez is a Rust library to create a Good Game Easily.\n\nMore specifically, ggez is a lightweight cross-platform game framework\nfor making 2D and 3D games with minimum friction.  It aims to implement an\nAPI based on (a Rustified version of) the [LÖVE](https:\u002F\u002Flove2d.org\u002F)\ngame framework.  This means it contains basic and portable 2D\ndrawing(in addition 3D which love doesn't have an API for), sound, \nresource loading and event handling, but finer details\nand performance characteristics may be different than LÖVE.\n\nggez is not meant to be everything to everyone, but rather a good\nbase upon which to build.  Thus it takes a fairly\nbatteries-included approach without needing a million additions\nand plugins for everything imaginable, but also does not dictate\nhigher-level functionality such as physics engine or entity\ncomponent system.  Instead the goal is to allow you to use\nwhichever libraries you want to provide these functions, or build\nyour own libraries atop ggez.\n\n### Features\n\n* Filesystem abstraction that lets you load resources from folders or zip files\n* Hardware-accelerated 2D and 3D rendering built on the `wgpu` graphics API\n* Loading and playing .ogg, .wav and .flac files via the `rodio` crate\n* TTF font rendering with `glyph_brush`.\n* Interface for handling keyboard and mouse events easily through callbacks\n* Config file for defining engine and game settings\n* Easy timing and FPS measurement functions.\n* Math library integration with `mint`.\n* Some more advanced graphics options: shaders, instanced draws and render targets\n\n### Non-Features (i.e. things to add from elsewhere if needed)\n\n* [Physics](https:\u002F\u002Farewegameyet.rs\u002Fecosystem\u002Fphysics\u002F)\n* Animation (check out [keyframe](https:\u002F\u002Fgithub.com\u002FHannesMann\u002Fkeyframe); [it works pretty well with ggez](https:\u002F\u002Fpsteinhaus.github.io\u002Fggez\u002Fweb-examples\u002F) ([source](https:\u002F\u002Fgithub.com\u002FPSteinhaus\u002FPSteinhaus.github.io\u002Ftree\u002Fmain\u002Fggez\u002Fweb-examples)))\n* [GUI](https:\u002F\u002Farewegameyet.rs\u002Fecosystem\u002Fui\u002F)\n* [Assets manager](https:\u002F\u002Fgithub.com\u002Fa1phyr\u002Fassets_manager)\n* [AI](https:\u002F\u002Farewegameyet.rs\u002Fecosystem\u002Fai\u002F)\n* [ECS](https:\u002F\u002Farewegameyet.rs\u002Fecosystem\u002Fecs\u002F)\n* [Networking](https:\u002F\u002Farewegameyet.rs\u002Fecosystem\u002Fnetworking\u002F)\n\n### Supported platforms\n\n * Fully supported: Windows, Linux, MacOS\n * Not officially supported but might work anyway: Android, iOS, Web\n\nFor details, see [docs\u002FBuildingForEveryPlatform.md](docs\u002FBuildingForEveryPlatform.md)\n\nIf you want to run ggez (up to 0.7 as of now) on Android, iOS or the web using WebAssembly right now, take a look at [good-web-game](https:\u002F\u002Fgithub.com\u002Fggez\u002Fgood-web-game).\n\n### Who's using ggez?\n\nCheck out the [projects list!](docs\u002FProjects.md)\n\n### Usage\n\nggez requires rustc >= 1.42 and is distributed on\ncrates.io. To include it in your project, just add the dependency\nline to your `Cargo.toml` file:\n\n```\nggez = \"0.10.0-rc0\"\n```\n\nggez consists of three main parts: A `Context` object which\ncontains all the state required to interface with the computer's\nhardware, an `EventHandler` trait that the user implements to\nregister callbacks for events, and various sub-modules such as\n`graphics` and `audio` that provide the functionality to actually\nget stuff done.  The general pattern is to create a struct holding\nyour game's data which implements the `EventHandler` trait.\nCreate a new `Context` object with default objects from a `ContextBuilder`\nor `Conf` object, and then call `event::run()` with\nthe `Context` and an instance of your `EventHandler` to run your game's\nmain loop.\n\nSee the [API docs](https:\u002F\u002Fdocs.rs\u002Fggez\u002F) for full documentation, or the [examples](\u002Fexamples) directory for a number of commented examples of varying complexity.  Most examples show off\na single feature of ggez, while `astroblasto` and `snake` are small but complete games.\n\n### Getting started\n\nFor a quick tutorial on ggez, see the [Hello ggez](https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez\u002Fblob\u002Fmaster\u002Fdocs\u002Fguides\u002FHelloGgez.md) guide in the `docs\u002F` directory.\n\n### Examples\n\nSee the `examples\u002F` directory in the source.  Most examples show off\na single feature of ggez, while `astroblasto` is a small  but\ncomplete Asteroids-like game.\n\nTo run the examples, just check out the source and execute `cargo run --example`\nin the root directory:\n\n```\ngit clone https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez.git\ncd ggez\ncargo run --example 05_astroblasto\n```\n\nIf this doesn't work, see the\n[FAQ](https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez\u002Fblob\u002Fmaster\u002Fdocs\u002FFAQ.md) for solutions\nto common problems.\n\n#### Basic Project Template\n\n```rust,no_run\nuse ggez::{Context, ContextBuilder, GameResult};\nuse ggez::graphics::{self, Color};\nuse ggez::event::{self, EventHandler};\n\nfn main() {\n    \u002F\u002F Make a Context.\n    let (mut ctx, event_loop) = ContextBuilder::new(\"my_game\", \"Cool Game Author\")\n        .build()\n        .expect(\"aieee, could not create ggez context!\");\n\n    \u002F\u002F Create an instance of your event handler.\n    \u002F\u002F Usually, you should provide it with the Context object to\n    \u002F\u002F use when setting your game up.\n    let my_game = MyGame::new(&mut ctx);\n\n    \u002F\u002F Run!\n    event::run(ctx, event_loop, my_game);\n}\n\nstruct MyGame {\n    \u002F\u002F Your state here...\n}\n\nimpl MyGame {\n    pub fn new(_ctx: &mut Context) -> MyGame {\n        \u002F\u002F Load\u002Fcreate resources such as images here.\n        MyGame {\n            \u002F\u002F ...\n        }\n    }\n}\n\nimpl EventHandler for MyGame {\n    fn update(&mut self, _ctx: &mut Context) -> GameResult {\n        \u002F\u002F Update code here...\n        Ok(())\n    }\n\n    fn draw(&mut self, ctx: &mut Context) -> GameResult {\n        let mut canvas = graphics::Canvas::from_frame(ctx, Color::WHITE);\n        \u002F\u002F Draw code here...\n        canvas.finish(ctx)\n    }\n}\n```\n\n### Implementation details\n\nggez is built upon `winit` for windowing and events, `rodio` for\nsound, and a 2D drawing engine implemented with `wgpu`. It is entirely\nthread-safe (though platform constraints mean the event-handling loop\nand drawing must be done in the main thread), and portable to Windows\nand Linux.\n\nggez is pure Rust™.\n\n### Help!\n\nSources of information:\n\n * The [FAQ](https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez\u002Fblob\u002Fmaster\u002Fdocs\u002FFAQ.md) has answers to common questions and problems.\n * The [API docs](https:\u002F\u002Fdocs.rs\u002Fggez\u002F), a lot of design stuff is explained there.\n * Check out the [examples](https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez\u002Ftree\u002Fmaster\u002Fexamples).\n\n If you still have problems or questions, feel free to ask!  Easiest ways are:\n\n * Open an issue on [the Github issue tracker](https:\u002F\u002Fgithub.com\u002Fggez\u002Fggez\u002Fissues)\n * Say hi on [our new Discord server](https:\u002F\u002Fdiscord.gg\u002F48VycPe2ZX)\n * Or ask the wise people on the [unofficial Rust Discord server](http:\u002F\u002Fbit.ly\u002Frust-community), the [Rust Gamedev server](https:\u002F\u002Fdiscord.gg\u002FyNtPTb2) or the [good-web-game Discord server](https:\u002F\u002Fdiscord.gg\u002Fjum3Fjek2A)\n\nLicense: MIT\n","ggez 是一个用 Rust 语言编写的轻量级跨平台游戏开发框架，旨在简化2D和3D游戏的创建过程。它提供了一系列核心功能，包括文件系统抽象、基于`wgpu`的硬件加速渲染、通过`rodio`实现的声音播放、TTF字体渲染、键盘鼠标事件处理以及简易的定时器和FPS测量工具等。ggez 设计为一个基础框架，允许开发者根据需要集成其他库来扩展功能，如物理引擎、动画、GUI、资源管理器、AI和ECS等。该框架适用于希望快速搭建原型或开发小型到中型游戏项目的个人开发者及小团队，在Windows、Linux和MacOS平台上得到全面支持，并且在Android、iOS和Web上也有一定的兼容性。",2,"2026-06-11 03:05:06","top_language"]