KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

golab

★ 43 Open GitHub ↗

Goofy, cartoonish, open-source multiplayer shooter written in Rust with Bevy 👻

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 🌹 Golab &emsp; [![Licence]][Licence URL] [![Rust]][repository] [![Bevy]][Bevy URL] [![Multiplayer]][Lightyear URL] [![Sponsors]][Sponsors URL]

[Licence]: https://img.shields.io/github/license/NiiightmareXD/golab
[Licence URL]: https://github.com/NiiightmareXD/golab/blob/main/LICENSE
[Rust]: https://img.shields.io/badge/Rust-nightly-orange?logo=rust
[repository]: https://github.com/NiiightmareXD/golab
[Bevy]: https://img.shields.io/badge/Bevy-0.18.1-8A2BE2
[Bevy URL]: https://bevyengine.org/
[Multiplayer]: https://img.shields.io/badge/Multiplayer-Lightyear-blue
[Lightyear URL]: https://github.com/cBournhonesque/lightyear
[Sponsors]: https://img.shields.io/github/sponsors/NiiightmareXD
[Sponsors URL]: https://github.com/sponsors/NiiightmareXD

**Golab** is a goofy, cartoonish, open-source multiplayer shooter written in Rust with Bevy — where everything is round, soft, blobby. 🔫🫧🌹

The name comes from a silly little chain of thoughts:

> Everything looks like a **blob** → blob sounds like **Golab** → Golab brings Persian rose water vibes → boom, tiny chaotic **Golab** shooter. 🌹✨

![Golab preview](https://raw.githubusercontent.com/NiiightmareXD/golab/main/assets/Github/preview.jpg)

<details>
<summary>🎬 Click to watch the gameplay clip</summary>

https://github.com/user-attachments/assets/13641e96-2cb7-432f-8baf-5b4d6ce82ddd
</details>

---

## ✨ What is this?

Golab is a fast little arena shooter with squishy cartoon energy:

- 🫧 **Blob-like characters** with cute low-poly/cartoon styling
- 🔫 **First-person shooting** with tiny glowing red blob bullets
- 🏃 **Movement tech**: jump, crouch, dash, and zip around the arena
- 👀 **First-person / third-person toggle** for maximum blob appreciation
- 🌐 **Multiplayer client + dedicated server** powered by Lightyear
- ❤️ **Health, respawn, ping, name tags, and HUD indicators**
- ⚙️ **In-game settings** for mouse sensitivity, audio, graphics, shadows, AA, motion blur, and more
- 🦀 **Built in Rust** because fearless concurrency pairs nicely with fearless blobbery

---

## 🎮 Controls

| Action | Input |
| --- | --- |
| Move | `W` `A` `S` `D` |
| Look around | Mouse |
| Shoot | Left mouse button |
| Dash | Right mouse button |
| Jump | `Space` |
| Crouch | `Left Ctrl` / `Right Ctrl` |
| Toggle first/third person | `R` |
| Open menu | `Esc` |
| Switch join fields | `Tab` |

---

## 🚀 Quick start

### Prerequisites

- 🦀 Rust with the repository toolchain installed — this project uses `nightly`
- 🎮 A graphics-capable machine supported by Bevy/wgpu

Clone the garden:

```bash
git clone https://github.com/NiiightmareXD/golab.git
cd golab
```

### Offline blob mode

Want to just vibe, run around, and test the game without a server? Launch the client by itself:

```bash
cargo run -p client --release
```

You can play offline locally — the server is only needed when you want multiplayer blob chaos. 🫧

### Multiplayer blob mode

#### 1. Start the server

```bash
cargo run -p server --release
```

The default server address is:

```text
127.0.0.1:5000
```

Want to bind the server somewhere else, like `0.0.0.0:5000` for LAN/external connections? Change `SERVER_ADDR` in `shared/src/lib.rs`:

```rust
pub const SERVER_ADDR: SocketAddr = SocketAddr::new(IpAddr::V4(Ipv4Addr::UNSPECIFIED), 5000);
```

> When binding to `0.0.0.0`, remote clients should join using the host machine's LAN/public IP address, not `0.0.0.0` itself.

#### 2. Start the client

In another terminal:

```bash
cargo run -p client --release
```

Open the menu, join the server, choose your blob name, and enter arena. 🌹🫡

> Tip: run multiple clients locally if you want to test multiplayer chaos on one machine.

---

## 🧰 Tech stack

| Piece | Tech |
| --- | --- |
| Engine | [Bevy](https://bevyengine.org/) |
| Physics / collision | [Avian3D](https://github.com/Jondolf/avian) |
| Networking | [Lightyear](https://github.com/cBournhonesque/lightyear) |
| Language | Rust 2024 / nightly |
| License | MIT |

---

## 📁 Project layout

```text
golab/
├── assets/          # Models, sounds, textures, environment maps, GitHub media
├── client/          # Bevy game client
├── server/          # Dedicated multiplayer server
├── shared/          # Shared protocol, messages, constants
├── Cargo.toml       # Workspace config
├── CREDITS.md       # Third-party asset credits
└── README.md        # You are here 🌹
```

---

## 🌱 Contributing

Pull requests, issues, ideas, bug reports, balancing suggestions, and ridiculous blob-related feature requests are welcome.

If you want to help, good places to start are:

- 🐛 report bugs
- 🎨 improve assets or animations
- 🔊 add satisfying blob sounds
- 🕹️ tune gameplay feel
- 🌐 improve networking polish
- 📚 improve docs

---

## 🥤 ~~Buy me a coffee~~ Buy me Claude

If Golab made you smile, helped you learn, or gave you the sudden urge to duel cartoon blobs, you can support the project here:

[![GitHub Sponsors](https://img.shields.io/badge/GitHub-Sponsor%20the%20blob-ff69b4?logo=github)](https://github.com/sponsors/NiiightmareXD)

Every little bit helps fuel more Rust, more Bevy, more blob polish, and more **Claude Code credits**. 🤖💸🌹

---

## 🙏 Credits

Golab uses lovely third-party assets from generous creators. See [CREDITS.md](CREDITS.md) for attribution and license details.

---

## 📜 License

Golab's source code is released under the [MIT License](LICENSE).

Third-party assets are licensed separately by their original creators. See [CREDITS.md](CREDITS.md) for attribution and asset license details.

---

golab

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README