{"id":49539597,"url":"https://github.com/tesselstudio/tesselbox","last_synced_at":"2026-05-02T14:03:38.595Z","repository":{"id":331675432,"uuid":"1128227374","full_name":"tesselstudio/TesselBox","owner":"tesselstudio","description":"the main discussion point of TesselBox","archived":false,"fork":false,"pushed_at":"2026-05-02T11:02:15.000Z","size":67172,"stargazers_count":8,"open_issues_count":4,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-02T11:28:58.446Z","etag":null,"topics":["game","github","sandbox","sandbox-game","single","singleplayer","testing"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tesselstudio.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-05T10:24:26.000Z","updated_at":"2026-05-02T11:02:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/tesselstudio/TesselBox","commit_stats":null,"previous_names":["jason1015-coder/hexagonal-sandbox","jason1015-coder/inhexit","jason1015-coder/tesselbox","tesselbox-studio/tesselbox-game","tesselstudio/tesselbox-game","tesselstudio/tesselbox-main","tesselstudio/tesselbox"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/tesselstudio/TesselBox","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesselstudio%2FTesselBox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesselstudio%2FTesselBox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesselstudio%2FTesselBox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesselstudio%2FTesselBox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tesselstudio","download_url":"https://codeload.github.com/tesselstudio/TesselBox/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tesselstudio%2FTesselBox/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32536585,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game","github","sandbox","sandbox-game","single","singleplayer","testing"],"created_at":"2026-05-02T14:03:37.416Z","updated_at":"2026-05-02T14:03:38.584Z","avatar_url":"https://github.com/tesselstudio.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TesselBox\n\nA hexagonal block-based adventure game with exploration, crafting, combat, survival elements, and **multiplayer support**.\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Build](https://github.com/tesselstudio/TesselBox/actions/workflows/build.yml/badge.svg)](https://github.com/tesselstudio/TesselBox/actions)\n\n## Overview\n\nTesselBox is an open-source game built with a unique hexagonal grid system. Explore vast worlds, gather resources, craft tools, build structures, survive against hostile mobs, and **play with friends** in multiplayer mode.\n\n## Features\n\n- **Hexagonal Grid System** - Unique 6-sided block world\n- **Procedural Generation** - Infinite worlds with varied biomes\n- **Crafting System** - Craft tools, weapons, and building materials\n- **Survival Mode** - Manage health, hunger, and fend off enemies\n- **Creative Mode** - Build without limits\n- **Dimensions** - Travel between overworld and Randomland\n- **Multiplayer** - Play with up to 16 players via LAN or direct connection\n- **Cross-Platform** - Play on PC (Windows/Linux/macOS) or Mobile (Android/iOS)\n\n## Multiplayer\n\nTesselBox now supports multiplayer gaming:\n\n- **UDP** for real-time position updates (50ms sync)\n- **TCP** for reliable messaging (chat, block changes)\n- **LAN Discovery** - Find servers automatically on your local network\n- **Direct Connect** - Connect by IP address\n- **Up to 16 players** per server\n- **PC can host** - Run as dedicated server or host while playing\n- **Mobile support** - Mobile clients can connect to PC servers\n\n### Server Commands (PC)\n\n```bash\n# Run as dedicated server\n./tesselbox --server --port 25565 --name \"My Server\"\n\n# Connect to a server\n./tesselbox --connect 192.168.1.100:25565 --player \"Player1\"\n\n# Enable LAN discovery\n./tesselbox --discover\n```\n\n## Building\n\n### Requirements\n\n- Go 1.21 or later\n- For Android: Android SDK and NDK\n- For iOS: macOS with Xcode\n\n### Quick Build\n\n```bash\n# Clone the repository\ngit clone https://github.com/tesselstudio/TesselBox.git\ncd TesselBox\n\n# Build for current platform\ngo build -o tesselbox ./cmd/main.go\n\n# Or use make to build all platforms\nmake build-all\n```\n\n### Platform-Specific Builds\n\n```bash\n# Linux\nmake build-linux\n\n# Windows\nmake build-windows\n\n# macOS\nmake build-macos\n\n# Android APK\nmake build-android\n\n# iOS\nmake build-ios\n```\n\n### Build Script\n\n```bash\n# Build all platforms\n./scripts/build.sh all\n\n# Build specific platform\n./scripts/build.sh linux\n./scripts/build.sh android\n```\n\n## Running\n\n```bash\n# Run the game\n./tesselbox\n\n# Run as dedicated server\n./tesselbox --server\n\n# Connect to a server\n./tesselbox --connect 192.168.1.100:25565\n```\n\n## Controls\n\n### PC/Desktop\n| Key | Action |\n|-----|--------|\n| WASD | Move |\n| Space | Jump |\n| Shift | Sprint |\n| Mouse | Look/Mine/Place |\n| I | Inventory |\n| C | Crafting |\n| B | Block Library |\n\n### Mobile\n| Gesture | Action |\n|---------|--------|\n| Swipe (left half) | Move/Jump |\n| Tap (right half) | Mine/Attack |\n| Hold (right half) | Place block |\n| Pinch | Zoom |\n| Two-finger tap | Inventory |\n\n## Project Structure\n\n```\nTesselBox/\n├── cmd/                    # Entry points\n│   └── main.go            # Main entry (desktop + mobile)\n├── internal/\n│   └── game/              # Core game logic\n├── pkg/\n│   ├── network/           # Multiplayer networking\n│   │   ├── packet.go      # Packet serialization\n│   │   ├── udp.go         # UDP transport\n│   │   ├── tcp.go         # TCP transport\n│   │   ├── server.go      # Game server\n│   │   ├── client.go      # Network client\n│   │   ├── discovery.go   # LAN discovery\n│   │   └── client_session.go\n│   ├── platform/          # Platform-specific code\n│   │   ├── desktop.go     # PC platform\n│   │   └── mobile.go      # Mobile platform\n│   ├── world/             # World generation\n│   ├── player/            # Player logic\n│   ├── blocks/            # Block definitions\n│   ├── crafting/          # Crafting system\n│   └── ...\n├── config/                # Configuration files\n├── scripts/               # Build scripts\n├── .github/workflows/      # CI/CD\n├── Makefile              # Build automation\n└── go.mod                # Go module\n```\n\n## Documentation\n\n- [Contributing Guidelines](CONTRIBUTING.md)\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [Security Policy](SECURITY.md)\n\n## Community\n\n- [Discussions](https://github.com/tesselstudio/TesselBox/discussions) - Ask questions, share ideas\n- [Issues](https://github.com/tesselstudio/TesselBox/issues) - Report bugs, request features\n\n## Development Status\n\n| Platform | Status | Multiplayer |\n|----------|--------|-------------|\n| PC (Windows/Linux/macOS) | Active | Host + Client |\n| Mobile (Android/iOS) | Active | Client only |\n\n## CI/CD\n\nThe project uses GitHub Actions for automated builds:\n\n- **Linux**: AMD64, ARM64\n- **Windows**: AMD64, ARM64\n- **macOS**: AMD64, ARM64, Universal\n- **Android**: APK\n- **iOS**: App bundle\n\nReleases are automatically created when pushing tags (e.g., `v1.0.0`).\n\n## License\n\nLicensed under the MIT License.\n\nCopyright (c) 2026 TesselStudio\n\nSee [LICENSE](LICENSE) for details.\n\n## Acknowledgments\n\n- Built with [Ebiten](https://ebiten.org/) game library\n- Inspired by classic block-based adventure games\n- Thanks to all contributors and the open-source community\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesselstudio%2Ftesselbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftesselstudio%2Ftesselbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesselstudio%2Ftesselbox/lists"}